sadi-rb 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab2044de34253723c4b946f38ffd1aa6c05ecc4f
-  data.tar.gz: 0f6b13b3ee863ab5cf5fe751c4511f7ceacc44f0
+  metadata.gz: 710664e9e7b3fd1fa404d9789934fbaab1ca6761
+  data.tar.gz: fa4892f551d5f15234837a89edf87798e48656cb
 SHA512:
-  metadata.gz: 4282d1f8e806189166e83517603e57a4718d4a55e7d528c359f1e3b4778c10fdb107fc765a070e3faf336bd89e7790aa8eb5e0502844af1212e8a40a5f2b7d36
-  data.tar.gz: ba25e5a446f0229053c126cefbe0cc3b4caba059214f81efc0841d6d941b00566de933c164e4d6212e7390586ef4e29e70d4ca7d5af9367a715a738e0cae68d4
+  metadata.gz: 1e0dfb9db33fcb89220ba2d7dc7a5633510f6517728345342186f70fa933b6bc9a42c3ca030aa10043c38e0f6aff926a92c455e9bdf37fe92aa71b4223f37d7c
+  data.tar.gz: da6d8beb97e317df3e6677b7464abcd957f81f951fbf3acc765ce5d6547668f8b82db45c56b298f61ec2b2527ba338ec69a532edc7dfdbcfb81dcfb9cd2c68fe

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3
+  - jruby

data/README.md

@@ -1,5 +1,7 @@
 # sadi-rb
 
