1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
.. rdflib documentation documentation main file
================
rdflib |release|
================
RDFLib is a pure Python package for working with `RDF <http://www.w3.org/RDF/>`_. It contains:
* **Parsers & Serializers**
* for RDF/XML, N3, NTriples, N-Quads, Turtle, TriX, JSON-LD, HexTuples, RDFa and Microdata
* **Store implementations**
* memory stores
* persistent, on-disk stores, using databases such as BerkeleyDB
* remote SPARQL endpoints
* **Graph interface**
* to a single graph
* or to multiple Named Graphs within a dataset
* **SPARQL 1.1 implementation**
* both Queries and Updates are supported
.. caution::
RDFLib is designed to access arbitrary network and file resources, in some
cases these are directly requested resources, in other cases they are
indirectly referenced resources.
If you are using RDFLib to process untrusted documents or queries you should
take measures to restrict file and network access.
For information on available security measures, see the RDFLib
:doc:`Security Considerations </security_considerations>`
documentation.
Getting started
---------------
If you have never used RDFLib, the following will help get you started:
.. toctree::
:maxdepth: 1
gettingstarted
intro_to_parsing
intro_to_creating_rdf
intro_to_graphs
intro_to_sparql
utilities
Examples <apidocs/examples>
In depth
--------
If you are familiar with RDF and are looking for details on how RDFLib handles it, these are for you:
.. toctree::
:maxdepth: 1
rdf_terms
namespaces_and_bindings
persistence
merging
changelog
upgrade6to7
upgrade5to6
upgrade4to5
security_considerations
Reference
---------
The nitty-gritty details of everything.
API reference:
.. toctree::
:maxdepth: 1
apidocs/modules
.. toctree::
:maxdepth: 2
plugins
.. * :ref:`genindex`
.. * :ref:`modindex`
Versioning
----------
RDFLib follows `Semantic Versioning 2.0.0 <https://semver.org/spec/v2.0.0.html>`_, which can be summarized as follows:
Given a version number ``MAJOR.MINOR.PATCH``, increment the:
#. ``MAJOR`` version when you make incompatible API changes
#. ``MINOR`` version when you add functionality in a backwards-compatible
manner
#. ``PATCH`` version when you make backwards-compatible bug fixes
For developers
--------------
.. toctree::
:maxdepth: 1
developers
CODE_OF_CONDUCT
docs
persisting_n3_terms
type_hints
CONTRIBUTING
decisions/index
Source Code
-----------
The rdflib source code is hosted on GitHub at `<https://github.com/RDFLib/rdflib>`__ where you can lodge Issues and
create Pull Requests to help improve this community project!
The RDFlib organisation on GitHub at `<https://github.com/RDFLib>`__ maintains this package and a number of other RDF
and RDFlib-related packaged that you might also find useful.
.. _further_help_and_contact:
Further help & Contact
----------------------
If you would like help with using RDFlib, rather than developing it, please post
a question on StackOverflow using the tag ``[rdflib]``. A list of existing
``[rdflib]`` tagged questions can be found
`here <https://stackoverflow.com/questions/tagged/rdflib>`_.
You might also like to join RDFlib's `dev mailing list
<https://groups.google.com/group/rdflib-dev>`_ or use RDFLib's `GitHub
discussions section <https://github.com/RDFLib/rdflib/discussions>`_.
The chat is available at `gitter <https://gitter.im/RDFLib/rdflib>`_ or via
matrix `#RDFLib_rdflib:gitter.im
<https://matrix.to/#/#RDFLib_rdflib:gitter.im>`_.
|
