This is Rack middleware that provides Linked Data content
negotiation for Rack applications. You can use Rack::LinkedData
with any
Ruby web framework based on Rack, including with Ruby on Rails 3.0 and with
Sinatra.
# config/application.rb
require 'rack/linkeddata'
class Application < Rails::Application
config.middleware.use Rack::LinkedData::ContentNegotiation
end
#!/usr/bin/env ruby -rubygems
require 'sinatra'
require 'rack/linkeddata'
use Rack::LinkedData::ContentNegotiation
get '/hello' do
RDF::Graph.new do |graph|
graph << [RDF::Node.new, RDF::DC.title, "Hello, world!"]
end
end
#!/usr/bin/env rackup
require 'rack/linkeddata'
rdf = RDF::Graph.new do |graph|
graph << [RDF::Node.new, RDF::DC.title, "Hello, world!"]
end
use Rack::LinkedData::ContentNegotiation
run lambda { |env| [200, {}, rdf] }
use Rack::LinkedData::ContentNegotiation, :default => "text/turtle"
Options are also passed to the writer, which can allow options to be shared among the application and different components.
shared_options = {:default => "text/turtle", :standard_prefixes => true, }
use Rack::LinkedData::ContentNegotiation, shared_options
run MyApplication, shared_options
rackup
and curl
$ rackup doc/examples/hello.ru
$ curl -iH "Accept: text/plain" http://localhost:9292/hello
$ curl -iH "Accept: text/turtle" http://localhost:9292/hello
$ curl -iH "Accept: application/rdf+xml" http://localhost:9292/hello
$ curl -iH "Accept: application/json" http://localhost:9292/hello
$ curl -iH "Accept: application/trix" http://localhost:9292/hello
$ curl -iH "Accept: */*" http://localhost:9292/hello
Rack::LinkedData
implements content negotiation for any Rack response
object that implements the RDF::Enumerable
mixin. You would typically
return an instance of RDF::Graph
or RDF::Repository
from your Rack
application, and let the Rack::LinkedData::ContentNegotiation
middleware
take care of serializing your response into whatever RDF format the HTTP
client requested and understands.
The middleware queries RDF.rb for the MIME content types of known RDF serialization formats, so it will work with whatever serialization extensions that are currently available for RDF.rb. (At present, this includes support for N-Triples, N-Quads, Turtle, RDF/XML, RDF/JSON, JSON-LD, RDFa, TriG and TriX.)
https://ruby-rdf.github.io/rack-linkeddata/
The recommended installation method is via RubyGems. To install the latest official release of the gem, do:
% [sudo] gem install rack-linkeddata
To get a local working copy of the development repository, do:
% git clone git://github.com/ruby-rdf/rack-linkeddata.git
Alternatively, download the latest development version as a tarball as follows:
% wget https://github.com/ruby-rdf/rack-linkeddata/tarball/master
This repository uses Git Flow to mange development and release activity. All submissions must be on a feature branch based on the develop branch to ease staging and integration.
.gemspec
, VERSION
or AUTHORS
files. If you need to
change them, do so on your private branch only.CREDITS
file and the corresponding
list in the the README
. Alphabetical order applies.This is free and unencumbered public domain software. For more information, see https://unlicense.org/ or the accompanying {file:UNLICENSE} file.