+[![Build Status](https://travis-ci.org/wstrinz/sadi-rb.png?branch=master)](https://travis-ci.org/wstrinz/sadi-rb)
+
 ### Installation
 `gem install sadi-rb`
 
@@ -7,13 +9,13 @@ or clone the repository and run `rake install` for the latest version
 
 ### Description
 
-Write [SADI] Services in Ruby, then host them as a Sinatra server
+Write [SADI] Services in Ruby, using [ruby-rdf], then host them in a [Sinatra] application.
 
-Currently only supports [synchronous] service have been implemented.
+Currently only support for [synchronous] services are fully supported, although an experimental [asynchronous] class is available.
 
 ### Usage
 
-To test the server, use the gem's executable `sadi-rb`. This will start the server on [http://localhost:4567](http://localhost:4567), and load the [demo service].
+To test the server, use the gem's executable `sadi-rb`. This will start the server on [http://localhost:4567](http://localhost:4567), and load the [demo service], which is based on the service at [http://sadiframework.org/examples/hello](http://sadiframework.org/examples/hello).
 
 The server can also be run as part of a script using
 
@@ -25,35 +27,45 @@ SADI::Server.run!
 
 ### Writing your own services
 
-To create an asynchronous service, simply extend the `SADI::SynchronousService` module and implement the interface methods it requires;
+#### Synchronous
+
+To create a [synchronous] service, simply extend the `SADI::SynchronousService` module and implement the interface methods it requires;
 
 ```ruby
 require 'sadi-rb'
 
-Class MyService
-    def service_name
-        "my_service_name"
-    end
+class MyService
+  extend SADI::SynchronousService
+
+  def self.service_name
+    "my_service_name" # => service will be accessible at "/services/my_service_name"
+  end
 
-    def service_description
-        # an RDF::Graph of your service's description
-    end
+  def self.service_description
+    # an RDF::Graph of your service's description
+  end
 
-    def service_owl
-        # an RDF::Graph of your service's OWL classes
-    end
+  def self.service_owl
+    # an RDF::Graph of your service's OWL classes
+  end
 
-    def process_object(input_graph, owl_object)
-        # Service logic goes here
+  def self.process_object(input_graph, owl_object)
+    # Service logic goes here
 
-        # Should return an RDF::Graph of
-        #   the output for the resource specified by the URI owl_object,
-        #   from the RDF::Graph input_graph
-    end
+    # Should return an RDF::Graph of
+    #   the output for the resource specified by the URI owl_object,
+    #   from the RDF::Graph input_graph
+  end
 end
 ```
 
-Although SADI can theoretically use any vocabulary for its service description, the gem internals currently require that you use the [mygrid ontology] in implementing your `service_description` method
+Although SADI can theoretically use any vocabulary for its service description, the gem internals currently require that you use the [mygrid ontology] in implementing your `service_description` method.
+
+You also have access to the `parse_string(string, format)` method, inherited from [SADI::Converter](https://github.com/wstrinz/sadi-rb/blob/master/lib/sadi-rb/converter.rb) through `SADI::SynchronousService`, which can be used create a RDF::Graph from a serialized string. The `format` argument should be a symbol for an `RDF::Format` class, for example `:ttl` or `:rdfxml`.
+
+#### Asynchronous Services
+
+SADI also supports [asynchronous] services, which can be polled repeatedly until their results are available. To make a service asynchronous, you can simply extend the `SADI::AsynchronousService` module, and implement your service the same way you would a synchronous service. However beware that the implementation of asynchronous services is currently not thread safe or very well tested, so it may not work well on unless you're using MRI and Thin.
 
 ## Contributing to sadi-rb
 
@@ -70,6 +82,10 @@ Although SADI can theoretically use any vocabulary for its service description,
 Copyright (c) 2013 Will Strinz. See LICENSE.txt for
 further details.
 
-[demo service]: http://sadiframework.org/content/how-sadi-works/synchronous-sadi-services/
+[synchronous]: http://sadiframework.org/content/how-sadi-works/synchronous-sadi-services/
+[asynchronous]: https://code.google.com/p/sadi/wiki/AsynchronousServices
+[demo service]: https://github.com/wstrinz/sadi-rb/blob/master/lib/sadi-rb/example_service.rb
 [SADI]: http://sadiframework.org
-[mygrid ontology]: http://www.mygrid.org.uk/tools/service-management/mygrid-ontology/
+[mygrid ontology]: http://www.mygrid.org.uk/tools/service-management/mygrid-ontology/
+[ruby-rdf]: http://ruby-rdf.github.io/
+[Sinatra]: http://www.sinatrarb.com/

data/Rakefile

@@ -22,7 +22,7 @@ Jeweler::Tasks.new do |gem|
   gem.email = "wstrinz@gmail.com"
   # gem.executables   = gem.files.grep(%r{^bin/}) { |f| File.basename(f) }
   gem.authors = ["Will Strinz"]
-  gem.version = '0.0.2'
+  gem.version = '0.0.3'
   # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new

data/lib/sadi-rb.rb

@@ -1,8 +1,11 @@
 require_relative 'sadi-rb/server.rb'
 require_relative 'sadi-rb/converter.rb'
+require_relative 'sadi-rb/base_service.rb'
 require_relative 'sadi-rb/synchronous_service.rb'
+require_relative 'sadi-rb/asynchronous_service.rb'
 require_relative 'sadi-rb/services.rb'
 
 require_relative 'sadi-rb/example_service.rb'
+require_relative 'sadi-rb/example_service_async.rb'
 
 SADI.reload_services

data/lib/sadi-rb/asynchronous_service.rb

@@ -0,0 +1,66 @@
+module SADI
+  module AsynchronousService
+    include SADI::Converter
+    include SADI::BaseService
+
+    def self.included(base)
+      @classes ||= []
+      @classes << base
+    end
+
+    def self.extended(base)
+      @classes ||= []
+      @classes << base
+    end
+
+    def self.classes
+      @classes
+    end
+
+    def jobs
+      # Yay not thread safety!
+
+      @jobs ||= {}
+    end
+
+    def generate_job_id
+      # TODO better poll URLs
+
+      # "#{service_name}_#{Time.now.nsec.to_s(32)}"
+      Time.now.nsec.to_s(32)
+    end
+
+    def process_input(input, format, poll_base)
+      job_id = generate_job_id
+
+      raise "Job already exists (#{job_id})" if jobs[job_id]
+
+      jobs[job_id] = nil
+
+      Thread.new do
+
+        gr = RDF::Graph.new
+        in_graph = parse_string(input,format)
+
+        input_objects(in_graph).each do |obj|
+          gr << process_object(in_graph, obj)
+        end
+
+        jobs[job_id] = gr
+      end
+
+      gr = RDF::Graph.new
+      out_class = output_classes.first
+      input_objects(parse_string(input,format)).each do |obj|
+        gr << RDF::Statement.new(obj, RDF.type, out_class)
+        gr << RDF::Statement.new(obj, RDF::RDFS.isDefinedBy, RDF::URI("#{poll_base}/#{job_id}"))
+      end
+
+      gr
+    end
+
+    def poll(job_id)
+      jobs[job_id]
+    end
+  end
+end

data/lib/sadi-rb/base_service.rb

@@ -0,0 +1,71 @@
+module SADI
+  module BaseService
+    include SADI::Converter
+
+    # def self.included(base)
+    #   @classes ||= []
+    #   @classes << base
+    # end
+
+    # def self.extended(base)
+    #   @classes ||= []
+    #   @classes << base
+    # end
+
+    # def self.classes
+    #   @classes
+    # end
+
+    def process_input(input, format)
+      raise "Input processing should be implemented by service module"
+    end
+
+    def input_objects(graph)
+      input_classes.map do |cl|
+        solutions = RDF::Query.execute(graph) do
+          pattern [:obj, RDF.type, cl]
+        end
+
+        solutions.map(&:obj)
+      end.flatten
+    end
+
+    def input_classes
+      moby = RDF::Vocabulary.new('http://www.mygrid.org.uk/mygrid-moby-service#')
+
+      solutions = RDF::Query.execute(service_description) do
+        pattern [nil, moby.inputParameter, :param]
+        pattern [:param, moby.objectType, :in_class]
+      end
+
+      solutions.map(&:in_class)
+    end
+
+    def output_classes
+      moby = RDF::Vocabulary.new('http://www.mygrid.org.uk/mygrid-moby-service#')
+
+      solutions = RDF::Query.execute(service_description) do
+        pattern [nil, moby.outputParameter, :param]
+        pattern [:param, moby.objectType, :out_class]
+      end
+
+      solutions.map(&:out_class)
+    end
+
+    def service_description(service)
+      raise "Must implement a #service_description method returning an RDF::Graph or Repository"
+    end
+
+    def service_owl(service)
+      raise "Must implement a #service_owl method returning an RDF::Graph or Repository"
+    end
+
+    def process_object(owl_graph, object)
+      raise "Must implement a #process_input that takes an RDF::Graph or Repository as input and returns a new one"
+    end
+
+    def service_name
+      raise "Must define a service name"
+    end
+  end
+end

data/lib/sadi-rb/example_service_async.rb

@@ -0,0 +1,91 @@
+class ExampleServiceAsync
+  extend SADI::AsynchronousService
+  class << self
+    def service_name
+      "hello_async"
+    end
+
+    def service_description
+      str = <<-EOS
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://sadiframework.org/examples/hello> a <http://www.mygrid.org.uk/mygrid-moby-service#serviceDescription>;
+      rdfs:label "Hello, world"^^xsd:string;
+      <http://www.mygrid.org.uk/mygrid-moby-service#hasOperation> [ a <http://www.mygrid.org.uk/mygrid-moby-service#operation>;
+            <http://www.mygrid.org.uk/mygrid-moby-service#hasUnitTest> [ a <http://www.mygrid.org.uk/mygrid-moby-service#unitTest>;
+            <http://www.mygrid.org.uk/mygrid-moby-service#exampleInput> <http://sadiframework.org/examples/t/hello.input.1.rdf>;
+            <http://www.mygrid.org.uk/mygrid-moby-service#exampleOutput> <http://sadiframework.org/examples/t/hello.output.1.rdf>];
+            <http://www.mygrid.org.uk/mygrid-moby-service#inputParameter> [ a <http://www.mygrid.org.uk/mygrid-moby-service#parameter>;
+            <http://www.mygrid.org.uk/mygrid-moby-service#objectType> <http://sadiframework.org/examples/hello.owl#NamedIndividual>];
+            <http://www.mygrid.org.uk/mygrid-moby-service#outputParameter> [ a <http://www.mygrid.org.uk/mygrid-moby-service#parameter>;
+            <http://www.mygrid.org.uk/mygrid-moby-service#objectType> <http://sadiframework.org/examples/hello.owl#GreetedIndividual>]];
+      <http://www.mygrid.org.uk/mygrid-moby-service#hasServiceDescriptionText> "A simple \"Hello, World\" service that reads a name and attaches a greeting."^^xsd:string;
+      <http://www.mygrid.org.uk/mygrid-moby-service#hasServiceNameText> "Hello, world"^^xsd:string;
+      <http://www.mygrid.org.uk/mygrid-moby-service#providedBy> [ a <http://www.mygrid.org.uk/mygrid-moby-service#organisation>;
+            <http://protege.stanford.edu/plugins/owl/dc/protege-dc.owl#creator> "info@sadiframework.org"^^xsd:string;
+            <http://www.mygrid.org.uk/mygrid-moby-service#authoritative> true];
+      rdfs:comment "A simple \"Hello, World\" service that reads a name and attaches a greeting."^^xsd:string .
+      EOS
+
+      parse_string(str, :ttl)
+    end
+
+    def service_owl
+      str = <<-EOS
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<> a owl:Ontology .
+
+<#GreetedIndividual> a owl:Class;
+      owl:equivalentClass [ a owl:Restriction;
+            owl:onProperty <#greeting>;
+            owl:someValuesFrom xsd:string] .
+
+<#NamedIndividual> a owl:Class;
+      owl:equivalentClass [ a owl:Restriction;
+            owl:minCardinality "1"^^xsd:int;
+            owl:onProperty foaf:name] .
+
+<#SecondaryParameters> a owl:Class;
+      owl:equivalentClass [ a owl:Restriction;
+            owl:minCardinality "1"^^xsd:int;
+            owl:onProperty <#lang>] .
+
+<#greeting> a owl:DatatypeProperty .
+
+<#lang> a owl:DatatypeProperty .
+
+foaf:name a owl:DatatypeProperty;
+      rdfs:isDefinedBy foaf:index.rdf .
+      EOS
+
+      parse_string(str, :ttl)
+    end
+
+    def owl_prefix
+      "http://sadiframework.org/examples/hello.owl#"
+    end
+
+    def process_object(in_graph, object)
+      out_graph = RDF::Graph.new
+
+      name = RDF::Query.execute(in_graph) do
+        pattern [object, RDF::FOAF.name, :name]
+      end
+      name = name.first.name
+
+      owl_vocab = RDF::Vocabulary.new(owl_prefix)
+
+      out_graph << RDF::Statement.new(object, RDF.type, output_classes.first)
+      out_graph << RDF::Statement.new(object, owl_vocab.greeting, "Hello, #{name}!")
+
+      out_graph
+    end
+  end
+end

data/lib/sadi-rb/server.rb

@@ -18,8 +18,13 @@ module SADI
       get_description(params[:service])
     end
 
+
     post '/services/:service' do
-      handle_synchronous(params[:service])
+      handle_post(params[:service])
+    end
+
+    get '/poll/:service/:job' do
+      poll_service(params[:service], params[:job])
     end
 
     get '/files/:service/:file' do
@@ -32,10 +37,15 @@ module SADI
         repo
       end
 
-      def handle_synchronous(service)
+      def handle_post(service)
         svc = SADI.service_for(service)
         raise "no service exists with name '#{service}'" unless svc
-        rdf_response svc.process_input(request.body.read,request.content_type)
+        if svc.is_a? SynchronousService
+          rdf_response svc.process_input(request.body.read, request.content_type)
+        else
+          status 202
+          rdf_response svc.process_input(request.body.read, request.content_type, "http://#{request.host_with_port}/poll/#{svc.service_name}")
+        end
       end
 
       def get_description(service)
@@ -54,6 +64,34 @@ module SADI
         .map{|f| "#{f.content_type} (#{f.to_sym})"}
         .join('<br>')
       end
+
+      def poll_service(service, job)
+        svc = SADI.service_for(service)
+        result = svc.poll(job)
+        if result.is_a?(RDF::Graph) || result.is_a?(RDF::Repository)
+          result
+        else
+          redirect_poll(svc, job)
+        end
+      end
+
+      def redirect_poll(svc, job)
+        status 302
+        retry_time = 10
+        headers \
+          "Pragma" => "sadi-please-wait = #{retry_time}",
+          "Location" => request.url
+
+      end
+    end
+
+    class << self
+      alias_method :base_run!, :run!
+
+      def run!
+        SADI.reload_services
+        base_run!
+      end
     end
   end
 end

data/lib/sadi-rb/services.rb

@@ -1,6 +1,5 @@
 module SADI
   class << self
-
     def service_for(name)
       services[name]
     end
@@ -16,7 +15,7 @@ module SADI
     def reload_services
       @@services = {}
 
-      SADI::SynchronousService.classes.each do |service|
+      (SADI::SynchronousService.classes | SADI::AsynchronousService.classes).each do |service|
         if service.respond_to? 'service_name'
           name = service.service_name
           puts "Warning: service #{@@services[name]} already using name '#{name}', overwriting" if @@services[name]

data/lib/sadi-rb/synchronous_service.rb

@@ -1,6 +1,7 @@
 module SADI
   module SynchronousService
     include SADI::Converter
+    include SADI::BaseService
 
     def self.included(base)
       @classes ||= []
@@ -25,52 +26,5 @@ module SADI
 
       gr
     end
-
-    def input_objects(graph)
-      cl = input_classes.first
-      solutions = RDF::Query.execute(graph) do
-        pattern [:obj, RDF.type, cl]
-      end
-
-      solutions.map(&:obj)
-    end
-
-    def input_classes
-      moby = RDF::Vocabulary.new('http://www.mygrid.org.uk/mygrid-moby-service#')
-
-      solutions = RDF::Query.execute(service_description) do
-        pattern [nil, moby.inputParameter, :param]
-        pattern [:param, moby.objectType, :in_class]
-      end
-
-      solutions.map(&:in_class)
-    end
-
-    def output_classes
-      moby = RDF::Vocabulary.new('http://www.mygrid.org.uk/mygrid-moby-service#')
-
-      solutions = RDF::Query.execute(service_description) do
-        pattern [nil, moby.outputParameter, :param]
-        pattern [:param, moby.objectType, :out_class]
-      end
-
-      solutions.map(&:out_class)
-    end
-
-    def service_description(service)
-      raise "Must implement a #service_description method returning an RDF::Graph or Repository"
-    end
-
-    def service_owl(service)
-      raise "Must implement a #service_owl method returning an RDF::Graph or Repository"
-    end
-
-    def process_object(owl_graph, object)
-      raise "Must implement a #process_input that takes an RDF::Graph or Repository as input and returns a new one"
-    end
-
-    def service_name
-      raise "Must define a service name"
-    end
   end
 end

data/sadi-rb.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "sadi-rb"
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Will Strinz"]
-  s.date = "2013-10-15"
+  s.date = "2013-10-17"
   s.description = "Build and run SADI services with ruby-rdf and sinatra"
   s.email = "wstrinz@gmail.com"
   s.executables = ["sadi-rb"]
@@ -19,14 +19,18 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".document",
+    ".travis.yml",
     "Gemfile",
     "LICENSE.txt",
     "README.md",
     "Rakefile",
     "bin/sadi-rb",
     "lib/sadi-rb.rb",
+    "lib/sadi-rb/asynchronous_service.rb",
+    "lib/sadi-rb/base_service.rb",
     "lib/sadi-rb/converter.rb",
     "lib/sadi-rb/example_service.rb",
+    "lib/sadi-rb/example_service_async.rb",
     "lib/sadi-rb/server.rb",
     "lib/sadi-rb/services.rb",
     "lib/sadi-rb/synchronous_service.rb",

data/spec/server_spec.rb

@@ -43,7 +43,7 @@ describe SADI::Server do
 
     it "returns output on post" do
       header "Accept", "text/turtle"
-      header "Content-Type", "application/rdf+xml"
+      header "Content-type", "application/rdf+xml"
 
       post '/services/hello', sample_input
 
@@ -54,16 +54,160 @@ describe SADI::Server do
   end
 
   context "content negotiation" do
-    %w{application/rdf+xml text/turtle application/ld+json}.each do |format|
+    ['application/rdf+xml'].each do |format|
+      describe "accepts #{format} (JRuby issues)", no_travis: true do
+        it do
+          header "Accept", format
+          get '/services/hello'
+
+          last_response.should be_ok
+          last_response.content_type.should == format
+        end
+      end
+    end
+
+    %w{text/turtle application/ld+json application/json}.each do |format|
       describe "accepts #{format}" do
-        it {
+        it do
           header "Accept", format
           get '/services/hello'
 
           last_response.should be_ok
           last_response.content_type.should == format
-        }
+        end
+      end
+    end
+  end
+
+  describe "async services" do
+    it "basic get" do
+      get 'services/hello_async'
+      last_response.should be_ok
+    end
+
+    describe "post" do
+      it "receives poll url" do
+        header "Accept", "text/turtle"
+        header "Content-type", "application/rdf+xml"
+
+        post '/services/hello_async', sample_input
+        last_response.status.should == 202
+
+        last_response.body["rdf-schema#isDefinedBy"].should_not be nil
+      end
+
+      it "gets result from poll url" do
+        header "Accept", "text/turtle"
+        header "Content-type", "application/rdf+xml"
+
+        post '/services/hello_async', sample_input
+
+        last_response.status.should == 202
+
+        poll_id = last_response.body.scan(%r{http://example.org/poll/hello_async/(\w+)}).first.first
+
+        get "/poll/hello_async/#{poll_id}"
+
+        last_response.should be_ok
+        last_response.body["Hello, Guy Incognito"].should_not be nil
+      end
+
+      context "redirection" do
+        before :all do
+          @cl = Class.new do
+            extend SADI::AsynchronousService
+
+            def self.service_name
+              "my_async"
+            end
+
+            def self.service_description
+              ExampleServiceAsync.service_description
+            end
+
+            def self.service_owl
+              ExampleServiceAsync.service_owl
+            end
+
+            def self.process_object(input_graph, owl_object)
+              sleep(1)
+              ExampleServiceAsync.process_object(input_graph, owl_object)
+            end
+          end
+
+          SADI.reload_services
+        end
+
+        it "receives redirects" do
+          header "Accept", "text/turtle"
+          header "Content-type", "application/rdf+xml"
+
+          post '/services/my_async', sample_input
+
+          poll_id = last_response.body.scan(%r{http://example.org/poll/my_async/(\w+)}).first.first
+
+          get "/poll/my_async/#{poll_id}"
+
+          last_response.status.should == 302
+          # puts last_response.headers["Pragma"]
+          last_response.headers["Pragma"][/sadi-please-wait = \d+/].should_not be nil
+          last_response.headers["Location"].should == "http://example.org/poll/my_async/#{poll_id}"
+        end
+
+        it "eventually receives results" do
+          header "Accept", "text/turtle"
+          header "Content-type", "application/rdf+xml"
+
+          post '/services/my_async', sample_input.gsub("Guy Incognito", "Nick Danger")
+
+          poll_id = last_response.body.scan(%r{http://example.org/poll/my_async/(\w+)}).first.first
+
+          get "/poll/my_async/#{poll_id}"
+
+          last_response.status.should == 302
+
+          sleep 1
+
+          get "/poll/my_async/#{poll_id}"
+          last_response.body["Hello, Nick Danger"].should_not be nil
+        end
+      end
+
+    end
+  end
+
+  describe "define new classes" do
+    before do
+      @cl = Class.new do
+        extend SADI::SynchronousService
+
+        def self.service_name
+          "my_service_name" # => service will be accessible at "/services/my_service_name"
+        end
+
+        def self.service_description
+          # an RDF::Graph of your service's description
+        end
+
+        def self.service_owl
+          # an RDF::Graph of your service's OWL classes
+        end
+
+        def self.process_object(input_graph, owl_object)
+          # Service logic goes here
+
+          # Should return an RDF::Graph of
+          #   the output for the resource specified by the URI owl_object,
+          #   from the RDF::Graph input_graph
+        end
       end
+
+      SADI.reload_services
     end
+
+    it {
+      get 'services/my_service_name'
+      last_response.should be_ok
+    }
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sadi-rb
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Will Strinz
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-15 00:00:00.000000000 Z
+date: 2013-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sinatra
@@ -174,14 +174,18 @@ extra_rdoc_files:
 - README.md
 files:
 - .document
+- .travis.yml
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/sadi-rb
 - lib/sadi-rb.rb
+- lib/sadi-rb/asynchronous_service.rb
+- lib/sadi-rb/base_service.rb
 - lib/sadi-rb/converter.rb
 - lib/sadi-rb/example_service.rb
+- lib/sadi-rb/example_service_async.rb
 - lib/sadi-rb/server.rb
 - lib/sadi-rb/services.rb
 - lib/sadi-rb/synchronous_service.rb