ruote-kit 2.1.4

data/spec/resources/index_spec.rb

@@ -0,0 +1,46 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "GET /" do
+  it "should return a welcome message in HTML be default" do
+    get "/_ruote"
+
+    last_response.should be_ok
+    last_response.content_type.should match("text/html")
+
+    last_response.should match(/Hello world/)
+    last_response.should match(/<title>/)
+  end
+
+  it "should return a version string if JSON is requested" do
+    header "Accept", "application/json"
+
+    get "/_ruote"
+
+    last_response.should be_ok
+    last_response.content_type.should match("application/json")
+    body = last_response.json_body
+
+    body["misc"].should == { "ruote-kit" => "welcome", "version" => RuoteKit::VERSION.to_s }
+  end
+end
+
+describe "Generic error handling" do
+  it "should give our own 404 page (HTML)" do
+    get "/kenneth"
+
+    last_response.should_not be_ok
+    last_response.status.should be(404)
+
+    last_response.should be_html
+    last_response.should match(/Resource not found/)
+  end
+
+  it "should give our own 404 data (JSON)" do
+    get "/kenneth.json"
+
+    last_response.should_not be_ok
+    last_response.status.should be(404)
+
+    last_response.should be_json
+  end
+end

data/spec/resources/processes_spec.rb

