ARQ <http://jena.hpl.hp.com/ARQ>
================================

A query processor for Jena that implements SPARQL

    andy.seaborne@hp.com

ARQ is a complete implementation of SPARQL that can query any Jena model
or graph, including ones stored in databases.

Download
--------

Releases : SourceForge, Project Jena : Package ARQ
http://sourceforge.net/project/showfiles.php?group_id=40417&package_id=143808

Also available via anonymous SVN:
https://jena.svn.sourceforge.net/svnroot/jena/ARQ/

Online demos and services
-------------------------

http://www.sparql.org/

including a SPARQL validator
http://www.sparql.org/validator.html

Documentation
-------------

Included in the download in doc/index.html

Installation
------------

Unpack zip : it unpacks into a directory, including the version number.
Set environment variable ARQROOT to the path of this direrctory.

ARQ includes all the libraries necessary in lib/
ARQ includes a copy of Jena, the one it is tested against.

Put each and every the jar file in lib/ on your classpath.


Running from the command line
-----------------------------

Some bash and bat scripts are provided to try out SPARQL queries:

First, set environment variable ARQROOT to the root of the unzipped distibution.

    export ARQROOT=$PWD

Second, ensure all scripts are executable

    chmod u+x $ARQROOT/bin/*

Command line applications:
sparql   -- Run a SPARQL query.  A wrapper around 'query'.
arq      -- Run an ARQ query.  A wrapper around 'query'.
query    -- Run a query. 
qparse   -- Parse a query
qtest    -- Run tests
rset     -- Read and write result sets (RDF, XML, JSON, text (out only))

For the 'query' command, files ending .rq are assumed to be SPARQL queries
and files ending .arq are ARQ queries, unless the syntax is given
explicitly.  Unknown files are assumed to be SPARQL queries.

sparql --data <some data file> --query query 
sparql --data <some data file> 'Query string'

Default output is a text table for SELECT queries, an RDF model for
DESCRIBE and CONSTRUCT.

Run the script with no argument to get a usage message.

See doc/cmds.html for details.  Check the suitablity of scripts before running them.

Running commands as Java
------------------------

Put all the jars files in lib/ on your classpath.  All of them, including
the version of jena.jar included.

The arq command line application is:
java -cp ... arq.query "$@"

Running the test suite:
java -cp ... arq.qtest --all

ARQ.Net
-------

ARQ has been run under IKVM (http://www.ikvm.net/), using IKVM to
translate the bytecodes to IL and using IKVM as a JVM.

Changes
-------

See ChangeLog.txt

Support and Questions
---------------------

Comments and questions about ARQ to the Jena mailing list 
    jena-dev@groups.yahoo.com

General questions and comments on SPARQL to jena-dev or
    public-sparql-dev@w3.org
    
Formal comments specific to the SPARQL query language,
protocol or result set docuemnts to:
	public-rdf-dawg-comments@w3.org
