rdf::query::parser::rdql(3pm) [debian man page]

RDF::Query::Parser::RDQL(3pm)				User Contributed Perl Documentation			     RDF::Query::Parser::RDQL(3pm)

NAME

       RDF::Query::Parser::RDQL - An RDQL parser for RDF::Query

VERSION

       This document describes RDF::Query::Parser::RDQL version 2.908.

METHODS

       "new ( $query_object ) "
	   Returns a new RDF::Query object.

       "parse ( $query ) "
	   Parses the supplied RDQL query string, returning a parse tree.

REVISION HISTORY

	$Log$
	Revision 1.5  2006/01/11 06:03:45  greg
	- Removed use of Data::Dumper::Simple.

	Revision 1.4  2005/05/08 08:26:09  greg
	- Added initial support for SPARQL ASK, DESCRIBE and CONSTRUCT queries.
	  - Added new test files for new query types.
	- Added methods to bridge classes for creating statements and blank nodes.
	- Added as_string method to bridge classes for getting string versions of nodes.
	- Broke out triple fixup code into fixup_triple_bridge_variables().
	- Updated FILTER test to use new Geo::Distance API.

	Revision 1.3  2005/04/26 02:54:40  greg
	- added core support for custom function constraints support
	- added initial SPARQL support for custom function constraints
	- SPARQL variables may now begin with the '$' sigil
	- broke out URL fixups into its own method
	- added direction support for ORDER BY (ascending/descending)
	- added 'next', 'current', and 'end' to Stream API

	Revision 1.2  2005/04/25 00:59:29  greg
	- streams are now objects usinig the Redland QueryResult API
	- RDF namespace is now always available in queries
	- row() now uses a stream when calling execute()
	- check_constraints() now copies args for recursive calls (instead of pass-by-ref)
	- added ORDER BY support to RDQL parser
	- SPARQL constraints now properly use the 'FILTER' keyword
	- SPARQL constraints can now use '&&' as an operator
	- SPARQL namespace declaration is now optional

	Revision 1.1  2005/04/21 02:21:44  greg
	- major changes (resurecting the project)
	- broke out the query parser into it's own RDQL class
	- added initial support for a SPARQL parser
	  - added support for blank nodes
	  - added lots of syntactic sugar (with blank nodes, multiple predicates and objects)
	- moved model-specific code into RDF::Query::Model::*
	- cleaned up the model-bridge code
	- moving over to redland's query API (pass in the model when query is executed)

AUTHOR

	Gregory Williams <gwilliams@cpan.org>

perl v5.14.2							    2012-01-31					     RDF::Query::Parser::RDQL(3pm)

RDF::Query::Util(3pm)					User Contributed Perl Documentation				     RDF::Query::Util(3pm)

NAME

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

VERSION

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

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>

perl v5.14.2							    2012-01-31						     RDF::Query::Util(3pm)