View on GitHub

rdf-raptor

RDF.rb extension for parsing/serializing RDF/XML, Turtle and RDFa data using the Raptor RDF Parser library.

Download this project as a .zip file Download this project as a tar.gz file

Raptor RDF Extension for RDF.rb

This is an RDF.rb extension that adds support for parsing/serializing NTriples, RDF/XML, Turtle, RDFa, and Graphviz data using the Raptor RDF Parser library.

Gem Version Build Status

Features

Examples

require 'rdf/raptor'

Ensuring Raptor is installed and obtaining the version number

RDF::Raptor.available?         #=> true
RDF::Raptor.version            #=> "2.0.8"

Parsing RDF statements from an NTriples file

RDF::Reader.open("http://datagraph.org/jhacker/foaf.nt") do |reader|
  reader.each_statement do |statement|
    puts statement.inspect
  end
end

Parsing RDF statements from an RDF/XML file

RDF::Reader.open("http://datagraph.org/jhacker/foaf.rdf") do |reader|
  reader.each_statement do |statement|
    puts statement.inspect
  end
end

Parsing RDF statements from a Turtle file

RDF::Reader.open("http://datagraph.org/jhacker/foaf.ttl") do |reader|
  reader.each_statement do |statement|
    puts statement.inspect
  end
end

Extracting RDF statements from an HTML+RDFa document

RDF::Reader.open(url = "http://bblfish.net/", :format => :rdfa, :base_uri => url) do |reader|
  reader.each_statement do |statement|
    puts statement.inspect
  end
end

Serializing RDF statements into an RDF/XML file

data = RDF::Repository.load("http://datagraph.org/jhacker/foaf.nt")

RDF::Writer.open("output.rdf") do |writer|
  data.each_statement do |statement|
    writer << statement
  end
end

Serializing RDF statements into a Turtle file

data = RDF::Repository.load("http://datagraph.org/jhacker/foaf.nt")

RDF::Writer.open("output.ttl") do |writer|
  data.each_statement do |statement|
    writer << statement
  end
end

Obtaining the NTriples format specification class

RDF::Format.for(:ntriples)      #=> RDF::Raptor::NTriples::Format
RDF::Format.for("input.nt")
RDF::Format.for(:file_name      => "input.nt")
RDF::Format.for(:file_extension => "nt")
RDF::Format.for(:content_type   => "application/n-triples")

Obtaining the RDF/XML format specification class

RDF::Format.for(:rdfxml)       #=> RDF::Raptor::RDFXML::Format
RDF::Format.for("input.rdf")
RDF::Format.for(:file_name      => "input.rdf")
RDF::Format.for(:file_extension => "rdf")
RDF::Format.for(:content_type   => "application/rdf+xml")

Obtaining the Turtle format specification class

RDF::Format.for(:turtle)       #=> RDF::Raptor::Turtle::Format
RDF::Format.for("input.ttl")
RDF::Format.for(:file_name      => "input.ttl")
RDF::Format.for(:file_extension => "ttl")
RDF::Format.for(:content_type   => "text/turtle")

Obtaining the RDFa format specification class

RDF::Format.for(:rdfa)         #=> RDF::Raptor::RDFa::Format
RDF::Format.for("input.html")
RDF::Format.for(:file_name      => "input.html")
RDF::Format.for(:file_extension => "html")
RDF::Format.for(:content_type   => "application/xhtml+xml")

Obtaining the Graphviz format specification class

RDF::Format.for(:graphviz)     #=> RDF::Raptor::Graphviz::Format
RDF::Format.for("output.dot")
RDF::Format.for(:file_name      => "output.dot")
RDF::Format.for(:file_extension => "")
RDF::Format.for(:content_type   => "text/vnd.graphviz")

Documentation

http://rdf.rubyforge.org/raptor/

Dependencies

Installation

The recommended installation method is via RubyGems. To install the latest official release of the RDF::Raptor gem, do:

% [sudo] gem install rdf-raptor

To install the required Raptor command-line tools themselves, look for a raptor or raptor-utils package in your platform's package management system. For your convenience, here follow installation instructions for the Mac and the most common Linux and BSD distributions:

% [sudo] port install raptor             # Mac OS X with MacPorts
% [sudo] fink install raptor-bin         # Mac OS X with Fink
% brew install raptor                    # Mac OS X with Homebrew
% [sudo] aptitude install raptor-utils   # Ubuntu / Debian with aptitude
% [sudo] apt-get install libraptor2-0    # Ubuntu / Debian with apt-get
% [sudo] yum install raptor              # Fedora / CentOS / RHEL
% [sudo] zypper install raptor           # openSUSE
% [sudo] emerge raptor                   # Gentoo Linux
% [sudo] pacman -S raptor                # Arch Linux
% [sudo] pkg_add -r raptor               # FreeBSD
% [sudo] pkg_add raptor                  # OpenBSD / NetBSD

Download

To get a local working copy of the development repository, do:

% git clone git://github.com/ruby-rdf/rdf-raptor.git

Alternatively, download the latest development version as a tarball as follows:

% wget https://github.com/ruby-rdf/rdf-raptor/tarball/master

Mailing List

Authors

Contributors

License

This is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.