# Raptor RDF Parser Toolkit - Raptor RDF parser utility

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

| −s, −−scan

| Scan for <rdf:RDF> element in the RDF/XML source content.

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

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

| 1.1.0

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

## AUTHOR

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

Copyright 2002-2008 Dave Beckett
2002-2008 University of Bristol