Fork of https://github.com/oxigraph/oxigraph.git for the purpose of NextGraph project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
oxigraph/python
Tpt 38844f6436 sparesults: use Read instead of BufRead as input type 1 year ago
..
docs Python: query results I/O 1 year ago
src sparesults: use Read instead of BufRead as input type 1 year ago
tests Adds basic location support to sparesults SyntaxError 1 year ago
Cargo.lock Python: Adds lockfile to source archive 3 years ago
Cargo.toml Upgrades oxhttp 1 year ago
README.md Upgrades oxhttp 1 year ago
generate_stubs.py Upgrades minimal Python version to 3.8 1 year ago
mypy_allowlist.txt Auto generates pyoxigraph type stubs 2 years ago
pyproject.toml Upgrades minimal Python version to 3.8 1 year ago
requirements.dev.txt Upgrades minimal Python version to 3.8 1 year ago

README.md

Pyoxigraph (Oxigraph for Python)

PyPI Conda PyPI - Implementation PyPI - Python Version actions status Gitter

Pyoxigraph is a graph database library implementing the SPARQL standard. It is a Python library written on top of Oxigraph.

Pyoxigraph offers two stores with SPARQL 1.1 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, TriG, N-Triples, N-Quads and RDF/XML.

Pyoxigraph is distributed on Pypi and on conda-forge. Run pip install pyoxigraph to install it.

There exists also a small library providing rdflib stores using pyoxigraph: oxrdflib.

Pyoxigraph documentation is available on the Oxigraph website.

Build the development version

To build and install the development version of pyoxigraph you need to clone this git repository including submodules (git clone --recursive https://github.com/oxigraph/oxigraph.git) and to run pip install . in the python directory (the one this README is in).

Note that by default the installation will not use cpython stable ABI and will rely on the host TLS implementation. Use --features abi3 feature to use cpython stable ABI and use --no-default-features --features rustls to use rustls with the system certificates.

Help

Feel free to use GitHub discussions or the Gitter chat to ask questions or talk about Oxigraph. Bug reports are also very welcome.

If you need advanced support or are willing to pay to get some extra features, feel free to reach out to Tpt.

How to contribute

Pyoxigraph is written in Rust using PyO3.

Pyoxigraph is built using Maturin. Maturin could be installed using the pip install 'maturin>=0.9,<0.10'. To install a development version of Oxigraph just run maturin develop in this README directory.

Tests

The Python bindings tests are written in Python. To run them use python -m unittest in the tests directory.

Docs

The Sphinx documentation can be generated and viewed in the browser using the following command:

sphinx-autobuild docs docs/_build/html

Note that you will need to have sphinx-autobuild installed.

Alternatively, you can use sphinx-build with Python's http.server to achieve the same thing.

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Oxigraph by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.