| Name | rdflib JSON |
| Version |
7.0.0
JSON |
| download |
| home_page | https://github.com/RDFLib/rdflib |
| Summary | RDFLib is a Python library for working with RDF, a simple yet powerful language for representing information. |
| upload_time | 2023-08-01 21:14:57 |
| maintainer | RDFLib Team |
| docs_url | None |
| author | Daniel 'eikeon' Krech |
| requires_python | >=3.8.1,<4.0.0 |
| license | BSD-3-Clause |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
RDFLib
======
[](https://github.com/RDFLib/rdflib/actions?query=branch%3Amain)
[](https://rdflib.readthedocs.io/en/latest/?badge=latest)
[](https://coveralls.io/r/RDFLib/rdflib?branch=main)
[](https://github.com/RDFLib/rdflib/stargazers)
[](https://pepy.tech/project/rdflib)
[](https://pypi.python.org/pypi/rdflib)
[](https://pypi.python.org/pypi/rdflib)
[](https://doi.org/10.5281/zenodo.6845245)
[](https://gitpod.io/#https://github.com/RDFLib/rdflib)
[](https://gitter.im/RDFLib/rdflib?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://matrix.to/#/#RDFLib_rdflib:gitter.im)
RDFLib is a pure Python package for working with [RDF](http://www.w3.org/RDF/). RDFLib contains most things you need to work with RDF, including:
* parsers and serializers for RDF/XML, N3, NTriples, N-Quads, Turtle, TriX, Trig and JSON-LD
* a Graph interface which can be backed by any one of a number of Store implementations
* store implementations for in-memory, persistent on disk (Berkeley DB) and remote SPARQL endpoints
* a SPARQL 1.1 implementation - supporting SPARQL 1.1 Queries and Update statements
* SPARQL function extension mechanisms
## RDFlib Family of packages
The RDFlib community maintains many RDF-related Python code repositories with different purposes. For example:
* [rdflib](https://github.com/RDFLib/rdflib) - the RDFLib core
* [sparqlwrapper](https://github.com/RDFLib/sparqlwrapper) - a simple Python wrapper around a SPARQL service to remotely execute your queries
* [pyLODE](https://github.com/RDFLib/pyLODE) - An OWL ontology documentation tool using Python and templating, based on LODE.
* [pyrdfa3](https://github.com/RDFLib/pyrdfa3) - RDFa 1.1 distiller/parser library: can extract RDFa 1.1/1.0 from (X)HTML, SVG, or XML in general.
* [pymicrodata](https://github.com/RDFLib/pymicrodata) - A module to extract RDF from an HTML5 page annotated with microdata.
* [pySHACL](https://github.com/RDFLib/pySHACL) - A pure Python module which allows for the validation of RDF graphs against SHACL graphs.
* [OWL-RL](https://github.com/RDFLib/OWL-RL) - A simple implementation of the OWL2 RL Profile which expands the graph with all possible triples that OWL RL defines.
Please see the list for all packages/repositories here:
* <https://github.com/RDFLib>
Help with maintenance of all of the RDFLib family of packages is always welcome and appreciated.
## Versions & Releases
* `7.1.0a0` current `main` branch.
* `7.x.y` current release, supports Python 3.8.1+ only.
* see [Releases](https://github.com/RDFLib/rdflib/releases)
* `6.x.y` supports Python 3.7+ only. Many improvements over 5.0.0
* see [Releases](https://github.com/RDFLib/rdflib/releases)
* `5.x.y` supports Python 2.7 and 3.4+ and is [mostly backwards compatible with 4.2.2](https://rdflib.readthedocs.io/en/stable/upgrade4to5.html).
See <https://rdflib.dev> for the release overview.
## Documentation
See <https://rdflib.readthedocs.io> for our documentation built from the code. Note that there are `latest`, `stable` `5.0.0` and `4.2.2` documentation versions, matching releases.
## Installation
The stable release of RDFLib may be installed with Python's package management tool *pip*:
$ pip install rdflib
Alternatively manually download the package from the Python Package
Index (PyPI) at https://pypi.python.org/pypi/rdflib
The current version of RDFLib is 7.0.0, see the ``CHANGELOG.md`` file for what's new in this release.
### Installation of the current main branch (for developers)
With *pip* you can also install rdflib from the git repository with one of the following options:
$ pip install git+https://github.com/rdflib/rdflib@main
or
$ pip install -e git+https://github.com/rdflib/rdflib@main#egg=rdflib
or from your locally cloned repository you can install it with one of the following options:
$ poetry install # installs into a poetry-managed venv
or
$ pip install -e .
## Getting Started
RDFLib aims to be a pythonic RDF API. RDFLib's main data object is a `Graph` which is a Python collection
of RDF *Subject, Predicate, Object* Triples:
To create graph and load it with RDF data from DBPedia then print the results:
```python
from rdflib import Graph
g = Graph()
g.parse('http://dbpedia.org/resource/Semantic_Web')
for s, p, o in g:
print(s, p, o)
```
The components of the triples are URIs (resources) or Literals
(values).
URIs are grouped together by *namespace*, common namespaces are included in RDFLib:
```python
from rdflib.namespace import DC, DCTERMS, DOAP, FOAF, SKOS, OWL, RDF, RDFS, VOID, XMLNS, XSD
```
You can use them like this:
```python
from rdflib import Graph, URIRef, Literal
from rdflib.namespace import RDFS, XSD
g = Graph()
semweb = URIRef('http://dbpedia.org/resource/Semantic_Web')
type = g.value(semweb, RDFS.label)
```
Where `RDFS` is the RDFS namespace, `XSD` the XML Schema Datatypes namespace and `g.value` returns an object of the triple-pattern given (or an arbitrary one if multiple exist).
Or like this, adding a triple to a graph `g`:
```python
g.add((
URIRef("http://example.com/person/nick"),
FOAF.givenName,
Literal("Nick", datatype=XSD.string)
))
```
The triple (in n-triples notation) `<http://example.com/person/nick> <http://xmlns.com/foaf/0.1/givenName> "Nick"^^<http://www.w3.org/2001/XMLSchema#string> .`
is created where the property `FOAF.givenName` is the URI `<http://xmlns.com/foaf/0.1/givenName>` and `XSD.string` is the
URI `<http://www.w3.org/2001/XMLSchema#string>`.
You can bind namespaces to prefixes to shorten the URIs for RDF/XML, Turtle, N3, TriG, TriX & JSON-LD serializations:
```python
g.bind("foaf", FOAF)
g.bind("xsd", XSD)
```
This will allow the n-triples triple above to be serialised like this:
```python
print(g.serialize(format="turtle"))
```
With these results:
```turtle
PREFIX foaf: <http://xmlns.com/foaf/0.1/>
PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
<http://example.com/person/nick> foaf:givenName "Nick"^^xsd:string .
```
New Namespaces can also be defined:
```python
dbpedia = Namespace('http://dbpedia.org/ontology/')
abstracts = list(x for x in g.objects(semweb, dbpedia['abstract']) if x.language=='en')
```
See also [./examples](./examples)
## Features
The library contains parsers and serializers for RDF/XML, N3,
NTriples, N-Quads, Turtle, TriX, JSON-LD, RDFa and Microdata.
The library presents a Graph interface which can be backed by
any one of a number of Store implementations.
This core RDFLib package includes store implementations for
in-memory storage and persistent storage on top of the Berkeley DB.
A SPARQL 1.1 implementation is included - supporting SPARQL 1.1 Queries and Update statements.
RDFLib is open source and is maintained on [GitHub](https://github.com/RDFLib/rdflib/). RDFLib releases, current and previous
are listed on [PyPI](https://pypi.python.org/pypi/rdflib/)
Multiple other projects are contained within the RDFlib "family", see <https://github.com/RDFLib/>.
## Running tests
### Running the tests on the host
Run the test suite with `pytest`.
```shell
poetry install
poetry run pytest
```
### Running test coverage on the host with coverage report
Run the test suite and generate a HTML coverage report with `pytest` and `pytest-cov`.
```shell
poetry run pytest --cov
```
### Viewing test coverage
Once tests have produced HTML output of the coverage report, view it by running:
```shell
poetry run pytest --cov --cov-report term --cov-report html
python -m http.server --directory=htmlcov
```
## Contributing
RDFLib survives and grows via user contributions!
Please read our [contributing guide](https://rdflib.readthedocs.io/en/latest/CONTRIBUTING.html) and [developers guide](https://rdflib.readthedocs.io/en/latest/developers.html) to get started.
Please consider lodging Pull Requests here:
* <https://github.com/RDFLib/rdflib/pulls>
To get a development environment consider using Gitpod or Google Cloud Shell.
[](https://gitpod.io/#https://github.com/RDFLib/rdflib)
[](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FRDFLib%2Frdflib&cloudshell_git_branch=main&cloudshell_open_in_editor=README.md)
You can also raise issues here:
* <https://github.com/RDFLib/rdflib/issues>
## Support & Contacts
For general "how do I..." queries, please use https://stackoverflow.com and tag your question with `rdflib`.
Existing questions:
* <https://stackoverflow.com/questions/tagged/rdflib>
If you want to contact the rdflib maintainers, please do so via:
* the rdflib-dev mailing list: <https://groups.google.com/group/rdflib-dev>
* the chat, which is available at [gitter](https://gitter.im/RDFLib/rdflib) or via matrix [#RDFLib_rdflib:gitter.im](https://matrix.to/#/#RDFLib_rdflib:gitter.im)
Raw data
{
"_id": null,
"home_page": "https://github.com/RDFLib/rdflib",
"name": "rdflib",
"maintainer": "RDFLib Team",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0.0",
"maintainer_email": "rdflib-dev@googlegroups.com",
"keywords": "",
"author": "Daniel 'eikeon' Krech",
"author_email": "eikeon@eikeon.com",
"download_url": "https://files.pythonhosted.org/packages/0d/a3/63740490a392921a611cfc05b5b17bffd4259b3c9589c7904a4033b3d291/rdflib-7.0.0.tar.gz",
"platform": null,
"description": " \n\nRDFLib\n======\n[](https://github.com/RDFLib/rdflib/actions?query=branch%3Amain)\n[](https://rdflib.readthedocs.io/en/latest/?badge=latest)\n[](https://coveralls.io/r/RDFLib/rdflib?branch=main)\n\n[](https://github.com/RDFLib/rdflib/stargazers)\n[](https://pepy.tech/project/rdflib)\n[](https://pypi.python.org/pypi/rdflib)\n[](https://pypi.python.org/pypi/rdflib)\n[](https://doi.org/10.5281/zenodo.6845245)\n\n[](https://gitpod.io/#https://github.com/RDFLib/rdflib)\n[](https://gitter.im/RDFLib/rdflib?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)\n[](https://matrix.to/#/#RDFLib_rdflib:gitter.im)\n\nRDFLib is a pure Python package for working with [RDF](http://www.w3.org/RDF/). RDFLib contains most things you need to work with RDF, including:\n\n* parsers and serializers for RDF/XML, N3, NTriples, N-Quads, Turtle, TriX, Trig and JSON-LD\n* a Graph interface which can be backed by any one of a number of Store implementations\n* store implementations for in-memory, persistent on disk (Berkeley DB) and remote SPARQL endpoints\n* a SPARQL 1.1 implementation - supporting SPARQL 1.1 Queries and Update statements\n* SPARQL function extension mechanisms\n\n## RDFlib Family of packages\nThe RDFlib community maintains many RDF-related Python code repositories with different purposes. For example:\n\n* [rdflib](https://github.com/RDFLib/rdflib) - the RDFLib core\n* [sparqlwrapper](https://github.com/RDFLib/sparqlwrapper) - a simple Python wrapper around a SPARQL service to remotely execute your queries\n* [pyLODE](https://github.com/RDFLib/pyLODE) - An OWL ontology documentation tool using Python and templating, based on LODE.\n* [pyrdfa3](https://github.com/RDFLib/pyrdfa3) - RDFa 1.1 distiller/parser library: can extract RDFa 1.1/1.0 from (X)HTML, SVG, or XML in general.\n* [pymicrodata](https://github.com/RDFLib/pymicrodata) - A module to extract RDF from an HTML5 page annotated with microdata. \n* [pySHACL](https://github.com/RDFLib/pySHACL) - A pure Python module which allows for the validation of RDF graphs against SHACL graphs.\n* [OWL-RL](https://github.com/RDFLib/OWL-RL) - A simple implementation of the OWL2 RL Profile which expands the graph with all possible triples that OWL RL defines.\n\nPlease see the list for all packages/repositories here:\n\n* <https://github.com/RDFLib>\n\nHelp with maintenance of all of the RDFLib family of packages is always welcome and appreciated.\n\n## Versions & Releases\n\n* `7.1.0a0` current `main` branch.\n* `7.x.y` current release, supports Python 3.8.1+ only.\n * see [Releases](https://github.com/RDFLib/rdflib/releases)\n* `6.x.y` supports Python 3.7+ only. Many improvements over 5.0.0\n * see [Releases](https://github.com/RDFLib/rdflib/releases)\n* `5.x.y` supports Python 2.7 and 3.4+ and is [mostly backwards compatible with 4.2.2](https://rdflib.readthedocs.io/en/stable/upgrade4to5.html).\n\nSee <https://rdflib.dev> for the release overview.\n\n## Documentation\nSee <https://rdflib.readthedocs.io> for our documentation built from the code. Note that there are `latest`, `stable` `5.0.0` and `4.2.2` documentation versions, matching releases.\n\n## Installation\nThe stable release of RDFLib may be installed with Python's package management tool *pip*:\n\n $ pip install rdflib\n\nAlternatively manually download the package from the Python Package\nIndex (PyPI) at https://pypi.python.org/pypi/rdflib\n\nThe current version of RDFLib is 7.0.0, see the ``CHANGELOG.md`` file for what's new in this release.\n\n### Installation of the current main branch (for developers)\n\nWith *pip* you can also install rdflib from the git repository with one of the following options:\n\n $ pip install git+https://github.com/rdflib/rdflib@main\n\nor\n\n $ pip install -e git+https://github.com/rdflib/rdflib@main#egg=rdflib\n\nor from your locally cloned repository you can install it with one of the following options:\n\n $ poetry install # installs into a poetry-managed venv\n\nor\n\n $ pip install -e .\n\n## Getting Started\nRDFLib aims to be a pythonic RDF API. RDFLib's main data object is a `Graph` which is a Python collection\nof RDF *Subject, Predicate, Object* Triples:\n\nTo create graph and load it with RDF data from DBPedia then print the results:\n\n```python\nfrom rdflib import Graph\ng = Graph()\ng.parse('http://dbpedia.org/resource/Semantic_Web')\n\nfor s, p, o in g:\n print(s, p, o)\n```\nThe components of the triples are URIs (resources) or Literals\n(values).\n\nURIs are grouped together by *namespace*, common namespaces are included in RDFLib:\n\n```python\nfrom rdflib.namespace import DC, DCTERMS, DOAP, FOAF, SKOS, OWL, RDF, RDFS, VOID, XMLNS, XSD\n```\n\nYou can use them like this:\n\n```python\nfrom rdflib import Graph, URIRef, Literal\nfrom rdflib.namespace import RDFS, XSD\n\ng = Graph()\nsemweb = URIRef('http://dbpedia.org/resource/Semantic_Web')\ntype = g.value(semweb, RDFS.label)\n```\nWhere `RDFS` is the RDFS namespace, `XSD` the XML Schema Datatypes namespace and `g.value` returns an object of the triple-pattern given (or an arbitrary one if multiple exist).\n\nOr like this, adding a triple to a graph `g`:\n\n```python\ng.add((\n URIRef(\"http://example.com/person/nick\"),\n FOAF.givenName,\n Literal(\"Nick\", datatype=XSD.string)\n))\n```\nThe triple (in n-triples notation) `<http://example.com/person/nick> <http://xmlns.com/foaf/0.1/givenName> \"Nick\"^^<http://www.w3.org/2001/XMLSchema#string> .`\nis created where the property `FOAF.givenName` is the URI `<http://xmlns.com/foaf/0.1/givenName>` and `XSD.string` is the\nURI `<http://www.w3.org/2001/XMLSchema#string>`.\n\nYou can bind namespaces to prefixes to shorten the URIs for RDF/XML, Turtle, N3, TriG, TriX & JSON-LD serializations:\n\n ```python\ng.bind(\"foaf\", FOAF)\ng.bind(\"xsd\", XSD)\n```\nThis will allow the n-triples triple above to be serialised like this:\n ```python\nprint(g.serialize(format=\"turtle\"))\n```\n\nWith these results:\n```turtle\nPREFIX foaf: <http://xmlns.com/foaf/0.1/>\nPREFIX xsd: <http://www.w3.org/2001/XMLSchema#>\n\n<http://example.com/person/nick> foaf:givenName \"Nick\"^^xsd:string .\n```\n\nNew Namespaces can also be defined:\n\n```python\ndbpedia = Namespace('http://dbpedia.org/ontology/')\n\nabstracts = list(x for x in g.objects(semweb, dbpedia['abstract']) if x.language=='en')\n```\n\nSee also [./examples](./examples)\n\n\n## Features\nThe library contains parsers and serializers for RDF/XML, N3,\nNTriples, N-Quads, Turtle, TriX, JSON-LD, RDFa and Microdata.\n\nThe library presents a Graph interface which can be backed by\nany one of a number of Store implementations.\n\nThis core RDFLib package includes store implementations for\nin-memory storage and persistent storage on top of the Berkeley DB.\n\nA SPARQL 1.1 implementation is included - supporting SPARQL 1.1 Queries and Update statements.\n\nRDFLib is open source and is maintained on [GitHub](https://github.com/RDFLib/rdflib/). RDFLib releases, current and previous\nare listed on [PyPI](https://pypi.python.org/pypi/rdflib/)\n\nMultiple other projects are contained within the RDFlib \"family\", see <https://github.com/RDFLib/>.\n\n## Running tests\n\n### Running the tests on the host\n\nRun the test suite with `pytest`.\n```shell\npoetry install\npoetry run pytest\n```\n\n### Running test coverage on the host with coverage report\n\nRun the test suite and generate a HTML coverage report with `pytest` and `pytest-cov`.\n```shell\npoetry run pytest --cov\n```\n\n### Viewing test coverage\n\nOnce tests have produced HTML output of the coverage report, view it by running:\n```shell\npoetry run pytest --cov --cov-report term --cov-report html\npython -m http.server --directory=htmlcov\n```\n\n## Contributing\n\nRDFLib survives and grows via user contributions!\nPlease read our [contributing guide](https://rdflib.readthedocs.io/en/latest/CONTRIBUTING.html) and [developers guide](https://rdflib.readthedocs.io/en/latest/developers.html) to get started.\nPlease consider lodging Pull Requests here:\n\n* <https://github.com/RDFLib/rdflib/pulls>\n\nTo get a development environment consider using Gitpod or Google Cloud Shell.\n\n[](https://gitpod.io/#https://github.com/RDFLib/rdflib)\n[](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FRDFLib%2Frdflib&cloudshell_git_branch=main&cloudshell_open_in_editor=README.md)\n\nYou can also raise issues here:\n\n* <https://github.com/RDFLib/rdflib/issues>\n\n## Support & Contacts\nFor general \"how do I...\" queries, please use https://stackoverflow.com and tag your question with `rdflib`.\nExisting questions:\n\n* <https://stackoverflow.com/questions/tagged/rdflib>\n\nIf you want to contact the rdflib maintainers, please do so via:\n\n* the rdflib-dev mailing list: <https://groups.google.com/group/rdflib-dev>\n* the chat, which is available at [gitter](https://gitter.im/RDFLib/rdflib) or via matrix [#RDFLib_rdflib:gitter.im](https://matrix.to/#/#RDFLib_rdflib:gitter.im)\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "RDFLib is a Python library for working with RDF, a simple yet powerful language for representing information.",
"version": "7.0.0",
"project_urls": {
"Documentation": "https://rdflib.readthedocs.org/",
"Homepage": "https://github.com/RDFLib/rdflib",
"Repository": "https://github.com/RDFLib/rdflib"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d4b07b7d8b5b0d01f1a0b12cc2e5038a868ef3a15825731b8a0d776cf47566c0",
"md5": "3b4231f789af0dd42a351f639d4d27eb",
"sha256": "0438920912a642c866a513de6fe8a0001bd86ef975057d6962c79ce4771687cd"
},
"downloads": -1,
"filename": "rdflib-7.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3b4231f789af0dd42a351f639d4d27eb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0.0",
"size": 531912,
"upload_time": "2023-08-01T21:14:52",
"upload_time_iso_8601": "2023-08-01T21:14:52.851597Z",
"url": "https://files.pythonhosted.org/packages/d4/b0/7b7d8b5b0d01f1a0b12cc2e5038a868ef3a15825731b8a0d776cf47566c0/rdflib-7.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0da363740490a392921a611cfc05b5b17bffd4259b3c9589c7904a4033b3d291",
"md5": "f57f1c5a17b9ab10c08555612c0d998c",
"sha256": "9995eb8569428059b8c1affd26b25eac510d64f5043d9ce8c84e0d0036e995ae"
},
"downloads": -1,
"filename": "rdflib-7.0.0.tar.gz",
"has_sig": false,
"md5_digest": "f57f1c5a17b9ab10c08555612c0d998c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0.0",
"size": 4765796,
"upload_time": "2023-08-01T21:14:57",
"upload_time_iso_8601": "2023-08-01T21:14:57.338312Z",
"url": "https://files.pythonhosted.org/packages/0d/a3/63740490a392921a611cfc05b5b17bffd4259b3c9589c7904a4033b3d291/rdflib-7.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-01 21:14:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RDFLib",
"github_project": "rdflib",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "rdflib"
}
