roqet(1)						      General Commands Manual							  roqet(1)

NAME

       roqet - Rasqal RDF query utility

SYNOPSIS

       roqet [OPTIONS] <query-URI> [base-URI]
       roqet [OPTIONS]-e query-string [base-URI]

DESCRIPTION

       The  roqet  utility allows querying of RDF content using the Rasqal RDF query library, printing the results in variable bindings, RDF graph
       or boolean format.  The query is read from query-URI and the optional base-URI is used as the base URI of the query if present.

MAIN OPTIONS

       roqet uses the usual GNU command line syntax, with long options starting with two dashes (`-') if supported by  the  getopt_long  function.
       Otherwise only the short options are available.

       -e, --exec QUERY
	      Execute the query in the argument QUERY instead of reading the query from a URI (when -e is not given).

       -i, --input LANGUAGE
	      Set  the	input query LANGUAGE to one of'sparql' (SPARQL Query Language for RDF, default) or 'rdql' (RDF Data Query Language).   The
	      list of supported languages is given in the help summary given by -h.

       -r, --results FORMAT
	      Set the query results format.

	      For variable bindings, the values of FORMAT vary upon what Rasqal supports but include 'simple' for a simple text format	(default),
	      'xml' for the SPARQL Query Results XML format and 'json' for a JSON version of the results.

	      For  RDF	graph  results,  the values of FORMAT are 'ntriples' (N-Triples, default), 'rdfxml-abbrev' (RDF/XML Abbreviated), 'rdfxml'
	      (RDF/XML), 'turtle' (Turtle), 'json' (RDF/JSON resource centric), 'json-triples' (RDF/JSON triples) or 'rss-1.0' (RSS 1.0,  also	an
	      RDF/XML syntax).

	      The exact list of formats depends on what libraptor(3) was built with but is given correct in the usage message with -h.

OTHER OPTIONS

       -c, --count
	      Only count the triples and produce no other output.

       -D, --data URI
	      Add  RDF	data  source  URI  (not a named graph).  If no data sources are given, the query itself must point to the data such as via
	      SPARQL or RDQL FROM uri statements.

       -d, --dump-query FORMAT
	      Print the parsed query out in a given FORMAT one of 'debug', 'structure' or 'sparql'

       -f, --feature NAME(=VALUE)
	      Set query feature NAME to the VALUE or integer 1 if omitted.  The known features can be shown with -f help or --feature help.

       -G, --named URI
	      Add RDF data source URI (named graph)

       -h, --help
	      Show a summary of the options.

       -n, --dryrun
	      Prepare the query but do not execute it.

       -q, --quiet
	      No extra information messages.

       -s, --source URI
	      Add RDF data source URI (named graph) URI by adding it to the list of query data source URIs.  FORMAT to 'simple' (default) or 'xml'
	      (an experimental XML format)

       -v, --version
	      Print the rasqal library version and exit.

       -w, --walk-query
	      Walk the query and display it using the API.

EXAMPLES

	      roqet sparql-query-file.rq

       Run  a  SPARQL  query  contained  in the local file sparql-query-file.rq.  The data used would be described in FROM statements in the query
       file.

	      roqet -q -i sparql http://example.org/sparql-query.rq

       Run a SPARQL query that is in the web at URI http://example.org/sparql-query.rq without an extra messages (quiet, -q).

	      roqet -q -i rdql rdql-query-file.rdql http://example.org/base/

       Run an RDQL query from a local file rdql-query-file.rdql but using base URI http://example.org/base/ to resolve any relative URIs.

	      roqet -q -i sparql -r xml http://example.org/sparql-query.rq

       Run a SPARQL query that is in the web at URI http://example.org/sparql-query.rq and format the results in the SPARQL Query Results XML for-
       mat with no extra messages.

	      roqet -i sparql -e 'SELECT * WHERE { ?s ?p ?o }' -D stuff.rdf

       Run  a  SPARQL  query  given on the command line against data in the file stuff.rdf.  The type of the file will be guessed and likely is of
       format RDF/XML.

CONFORMING TO

       SPARQL  Query  Language	 for   RDF,   Eric   Prud'hommeaux   and   Andy   Seaborne   (eds),   W3C   Recommendation,   15   January   2008.
       http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/ <http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/>

       SPARQL	 Query	 Results   XML	 Format,   Jeen   Broekstra   and   Dave   Beckett   (eds),   W3C   Recommendation,   15   January   2008.
       http://www.w3.org/TR/2008/REC-rdf-sparql-XMLres-20080115/ <http://www.w3.org/TR/2008/REC-rdf-sparql-XMLres-20080115/>

       RDQL - A Query Language for RDF, Andy Seaborne, W3C Member Submission 9 January 2004  http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/
       <http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/>

SEE ALSO

       librasqal(3),rasqal-config(1),libraptor(3)

CHANGES

AUTHOR

       Dave Beckett - http://www.dajobe.org/ <http://www.dajobe.org/>

								    2009-12-15								  roqet(1)