User Commands rapper(1)
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
rapper --count http://example.org/index.rdf
DESCRIPTION
The rapper utility allows parsing of RDF content by the Rap-
tor 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 oth-
erwise defaults to the IINPUT-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 for-
mats 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
SunOS 5.10 Last change: 2007-08-19 1
User Commands rapper(1)
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 con-
tinue 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.
-s, --scan
Scan for element in the RDF/XML source con-
tent.
--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.
SunOS 5.10 Last change: 2007-08-19 2
User Commands rapper(1)
-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
rapper -q -o rdfxml -f
'xmlns:rdfs="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 Bir-
beck, Shane McCarron and Steven Pemberton (eds.), W3C Candi-
date 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
SEE ALSO
libraptor(3),raptor-config(1)
CHANGES
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.
SunOS 5.10 Last change: 2007-08-19 3
User Commands rapper(1)
1.1.0
Removed -a, --assume since rdf:RDF is now always optional.
AUTHOR
Dave Beckett - http://www.dajobe.org/
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWraptor |
|_____________________________|_____________________________|
| Interface stability | Volatile |
| | |
|_____________________________|_____________________________|
SunOS 5.10 Last change: 2007-08-19 4