Pyoxigraph (Oxigraph for Python)
================================
[](https://pypi.org/project/pyoxigraph/)
[](https://github.com/oxigraph/oxigraph/actions)
[](https://gitter.im/oxigraph/community?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge)
Pyoxigraph is a graph database library implementing the [SPARQL ](https://www.w3.org/TR/sparql11-overview/ ) standard.
It is a Python library written on top of [Oxigraph ](https://github.com/oxigraph/oxigraph ).
Pyoxigraph offers two stores with [SPARQL 1.1 Query ](https://www.w3.org/TR/sparql11-query/ ) capabilities.
One of the store is in-memory, and the other one is disk based.
It also provides a set of utility functions for reading, writing and processing RDF files in
[Turtle ](https://www.w3.org/TR/turtle/ ),
[TriG ](https://www.w3.org/TR/trig/ ),
[N-Triples ](https://www.w3.org/TR/n-triples/ ),
[N-Quads ](https://www.w3.org/TR/n-quads/ ) and
[RDF/XML ](https://www.w3.org/TR/rdf-syntax-grammar/ ).
Pyoxigraph is distributed [on Pypi ](https://pypi.org/project/pyoxigraph/ ).
Run `pip install pyoxigraph` to install it.
There exists also a small library providing [rdflib ](https://rdflib.readthedocs.io ) stores using pyoxigraph: [oxrdflib ](https://github.com/oxigraph/oxrdflib ).
Pyoxigraph documentation is [available on the Oxigraph website ](https://oxigraph.org/pyoxigraph/ ).
## Build the development version
To build and install the development version of pyoxigraph you need to clone this git repository
and to run `pip install .` in the `python` directory (the one this README is in).
## How to contribute
Pyoxigraph is written in Rust using [PyO3 ](https://github.com/PyO3/pyo3 ).
Pyoxigraph is built using [Maturin ](https://github.com/PyO3/maturin ).
Maturin could be installed using the `pip install maturin` .
To install a development version of Oxigraph just run `maturin develop` in this README directory.
The Python bindings tests are written in Python.
To run them use `python -m unittest` in the `tests` directory.
