rdb2rdf 0.1.2

PyRDB2RDF

#########
PyRDB2RDF
#########

PyRDB2RDF provides RDFLib_ with an interface to relational databases as
RDF_ stores_. The underlying data is accessed via SQLAlchemy_. It is
mapped to RDF according to the specifications of RDB2RDF_. The
corresponding RDF graph is represented as an RDFLib Graph_.

Translating from relational data to RDF via `direct mapping`_ is
currently supported. Translating in the other direction and mapping
with R2RML_ are planned but not yet implemented.


.. _direct mapping: http://www.w3.org/TR/rdb-direct-mapping/

.. _R2RML: http://www.w3.org/TR/r2rml/

.. _RDB2RDF: http://www.w3.org/2001/sw/rdb2rdf/

.. _RDF: http://www.w3.org/TR/rdf11-concepts/

.. _RDFLib: http://rdflib.readthedocs.org/

.. _SQLAlchemy: http://www.sqlalchemy.org/

.. _stores: http://rdflib.readthedocs.org/en/latest/univrdfstore.html


************
Installation
************

.. code-block:: bash

pip install rdb2rdf


********
Examples
********

Serializing a database as N-Triples
===================================

Suppose the local PostgreSQL_ database ``test_dm`` contains data that
we want to translate to RDF and serialize as N-Triples_. The following
code achieves that.


.. _N-Triples: http://www.w3.org/TR/n-triples/

.. _PostgreSQL: http://www.postgresql.org/

.. code-block:: python

import rdflib as _rdf
import sqlalchemy as _sqla

db_str = 'postgresql://testuser:testpasswd@localhost/testdb'
db = _sqla.create_engine(db_str)
graph = _rdf.Graph('rdb2rdf_dm')
graph.open(db)

print(graph.serialize(format='nt'))


*********
Changelog
*********

0.1.2
=====

* Updated references to Spruce projects (lang, iri, types) and Goose
Types.

* Improved the setup script.

* Improved documentation.

0.1.1
=====

* Added a missing installation dependency.

0.1.0
=====

First public release.