@@ -0,0 +1,259 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "GET /_ruote/processes" do
+  describe "without any running processes" do
+    it "should give no processes back (HTML)" do
+      get "/_ruote/processes"
+
+      last_response.should be_ok
+    end
+
+    it "should give an empty array (JSON)" do
+      get "/_ruote/processes.json"
+
+      last_response.should be_ok
+
+      body = last_response.json_body
+      body.should have_key("processes")
+
+      body["processes"].should be_empty
+    end
+  end
+
+  describe "with running processes" do
+    before(:each) do
+      @wfid = launch_test_process
+    end
+
+    it "should give process information back (HTML)" do
+      get "/_ruote/processes"
+
+      last_response.should be_ok
+    end
+
+    it "should give process information back (JSON)" do
+      get "/_ruote/processes.json"
+
+      last_response.should be_ok
+
+      body = last_response.json_body
+
+      body["processes"].should_not be_empty
+    end
+  end
+end
+
+describe "GET /_ruote/processes/X-Y" do
+  describe "with a running process" do
+    before(:each) do
+      @wfid = launch_test_process
+    end
+
+    it "should give process information back (HTML)" do
+      get "/_ruote/processes/#{@wfid}"
+
+      last_response.should be_ok
+    end
+
+    it "should give process information back (JSON)" do
+      get "/_ruote/processes/#{@wfid}.json"
+
+      last_response.should be_ok
+
+      body = last_response.json_body
+
+      body.should have_key('process')
+    end
+  end
+
+  describe "without a running process" do
+    it "should 404 correctly (HTML)" do
+      get "/_ruote/processes/foo"
+
+      last_response.should_not be_ok
+      last_response.status.should be(404)
+
+      last_response.should match(/Resource not found/)
+    end
+
+    it "should 404 correctly (JSON)" do
+      get "/_ruote/processes/foo.json"
+
+      last_response.should_not be_ok
+      last_response.status.should be(404)
+
+      last_response.json_body.keys.should include("error")
+      last_response.json_body['error'].should == { "code" => "404", "message" => "Resource not found" }
+    end
+  end
+end
+
+describe "GET /_ruote/processes/new" do
+  it "should return a launch form" do
+    get "/_ruote/processes/new"
+
+    last_response.should be_ok
+  end
+end
+
+describe "POST /_ruote/processes" do
+  before(:each) do
+    engine.processes.should be_empty
+  end
+
+  it "should launch a valid process definition (JSON)" do
+    params = {
+      :definition => %q{Ruote.process_definition :name => 'test' do
+        _sleep '1m'
+      end}
+    }
+
+    post '/_ruote/processes.json', params.to_json, { 'CONTENT_TYPE' => 'application/json' }
+
+    last_response.should be_ok
+
+    last_response.json_body['launched'].should match(/[0-9a-z\-]+/)
+
+    sleep 0.4
+
+    engine.processes.should_not be_empty
+  end
+
+  it "should launch a valid process definition with fields (JSON)" do
+    params = {
+      :definition => %q{Ruote.process_definition :name => 'test' do
+        echo '${f:foo}'
+      end},
+      :fields => { :foo => 'bar' }
+    }
+
+    post '/_ruote/processes.json', params.to_json, { 'CONTENT_TYPE' => 'application/json' }
+
+    last_response.should be_ok
+    last_response.json_body['launched'].should match(/[0-9a-z\-]+/)
+
+    sleep 0.5
+
+    @tracer.to_s.should == "bar"
+  end
+
+  it "should launch a valid process definition (HTML)" do
+    params = {
+      :process_definition => %q{Ruote.process_definition :name => "test" do
+        _sleep '1m'
+      end
+      }
+    }
+
+    post "/_ruote/processes", params
+
+    last_response.should be_redirect
+    last_response['Location'].should match( /^\/_ruote\/processes\/[0-9a-z\-]+$/ )
+
+    sleep 0.4
+
+    engine.processes.should_not be_empty
+  end
+
+  it "should launch a process definition with fields (HTML)" do
+    params = {
+      :process_definition => %q{Ruote.process_definition :name => 'test' do
+        echo '${f:foo}'
+      end},
+      :process_fields => %q{ { "foo": "bar" } }
+    }
+
+    post '/_ruote/processes', params
+
+    last_response.should be_redirect
+    last_response['Location'].should match( /^\/_ruote\/processes\/([0-9a-z\-]+)$/ )
+
+    sleep 0.5
+
+    @tracer.to_s.should == "bar"
+  end
+
+  it "should correct for empty fields sent by browsers" do
+    params = {
+      :process_definition => %q{Ruote.process_definition :name => 'test' do
+        wait '5m'
+      end},
+      :process_fields => ''
+    }
+
+    post '/_ruote/processes', params
+
+    last_response.should be_redirect
+
+    sleep 0.4
+
+    engine.processes.should_not be_empty
+  end
+end
+
+describe "DELETE /_ruote/processes/X-Y" do
+  before(:each) do
+    @wfid = launch_test_process do
+      Ruote.process_definition :name => 'test' do
+        sequence :on_cancel => 'bail_out' do
+          echo "done."
+          wait '1d'
+        end
+
+        define :name => 'bail_out' do
+          echo "bailout."
+        end
+      end
+    end
+  end
+
+  it "should cancel processes (JSON)" do
+    delete "/_ruote/processes/#{@wfid}.json"
+
+    last_response.should be_ok
+
+    wait_for( @wfid )
+
+    engine.process( @wfid ).should be_nil
+
+    @tracer.to_s.should == "done.\nbailout."
+  end
+
+  it "should cancel processes (HMTL)" do
+    delete "/_ruote/processes/#{@wfid}"
+
+    last_response.should be_redirect
+    last_response['Location'].should == "/_ruote/processes"
+
+    wait_for( @wfid )
+
+    engine.process( @wfid ).should be_nil
+
+    @tracer.to_s.should == "done.\nbailout."
+  end
+
+  it "should kill processes (JSON)" do
+    delete "/_ruote/processes/#{@wfid}.json?_kill=1"
+
+    last_response.should be_ok
+
+    wait_for( @wfid )
+
+    engine.process( @wfid ).should be_nil
+
+    @tracer.to_s.should == "done."
+  end
+
+  it "should kill processes (HTML)" do
+    delete "/_ruote/processes/#{@wfid}?_kill=1"
+
+    last_response.should be_redirect
+    last_response['Location'].should == '/_ruote/processes'
+
+    wait_for( @wfid )
+
+    engine.process( @wfid ).should be_nil
+
+    @tracer.to_s.should == "done."
+  end
+end

data/spec/resources/workitems_spec.rb

