rapper(1)

NAME
rapper - Raptor RDF parser and serializer utility

SYNOPSIS
rapper [OPTIONS] <source-URI> [base-URI]

EXAMPLE
rapper -o ntriples http://www.ilrt.bris.ac.uk/discovery/rdf/resources/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 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) 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..

-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.ilrt.bristol.ac.uk/discovery/2004/01/turtle/ (http://www.ilrt.bristol.ac.uk/discovery/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.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/)
Institute for Learning and Research Technology (ILRT) http://www.ilrt.bristol.ac.uk/
University of Bristol http://www.bristol.ac.uk/