baldrick 0.0.1 → 0.0.2

data/History.txt

@@ -1,3 +1,7 @@
+== 0.0.2 2009-10-14
+
+* Remove parenthesis warning under 1.8.6
+
 == 0.0.1 2009-02-24
 
 * 1 major enhancement:

data/Manifest.txt

@@ -2,17 +2,41 @@ History.txt
 Manifest.txt
 README.rdoc
 Rakefile
+TODO.txt
+features/follow_feed_orders.feature
+features/follow_injour_orders.feature
+features/resources/a_feed_servant
+features/resources/common_configuration
+features/resources/feed_server
+features/resources/injour_servant
+features/steps/feed_steps.rb
+features/steps/helpers/command_output.rb
+features/steps/helpers/scenario_process.rb
+features/steps/injour_steps.rb
+features/steps/order_steps.rb
+features/steps/servant_steps.rb
+features/support/env.rb
 lib/baldrick.rb
-lib/baldrick_serve.rb
 lib/baldrick/command.rb
-lib/baldrick/run_servant.rb
-lib/baldrick/servant.rb
-lib/baldrick/task.rb
 lib/baldrick/listeners/feed_listener.rb
 lib/baldrick/listeners/feed_orders.rb
 lib/baldrick/listeners/injour_listener.rb
 lib/baldrick/listeners/xpath_locator.rb
+lib/baldrick/run_servant.rb
+lib/baldrick/servant.rb
+lib/baldrick/task.rb
+lib/baldrick_serve.rb
 script/console
 script/destroy
 script/generate
-tasks/rspec.rake
+spec/lib/baldrick/command_spec.rb
+spec/lib/baldrick/listeners/feed_listener_spec.rb
+spec/lib/baldrick/listeners/feed_orders_spec.rb
+spec/lib/baldrick/listeners/injour_listener_spec.rb
+spec/lib/baldrick/listeners/xpath_locator_spec.rb
+spec/lib/baldrick/run_servant_spec.rb
+spec/lib/baldrick/servant_spec.rb
+spec/lib/baldrick/task_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/rspec.rake

data/README.rdoc

@@ -1,16 +1,18 @@
 = Baldrick
 
 * http://github.com/brentsnook/baldrick
+* http://groups.google.com/group/baldrick
+* http://baldrick.lighthouseapp.com
 
-A dogsbody. Does what you tell it.
+== Description
+
+A dogsbody. Does what you tell it. Use it to glue things together.
 
 Baldrick recognises orders and then performs appropriate tasks.
 Baldrick acts as the glue between the source of the order (for example a twitter Atom feed) and the task you would like performed (put the kettle on).
 
 == Installation
 
-<em>Note: the rubyforge project application is currently being considered. First gem should be up within a few days. Please build yourself in the meantime - 2009-02-23</em>
-
 Make Baldrick cower 'neath *your* boot:
 
   sudo gem install baldrick
@@ -25,7 +27,7 @@ Grab the code from github:
   cd baldrick
   rake install_gem
 
-== How does it work?
+== Synopsis
 
 You tell Baldrick:
 
@@ -70,7 +72,7 @@ Don't look at me, I just made it. How about these for suggestions?
 * control a continuous integration build light
 * control a nuclear power plant
 
