Module Expr Str ImportFrom alias Assign NameStore Call NameLoad Str Assign NameStore Str Assign NameStore NameLoad Assign NameStore Str ImportFrom alias ClassDef bases NameLoad body Expr Str FunctionDef arguments args NameParam NameParam defaults body Expr Call AttributeLoad NameLoad attr NameLoad BinOpMod Str NameLoad decorator_list decorator_list
N/A N/A 
TODO: merge this first bit from sparql.sparql.py into rest of doc... 
updating all along the way.

SPARQL implementation on top of RDFLib

Implementation of the `W3C SPARQL <http://www.w3.org/TR/rdf-sparql-query/>`_ 
language (version April 2005). The basic class here is supposed to be a 
superclass of rdfextras.sparql.graph; it has been separated only for 
a better maintainability.

There is a separate
`description <http://dev.w3.org/cvsweb/%7Echeckout%7E/2004/PythonLib-IH/Doc/sparqlDesc.html>`_
for the functionalities.


For a general description of the SPARQL API, see the separate, more complete
`description <http://dev.w3.org/cvsweb/%7Echeckout%7E/2004/PythonLib-IH/Doc/sparqlDesc.html>`_.

Variables, Imports
==================

The top level (__init__.py) module of the Package imports the
important classes. In other words, the user may choose to use the
following imports only::

    from rdflibUtils   import myTripleStore
    from rdflibUtils   import retrieveRDFFiles
    from rdflibUtils   import SPARQLError
    from rdflibUtils   import GraphPattern

The module imports and/or creates some frequently used Namespaces, and
these can then be imported by the user like::

    from rdflibUtils import ns_rdf

Finally, the package also has a set of convenience string defines for
XML Schema datatypes (ie, the URI-s of the datatypes); ie, one can
use::

    from rdflibUtils import type_string
    from rdflibUtils import type_integer
    from rdflibUtils import type_long
    from rdflibUtils import type_double
    from rdflibUtils import type_float
    from rdflibUtils import type_decimal
    from rdflibUtils import type_dateTime
    from rdflibUtils import type_date
    from rdflibUtils import type_time
    from rdflibUtils import type_duration

These are used, for example, in the sparql-p implementation.

The three most important classes in RDFLib for the average user are
Namespace, URIRef and Literal; these are also imported, so the user
can also use, eg::

    from rdflib import Namespace, URIRef, Literal

History
=======

 - Version 1.0: based on an earlier version of the SPARQL, first released implementation

 - Version 2.0: version based on the March 2005 SPARQL document, 
   also a major change of the core code (introduction of the separate 
   ``GraphPattern`` :class:`rdflibUtils.graph.GraphPattern` class, etc).

 - Version 2.01: minor changes only: - switch to epydoc as a documentation tool, 
   it gives a much better overview of the classes - addition of the 
   SELECT * feature to sparql-p

 - Version 2.02: - added some methods to
   ``myTripleStore`` :class:`rdflibUtils.myTripleStore.myTripleStore` to handle
   ``Alt`` and ``Bag`` the same way as ``Seq`` - added also methods to
   :meth:`add` collections and containers to the triple store, not only
   retrieve them

 - Version 2.1: adapted to the inclusion of the code into rdflib, thanks to Michel Pelletier

 - Version 2.2: added the sorting possibilities; introduced the Unbound class and have a better
   interface to patterns using this (in the BasicGraphPattern class)

@author: `Ivan Herman <http://www.ivan-herman.net>`_

@license: This software is available for use under the
`W3C Software License <http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231>`_

@contact: Ivan Herman, ivan@ivan-herman.net

@version: 2.2

 rdflib URIRef N/A DESCRIBE N/A URIRef http://www.w3.org/TR/rdf-sparql-query/#describe N/A __version__ 2.2 N/A Debug False N/A _questChar ? rdflib.exceptions Error SPARQLError N/A Error N/A N/A Am SPARQL error has been detected __init__ N/A N/A self msg N/A N/A N/A N/A N/A Error __init__ self N/A SPARQL Error: %s. msg N/A N/A