rapper(1)

NAME
rapper - Raptor RDF parser and serializer utility

SYNOPSIS
rapper [OPTIONS] <source-URI> [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 source-URI can be a file name or if Raptor is built with a WWW retrieval library, a general URI. The optional base-URI is used as the document URI if present.

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.

-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.

-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.

-s, --scan
    Scan for <rdf:RDF> element in the RDF/XML source content.

--show-namespaces
    Print namespaces as they are seen in the input.

-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/ (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 (http://www.w3.org/TR/rdf-testcases/#ntriples) Turtle Terse RDF Triple Language, Dave Beckett, http://www.dajobe.org/2004/01/turtle/ (http://www.dajobe.org/2004/01/turtle/) RDF Site Summary (RSS) 1.0, 2000-12-06 http://purl.org/rss/1.0/spec (http://purl.org/rss/1.0/spec)

SEE ALSO
libraptor(3),raptor-config(1)

CHANGES

  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://purl.org/net/dajobe/ (http://purl.org/net/dajobe/)