bumbleworks-api 0.0.1

data/spec/controllers/trackers_controller_spec.rb

@@ -0,0 +1,25 @@
+describe Bumbleworks::Api::TrackersController do
+  before(:each) do
+    Bumbleworks.launch!('waiting_process')
+    wait_until { Bumbleworks::Tracker.count == 5 }
+  end
+
+  describe "#index" do
+    it "returns all existing trackers" do
+      get "/trackers"
+      expect(last_response.body).to eq(
+        json_presentation_of(Bumbleworks::Tracker.all, :as => 'Tracker')
+      )
+    end
+  end
+
+  describe "#show" do
+    it "returns requested instance" do
+      tracker = Bumbleworks::Tracker.all.first
+      get "/trackers/#{tracker.id}"
+      expect(last_response.body).to eq(
+        json_presentation_of(tracker, :as => 'Tracker')
+      )
+    end
+  end
+end

data/spec/controllers/workers_controller_spec.rb

@@ -0,0 +1,113 @@
+describe Bumbleworks::Api::WorkersController do
+  before(:each) do
+    Bumbleworks.start_worker!
+    allow(Time).to receive(:now).and_return(Time.now)
+  end
+
+  describe "#index" do
+    it "returns all workers" do
+      allow(Time).to receive(:now).and_return(Time.now)
+      workers = Bumbleworks::Worker::Info.all
+      expect(Bumbleworks::Worker).to receive(:refresh_worker_info)
+      get "/workers"
+      expect(last_response.body).to eq(
+        json_presentation_of(workers, :as => 'Worker')
+      )
+    end
+  end
+
+  describe "#show" do
+    it "returns requested worker" do
+      worker = Bumbleworks::Worker::Info.first
+      expect(Bumbleworks::Worker).to receive(:refresh_worker_info)
+      get "/workers/#{worker.id}"
+      expect(last_response.body).to eq(
+        json_presentation_of(worker, :as => 'Worker')
+      )
+    end
+  end
+
+  describe "#change_state" do
+    let(:worker) { Bumbleworks::Worker::Info.first }
+    before(:each) do
+      allow(Bumbleworks::Worker::Info).to receive(:[]).
+        with(worker.id).and_return(worker)
+    end
+
+    it "sends shutdown to given worker" do
+      expect(worker).to receive(:shutdown)
+      put "/workers/#{worker.id}/command/shutdown"
+      expect(last_response.body).to eq(
+        { "status" => "shutdown sent" }.to_json
+      )
+    end
+
+    it "sends pause to given worker" do
+      expect(worker).to receive(:pause)
+      put "/workers/#{worker.id}/command/pause"
+      expect(last_response.body).to eq(
+        { "status" => "pause sent" }.to_json
+      )
+    end
+
+    it "sends unpause to given worker" do
+      expect(worker).to receive(:unpause)
+      put "/workers/#{worker.id}/command/unpause"
+      expect(last_response.body).to eq(
+        { "status" => "unpause sent" }.to_json
+      )
+    end
+
+    it "returns 404 if unknown command is sent" do
+      put "/workers/#{worker.id}/command/dance"
+      expect(last_response.body).to eq(
+        { :error => "not_found" }.to_json
+      )
+      expect(last_response.status).to eq(404)
+    end
+  end
+
+  describe "#change_global_state" do
+    it "sends shutdown to all workers" do
+      expect(Bumbleworks::Worker).to receive(:shutdown_all)
+      put "/workers/command/shutdown"
+      expect(last_response.body).to eq(
+        { "status" => "shutdown sent" }.to_json
+      )
+    end
+
+    it "sends pause to all workers" do
+      expect(Bumbleworks::Worker).to receive(:pause_all)
+      put "/workers/command/pause"
+      expect(last_response.body).to eq(
+        { "status" => "pause sent" }.to_json
+      )
+    end
+
+    it "sends unpause to all workers" do
+      expect(Bumbleworks::Worker).to receive(:unpause_all)
+      put "/workers/command/unpause"
+      expect(last_response.body).to eq(
+        { "status" => "unpause sent" }.to_json
+      )
+    end
+
+    it "returns 404 if unknown command is sent" do
+      put "/workers/command/dance"
+      expect(last_response.body).to eq(
+        { :error => "not_found" }.to_json
+      )
+      expect(last_response.status).to eq(404)
+    end
+  end
+
+  describe "#prune_stopped_workers" do
+    it "prunes stale worker info" do
+      expect(Bumbleworks::Worker::Info).to receive(:purge_stale_worker_info)
+      delete "/workers/prune"
+      expect(last_response.body).to eq(
+        { :status => "pruned_stale_worker_info" }.to_json
+      )
+    end
+  end
+end

data/spec/fixtures/bumbleworks_config.rb

