README
======

This is GraphPath, a little-language for analysing
graph-structured data, especially RDF. The syntax
of the GraphPath language is reminiscent of Xpath.

The graphpath python package provides a query evaluator
and a goal-driven inference engine for the GraphPath
language, which work together to perform graph analysis.

The package can be teamed up with your favourite
python RDF API (e.g. Redland, rdflib, or your own API).

See index.html for documentation.

RELEASE NOTES
=============

Version 0.6 is the first public release and is provided
under the GPL (see LICENSE).

This version is the product of a period of evolution and
has been successfully used in a project to analyse and
convert some fairly convoluted data sets. It is thought
to be stable although recent changes for packaging
of this release might have introduced a "howler".

Compatibility
-------------

The package has been tested with:

Python 2.2.2, 2.2.3 and 2.3
Redland 0.9.14, 0.9.15
rdflib 1.3.1

Redland
-------

There is a bug in the redland python interface that prevents
setting of the datatype of an RDF value node.   For now, the
GraphPath implementation stores all values as pickled object
strings.  You can change this in redadapt.py.

Sets Module
-----------

GraphPath is implemented in terms of python sets which
were introduced in python 2.3.  Back compatibility to
earlier python versions has been provided via modules
graphpath.util.anysets and graphpath.util.altsets.
The latter is a backport of the 2.3 sets module by
Mike Fletcher.  Some small changes will be needed for the
forthcoming builtin set datatypes.