-I'd love to hear what you use it for.
+We want to know what you use it for, please send us some love on the {google group}[http://groups.google.com/group/baldrick].
 
 == License
 

data/Rakefile

@@ -1,30 +1,31 @@
-%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+%w[rubygems rake rake/clean hoe fileutils newgem rubigen].each { |f| require f }
 require File.dirname(__FILE__) + '/lib/baldrick'
 
-# Generate all the Rake tasks
-# Run 'rake -T' to see list of generated tasks (from gem root directory)
-$hoe = Hoe.new('baldrick', Baldrick::VERSION) do |p|
-  p.developer 'Brent Snook', 'brent@fuglylogic.com'
-  p.summary = %q{Does what you tell it - glues orders to tasks.}
-  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
-  p.rubyforge_name = p.name
-  p.extra_deps = [
+Hoe.spec 'baldrick' do
+  version = Baldrick::VERSION
+  developer 'Brent Snook', 'brent@fuglylogic.com'
+  self.readme_file = 'README.rdoc'
+  self.clean_globs |= %w[**/.DS_Store tmp *.log]
+  self.rsync_args = '-av --delete --ignore-errors' # is this needed?
+  
+  self.extra_deps = [
     ['nokogiri','>= 1.1.1'],
   ]
-  p.extra_dev_deps = [
+  
+  self.extra_dev_deps = [
     ['newgem', ">= #{::Newgem::VERSION}"],
     ['rspec', '>= 1.1.12'],
-    ['cucumber', '>= 0.1.16'],
-    ['injour', '>= 0.2.3'],
+    ['cucumber', '>= 0.1.16']
   ]
-  
-  p.clean_globs |= %w[**/.DS_Store tmp *.log]
-  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
-  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
-  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
 end
 
 require 'newgem/tasks' # load /tasks/*.rake
 Dir['tasks/**/*.rake'].each { |t| load t }
 
-task :default => [:spec, :features]
+task :default => [:spec, :features]
+

data/TODO.txt

@@ -0,0 +1,40 @@
+
+- add website - 2
+  - turnip logo
+  - how to include documentation from wiki? Just link?
+
+- merge README and wiki page - 1
+
+- create google group - 1
+
+- test on various feeds - 1
+
+- test on cruise.rb
+- test on slashdot
+- test on twitter
+- test on thinkgeek
+
+
+X
+- set up rubyforge account
+- publish gem to rubyforge
+- test install from rubyforge - 2 '''
+
+- create tag of first release
+
+
+
+
+????
+
+- should I package specs and features in my manifest?
+- how is the gemspec used? Do I need one?
+
+LATER
+
+- add a spec around run_servant
+- add ability to pass in feed listener xpath expressions for who, what, where, when during configuration
+- fix bug: displaying multiple stack traces after error
+- better way to log error with listener than puts
+
+

data/features/follow_feed_orders.feature

@@ -0,0 +1,9 @@
+Feature: Follow feed orders
+  In order to allow tasks to be triggered from RSS
+  As a person interested in a web feed
+  I want new RSS items to be followed as orders
+    
+  Scenario: Feed item contains a new order
+    Given a servant is listening for orders from a feed
+    When a new item appears in the feed containing an order
+    Then the order is followed

data/features/follow_injour_orders.feature

@@ -0,0 +1,9 @@
+Feature: Follow injour orders
+  In order to trigger tasks by changing my status message
+  As an injour user
+  I want orders in my status message to be followed
+    
+  Scenario: Status message contains a new order
+    Given a servant is listening for orders from injour
+    When an injour status is changed to contain an order
+    Then the order is followed

data/features/resources/a_feed_servant

@@ -0,0 +1,2 @@
+load File.dirname(__FILE__) + '/common_configuration'
+listen_to :feed, :at => 'http://localhost:1726/rss'

data/features/resources/common_configuration

@@ -0,0 +1,10 @@
+# as with all servant files, don't give this file a .rb extension or cucumber will try to require it resulting in the server starting when you don't want it to
+
+require File.dirname(__FILE__) + '/../../lib/baldrick_serve'
+require File.dirname(__FILE__) + '/../steps/helpers/command_output'
+
+listen_every 0.5
+
+on_hearing /follow an order/m do
+  CommandOutput.add 'Order followed'
+end

data/features/resources/feed_server

@@ -0,0 +1,30 @@
+require 'webrick'
+
+server = WEBrick::HTTPServer.new :Port => 1726
+
+server.mount_proc("/rss") do |request, response|
+  response.body = <<-RSS
+<?xml version="1.0"?>
+<rss version="2.0">
+  <channel>
+    <item>
+      <title>hey you, follow an order</title>
+      <link></link>
+      <description></description>
+      <pubDate>Tue, 20 Apr 2000 04:00:00 GMT</pubDate>
+      <guid></guid>
+    </item>
+  </channel>
+</rss>
+RSS
+  response['Content-Type'] = 'text/xml' 
+end
+
+%w(INT TERM).each do |signal|
+  trap signal do
+    server.shutdown
+    exit!
+  end
+end
+
+server.start

data/features/resources/injour_servant

@@ -0,0 +1,2 @@
+load File.dirname(__FILE__) + '/common_configuration'
+listen_to :injour

data/features/steps/feed_steps.rb

@@ -0,0 +1,4 @@
+When 'a new item appears in the feed containing an order' do
+  server = File.dirname(__FILE__) + "/../resources/feed_server"
+  ScenarioProcess.run "ruby #{server}", 'feed_server'
+end

data/features/steps/helpers/command_output.rb

@@ -0,0 +1,33 @@
+class CommandOutput
+
+  OUTPUT_FILE = File.expand_path(File.dirname(__FILE__) + '/../../../tmp/command_output')
+
+  TIMEOUT = 10
+
+  def self.contents
+    wait_for {File.exists? OUTPUT_FILE and !file_contents.empty?}
+    file_contents
+  end
+
+  def self.clear
+    FileUtils.rm OUTPUT_FILE, :force => true
+  end
+ 
+  def self.add output
+    File.open(OUTPUT_FILE, 'a') {|f| f.write(output) }
+  end
+
+  private
+
+  def self.wait_for &condition
+    time_spent = 0
+    until yield or time_spent > TIMEOUT   
+      sleep 0.5
+      time_spent += 0.5
+    end
+  end
+
+  def self.file_contents
+    File.read OUTPUT_FILE
+  end
+end

data/features/steps/helpers/scenario_process.rb

@@ -0,0 +1,37 @@
+class ScenarioProcess
+
+  @commands = []
+
+  def self.run command, name
+    log = File.expand_path(File.dirname(__FILE__) + "/../../../tmp/#{name}.log")
+    FileUtils.rm log, :force => true
+    process = IO.popen "(#{command}) > #{log} 2>&1"
+    process.sync = true
+    wait_for log
+
+    @commands << command
+  end
+
+  def self.kill_all
+    # this method of killing stuff sucks, feels error prone
+    @commands.each do |command|
+      `ps`.each do |process|
+        # the space at the front of the pattern is essential...
+        # otherwise this will only work intermittently; if the pid you want to kill
+        # is shorter than others in the process list then the group will not capture it        
+        matches = process.match /\s*(\d*).*#{Regexp.escape(command)}/
+        `kill #{matches[1]}` if matches
+      end
+    end  
+  end
+
+  private
+
+  def self.wait_for file
+    until File.exists? file
+      sleep 0.2
+    end
+    
+  end
+
+end

data/features/steps/injour_steps.rb

@@ -0,0 +1,4 @@
+When 'an injour status is changed to contain an order' do
+  ScenarioProcess.run 'injour serve baldrickfeature 43216', 'injour_server'
+  ScenarioProcess.run 'injour status hey you, follow an order', 'injour_status'
+end

data/features/steps/order_steps.rb

@@ -0,0 +1,3 @@
+Then 'the order is followed' do
+  CommandOutput.contents.should include('Order followed')
+end

data/features/steps/servant_steps.rb

@@ -0,0 +1,5 @@
+Given 'a servant is listening for orders from $listener' do |listener|
+  servant = File.dirname(__FILE__) + "/../resources/#{listener.downcase.gsub(' ', '_')}_servant"
+
+  ScenarioProcess.run "ruby #{servant}", 'servant'
+end

data/features/support/env.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/../../lib/baldrick'
+
+gem 'cucumber'
+require 'cucumber'
+gem 'rspec'
+require 'spec'
+
+Before do
+  CommandOutput.clear
+end
+
+After do
+  ScenarioProcess.kill_all
+end
+

data/lib/baldrick.rb

@@ -2,7 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module Baldrick
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end
 
 require 'baldrick/listeners/xpath_locator'

data/lib/baldrick/listeners/xpath_locator.rb

@@ -5,7 +5,7 @@ module Baldrick::Listeners
   class XPathLocator
     
     def self.from_xml xml
-      from_node Nokogiri::XML(strip_default_namespaces_from xml)
+      from_node Nokogiri::XML(strip_default_namespaces_from(xml))
     end  
     
     def self.from_node node

data/spec/lib/baldrick/command_spec.rb

@@ -0,0 +1,115 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Baldrick
+
+describe Command do
+
+  before :each do
+    @servant = mock('servant', :null_object => true)
+    Servant.stub!(:new).and_return @servant
+    @stdout = stub('stdout', :null_object => true)
+    
+    # including Singleton marks new as private but I still want to instantiate it for testing
+    # nasty, I know
+    @command = Command.send(:new)
+  end
+  
+  describe 'when executing' do
+  
+    it 'registers the injour listener type by default' do
+      @command.listener_class_for(:injour).should == Listeners::InjourListener
+    end
+    
+    it 'registers the feed listener type by default' do
+      @command.listener_class_for(:feed).should == Listeners::FeedListener
+    end  
+    
+    it 'displays a startup message' do
+      @command.stub!(:should_serve?).and_return false
+    
+      @stdout.should_receive(:<<).with /started/
+    
+      @command.execute @stdout
+    end
+  
+    it 'tells the servant to serve repeatedly' do
+      @command.stub!(:should_serve?).and_return true, true, false
+      @command.stub!(:sleep)
+    
+      @servant.should_receive(:serve).twice
+    
+      @command.execute @stdout  
+    end
+  
+    it 'waits for 2 seconds between service by default' do
+      @command.stub!(:should_serve?).and_return true, false
+  
+      @command.should_receive(:sleep).with(2)
+    
+      @command.execute @stdout
+    end
+  
+    it 'allows wait period between service to be specified' do
+      @command.stub!(:should_serve?).and_return true, false
+      @command.listen_every 10
+  
+      @command.should_receive(:sleep).with(10)
+    
+      @command.execute @stdout
+    end   
+  end
+  
+  describe 'configuration' do
+    
+    it 'can be told of how to listen for orders of a particular type' do
+      @command.register_listener_type :type, (listener_class = mock('listener class'))
+  
+      @command.listener_class_for(:type).should == listener_class
+    end
+
+    describe 'when told where to listen for orders' do
+    
+      it 'adds a new listener of a recognised type to the servant' do
+        listener_class = stub('listener class', :new => (listener = mock('listener')))
+        @command.stub!(:listener_class_for).with(:recognised_type).and_return listener_class
+        
+        @servant.should_receive(:add_listener).with listener
+    
+        @command.listen_to :recognised_type
+      end
+          
+      it 'configures a new listener with given options' do
+        listener_class = stub 'listener class'
+        @command.stub!(:listener_class_for).with(:listener_type).and_return listener_class
+        @servant.stub! :add_listener
+          
+        listener_class.should_receive(:new).with({:option => true})
+          
+        @command.listen_to :listener_type, :option => true
+      end
+          
+      it 'fails if the listener type is not recognised' do
+        @command.stub!(:listener_class_for).with(:unrecognised_type).and_return nil
+          
+        lambda{@command.listen_to :unrecognised_type}.should raise_error(RuntimeError, 'No order listener implementation found for unrecognised_type')
+      end
+    
+    end
+    
+    describe 'when told how to perform a task' do
+      
+      %w{to on_hearing}.each do |to_alias|
+      
+        it "adds a new task to the servant using the instructions given via '#{to_alias}'" do
+          procedure = lambda {}
+          Task.stub!(:new).with(/put the kettle on/, procedure).and_return(task = stub('job'))
+    
+          @servant.should_receive(:add_task).with task
+    
+          @command.send to_alias, /put the kettle on/, &procedure
+        end
+      
+      end
+    end
+  end
+end

data/spec/lib/baldrick/listeners/feed_listener_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+
+include Baldrick::Listeners
+
+describe FeedListener do
+
+  before(:each) do
+    @listener = FeedListener.new :at => ''
+  end
+
+  it 'allows RSS URL to be specified' do
+    @listener = FeedListener.new :at => 'http://billywitchdoctor.com/rss' 
+    FeedOrders.stub!(:within).and_return []
+    
+    @listener.should_receive(:open).with 'http://billywitchdoctor.com/rss'
+  
+    @listener.orders  
+  end  
+  
+  it 'only return orders newer than that last stored' do
+    
+    now = Time.now
+    old_news = {:what => 'shake has gone...', :when => now}
+    new_news = {:what => 'newsflash! the drizzle is coming', :when => now + 1}
+    stale_news = {:what => 'carl is incredibly lonely', :when => now - 1}
+    latest_news = {:what => 'the drizzle is the shizzle!', :when => now + 2}
+
+    @listener.stub! :open
+    FeedOrders.stub!(:within).and_return [old_news], [old_news, new_news, stale_news, latest_news]
+
+    @listener.orders
+    
+    @listener.orders.should == [new_news, latest_news]    
+  end
+  
+  it "handles orders with no 'when' specified" do
+    @listener.stub! :open
+    FeedOrders.stub!(:within).and_return  [{:what => 'shake has gone...', :when => nil}]
+
+    @listener.orders 
+  end  
+   
+end  

data/spec/lib/baldrick/listeners/feed_orders_spec.rb

@@ -0,0 +1,63 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+
+include Baldrick::Listeners
+
+describe FeedOrders do
+  
+  before :each do
+    @item_locator = mock('item locator')
+    XPathLocator.stub!(:from_xml).and_return @item_locator
+  end
+  
+  it 'first searches items then elements for orders' do
+    @item_locator.should_receive(:find_nodes_matching).with('//item', '//entry').and_return []
+    
+    FeedOrders.within ''
+  end
+  
+  it 'creates an order for every item found' do
+    node = stub 'node', :null_object => true
+    @item_locator.stub!(:find_nodes_matching).and_return [node, node, node]
+    
+    FeedOrders.within('').size.should == 3
+  end   
+  
+  describe 'when creating an order' do
+  
+    before :each do
+      @node = stub 'node', :null_object => true
+      @item_locator.stub!(:find_nodes_matching).and_return [@node]
+      @text_locator = stub('item locator', :null_object => true)
+      XPathLocator.stub!(:from_node).and_return @text_locator
+      
+      @time = Time.now
+      Time.stub!(:parse).and_return @time
+    end
+      
+    it "parses the publish time and use it as 'when'" do
+      Time.stub!(:parse).with(@time.to_s).and_return @time
+      @text_locator.stub!(:find_text_matching).with('published/text()', 'pubDate/text()', 'date/text()', 'updated/text()').and_return @time.to_s
+      
+      FeedOrders.within('').first[:when].should == @time  
+    end  
+    
+    it "uses the contents of the item as 'what'" do
+      @text_locator.stub!(:find_text_matching).and_return stub('text', :null_object => true)
+      @node.stub!(:to_s).and_return 'item node contents'
+             
+      FeedOrders.within('').first[:what].should == 'item node contents'
+    end
+    
+    it "uses the author as the 'who'" do
+      @text_locator.stub!(:find_text_matching).with('author/name/text()', 'author/text()').and_return 'Alan Moore'
+             
+      FeedOrders.within('').first[:who].should == 'Alan Moore'     
+    end  
+    
+    it "uses the link as the 'where'" do
+      @text_locator.stub!(:find_text_matching).with('link/text()', "link[@rel='alternate']/@href").and_return 'http://internet.com'
+             
+      FeedOrders.within('').first[:where].should == 'http://internet.com'      
+    end  
+  end
+end

data/spec/lib/baldrick/listeners/injour_listener_spec.rb

@@ -0,0 +1,82 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+
+include Baldrick::Listeners
+
+describe InjourListener do
+
+  before(:each) do
+    @listener = InjourListener.new
+    Time.stub!(:parse)
+  end
+
+  it 'only return new orders' do
+
+    first_status = <<-FIRST_STATUS
+=== nathan on dk3.mordhaus.net:43215 ===
+* [05-Feb-2009 11:30 PM] i like chips
+FIRST_STATUS
+    second_status = <<-SECOND_STATUS
+=== nathan on dk3.mordhaus.net:43215 ===
+* [05-Feb-2009 11:30 PM] i like chips
+=== murderface on dk4.mordhaus.net:43215 ===
+* [05-Feb-2009 11:31 PM] no kidding
+SECOND_STATUS
+
+    @listener.stub!(:`).with('injour ls').and_return first_status, second_status
+
+    @listener.orders
+
+    @listener.orders.should == [
+      {
+        :who => 'murderface',
+        :what => 'no kidding',
+        :where => 'dk4.mordhaus.net:43215',
+        :when => nil
+      }]
+  end
+  
+  it 'handles multiple orders from a single user' do
+
+    status = <<-STATUS
+=== skwisgaar on dk5.mordhaus.net:43215 ===
+* [05-Feb-2009 11:30 PM] stops copies me!
+=== skwisgaar on dk5.mordhaus.net:43215 ===
+* [05-Feb-2009 11:31 PM] I means its, stops copies me!
+=== skwisgaar on dk5.mordhaus.net:43215 ===
+* [05-Feb-2009 11:32 PM] STOPS COPIES ME!
+STATUS
+
+    @listener.stub!(:`).with('injour ls').and_return status
+
+    @listener.orders.collect{|order| order[:what]}.should == ['stops copies me!', 'I means its, stops copies me!', 'STOPS COPIES ME!']
+  end 
+  
+  describe 'reading individual parts of an order' do
+    
+    before :each do
+      status = <<-STATUS
+=== twinkletits on dk6.mordhaus.net:43215 ===
+* [05-Feb-2009 11:30 PM] who wants a banana sticker?
+STATUS
+      @listener.stub!(:`).with('injour ls').and_return status
+
+      @order = @listener.orders.first
+    end
+    
+    it "interprets injour user as 'who'" do
+      @order[:who].should == 'twinkletits'
+    end 
+
+    it "interprets status as 'what'" do
+      @order[:what].should == 'who wants a banana sticker?'
+    end
+
+    it "interprets injour address as 'where'" do
+      @order[:where].should == 'dk6.mordhaus.net:43215'
+    end
+       
+    it "interprets parsed time as 'when'" do
+      @order[:when].should == Time.parse('05-Feb-2009 11:30 PM')
+    end
+  end
+end

data/spec/lib/baldrick/listeners/xpath_locator_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+
+include Baldrick::Listeners
+
+describe XPathLocator do
+
+  describe 'when created' do
+ 
+    it 'allows a new locator to be created from an XML string' do
+      locator = XPathLocator.from_xml '<root><child/></root>'
+    
+      locator.find_nodes_matching('//child').should_not be_empty
+    end  
+    
+    it 'allows a new locator to be created from a previously returned node' do
+      node = XPathLocator.from_xml('<root><child><grandchild/></child></root>').find_nodes_matching('//child').first
+      locator = XPathLocator.from_node node 
+    
+      locator.find_nodes_matching('//grandchild').should_not be_empty  
+    end 
+  end
+  
+  describe 'when finding nodes' do
+  
+    it 'finds all nodes matching any of the given xpath expressions' do
+      locator = XPathLocator.from_xml '<root><match/></root>'
+      
+      locator.find_nodes_matching('//nomatches', '//match').size.should == 1    
+    end  
+  
+    it 'handles tags with a default namespace' do
+      locator = XPathLocator.from_xml '<root xmlns="http://namespace.com"><match/></root>'
+      
+      locator.find_nodes_matching('//match').size.should == 1      
+    end  
+    
+    it 'finds only the first text matching any of the given xpath expressions' do
+      locator = XPathLocator.from_xml '<root><match>first</match><match>second</match></root>'
+      
+      locator.find_text_matching('//match').should == 'first'      
+    end
+  end
+end  

data/spec/lib/baldrick/run_servant_spec.rb

@@ -0,0 +1,14 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Baldrick
+
+describe RunServant do
+  
+  describe 'when exiting' do
+    it 'rethrows any exceptions thrown in the script body'
+    it 'causes the command to execute'  
+  end
+  
+  it 'delegates all calls for missing methods to the command'   
+  it 'causes an interrupt to stop execution of the command'
+end

data/spec/lib/baldrick/servant_spec.rb

@@ -0,0 +1,45 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Baldrick
+
+describe Servant do
+
+  before(:each) do
+    @servant = Servant.new
+  end
+
+  it 'executes all orders from all listeners' do
+    2.times do |listener_number|
+      orders = [stub("order #{listener_number} a"), stub("order #{listener_number} b")]
+      listener = mock("listener #{listener_number}", :orders => orders)
+      @servant.add_listener listener
+
+      orders.each {|order| @servant.should_receive(:follow).with order}
+    end
+
+    @servant.serve
+  end
+
+  it 'performs all tasks for an executed order' do
+    order = stub('order')
+    @servant.add_listener mock('listener', :orders => [order])
+    2.times do |task_number|
+
+      @servant.add_task(task = mock("task #{task_number}"))
+
+      task.should_receive(:run).with order
+    end
+
+    @servant.serve
+  end
+  
+  it 'recovers from a problem with a listener and continues' do
+    @servant.add_listener(first_listener = mock('first listener'))
+    @servant.add_listener(second_listener = mock('second listener'))
+    first_listener.stub!(:orders).and_raise Exception
+    
+    second_listener.should_receive(:orders).and_return []
+
+    @servant.serve   
+  end
+end

data/spec/lib/baldrick/task_spec.rb

@@ -0,0 +1,64 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Baldrick
+
+describe Task do
+
+  it 'checks the what value of the command when determining whether or not to run' do
+    @matcher = mock('matcher')
+
+    @matcher.should_receive(:match).with 'what value'
+
+    run :what => 'what value'
+  end
+
+  it 'runs if order matches' do
+    @matcher = stub('matcher', :match => [''])
+    @procedure = stub('procedure', :arity => 1)
+
+    @procedure.should_receive :call
+
+    run ''
+  end
+
+  it "doesn't run if order does not match" do
+    @matcher = stub('matcher', :match => nil)
+    @procedure = stub('procedure', :arity => 1)
+
+    @procedure.should_not_receive :call
+
+    run ''
+  end
+
+  it 'only passes as many arguments as the procedure can handle' do
+    @matcher = stub('matcher', :match => ['', '1', '2', '3', '4'])
+    @procedure = stub('procedure', :arity => 3)
+
+    @procedure.should_receive(:call).with('1', '2', '3')
+
+    run ''
+  end
+
+  it "doesn't pass the matched string to the procedure" do
+    @matcher = stub('matcher', :match => ['matching string', '1', '2'])
+    @procedure = stub('procedure', :arity => 1)
+
+    @procedure.should_receive(:call).with('1')
+
+    run ''
+  end
+
+  it 'passes all matching portions of the command and the command to the procedure' do
+    @matcher = stub('matcher', :match => ['', 'com', 'mand'])
+    @procedure = stub('procedure', :arity => 3)
+
+    @procedure.should_receive(:call).with('com', 'mand', {:what => 'command'})
+
+    run :what => 'command'
+  end
+  
+  def run order
+    Task.new(@matcher, @procedure).run order  
+  end
+
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+profile
+--timeout
+20
+--diff

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+$:.unshift File.dirname(__FILE__)
+require 'baldrick'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: baldrick
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Brent Snook
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-24 00:00:00 +11:00
+date: 2009-10-14 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.3
+        version: 1.5.2
     version: 
 - !ruby/object:Gem::Dependency 
   name: rspec
@@ -52,16 +52,6 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.1.16
     version: 
-- !ruby/object:Gem::Dependency 
-  name: injour
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.2.3
-    version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
   type: :development
@@ -70,9 +60,13 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.8.0
+        version: 2.3.3
     version: 
-description: ""
+description: |-
+  A dogsbody. Does what you tell it. Use it to glue things together.
+  
+  Baldrick recognises orders and then performs appropriate tasks.
+  Baldrick acts as the glue between the source of the order (for example a twitter Atom feed) and the task you would like performed (put the kettle on).
 email: 
 - brent@fuglylogic.com
 executables: []
@@ -82,28 +76,54 @@ extensions: []
 extra_rdoc_files: 
 - History.txt
 - Manifest.txt
-- README.rdoc
+- TODO.txt
 files: 
 - History.txt
 - Manifest.txt
 - README.rdoc
 - Rakefile
+- TODO.txt
+- features/follow_feed_orders.feature
+- features/follow_injour_orders.feature
+- features/resources/a_feed_servant
+- features/resources/common_configuration
+- features/resources/feed_server
+- features/resources/injour_servant
+- features/steps/feed_steps.rb
+- features/steps/helpers/command_output.rb
+- features/steps/helpers/scenario_process.rb
+- features/steps/injour_steps.rb
+- features/steps/order_steps.rb
+- features/steps/servant_steps.rb
+- features/support/env.rb
 - lib/baldrick.rb
-- lib/baldrick_serve.rb
 - lib/baldrick/command.rb
-- lib/baldrick/run_servant.rb
-- lib/baldrick/servant.rb
-- lib/baldrick/task.rb
 - lib/baldrick/listeners/feed_listener.rb
 - lib/baldrick/listeners/feed_orders.rb
 - lib/baldrick/listeners/injour_listener.rb
 - lib/baldrick/listeners/xpath_locator.rb
+- lib/baldrick/run_servant.rb
+- lib/baldrick/servant.rb
+- lib/baldrick/task.rb
+- lib/baldrick_serve.rb
 - script/console
 - script/destroy
 - script/generate
+- spec/lib/baldrick/command_spec.rb
+- spec/lib/baldrick/listeners/feed_listener_spec.rb
+- spec/lib/baldrick/listeners/feed_orders_spec.rb
+- spec/lib/baldrick/listeners/injour_listener_spec.rb
+- spec/lib/baldrick/listeners/xpath_locator_spec.rb
+- spec/lib/baldrick/run_servant_spec.rb
+- spec/lib/baldrick/servant_spec.rb
+- spec/lib/baldrick/task_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
 - tasks/rspec.rake
 has_rdoc: true
 homepage: http://github.com/brentsnook/baldrick
+licenses: []
+
 post_install_message: 
 rdoc_options: 
 - --main
@@ -125,9 +145,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: baldrick
-rubygems_version: 1.3.1
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
-summary: Does what you tell it - glues orders to tasks.
+specification_version: 3
+summary: A dogsbody
 test_files: []