module RDF::Raptor

**‘RDF::Raptor`** is a Raptor RDF Parser plugin for RDF.rb.

@example Requiring the ‘RDF::Raptor` module

require 'rdf/raptor'

@example Checking whether Raptor is installed

RDF::Raptor.available?         #=> true

@example Obtaining the Raptor version number

RDF::Raptor.version            #=> "1.4.21"

@example Obtaining the Raptor engine

RDF::Raptor::ENGINE            #=> :ffi

@example Obtaining an N-Triples format 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:   "text/plain")

@example Obtaining a Turtle format 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")

@example Obtaining an RDF/XML format 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")

@example Obtaining an RDFa format 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")

{RDF::Raptor} includes an FFI implementation, which loads the ‘libraptor2` library into the Ruby process, as well as a CLI implementation, which drives the `rapper` command-line tool in a sub-process.

The FFI implementation is used by default unless the ‘libraptor2` library cannot be found, or if the `RDF_RAPTOR_ENGINE` environment variable is explicitly set to `’cli’‘.

If the ‘libraptor2` library is in the standard library search path, and the `rapper` command is in the standard command search path, all should be well and work fine out of the box. However, if either is in a non-standard location, be sure to set the `RDF_RAPTOR_LIBPATH` and/or `RDF_RAPTOR_BINPATH` environment variables appropriately before requiring `rdf/raptor`.

@see www.rubydoc.info/github/ruby-rdf/rdf/ @see librdf.org/raptor/ @see wiki.github.com/ffi/ffi/

@author [Arto Bendiken](github.com/artob) @author [John Fieber](github.com/jfieber)

Constants

LIBRAPTOR
RAPPER

Public Class Methods

available?() click to toggle source

Returns ‘true` if the `rapper` binary is available.

@example

RDF::Raptor.available?  #=> true

@return [Boolean]

# File lib/rdf/raptor.rb, line 106
def self.available?
  !!version
end