NAME

RDF::Query::Util - Miscellaneous utility functions to support work with RDF::Query.

VERSION

This document describes RDF::Query::Util version 2.918.

SYNOPSIS

 use RDF::Query::Util;
 my $query = &RDF::Query::Util::cli_make_query;
 my $model = &RDF::Query::Util::cli_make_model;
 $query->execute( $model );
 ...

FUNCTIONS

"cli_make_query_and_model": Returns a query object, model, and args HASHref based on the arguments in @ARGV. These arguments are parsed using "cli_make_query" and "make_model".
"cli_make_query": Returns a RDF::Query object based on the arguments in @ARGV. These arguments are parsed using &cli_parse_args. If the -e flag is not present, the query will be loaded from a file named by the argument in @ARGV immediately following the final argument parsed by &cli_parse_args.
"cli_make_model": Calls "make_model" with arguments from @ARGV, returning the constructed model object.
"cli_make_model" will usually be called after cli_make_query, allowing a typical CLI invocation to look like `prog.pl [flags] [query file] [data files]`.
"make_model ( @files )": Returns a model object suitable for use in a call to "$query->execute", loaded with RDF from files and/or URLs listed in @files. This model may be any of the supported models, but as currently implemented will be a RDF::Trine::Model object.
"cli_parse_args": Parses CLI arguments from @ARGV and returns a HASH with the recognized key/values. The allowable arguments are listed below.
"start_endpoint ( $model, $port )": Starts an SPARQL endpoint HTTP server on port $port.
If called in list context, returns the PID and the actual port the server bound to. If called in scalar context, returns only the port.

COMMAND LINE ARGUMENTS

-e str: Specifies the query string str.
-l lang: Specifies the query language lang used. This should be one of: sparql, sparql11, or rdql.
-O: Turns on optimization.
-o: Turns off optimization.
-c class: Specifies the perl class used to construct the query object. Defaults to "RDF::Query".
-f: Implies -c RDF::Query::Federate.
-F loc: Specifies the URL or path to a file loc which contains an RDF service description. The described service is used as an underlying triplestore for query answering. Implies -f.
-E url: Specifies the URL of a remove SPARQL endpoint to be used as a data source. The endpoint is used as an underlying triplestore for query answering. Implies -f.
-s database-type: Specifies the database type to use for the underlying data model.
-u user
-p password
-m model

AUTHOR

 Gregory Todd Williams <gwilliams@cpan.org>