@@ -0,0 +1,308 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "GET /_ruote/workitems" do
+  describe "without any workitems" do
+    it "should report no workitems (HTML)" do
+      get "/_ruote/workitems"
+
+      last_response.should be_ok
+      last_response.should match(/No workitems are currently available/)
+    end
+
+    it "should report no workitems (JSON)" do
+      get "/_ruote/workitems.json"
+
+      last_response.should be_ok
+      json = last_response.json_body
+
+      json.should have_key('workitems')
+      json['workitems'].should be_empty
+    end
+  end
+
+  describe "with workitems" do
+    before(:each) do
+      @wfid = launch_test_process do
+        Ruote.process_definition :name => 'test' do
+          sequence do
+            nada :activity => 'Work your magic'
+          end
+        end
+      end
+    end
+
+    it "should have a list of workitems (HTML)" do
+      get "/_ruote/workitems"
+
+      last_response.should be_ok
+      last_response.should match(/1 workitem available/)
+    end
+
+    it "should have a list of workitems (JSON)" do
+      get "/_ruote/workitems.json"
+
+      last_response.should be_ok
+      json = last_response.json_body
+
+      json['workitems'].size.should be(1)
+
+      wi = json['workitems'][0]
+
+      wi.keys.should include('fei', 'participant_name', 'fields')
+      wi['fei']['wfid'].should == @wfid
+      wi['participant_name'].should == 'nada'
+      wi['fields']['params']['activity'].should == 'Work your magic'
+    end
+  end
+end
+
+describe "GET /_ruote/workitems/wfid" do
+  describe "with workitems" do
+    before(:each) do
+      @wfid = launch_test_process do
+        Ruote.process_definition :name => 'foo' do
+          concurrence do
+            nada :activity => 'This'
+            nada :activity => 'Or that'
+          end
+        end
+      end
+    end
+
+    it "should list the workitems (HTML)" do
+      get "/_ruote/workitems/#{@wfid}"
+
+      last_response.should be_ok
+      last_response.should match(/2 workitems available for #{@wfid}/)
+    end
+
+    it "should list the workitems (JSON)" do
+      get "/_ruote/workitems/#{@wfid}.json"
+
+      last_response.should be_ok
+
+      json = last_response.json_body
+
+      json.should have_key('workitems')
+      json['workitems'].should_not be_empty
+    end
+  end
+
+  describe "without workitems" do
+    it "should report no workitems (HTML)" do
+      get "/_ruote/workitems/foo"
+
+      last_response.should be_ok
+      last_response.should match(/No workitems are currently available for foo/)
+    end
+
+    it "should report an empty list (JSON)" do
+      get "/_ruote/workitems/foo.json"
+
+      last_response.should be_ok
+
+      json = last_response.json_body
+
+      json.should have_key('workitems')
+      json['workitems'].should be_empty
+    end
+  end
+end
+
+describe "GET /_ruote/workitems/wfid/expid" do
+  describe "with a workitem" do
+    before(:each) do
+      @wfid = launch_test_process do
+        Ruote.process_definition :name => 'foo' do
+          sequence do
+            nada :activity => 'Work your magic'
+          end
+        end
+      end
+
+      process = engine.process( @wfid )
+      @nada_exp_id = "0_0_0" #process.expressions.last.fei.expid
+
+      @nada_exp_id.should_not be_nil
+    end
+
+    it "should return it (HTML)" do
+      get "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}"
+
+      last_response.should be_ok
+    end
+
+    it "should return it (JSON)" do
+      get "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}.json"
+
+      last_response.should be_ok
+    end
+  end
+
+  describe "without a workitem" do
+    it "should return a 404 (HTML)" do
+      get "/_ruote/workitems/foo/bar"
+
+      last_response.should_not be_ok
+      last_response.status.should be(404)
+    end
+
+    it "should return a 404 (JSON)" do
+      get "/_ruote/workitems/foo/bar.json"
+
+      last_response.should_not be_ok
+      last_response.status.should be(404)
+    end
+  end
+end
+
+describe "PUT /_ruote/workitems/X-Y" do
+  before(:each) do
+    @wfid = launch_test_process do
+      Ruote.process_definition :name => 'foo' do
+        sequence do
+          nada :activity => 'Work your magic'
+          echo "${f:foo}"
+        end
+      end
+    end
+
+    process = engine.process( @wfid )
+    @nada_exp_id = "0_0_0" #process.expressions.last.fei.expid
+
+    @nada_exp_id.should_not be_nil
+  end
+
+  it "should update the workitem fields (HTML)" do
+    fields = {
+      "params" => {
+        "activity" => "Work your magic",
+      },
+      "foo" => "bar"
+    }
+
+    put "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}", :fields => fields.to_json
+
+    last_response.should be_redirect
+    last_response['Location'].should == "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}"
+
+    find_workitem( @wfid, @nada_exp_id ).fields.should == fields
+
+    sleep 0.4
+
+    @tracer.to_s.should == ""
+  end
+
+  it "should update the workitem fields (JSON)" do
+    fields = {
+      "params" => {
+        "activity" => "Work your magic",
+      },
+      "foo" => "bar"
+    }
+    params = {
+      "fields" => fields
+    }
+
+    put "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}.json", params.to_json, { 'CONTENT_TYPE' => 'application/json' }
+
+    last_response.should be_ok
+
+    find_workitem( @wfid, @nada_exp_id ).fields.should == fields
+
+    sleep 0.4
+
+    @tracer.to_s.should == ""
+  end
+
+  it "should reply to the engine (HTML)" do
+    fields = {
+      "params" => {
+        "activity" => "Work your magic",
+      },
+      "foo" => "bar"
+    }.to_json
+
+    put "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}", :fields => fields, :_proceed => '1'
+
+    last_response.should be_redirect
+    last_response['Location'].should == "/_ruote/workitems/#{@wfid}"
+
+    #engine.context[:s_logger].wait_for([
+    #  [ :processes, :terminated, { :wfid => @wfid } ],
+    #  [ :errors, nil, { :wfid => @wfid } ]
+    #])
+    sleep 0.5
+
+    @tracer.to_s.should == "bar"
+  end
+
+  it "should reply to the engine (JSON)" do
+    fields = {
+      "params" => {
+        "activity" => "Work your magic",
+      },
+      "foo" => "bar"
+    }
+    params = {
+      "fields" => fields,
+      "_proceed" => "1"
+    }
+
+    put "/_ruote/workitems/#{@wfid}/#{@nada_exp_id}.json", params.to_json, { 'CONTENT_TYPE' => 'application/json' }
+
+    last_response.should be_ok
+
+    #engine.context[:s_logger].wait_for([
+    #  [ :processes, :terminated, { :wfid => @wfid } ],
+    #  [ :errors, nil, { :wfid => @wfid } ]
+    #])
+    sleep 0.5
+
+    @tracer.to_s.should == "bar"
+  end
+end
+
+describe "Filtering workitems" do
+  describe "on participants" do
+    before(:each) do
+      @wfid = launch_test_process do
+        Ruote.process_definition :name => 'test' do
+          concurrence do
+            jack :activity => 'Fetch a pale'
+            jill :activity => 'Chase Jack'
+            well :activity => 'Ready water'
+          end
+        end
+      end
+    end
+
+    it "should narrow results down to a single participant (JSON)" do
+      get '/_ruote/workitems.json', :participant => 'jack'
+
+      last_response.should be_ok
+
+      last_response.json_body['workitems'].size.should be(1)
+    end
+
+    it "should narrow results down to a single participant (HTML)" do
+      get '/_ruote/workitems', :participant => 'jack'
+
+      last_response.should be_ok
+    end
+
+    it "should narrow results down to multiple participants (JSON)" do
+      get "/_ruote/workitems.json", :participant => 'jack,jill'
+
+      last_response.should be_ok
+
+      last_response.json_body['workitems'].size.should be(2)
+    end
+
+    it "should narrow results down to multiple participants (HTML)" do
+      get "/_ruote/workitems", :participant => 'jack,jill'
+
+      last_response.should be_ok
+    end
+  end
+end

data/spec/ruote-kit_spec.rb

@@ -0,0 +1,4 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe RuoteKit do
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--colour
+--debugger