lackie 0.1.0

data/lib/lackie/remote_control.rb

@@ -0,0 +1,51 @@
+require 'restclient'
+require 'json'
+require 'lackie/poller'
+
+module Lackie
+  class RemoteControl
+    def initialize(host, port, poller=Poller.new)
+      @host, @port, @poller = host, port, poller
+    end
+    
+    def log(message)
+      exec("Lackie.log(#{message.to_json})")
+    end
+    
+    def exec(command)
+      send_command(command)
+      poll_for_result(command)
+    end
+    
+    private
+    
+    def send_command(command)
+      RestClient.post("http://#{@host}:#{@port}/lackie/eval", command)
+    end
+    
+    def poll_for_result(command)
+      body = nil
+      @poller.await("result of command:\n#{command}") do
+        body = retrieve_result_body
+      end
+      parse_result(body)
+    end
+    
+    def retrieve_result_body
+      begin
+        RestClient.get("http://#{@host}:#{@port}/lackie/result").body
+      rescue RestClient::ResourceNotFound
+        nil
+      end
+    end
+    
+    def parse_result(body)
+      parsed_body = JSON.parse(body)
+      raise RemoteExecutionError.new(parsed_body["error"]) if parsed_body.include?("error")
+      return parsed_body["value"]
+    end
+  end
+  
+  class RemoteExecutionError < RuntimeError
+  end
+end

data/lib/lackie.rb

@@ -0,0 +1,8 @@
+lib = File.dirname(__FILE__)
+$:.unshift(lib) unless $:.include?(lib) || $:.include?(File.expand_path(lib))
+
+module Lackie
+  VERSION = '0.1.0'
+end
+
+require 'lackie/remote_control'

data/spec/lackie/javascript/surrender_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'lackie/javascript'
+
+module Lackie
+  module JavaScript
+    describe Surrender do
+      it "produces a javascript to zombify a remote browser" do
+        Surrender.new.script.should =~ /window\.setInterval/
+      end
+      
+      it "includes json2.js" do
+        Surrender.new.script.should include("http://www.JSON.org/json2.js")
+      end
+    end
+  end
+end

data/spec/lackie/poller_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+require 'lackie/poller'
+
+module Lackie
+  describe Poller do
+    it "sleeps for a sepecified number of seconds between yields, until the block returns true" do
+      Kernel.should_receive(:sleep).with(0.666).exactly(:twice)
+      return_values = [false, false, true]
+      Poller.new(:interval_seconds => 0.666).await("foo") do
+        return_values.shift
+      end
+      return_values.should be_empty
+    end
+    
+    it "gives up after a specified number of seconds" do
+      Kernel.stub!(:sleep)
+      poller = Poller.new(:timeout_seconds => 2.5)
+      lambda {
+        poller.await("foo") do
+          false
+        end
+      }.should raise_error("Timed out after 2.5 seconds awaiting foo")
+    end
+    
+    it "uses a different sleeper when Kernel is not convenient" do
+      sleeper = mock("sleeper")
+      sleeper.should_receive(:sleep).with(0.999).exactly(:twice)
+      return_values = [false, false, true]
+      Poller.new(:interval_seconds => 0.999, :sleeper => sleeper).await("foo") do
+        return_values.shift
+      end
+    end
+  end
+end

data/spec/lackie/rack/middleware_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+require 'lackie/rack'
+
+module Lackie
+  module Rack
+    describe Middleware do
+      before do
+        Lackie::JavaScript::Surrender.should_receive(:new).and_return(mock("surrender", :script => "yowzer"))
+        @app = mock("app")
+        @env = mock("env")
+        @middleware = Middleware.new(@app)
+      end
+      
+      def request(options)
+        @request = mock("Request: #{options.inspect}", options)
+        ::Rack::Request.stub!(:new).with(@env).and_return(@request)
+        @middleware.call(@env)
+      end
+      
+      def get(path)
+        request(:path => path, :get? => true)
+      end
+      
+      def post(path, body)
+        request(:path => path, :get? => false, :body => mock("io", :read => body))
+      end
+      
+      it "ignores GET requests with paths not beginning with /lackie/" do
+        @app.should_receive(:call).with(@env).and_return(:result)
+        get("else/where").should == :result
+      end
+      
+      it "ignores POST requests with paths not beginning with /lackie/" do
+        @app.should_receive(:call).with(@env).and_return(:result)
+        post("over/yonder", "body").should == :result
+      end
+      
+      describe "GET /lackie/surrender" do
+        it "returns a javascript to zombify a remote browser" do
+          get("/lackie/surrender").should == [200, {'Content-Type' => 'text/javascript'}, ["yowzer"]]
+        end        
+      end
+      
+      describe "POST /lackie/eval with the body 'foo()'" do
+        describe "followed by GET /lackie/yield" do
+          it "returns 'foo()' as the response body" do
+            post("/lackie/eval", "foo()")
+            get("/lackie/yield").should == [200, {"Content-Type"=>"text/javascript"}, ["foo()"]]
+          end
+          
+          describe "followed by GET /lackie/yield" do
+            it "returns '' as the response body" do
+              post("/lackie/eval", "foo()")
+              get("/lackie/yield")
+              get("/lackie/yield").should == [200, {"Content-Type"=>"text/javascript"}, [""]]
+            end
+          end
+        end
+      end
+      
+      describe "GET /lackie/result (before POST /lackie/result)" do
+        it "returns a 404 Not Found" do
+          get("/lackie/result").should == [404, {'Content-Type' => 'text/plain'}, ["Not Found"]]
+        end        
+      end
+      
+      describe "POST /lackie/result with 'yippee'" do
+        describe "followed by GET /lackie/result" do
+          it "gets 'bar' as the response body" do
+            post("/lackie/result", "'bar'")
+            get("/lackie/result").should == [200, {"Content-Type"=>"application/json"}, ["'bar'"]]
+          end
+        end
+      end
+    end
+  end
+end