@@ -0,0 +1,10 @@
+require_relative 'entities/widget'
+require_relative 'entities/widgety_fidget'
+
+Bumbleworks.configure do |c|
+  c.storage = {}
+  c.root = File.dirname(__FILE__)
+end
+
+Bumbleworks.bootstrap!
+Bumbleworks.initialize!

data/spec/fixtures/entities/mock_entity.rb

@@ -0,0 +1,38 @@
+class MockEntity
+  class << self
+    def collection
+      @collection ||= {}
+    end
+
+    def all
+      collection.values
+    end
+
+    def truncate!
+      @collection = {}
+    end
+
+    def first_by_identifier(identifier)
+      collection[identifier.to_i]
+    end
+
+    def count
+      all.count
+    end
+  end
+
+  def initialize(identifier)
+    @identifier = identifier
+    self.class.collection[identifier] = self
+  end
+
+  def id
+    @identifier
+  end
+
+  def update(hsh)
+    hsh.each do |key, value|
+      self.send(:"#{key}=", value)
+    end
+  end
+end

data/spec/fixtures/entities/widget.rb

@@ -0,0 +1,9 @@
+require_relative 'mock_entity'
+
+class Widget < MockEntity
+  include Bumbleworks::Entity
+
+  process :task_process
+
+  attr_accessor :task_process_identifier
+end

data/spec/fixtures/entities/widgety_fidget.rb

@@ -0,0 +1,5 @@
+require_relative 'mock_entity'
+
+class WidgetyFidget < MockEntity
+  include Bumbleworks::Entity
+end

data/spec/fixtures/participants.rb

@@ -0,0 +1,3 @@
+Bumbleworks.register_participants do
+  fall_apart NaughtyParticipant
+end

data/spec/fixtures/participants/naughty_participant.rb

@@ -0,0 +1,16 @@
+class NaughtyParticipant
+  class StupidError < StandardError; end
+  include Bumbleworks::LocalParticipant
+
+  class << self
+    attr_accessor :naughty_is_ok
+  end
+
+  def on_workitem
+    if self.class.naughty_is_ok
+      reply
+    else
+      raise StupidError, 'Oh crumb.'
+    end
+  end
+end

data/spec/fixtures/processes/error_process.rb

@@ -0,0 +1,3 @@
+Bumbleworks.define_process do
+  fall_apart
+end

data/spec/fixtures/processes/task_process.rb

@@ -0,0 +1,9 @@
+Bumbleworks.define_process do
+  concurrence do
+    admin :task => 'do_something'
+    peon :task => 'do_something_dumb'
+  end
+  fall_apart
+  peon :task => 'meekly_do_another_thing'
+  admin :task => 'confront'
+end

data/spec/fixtures/processes/waiting_process.rb

@@ -0,0 +1,8 @@
+Bumbleworks.define_process do
+  concurrence do
+    wait_for_event :the_event, :where => :entities_match
+    await :left_tag => 'local_event'
+    await :error => /bad/
+    await :participant => %w[goose bunnies]
+  end
+end

data/spec/lib/presenter_spec.rb

@@ -0,0 +1,29 @@
+describe Bumbleworks::Api::Presenter do
+  describe ".from_array" do
+    it "maps each object to its presentation, passing in_collection arg" do
+      allow(described_class).to receive(:new).
+        with(:a, :in_collection => true).
+        and_return(:a_p)
+      allow(described_class).to receive(:new).
+        with(:b, :in_collection => true).
+        and_return(:b_p)
+      expect(described_class.from_array([:a, :b])).to eq(
+        [:a_p, :b_p]
+      )
+    end
+  end
+
+  describe ".present" do
+    it "instantiates single presenter if not given array" do
+      allow(described_class).to receive(:new).with(:a).and_return(:a_p)
+      expect(described_class.present(:a)).to eq(:a_p)
+    end
+
+    it "returns result of .from_array if given array" do
+      allow(described_class).to receive(:from_array).
+        with([:a, :b]).
+        and_return(:presented_array)
+      expect(described_class.present([:a, :b])).to eq(:presented_array)
+    end
+  end
+end

data/spec/lib/presenters/entity_class_presenter_spec.rb

@@ -0,0 +1,17 @@
+describe Bumbleworks::Api::EntityClassPresenter do
+  let(:presented) { Widget }
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of entity class" do
+      allow(presented).to receive(:count).and_return(10)
+      expect(subject.to_hash).to eq({
+        :class => 'Widget',
+        :count => 10,
+        :registered_processes => [
+          { :name => :task_process, :attribute => :task_process_identifier }
+        ]
+      })
+    end
+  end
+end

data/spec/lib/presenters/entity_presenter_spec.rb

