fakettp 0.2.4.1

data/README.html

@@ -0,0 +1,113 @@
+<h1>FakeTTP</h1>
+<h2>Purpose</h2>
+<p>When you are writing acceptance/integration tests for an application which makes <span class="caps">HTTP</span> requests to a remote application, sometimes you need to be able to test the interactions in different scenarios without talking to a real instance of the remote application.</p>
+<p>FakeTTP is a standalone web application that allows you to mock requests (ie set and verify expectations on the requests your application makes, and return suitable responses to those requests).</p>
+<h2>Installation</h2>
+<h3>Install the gem</h3>
+<p>Add GitHub as a gem source (you only need to do this once):</p>
+<p><code>gem sources -a http://gems.github.com</code></p>
+<p>Then install FakeTTP:</p>
+<p><code>sudo gem install kerryb-fakettp</code></p>
+<p>Alternatively, you can specify the source when you install the gem:</p>
+<p><code>sudo gem install kerryb-fakettp --source http://gems.github.com</code></p>
+<h3>Create a FakeTTP directory</h3>
+<p>You can install FakeTTP anywhere that your web server user can see it:</p>
+<p><code>fakettp install &lt;directory&gt;</code></p>
+<h3>Point your web server at the directory</h3>
+<p>FakeTTP should work with any Rack-compatible server: just point the server to the correct directory. For example, using <a href="http://www.modrails.com/">Passenger</a> (mod_rails) with Apache, create a virtual host along these lines:</p>
+<pre><code>
+  &lt;VirtualHost *:80&gt;
+    ServerName fakettp.local
+    DocumentRoot "/path/to/fakettp/public"
+    &lt;directory "/path/to/fakettp/public"&gt;
+      Order deny,allow
+      Deny from all
+      Allow from 127.0.0.1
+    &lt;/directory&gt;
+  &lt;/VirtualHost&gt;
+</code></pre>
+<p>Then make sure <code>fakettp.local</code> resolves to 127.0.0.1 (assuming you&#8217;re running the simulator on the same machine as the application under test), eg by adding the following line to <code>/etc/hosts</code>:</p>
+<p><code>127.0.0.1	fakettp.local</code></p>
+<h3><span class="caps">IMPORTANT</span>: security note</h3>
+<p>Because expectations are set by posting Ruby code to be executed on the server, you probably don&#8217;t want any old Tom, Dick or Harry to be able to connect. The security settings in the virtual host config example above restrict access to clients running on the local machine.</p>
+<h2>Usage</h2>
+<h3>Resetting</h3>
+<p>To reset FakeTTP (ie remove all expectations and errors), make an <span class="caps">HTTP</span> <span class="caps">POST</span> request to <code>http://fakettp.local/reset</code>.</p>
+<h4>Calling from curl</h4>
+<p><code>curl fakettp.local/reset -X POST</code></p>
+<h3>Setting expectations</h3>
+<p>To create a new expectation, make an <span class="caps">HTTP</span> <span class="caps">POST</span> request to <code>http://fakettp.local/expect</code>, with a <em>Content-Type</em> header of &#8216;text/plain&#8217; and the request data containing a Ruby block to execute.</p>
+<p>The supplied code should be in the following format, and will generally consist of a number of assertions on the request, followed by creation of the response to return to the application under test.</p>
+<pre><code>
+  expect "GET of /foo" do
+    request.host.should == 'fakettp.local'
+    request.path_info.should == '/foo'
+  
+    content_type 'text/plain'
+    "All is well\n"
+  end
+</code></pre>
+<p>The label on the first line is used in error reporting.</p>
+<p>The expectation code has access to the underlying Sinatra request and response objects etc, as well as <a href="http://rspec.info">RSpec</a> matchers.</p>
+<h4>Calling from curl</h4>
+<p>Assuming the expectation is in <code>expectation_file</code>:</p>
+<p><code>curl -X POST fakettp.local/expect -X POST -H 'Content-Type:text/plain' --binary-data @expectation_file</code></p>
+<h3>Verifying</h3>
+<p>To verify that all expectations have been met, make an <span class="caps">HTTP</span> <span class="caps">GET</span> request to <code>http://fakettp.local/verify</code>.</p>
+<p>If all is well, the response will be a <em>200 OK</em> with a body of &#8216;OK&#8217;. Otherwise the status will be <em>400 Bad Request</em>, with a list of failures in the body. The failure messages include the complete details of the unexpected request that was received, to assist debugging.</p>
+<h4>Calling from curl</h4>
+<p><code>curl fakettp.local/verify</code></p>
+<h3>Multiple hosts</h3>
+<p>To have FakeTTP respond to multiple hostnames, create the appropriate hosts entries. If you&#8217;re using name-based virtual hosts in Apache, add a <em>ServerAlias</em> entry to the virtual host config, under the <em>ServerName</em> line, eg:</p>
+<p><code>ServerAlias foo.com bar.com</code></p>
+<h2>Change log</h2>
+<p>0.2.4.1 (5 May 2009)</p>
+<ul>
+	<li>Temporarily depend on edge version of Sinatra, to gain Rack 1.0 compatibility.</li>
+</ul>
+<p>0.2.4 (25 Mar 2009)</p>
+<ul>
+	<li>Fixed a bug which caused expectations to be run in the wrong order if there were more than nine of them.</li>
+</ul>
+<p>0.2.3 (19 Mar 2009)</p>
+<ul>
+	<li>Fixed a bug where expectations were being overwritten on Linux due to Dir.entries not returning results in the expected order</li>
+</ul>
+<p>0.2.2 (18 Mar 2009)</p>
+<ul>
+	<li>Only accept control requests (reset, expect, verify) on fakettp.local</li>
+</ul>
+<p>0.2.1 (17 Mar 2009)</p>
+<ul>
+	<li>Fixed issue where rspec matchers weren&#8217;t available to expectations</li>
+</ul>
+<p>0.2 (14 Mar 2009)</p>
+<ul>
+	<li>Complete rewrite, with tests and classes and stuff this time.</li>
+</ul>
+<p>If you get an &#8216;unexpected return&#8217; error, remove the return statement from your expectation, and just put the return value on the last line of the <em>expect</em> block.</p>
+<p>0.1.2 (13 Feb 2009)</p>
+<ul>
+	<li>Make sure <span class="caps">README</span>.html appears in generated gem</li>
+</ul>
+<p>0.1.1 (13 Feb 2009)</p>
+<ul>
+	<li>Fix permissions on installed tmp directory.</li>
+</ul>
+<p>0.1.0 (13 Feb 2009)</p>
+<ul>
+	<li>First release as a gem.</li>
+</ul>
+<h2>To Do</h2>
+<ul>
+	<li>Add examples</li>
+	<li>Make control requests RESTful?</li>
+	<li>Make main hostname configurable?</li>
+	<li>Show label in verification error for expected requests that weren&#8217;t received</li>
+	<li>Add facility to stub as well as mock requests</li>
+	<li>Allow more flexibility in request ordering</li>
+	<li>Allow user-specific helper files in installation dir</li>
+	<li>Check install/run behaviour when development dependencies are not installed</li>
+	<li>Provide Ruby <span class="caps">API</span> to set expectations etc</li>
+	<li>Return the expected content type even if expectation fails</li>
+</ul>

data/bin/fakettp

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'fakettp/commands/fakettp_command'
+
+exit Fakettp::Commands::FakettpCommand.new(ARGV).run

data/lib/fakettp/commands/fakettp_command.rb

@@ -0,0 +1,53 @@
+module Fakettp
+  module Commands
+    class FakettpCommand
+      def initialize args
+        @args = args
+      end
+  
+      def run
+        command = get_command
+        return usage unless command
+        case command
+        when 'install' then
+          return install
+        else
+          return usage
+        end
+      end
+  
+      private
+  
+      def get_command
+        @args[0]
+      end
+      
+      def install
+        dir = get_dir
+        return usage unless dir
+        if File.exist? dir
+          $stderr.puts "File or directory #{dir} already exists."
+          return 1
+        end
+        FileUtils.mkdir_p dir + '/tmp/expectations', :mode => 0777
+        FileUtils.mkdir_p dir + '/public'
+        FileUtils.cp File.dirname(__FILE__) + '/../config.ru', dir
+        FileUtils.cp File.dirname(__FILE__) + '/../../../README.html', dir
+        return 0
+      end
+      
+      def get_dir
+        @args[1]
+      end
+  
+      def usage
+        $stderr.puts <<-EOF
+Usage:
+
+  [TODO]
+EOF
+        return 1
+      end
+    end
+  end
+end

data/lib/fakettp/config.ru

@@ -0,0 +1,6 @@
+require 'rubygems'
+
+FAKETTP_BASE = File.expand_path(File.dirname(__FILE__))
+require 'fakettp'
+
+run Sinatra::Application

data/lib/fakettp/controller.rb

@@ -0,0 +1,42 @@
+require 'sinatra'
+require 'spec'
+Sinatra::Default.set :run, false
+Sinatra::Default.set :environment, ENV['RACK_ENV']
+
+require 'fakettp/expectation_helper'
+require 'fakettp/simulator'
+require 'fakettp/expectation'
+
+include Fakettp::ExpectationHelper
+
+post '/expect', :host => 'fakettp.local' do
+  Fakettp::Simulator << request.body.read
+  content_type 'text/plain'
+  "Expect OK\n"
+end
+
+post '/reset', :host => 'fakettp.local' do
+  Fakettp::Simulator.reset
+  content_type 'text/plain'
+  "Reset OK\n"
+end
+
+get '/verify', :host => 'fakettp.local' do
+  content_type 'text/plain'
+  if Fakettp::Simulator.verify
+    "Verify OK\n"
+  else
+    throw :halt, [500, Fakettp::Simulator.list_errors]
+  end
+end
+
+[:get, :post, :put, :delete, :head].each do |method|
+  send method, '/**' do
+    begin
+      Fakettp::Simulator.handle_request binding
+    rescue Fakettp::Expectation::Error => e
+      content_type 'text/plain'
+      throw :halt, [500, "Simulator received mismatched request\n"]
+    end
+  end
+end

data/lib/fakettp/error.rb

@@ -0,0 +1,23 @@
+module Fakettp
+  class Error
+    ERROR_FILE = File.join FAKETTP_BASE, 'tmp', 'errors'
+    
+    def self.clear_all
+      FileUtils.rm_rf ERROR_FILE
+    end
+    
+    def self.<< message
+      File.open ERROR_FILE, 'a' do |f|
+        f.puts message
+      end
+    end
+    
+    def self.empty?
+      !File.exists? ERROR_FILE
+    end
+    
+    def self.list
+      empty? ? '' : File.read(ERROR_FILE)
+    end
+  end
+end

data/lib/fakettp/expectation.rb

@@ -0,0 +1,56 @@
+module Fakettp
+  class Expectation
+    class Error < Exception; end
+    
+    EXPECTATION_DIR = File.join FAKETTP_BASE, 'tmp', 'expectations'
+    
+    def initialize contents
+      @contents = contents
+    end
+    
+    def execute binding
+      eval @contents, binding
+      # TODO: Include context of expectation file
+    end
+    
+    def self.clear_all
+      FileUtils.rm_rf Dir.glob(File.join(EXPECTATION_DIR, '*'))
+    end
+    
+    def self.empty?
+      files.empty?
+    end
+    
+    def self.<< expectation
+      File.open next_file_to_create, 'w' do |f|
+        f.write expectation
+      end
+    end
+    
+    def self.next
+      file = next_file_to_read
+      contents = File.read file
+      FileUtils.rm file
+      Expectation.new contents
+    end
+    
+    private
+    
+    def self.next_file_to_create
+      name = (files.last.to_i + 1).to_s
+      File.join EXPECTATION_DIR, name
+    end
+    
+    def self.next_file_to_read
+      name = files.first
+      raise Error.new('Received unexpected request') unless name
+      File.join EXPECTATION_DIR, name
+    end
+    
+    def self.files
+      (Dir.entries(EXPECTATION_DIR) - ['.', '..']).sort_by {|a| a.to_i}
+    end
+  
+    private_class_method :next_file_to_create, :next_file_to_read, :files
+  end
+end

data/lib/fakettp/expectation_helper.rb

@@ -0,0 +1,17 @@
+require 'fakettp/expectation'
+
+module Fakettp
+  module ExpectationHelper
+    def self.included(cls)
+      cls.send :include, Spec::Matchers
+    end
+  
+    def expect label
+      begin
+        yield
+      rescue Exception => e
+        raise Fakettp::Expectation::Error.new("Error in #{label}: #{e.message}")
+      end
+    end
+  end
+end

data/lib/fakettp/simulator.rb

@@ -0,0 +1,33 @@
+require 'fakettp/expectation'
+require 'fakettp/error'
+
+module Fakettp
+  class Simulator    
+    def self.reset
+      Expectation.clear_all
+      Error.clear_all
+    end
+    
+    def self.verify
+      Error << 'Expected request not received' unless Expectation.empty?
+      Error.empty?
+    end
+    
+    def self.<< expectation
+      Expectation << expectation
+    end
+    
+    def self.handle_request binding
+      begin
+        Expectation.next.execute binding
+      rescue Fakettp::Expectation::Error => e
+        Error << e.message
+        raise e
+      end
+    end
+    
+    def self.list_errors
+      Error.list
+    end
+  end
+end

data/lib/fakettp.rb

@@ -0,0 +1,3 @@
+$LOAD_PATH << File.dirname(__FILE__)
+require 'fakettp/controller'
+require 'fakettp/commands/fakettp_command'

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification 
+name: fakettp
+version: !ruby/object:Gem::Version 
+  version: 0.2.4.1
+platform: ruby
+authors: 
+- Kerry Buckley
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-13 00:00:00 +01:00
+default_executable: fakettp
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra-sinatra
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.12
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: spicycode-rcov
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.16
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: RedCloth
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 4.1.1
+    version: 
+description: 
+email: kerryjbuckley@gmail.com
+executables: 
+- fakettp
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/fakettp/commands/fakettp_command.rb
+- lib/fakettp/config.ru
+- lib/fakettp/controller.rb
+- lib/fakettp/error.rb
+- lib/fakettp/expectation.rb
+- lib/fakettp/expectation_helper.rb
+- lib/fakettp/simulator.rb
+- lib/fakettp.rb
+- bin/fakettp
+- README.html
+has_rdoc: true
+homepage: http://github.com/kerryb/fakettp/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: fakettp
+rubygems_version: 1.3.2
+signing_key: 
+specification_version: 3
+summary: HTTP server mocking tool
+test_files: []
+