rapper - Raptor RDF parsing and serializing utility
Contents
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.
Conforming To
RDF/XMLSyntax(Revised), W3C Recommendation, http://www.w3.org/TR/rdf-syntax-grammar/N-Triples, in RDFTestCases, Jan Grant and Dave Beckett (eds.), W3C Recommendation, http://www.w3.org/TR/rdf-testcases/#ntriples TurtleTerseRDFTripleLanguage, Dave Beckett, http://www.dajobe.org/2004/01/turtle/RDFAinXHTML:SyntaxandProcessing, 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/RDFSiteSummary(RSS)1.0, 2000-12-06 http://purl.org/rss/1.0/spec
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.
Example
rapper-ontripleshttp://planetrdf.com/guide/rss.rdfrapper-irss-tag-soup-orss-1.0pile-of-rss.xmlhttp://example.org/base/rapper--counthttp://example.org/index.rdf
Examples
rapper-q-intriples-ordfxml-f'xmlns:rss="http://purl.org/rss/1.0/"'-f'xmlns:ex="http://example.org/"'tests/test.ntrapper-q-ordfxml-f'xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"'tests/rdf-schema.rdf'http://www.w3.org/2000/01/rdf-schema#'
Name
rapper - Raptor RDF parsing and serializing utility
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,--inputFORMAT
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, Atom 0.3 and Atom 1.0 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-uriURI
Set the input/parser base URI or use value '-' for no base. The default is the INPUT-URI argument
value.
-o,--outputFORMAT
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-uriURI
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-uriURI-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,--featureFEATURE[=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.
See Also
libraptor(3),raptor-config(1)
Synopsis
rapper [OPTIONS] INPUT-URI[INPUT-BASE-URI]
