rapper

Section: User Commands (1)
Updated: 2010-04-28
Page Index

NAME

rapper - Raptor RDF parsing and serializing utility

SYNOPSIS

rapper [OPTIONS] INPUT-URI [INPUT-BASE-URI]

EXAMPLE

rapper -o ntriples http://planetrdf.com/guide/rss.rdf


rapper -i rss-tag-soup -o rss-1.0 pile-of-rss.xml http://example.org/base/


rapper --count http://example.org/index.rdf

DESCRIPTION

The rapper utility allows parsing of RDF content by the Raptor RDF parser toolkit emitting the results as RDF triples in a choice of syntaxes. The INPUT-URI can be a file name, '-' for standard input or if Raptor is built with a WWW retrieval library, a general URI. The optional INPUT-BASE-URI is used as the document parser base URI if present otherwise defaults to the INPUT-URI. A value of '-' means no base URI.

OPTIONS

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

-h, --help: Show a summary of the options.
-i, --input FORMAT: Set the input FORMAT to one of 'rdfxml' (RDF/XML, default), 'ntriples' (N-Triples, see below), 'turtle' (Turtle, see below) or 'rss-tag-soup' (RSS Tag Soup). The RSS Tag Soup parser can turn the many XML RSS formats and Atom 0.3 into RDF triples.
: The list of parsers depends on how libraptor(3) was built. The list of supported parsers is given in the help summary given by -h.
-I, --input-uri URI: Set the input/parser base URI or use value '-' for no base. The default is the INPUT-URI argument value.
-o, --output FORMAT: Set the output FORMAT to 'ntriples' (N-Triples, default), 'rdfxml' (RDF/XML), 'rdfxml-abbrev' (RDF/XML with abbreviations) or 'rss-1.0' (RSS 1.0, also an RDF/XML syntax).
: The list of serializers depends on how libraptor(3) was built. The list of supported serializers is given in the help summary given by -h.
-O, --output-uri URI: Set the output/serializer base URI or use value '-' for no base. The default is the input base uri, either set by the argument INPUT-BASE-URI or via options -I, --input-uri URI
-c, --count: Only count the triples and produce no other output.
-e, --ignore-errors: Ignore errors, do not emit the messages and try to continue parsing.
-f, --feature FEATURE[=VALUE]: Set a parser or serializer feature FEATURE to a value, or to 1 if VALUE is omitted, Use -f help to get lists of valid parser and serializer features.
: If the form -f 'xmlns:prefix="uri"' is used, the prefix and namespace uri given will be set for serializing. The syntax matches XML in that either or both of prefix or uri can be omitted.
-g, --guess: Guess the parser to use from the source-URI rather than use the -i FORMAT.
-q, --quiet: No extra information messages.
-r, --replace-newlines: Replace newlines in multi-line literals with spaces.
--show-graphs: Print graph names (URIs) as they are seen in the input. This only has a meaning for parsers that support graph names such as the TRiG parser.
--show-namespaces: Print namespaces as they are seen in the input.
-t, --trace: Print URIs retrieved during parsing. Especially useful for monitoring what the guess and GRDDL parsers are doing.
-w, --ignore-warnings: Ignore warnings, do not emit the messages.
-v, --version: Print the raptor version and exit.

EXAMPLES

rapper -q -i ntriples -o rdfxml -f 'xmlns:rss=http://purl.org/rss/1.0/' -f 'xmlns:ex=http://example.org/' tests/test.nt
rapper -q -o rdfxml -f 'xmlns:rdfs=http://www.w3.org/2000/01/rdf-schema#' tests/rdf-schema.rdf 'http://www.w3.org/2000/01/rdf-schema#'

CONFORMING TO

RDF/XML Syntax (Revised), W3C Recommendation, http://www.w3.org/TR/rdf-syntax-grammar/

N-Triples, in RDF Test Cases, Jan Grant and Dave Beckett (eds.), W3C Recommendation, http://www.w3.org/TR/rdf-testcases/#ntriples

Turtle Terse RDF Triple Language, Dave Beckett, http://www.dajobe.org/2004/01/turtle/

RDFA in XHTML: Syntax and Processing, Ben Adida, Mark Birbeck, Shane McCarron and Steven Pemberton (eds.), W3C Candidate Recommendation, 20 June 2008 http://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/

RDF Site Summary (RSS) 1.0, 2000-12-06 http://purl.org/rss/1.0/spec

CHANGES

2.0.0

Removed -a option that did nothing.

Removed -m option from rapper but it was never documented here.

Removed -n option that was long hidden.

Removed -s option that was equivalent to -f scanForRDF

1.4.16

Added -I/--input-uri and -O/--output-uri to set the input and output (parser and serializer) base URIs separately.

1.4.15

Added -t/--trace to do URI traces.

1.4.5

Updated to add serializer rdfxml-abbrev

1.4.3

Updated potential parser and serializers and described -f for defining namespaces.

1.3.0

Added -f for features.
Added -g for guessing the parser to use.

1.1.0

Removed -a, --assume since rdf:RDF is now always optional.

AUTHOR

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