data/spec/lackie/remote_control_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+require 'lackie/javascript'
+
+module Lackie
+  describe RemoteControl do
+    before(:each) do
+      @poller = Poller.new(:sleeper => mock("sleeper", :sleep => true))
+      Poller.stub!(:new).and_return(@poller)
+      @rc = RemoteControl.new("host", 555, @poller)
+      RestClient.stub!(:post)
+      RestClient.stub!(:get).and_return(mock("response", :body => '{"value":"123"}'))
+    end
+    
+    it "sends log commands as POST /lackie/eval" do
+      RestClient.should_receive(:post).with("http://host:555/lackie/eval", 'Lackie.log("OK")')
+      @rc.log("OK")
+    end
+    
+    it "sends execute 'X' commands as POST /lackie/eval with the body 'X'" do
+      RestClient.should_receive(:post).with("http://host:555/lackie/eval", 'X')
+      @rc.exec("X")
+    end
+    
+    it "polls for results via GET /lackie/result" do
+      responses = [
+        lambda { raise RestClient::ResourceNotFound },
+        lambda { mock("poll_response", :body => '{"value":"bar"}') }
+      ]
+      RestClient.stub!(:get).with("http://host:555/lackie/result").and_return {
+        responses.shift.call
+      }
+      @rc.exec("foo").should == "bar"
+      responses.should be_empty
+    end
+    
+    it "deserializes json results" do
+      RestClient.should_receive(:get).and_return(mock("response", :body => '{"value":666}'))
+      @rc.log("oops").should == 666
+    end
+    
+    it "rethrows json errors" do
+      RestClient.should_receive(:get).and_return(mock("response", :body => '{"error":"oops"}'))
+      lambda { @rc.log("oops") }.should raise_error("oops")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'rspec'
+
+require File.dirname(__FILE__) + '/../lib/lackie'

metadata

@@ -0,0 +1,197 @@
+--- !ruby/object:Gem::Specification 
+name: lackie
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Josh Chisholm
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-31 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 1
+        - 2
+        - 1
+        version: 1.2.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 4
+        - 2
+        version: 1.4.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 2
+        - 0
+        version: 2.2.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 55
+        segments: 
+        - 0
+        - 10
+        - 0
+        version: 0.10.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: mongrel
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 1
+        - 5
+        version: 1.1.5
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: relevance-rcov
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 0
+        - 9
+        - 2
+        - 1
+        version: 0.9.2.1
+  type: :development
+  version_requirements: *id006
+description: Automates remote applications using an HTTP middleman
+email: joshuachisholm@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- features/remote_control.feature
+- features/step_definitions/lackie_steps.rb
+- features/support/config.ru
+- features/support/env.rb
+- features/support/example_app.rb
+- features/support/example_app/app.html
+- lackie.gemspec
+- lib/lackie.rb
+- lib/lackie/javascript.rb
+- lib/lackie/javascript/json2.js
+- lib/lackie/javascript/surrender.js
+- lib/lackie/javascript/surrender.rb
+- lib/lackie/poller.rb
+- lib/lackie/rack.rb
+- lib/lackie/rack/middleware.rb
+- lib/lackie/remote_control.rb
+- spec/lackie/javascript/surrender_spec.rb
+- spec/lackie/poller_spec.rb
+- spec/lackie/rack/middleware_spec.rb
+- spec/lackie/remote_control_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/joshski/lackie
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: lackie-0.1.0
+test_files: 
+- features/remote_control.feature
+- features/step_definitions/lackie_steps.rb
+- features/support/config.ru
+- features/support/env.rb
+- features/support/example_app.rb
+- features/support/example_app/app.html
+- spec/lackie/javascript/surrender_spec.rb
+- spec/lackie/poller_spec.rb
+- spec/lackie/rack/middleware_spec.rb
+- spec/lackie/remote_control_spec.rb
+- spec/spec_helper.rb