mimic 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Luke Redpath
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# What is Mimic?
+Mimic is a testing tool that lets you set create a fake stand-in for an external web service to be used when writing integration/end-to-end tests for applications or libraries that access these services.
+
+Note: this is still very early in its development; don't let the existence of this README fool you into thinking its ready for prime-time!
+
+## Why not stub?
+There are already some good tools, like [FakeWeb](http://fakeweb.rubyforge.org/) which let you stub requests at a low-level which is fine for unit and functional tests but when exercising our code through integration or end-to-end tests we want to exercise as much of the stack as possible.
+
+Mimic aims to make it possible to test your networking code without actually hitting the real services by starting up a real web server and responding to HTTP requests. This lets you test your application against canned responses in an as-close-to-the-real-thing-as-possible way.
+
+Also, because Mimic starts responds to real HTTP requests, it can be used when testing non-Ruby applications too (like an iPhone application).
+
+## How does it work?
+
+Mimic's API is designed to be simple yet expressive. You simply register the host that you want to fake and then register any number of requests and responses. Mimic will then start an HTTP server (using Rack and WEBRick) on the specified port and add an entry to your hosts file (OSX and Linux only) for that host.
+
+## Examples
+
+Registering to a single request stub:
+
+    Mimic.mimic("www.example.com", 10090).get("/some/path").returning("hello world")
+    
+And the result, using RestClient:
+  
+    $ RestClient.get("http://www.example.com:10090/some/path") # => 200 | hello world
+  
+Registering multiple request stubs; note that you can stub the same path with different HTTP methods separately.
+
+    Mimic.mimic("www.example.com", 10090) do
+      get("/some/path").returning("Hello World", 200)
+      get("/some/other/path").returning("Redirecting...", 301, {"Location" => "somewhere else"})
+      post("/some/path").returning("Created!", 201)
+    end
+    
+## Caveats
+
+* Because the server is not started on port 80, you need a way of configuring your application under test to use a different port at runtime.
+
+* Mimic uses the Ghost gem to modify the hosts file and is therefore dependent on support for this gem. In addition, Ghost currently requires sudo privileges to run which means entering your password. I'm happy to hear any suggestions for working around this.
+
+## License
+
+As usual, the code is released under the MIT license which is included in the repository.

data/Rakefile

@@ -0,0 +1,83 @@
+require 'rubygems'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'spec/rake/spectask'
+
+desc "Run all Cucumber features"
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new('specs') do |t|
+  t.spec_files = FileList['spec/**/*.rb']
+end
+
+task :default => :specs
+
+require "rake/gempackagetask"
+require "rake/rdoctask"
+
+# This builds the actual gem. For details of what all these options
+# mean, and other ones you can add, check the documentation here:
+#
+#   http://rubygems.org/read/chapter/20
+#
+spec = Gem::Specification.new do |s|
+
+  # Change these as appropriate
+  s.name              = "mimic"
+  s.version           = "0.1.0"
+  s.summary           = "A Ruby gem for faking external web services for testing"
+  s.author            = "Luke Redpath"
+  s.email             = "luke@lukeredpath.co.uk"
+  s.homepage          = "http://lukeredpath.co.uk"
+
+  s.has_rdoc          = true
+  s.extra_rdoc_files  = %w(README.md)
+  s.rdoc_options      = %w(--main README.md)
+
+  # Add any extra files to include in the gem
+  s.files             = %w(LICENSE Rakefile README.md) + Dir.glob("{spec,lib/**/*}")
+  s.require_paths     = ["lib"]
+
+  # If you want to depend on other gems, add them here, along with any
+  # relevant versions
+  s.add_dependency("ghost", "~> 0.2.5")
+  s.add_dependency("rack", "~> 1.2.1")
+
+  # If your tests use any gems, include them here
+  s.add_development_dependency("rspec")
+  s.add_development_dependency("cucumber")
+end
+
+# This task actually builds the gem. We also regenerate a static
+# .gemspec file, which is useful if something (i.e. GitHub) will
+# be automatically building a gem for this project. If you're not
+# using GitHub, edit as appropriate.
+#
+# To publish your gem online, install the 'gemcutter' gem; Read more 
+# about that here: http://gemcutter.org/pages/gem_docs
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Build the gemspec file #{spec.name}.gemspec"
+task :gemspec do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+task :package => :gemspec
+
+# Generate documentation
+Rake::RDocTask.new do |rd|
+  rd.main = "README.md"
+  rd.rdoc_files.include("README.md", "lib/**/*.rb")
+  rd.rdoc_dir = "rdoc"
+end
+
+desc 'Clear out RDoc and generated packages'
+task :clean => [:clobber_rdoc, :clobber_package] do
+  rm "#{spec.name}.gemspec"
+end

data/lib/mimic.rb

@@ -0,0 +1,75 @@
+require 'mimic/fake_host'
+require 'singleton'
+require 'rack'
+require 'ghost'
+require 'logger'
+
+module Mimic
+  MIMIC_DEFAULT_PORT = 11988
+  
+  def self.mimic(hostname, port = MIMIC_DEFAULT_PORT, &block)
+    FakeHost.new(hostname).tap do |host|
+      registry.register_host(host)
+      host.instance_eval(&block) if block_given?
+      Server.instance.serve(host, port)
+    end
+  end
+  
+  def self.cleanup!
+    Mimic::Server.instance.shutdown
+    registry.unregister_all_hosts
+  end
+
+  private
+  
+  def self.registry
+    @registry ||= Registry.new
+  end
+
+  class Server
+    include Singleton
+
+    def logger
+      @logger ||= Logger.new(StringIO.new)
+    end
+
+    def serve(host_app, port)
+      webrick_logger = logger
+      @thread = Thread.fork do
+        Rack::Handler::WEBrick.run(host_app, 
+          :Port      => port, 
+          :Logger    => webrick_logger, 
+          :AccessLog => webrick_logger
+          
+        ) { |server| @server = server }
+      end
+    end
+    
+    def shutdown
+      if @thread
+        Thread.kill(@thread) 
+        @server.shutdown
+      end
+    end
+  end
+  
+  class Registry
+    def initialize
+      @hosts = []
+    end
+    
+    def register_host(host)
+      @hosts << host
+      Host.add(host.hostname)
+    end
+    
+    def unregister_host(host)
+      @hosts.delete(host)
+      Host.delete(host.hostname)
+    end
+    
+    def unregister_all_hosts
+      @hosts.each { |host| unregister_host(host) }
+    end
+  end
+end

data/lib/mimic/fake_host.rb

@@ -0,0 +1,90 @@
+module Mimic
+  class FakeHost
+    attr_reader :hostname
+    
+    def initialize(hostname, unhandled_response_strategy = NotFoundResponseStrategy.new)
+      @hostname = hostname
+      @stubs = {}
+      @unhandled_response_strategy = unhandled_response_strategy
+    end
+    
+    def get(path)
+      request("GET", path)
+    end
+    
+    def post(path)
+      request("POST", path)
+    end
+    
+    def put(path)
+      request("PUT", path)
+    end
+    
+    def delete(path)
+      request("DELETE", path)
+    end
+    
+    def head(path)
+      request("HEAD", path)
+    end
+    
+    def call(env)
+      handler_for_call(env).call(env)
+    end
+    
+    def terminate
+      Mimic.terminate(@hostname)
+    end
+    
+    private
+    
+    def request(method, path)
+      stubbed_request = StubbedRequest.new(method, path)
+      @stubs[stubbed_request.key] = stubbed_request
+    end
+    
+    def handler_for_call(env)
+      (@stubs[request_key(env)] || @unhandled_response_strategy)
+    end
+    
+    def request_key(env)
+      request = Rack::Request.new(env)
+      StubbedRequest.key(request.request_method, request.path)
+    end
+    
+    class StubbedRequest
+      def initialize(method, path)
+        @method, @path = method, path
+        @code = 200
+        @headers = {}
+        @body = ""
+      end
+      
+      def returning(body, code = 200, headers = {})
+        tap do
+          @body = body
+          @code = code
+          @headers = headers
+        end
+      end
+      
+      def call(env)
+        [@code, @headers, @body]
+      end
+      
+      def key
+        self.class.key(@method, @path)
+      end
+      
+      def self.key(method, path)
+        "#{method} #{path}"
+      end
+    end
+    
+    class NotFoundResponseStrategy
+      def call(env)
+        [404, {}, ""]
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: mimic
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Luke Redpath
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-19 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ghost
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 0
+        - 2
+        - 5
+        version: 0.2.5
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id002 !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: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "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: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: 
+email: luke@lukeredpath.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- LICENSE
+- Rakefile
+- README.md
+- lib/mimic/fake_host.rb
+- lib/mimic.rb
+has_rdoc: true
+homepage: http://lukeredpath.co.uk
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.md
+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: A Ruby gem for faking external web services for testing
+test_files: []
+