NAME¶
RDF::Query::Util - Miscellaneous utility functions to support work with
RDF::Query.
VERSION¶
This document describes RDF::Query::Util version 2.912.
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>