roqet - Rasqal RDF query utility

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

                                                   2013-12-11                                           roqet(1)

SPARQL1.1QueryLanguage, Steve Harris and Andy  Seaborne  (eds),  W3C  Recommendation,  21  March  2013
       http://www.w3.org/TR/2013/REC-sparql11-query-20130321/SPARQLQueryResultsXMLFormat(SecondEdition), Sandro Hawke (Second Edition ed), Jeen Broekstra and
       Dave  Beckett  (eds),  W3C  Recommendation,  21  March  2013.   http://www.w3.org/TR/2013/REC-rdf-sparql-
       XMLres-20130321/

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

roqetsparql-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-isparqlhttp://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-qquery-file.rqhttp://example.org/base/

       Run  an  query  (default  languge  SPARQL)  from  a  local  file  query-file.rq  but   using   base   URI
       http://example.org/base/ to resolve any relative URIs.

              roqet-q-isparql-rxmlhttp://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 format with no extra messages.

              roqet-isparql-e'SELECT*WHERE{?s?p?o}'-Dstuff.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.

              roqet-tresult.srx-rhtml

       Read a SPARQL query results in SPARQL Query Results XML format (default) and print it in HTML.

              roqet-tresult.ttl-Rturtle-rcsv

       Read a SPARQL query results in RDF/Turtle format and print it in CSV.

       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,--execQUERY
              Execute  the query string in the argument QUERY instead of reading the query from a URI (when -e /
              --exec is not given).

       -i,--inputLANGUAGE
              Set the input query LANGUAGE to one of the supported languages  which  includes  'sparql'  (SPARQL
              Query  Language  for  RDF, default), 'sparql11' and 'laqrs'.  The full list of supported languages
              and subsets is given in the help summary with the -h / --help option.

       -p,--protocolSERVICE-URI
              Call the SPARQL HTTP protocol SERVICE-URI to execute the query instead of executing it inside  the
              Rasqal query engine locally ( when -e is given, or a query string given)

       -r,--resultsFORMAT
              Set the query results output 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,  'csv'  for
              SPARQL  CSV,  'tsv' for SPARQL TSV, 'rdfxml' and 'turtle' for RDF syntax formats, 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 libraptor2(3) was built with but is given correct in the
              usage message with -h.

       -R,--results-input-formatFORMAT
              Set the query results input FORMAT

              This is for use with -t and takes values of 'xml' for the SPARQL Query Results XML format,,  'csv'
              for SPARQL CSV,, 'tsv' for SPARQL TSV, 'turtle' and 'rdfxml' for RDF syntax formats.

       -t,--results-inputFILE
              Read query results from FILE

       roqet - Rasqal RDF query utility

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

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

       -D,--dataURI
              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 FROM uri statements.

       -E,--ignore-errors
              Do not print error messages and do not exit with a non-0 status.

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

       -F,--formatNAME
              Set  the  data  source  format  name  for  subsequent  data graphs called with -D / --data or -G /
              --named.  The default if this is not specified is for the query engine to guess.  The  name  is  a
              Raptor parser name.

       -G,--namedURI
              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,--sourceURI
              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,--warningsLEVEL
              Set the warning LEVEL in the range 0 (do not warn about anything) to 100 (show every warning). The
              Rasqal default is in the middle (50).

librasqal(3),libraptor(3)

roqet [OPTIONS] <query-URI>[base-URI]roqet [OPTIONS]-equery-string[base-URI]roqet [OPTIONS]-psparql-protocol-service-URIquery-URI[base-URI]roqet [OPTIONS]-psparql-protocol-service-URI [-equery-string ] [base-URI]roqet [OPTIONS]-tqueryresultsfile[base-URI]