@@ -0,0 +1,15 @@
+describe Bumbleworks::Api::EntityPresenter do
+  let(:presented) { Widget.new(42) }
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of entity class" do
+      allow(presented).to receive(:processes).and_return([:a, :b])
+      expect(subject.to_hash).to eq({
+        :identifier => 42,
+        :name => "Widget 42",
+        :process_count => 2
+      })
+    end
+  end
+end

data/spec/lib/presenters/error_presenter_spec.rb

@@ -0,0 +1,18 @@
+describe Bumbleworks::Api::ErrorPresenter do
+  let(:presented) { Bumbleworks.errors.first }
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of error" do
+      process = Bumbleworks.launch!('error_process')
+      wait_until { Bumbleworks.errors.count == 1 }
+      expect(subject.to_hash).to eq({
+        :process_id => process.id,
+        :expression_id => presented.expression.expid,
+        :error_class_name => "NaughtyParticipant::StupidError",
+        :message => "Oh crumb.",
+        :backtrace => presented.backtrace
+      })
+    end
+  end
+end

data/spec/lib/presenters/expression_presenter_spec.rb

@@ -0,0 +1,33 @@
+describe Bumbleworks::Api::ExpressionPresenter do
+  let(:process) { Bumbleworks.launch!('task_process') }
+  let(:presented) { process.expression_at_position('0_0_1') }
+
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of expression" do
+      wait_until { process.tasks.count == 2 }
+      expect(subject.to_hash).to eq({
+        :expression_id => presented.expid,
+        :process_id => presented.process.id,
+        :tree => presented.tree
+      })
+    end
+
+    context "with error" do
+      let(:process) { Bumbleworks.launch!('error_process') }
+      let(:presented) { process.expression_at_position('0_0') }
+
+      it "includes presented error" do
+        wait_until { process.reload.errors.count == 1 }
+        error = Bumbleworks.errors.first
+        expect(subject.to_hash).to eq({
+          :expression_id => presented.expid,
+          :process_id => presented.process.id,
+          :tree => presented.tree,
+          :error => Bumbleworks::Api::ErrorPresenter.present(error).to_hash
+        })
+      end
+    end
+  end
+end

data/spec/lib/presenters/process_presenter_spec.rb

@@ -0,0 +1,42 @@
+describe Bumbleworks::Api::ProcessPresenter do
+  let(:presented) { Bumbleworks.launch!('task_process', :entity => widget) }
+  let(:widget) { Widget.new(41) }
+
+  describe "#to_hash" do
+    context "not in collection" do
+      subject { described_class.new(presented) }
+
+      it "returns full hash representation of process" do
+        wait_until { presented.tasks.count == 2 }
+        expect(subject.to_hash).to eq({
+          :id => presented.id,
+          :definition_name => "task_process",
+          :subscribed_events => [],
+          :entity => Bumbleworks::Api::EntityPresenter.present(widget).to_hash,
+          :entity_name => widget.to_s,
+          :original_tree => presented.original_tree
+        })
+      end
+
+      it "doesn't include entity if process has none" do
+        wait_until { presented.tasks.count == 2 }
+        allow(presented).to receive(:entity).and_return(nil)
+        expect(subject.to_hash.keys).not_to include(:entity)
+      end
+    end
+
+    context "in collection" do
+      subject { described_class.new(presented, :in_collection => true) }
+
+      it "returns minimal hash representation of process" do
+        wait_until { presented.tasks.count == 2 }
+        expect(subject.to_hash).to eq({
+          :id => presented.id,
+          :definition_name => "task_process",
+          :entity_name => widget.to_s,
+          :subscribed_events => []
+        })
+      end
+    end
+  end
+end

data/spec/lib/presenters/task_presenter_spec.rb

@@ -0,0 +1,18 @@
+describe Bumbleworks::Api::TaskPresenter do
+  let(:process) { Bumbleworks.launch!('task_process') }
+  let(:presented) { process.tasks.next_available }
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of entity class" do
+      presented.claim('oscar')
+      expect(subject.to_hash).to eq({
+        :id => presented.id,
+        :name => presented.to_s,
+        :claimant => 'oscar',
+        :process_id => presented.wfid,
+        :role => presented.role
+      })
+    end
+  end
+end

data/spec/lib/presenters/tracker_presenter_spec.rb

@@ -0,0 +1,18 @@
+describe Bumbleworks::Api::TrackerPresenter do
+  let(:process) { Bumbleworks.launch!('waiting_process') }
+  let(:presented) { Bumbleworks::Tracker.all.first }
+  subject { described_class.new(presented) }
+
+  describe "#to_hash" do
+    it "returns hash representation of entity class" do
+      expect(subject.to_hash).to eq({
+        :id => presented.id,
+        :waiting_expression => presented.waiting_expression,
+        :original_hash => presented.original_hash,
+        :action => presented.action,
+        :conditions => presented.conditions,
+        :process_id => presented.wfid
+      })
+    end
+  end
+end