sham_rack 1.3.6 → 1.4.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ZmU4NWE2MGVhYjA0ZDE5ODM1NjJiYTlhMzE1MTg5MjMyMTQ4YmExNg==
-  data.tar.gz: !binary |-
-    ZmEwZDliNjk4MzIxNjdkYWNlZTQzY2ZhOWU2ZDdjMzg1NmZiODk4Yw==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    NDI2MTVkYzU3OWI2YTgwYzFkMWEzYzg0NWJlOTM3YzU4NjhmYzk0Mzc1NTUy
-    ZGNhMTY2OGQ1ODA2ODExY2U3OTE3M2VjZjI3MjE0ZjllZDQ5YTE4OGQyNDY3
-    YTEwZTM1OWRjZGZiZjMyM2U2NmVkYjFmN2I2NTA4NzNlNTUxOTc=
-  data.tar.gz: !binary |-
-    ZmEyODY4YTVlNGRkNTNmMjE4ODNhZjlhNDUwODU0MjI3ZDFmZGYyYTcwNGJk
-    M2I2NTk0OGU1MDA2NTJiYWUyODczZGZjYTQ2ZjY2YjRmOGYwZDMzZmM4OTU1
-    MDljNjA2OTQ5NWFmNzQxMzAzZWYzZWEzZGZhZDMwZDA1NGI2ZGY=
+SHA1:
+  metadata.gz: 887447b8de1ec4acf1dec895fc3f51634cedc2d7
+  data.tar.gz: ad8bbd8c761fc122986386bba9907fef7273762e
+SHA512:
+  metadata.gz: 4a4bfe421be365279abdb1a5436b04fa08de0c93ca0a524d57767a5fd1fd7f8236b03815f15578c94eb14812de73b93830f4c8d0aad05da2fa08dab2a5112ab8
+  data.tar.gz: 56abd422fc06f9ce5eff13bef96b230883ec49c97ec33bff4bb5aa2847f545e6ac6864d04dce3b8884e911e2f7372aa29cd2d3373258b76df69995c6345d6652

data/Rakefile

@@ -6,7 +6,7 @@ task "default" => "spec"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new do |t|
-  t.rspec_opts = ["--format", "nested"]
+  t.rspec_opts = ["--format", "doc"]
 end
 
 require 'bundler'

data/lib/sham_rack.rb

@@ -7,5 +7,12 @@ require "sham_rack/version"
 # For more detail, see http://github.com/mdub/sham_rack
 #
 module ShamRack
+
   extend ShamRack::Registration
+
+  def self.reset
+    unmount_all
+    allow_network_connections
+  end
+
 end

data/lib/sham_rack/allowances.rb

@@ -0,0 +1,24 @@
+module ShamRack
+
+  class << self
+
+    def network_connections_allowed?
+      @allow_network_connections
+    end
+
+    def allow_network_connections
+      @allow_network_connections = true
+    end
+
+    def prevent_network_connections
+      @allow_network_connections = false
+    end
+
+  end
+
+  class NetworkConnectionPrevented < StandardError
+  end
+
+end
+
+ShamRack.allow_network_connections

data/lib/sham_rack/registration.rb

@@ -1,3 +1,5 @@
+require "sham_rack/allowances"
+
 module ShamRack
 
   module Registration
@@ -18,11 +20,13 @@ module ShamRack
     end
 
     def application_for(address, port = nil)
-      mount_point_for(address, port).app
-    end
-
-    def mount(app, address, port = nil)
-      at(address, port).mount(app)
+      port ||= Net::HTTP.default_port
+      mount_point_for(address, port).app.tap do |app|
+        return app unless app.nil?
+        unless ShamRack.network_connections_allowed?
+          raise NetworkConnectionPrevented, "connection to #{address}:#{port} not allowed"
+        end
+      end
     end
 
     private

data/lib/sham_rack/version.rb

@@ -1,3 +1,3 @@
 module ShamRack
-  VERSION = "1.3.6"
+  VERSION = "1.4.0"
 end

data/spec/sham_rack/stub_web_service_spec.rb

@@ -3,7 +3,7 @@ require "spec_helper"
 require "sham_rack/stub_web_service"
 require "rack/test"
 
-describe ShamRack::StubWebService do
+RSpec.describe ShamRack::StubWebService do
 
   include Rack::Test::Methods
 
@@ -14,14 +14,14 @@ describe ShamRack::StubWebService do
   end
 
   describe "#last_request" do
-    
+
     it "returns the last request" do
       get '/foo/bar'
-      @app.last_request.path_info.should == "/foo/bar"
+      expect(@app.last_request.path_info).to eq("/foo/bar")
     end
-    
+
   end
-  
+
   describe "with no handlers registered" do
 
     describe "any request" do
@@ -31,7 +31,7 @@ describe ShamRack::StubWebService do
       end
 
       it "returns a 404" do
-        last_response.status.should == 404
+        expect(last_response.status).to eq(404)
       end
 
     end
@@ -39,9 +39,9 @@ describe ShamRack::StubWebService do
   end
 
   describe "with two handlers registered" do
-    
+
     before(:each) do
-      
+
       @app.handle do |request|
         [200, {}, ["response from first handler"]] if request.get?
       end
@@ -49,9 +49,9 @@ describe ShamRack::StubWebService do
       @app.handle do |request|
         [200, {}, ["response from second handler"]] if request.path_info == "/stuff"
       end
-      
+
     end
-      
+
     describe "a request matching the first handler" do
 
       before do
@@ -59,11 +59,11 @@ describe ShamRack::StubWebService do
       end
 
       it "receives a response from the first handler" do
-        last_response.body.should == "response from first handler"
+        expect(last_response.body).to eq("response from first handler")
       end
-      
+
     end
-    
+
     describe "a request matching the second handler" do
 
       before do
@@ -71,11 +71,11 @@ describe ShamRack::StubWebService do
       end
 
       it "receives a response from the second handler" do
-        last_response.body.should == "response from second handler"
+        expect(last_response.body).to eq("response from second handler")
       end
-      
+
     end
-    
+
     describe "a request matching both handlers" do
 
       before do
@@ -83,11 +83,11 @@ describe ShamRack::StubWebService do
       end
 
       it "receives a response from the second handler" do
-        last_response.body.should == "response from second handler"
+        expect(last_response.body).to eq("response from second handler")
       end
-      
+
     end
-    
+
   end
 
   describe ".register_resource" do
@@ -96,17 +96,17 @@ describe ShamRack::StubWebService do
       @app.register_resource("/stuff?foo=bar", "STUFF", "text/plain", 202)
       get "/stuff?foo=bar"
     end
-      
+
     it "sets body" do
-      last_response.body.should == "STUFF"
+      expect(last_response.body).to eq("STUFF")
     end
 
     it "sets content-type" do
-      last_response.content_type.should == "text/plain"
+      expect(last_response.content_type).to eq("text/plain")
     end
-    
+
     it "sets status code" do
-      last_response.status.should == 202
+      expect(last_response.status).to eq(202)
     end
 
   end

data/spec/sham_rack_spec.rb

@@ -7,61 +7,59 @@ require "restclient"
 require "mechanize"
 require "rack"
 
-describe ShamRack do
+RSpec.describe ShamRack do
 
   class NetHttpProhibited < StandardError; end
 
   before do
-    any_instance_of(Net::HTTP) do |http|
-      stub(http).start do
-        raise NetHttpProhibited, "real network calls are not allowed"
-      end
+    allow_any_instance_of(Net::HTTP).to receive(:start) do
+      raise NetHttpProhibited, "real network calls are not allowed"
     end
   end
 
   after(:each) do
-    ShamRack.unmount_all
+    ShamRack.reset
   end
 
   describe "mounted Rack application" do
 
     before(:each) do
-      ShamRack.mount(GreetingApp.new, "www.greetings.com")
+      ShamRack.at("www.greetings.com").mount(GreetingApp.new)
     end
 
     it "can be accessed using Net::HTTP" do
       response = Net::HTTP.start("www.greetings.com") do |http|
         http.request(Net::HTTP::Get.new("/"))
       end
-      response.body.should == "Hello, world"
+      expect(response.body).to eq("Hello, world")
     end
 
     it "can be accessed using Net::HTTP#get_response" do
       response = Net::HTTP.get_response(URI.parse("http://www.greetings.com/"))
-      response.body.should == "Hello, world"
+      expect(response.body).to eq("Hello, world")
     end
 
     it "can be accessed using open-uri" do
       response = open("http://www.greetings.com")
-      response.status.should == ["200", "OK"]
-      response.read.should == "Hello, world"
+      expect(response.status).to eq(["200", "OK"])
+      expect(response.read).to eq("Hello, world")
     end
 
     it "can be accessed using RestClient" do
       response = RestClient.get("http://www.greetings.com")
-      response.code.should == 200
-      response.to_s.should == "Hello, world"
+      expect(response.code).to eq(200)
+      expect(response.to_s).to eq("Hello, world")
     end
 
     it "can be accessed using Mechanize" do
       response = Mechanize.new.get("http://www.greetings.com")
-      response.body.should == "Hello, world"
+      expect(response.body).to eq("Hello, world")
     end
 
     it "can be accessed using Patron" do
       patron = Patron::Session.new
       response = patron.get("http://www.greetings.com/foo/bar")
-      response.body.should == "Hello, world"
+      expect(response.body).to eq("Hello, world")
     end
 
   end
@@ -76,7 +74,7 @@ describe ShamRack do
           ["200 OK", { "Content-type" => "text/plain" }, ["Easy, huh?"]]
         end
 
-        open("http://simple.xyz").read.should == "Easy, huh?"
+        expect(open("http://simple.xyz").read).to eq("Easy, huh?")
 
       end
 
@@ -85,9 +83,9 @@ describe ShamRack do
     context "with a URL" do
 
       it "raises an ArgumentError" do
-        lambda do
+        expect do
           ShamRack.at("http://www.greetings.com")
-        end.should raise_error(ArgumentError, "invalid address")
+        end.to raise_error(ArgumentError, "invalid address")
       end
 
     end
@@ -98,7 +96,7 @@ describe ShamRack do
 
         ShamRack.at("hello.xyz").mount(GreetingApp.new)
 
-        open("http://hello.xyz").read.should == "Hello, world"
+        expect(open("http://hello.xyz").read).to eq("Hello, world")
 
       end
 
@@ -111,9 +109,9 @@ describe ShamRack do
         ShamRack.at("gone.xyz").mount(GreetingApp.new)
         ShamRack.at("gone.xyz").unmount
 
-        lambda do
+        expect do
           open("http://gone.xyz").read
-        end.should raise_error(NetHttpProhibited)
+        end.to raise_error(NetHttpProhibited)
 
       end
 
@@ -129,11 +127,11 @@ describe ShamRack do
       end
 
       it "mounts an app created using Rack::Builder" do
-        open("http://rackup.xyz").read.should == "HELLO, WORLD"
+        expect(open("http://rackup.xyz").read).to eq("HELLO, WORLD")
       end
 
       it "returns the app" do
-        @return_value.should respond_to(:call)
+        expect(@return_value).to respond_to(:call)
       end
 
     end
@@ -149,11 +147,11 @@ describe ShamRack do
       end
 
       it "mounts associated block as a Sinatra app" do
-        open("http://sinatra.xyz/hello/stranger").read.should == "Hello, stranger"
+        expect(open("http://sinatra.xyz/hello/stranger").read).to eq("Hello, stranger")
       end
 
       it "returns the app" do
-        @return_value.should respond_to(:call)
+        expect(@return_value).to respond_to(:call)
       end
 
     end
@@ -165,29 +163,17 @@ describe ShamRack do
       end
 
       it "mounts a StubWebService" do
-        ShamRack.application_for("stubbed.xyz").should be_kind_of(ShamRack::StubWebService)
+        expect(ShamRack.application_for("stubbed.xyz")).to be_kind_of(ShamRack::StubWebService)
       end
 
       it "returns the StubWebService" do
-        @return_value.should == ShamRack.application_for("stubbed.xyz")
+        expect(@return_value).to eq(ShamRack.application_for("stubbed.xyz"))
       end
 
     end
 
   end
 
-  describe ".mount" do
-
-    it "is deprecated, but still works" do
-
-      ShamRack.mount(GreetingApp.new, "hello.xyz")
-
-      open("http://hello.xyz").read.should == "Hello, world"
-
-    end
-
-  end
-
   describe "response" do
 
     before(:each) do
@@ -203,23 +189,23 @@ describe ShamRack do
     let(:response) { Net::HTTP.get_response(URI.parse("http://www.greetings.com/")) }
 
     it "has status returned by app" do
-      response.code.should == "456"
+      expect(response.code).to eq("456")
     end
 
     it "has status message returned by app" do
-      response.message.should == "Foo Bar"
+      expect(response.message).to eq("Foo Bar")
     end
 
     it "has body returned by app" do
-      response.body.should == "BODY"
+      expect(response.body).to eq("BODY")
     end
 
     it "has Content-Type returned by app" do
-      response.content_type.should == "text/plain"
+      expect(response.content_type).to eq("text/plain")
     end
 
     it "has other headers returned by app" do
-      response["x-foo"].should =="bar"
+      expect(response["x-foo"]).to eq("bar")
     end
 
     context "when the app returns a numeric status" do
@@ -236,11 +222,53 @@ describe ShamRack do
       end
 
       it "has status returned by app" do
-        response.code.should == "201"
+        expect(response.code).to eq("201")
       end
 
       it "derives a status message" do
-        response.message.should == "Created"
+        expect(response.message).to eq("Created")
+      end
+
+    end
+
+  end
+
+  describe ".allow_network_connections" do
+
+    context "when false" do
+
+      before do
+        ShamRack.prevent_network_connections
+      end
+
+      after do
+        ShamRack.allow_network_connections
+      end
+
+      it "prevents Net::HTTP requests" do
+        expect {
+          Net::HTTP.get_response(URI.parse("http://www.example.com/"))
+        }.to raise_error(ShamRack::NetworkConnectionPrevented)
+      end
+
+      it "prevents Patron requests" do
+        expect {
+          Patron::Session.new.get("http://www.example.com/")
+        }.to raise_error(ShamRack::NetworkConnectionPrevented)
+      end
+
+    end
+
+    context "when true" do
+
+      before do
+        ShamRack.allow_network_connections
+      end
+
+      it "allows Net::HTTP requests" do
+        expect {
+          Net::HTTP.get_response(URI.parse("http://www.example.com/"))
+        }.to raise_error(NetHttpProhibited)
       end
 
     end
@@ -265,19 +293,19 @@ describe ShamRack do
 
       open("http://env.xyz/blah?q=abc")
 
-      env["REQUEST_METHOD"].should == "GET"
-      env["SCRIPT_NAME"].should == ""
-      env["PATH_INFO"].should == "/blah"
-      env["QUERY_STRING"].should == "q=abc"
-      env["SERVER_NAME"].should == "env.xyz"
-      env["SERVER_PORT"].should == "80"
+      expect(env["REQUEST_METHOD"]).to eq("GET")
+      expect(env["SCRIPT_NAME"]).to eq("")
+      expect(env["PATH_INFO"]).to eq("/blah")
+      expect(env["QUERY_STRING"]).to eq("q=abc")
+      expect(env["SERVER_NAME"]).to eq("env.xyz")
+      expect(env["SERVER_PORT"]).to eq("80")
 
-      env["rack.version"].should be_kind_of(Array)
-      env["rack.url_scheme"].should == "http"
+      expect(env["rack.version"]).to be_kind_of(Array)
+      expect(env["rack.url_scheme"]).to eq("http")
 
-      env["rack.multithread"].should == true
-      env["rack.multiprocess"].should == true
-      env["rack.run_once"].should == false
+      expect(env["rack.multithread"]).to eq(true)
+      expect(env["rack.multiprocess"]).to eq(true)
+      expect(env["rack.run_once"]).to eq(false)
 
     end
 
@@ -289,7 +317,7 @@ describe ShamRack do
         http.request(request)
       end
 
-      env["HTTP_FOO_BAR"].should == "baz"
+      expect(env["HTTP_FOO_BAR"]).to eq("baz")
 
     end
 
@@ -297,9 +325,9 @@ describe ShamRack do
 
       RestClient.post("http://env.xyz/resource", "q" => "rack")
 
-      env["REQUEST_METHOD"].should == "POST"
-      env["CONTENT_TYPE"].should == "application/x-www-form-urlencoded"
-      env["rack.input"].read.should == "q=rack"
+      expect(env["REQUEST_METHOD"]).to eq("POST")
+      expect(env["CONTENT_TYPE"]).to eq("application/x-www-form-urlencoded")
+      expect(env["rack.input"].read).to eq("q=rack")
 
     end
 
@@ -309,8 +337,8 @@ describe ShamRack do
         http.post("/resource", "q=rack")
       end
 
-      env["REQUEST_METHOD"].should == "POST"
-      env["rack.input"].read.should == "q=rack"
+      expect(env["REQUEST_METHOD"]).to eq("POST")
+      expect(env["rack.input"].read).to eq("q=rack")
 
     end
 
@@ -319,11 +347,11 @@ describe ShamRack do
       patron = Patron::Session.new
       response = patron.post("http://env.xyz/resource", "<xml/>", "Content-Type" => "application/xml")
 
-      response.status.should == 200
+      expect(response.status).to eq(200)
 
-      env["REQUEST_METHOD"].should == "POST"
-      env["rack.input"].read.should == "<xml/>"
-      env["CONTENT_TYPE"].should == "application/xml"
+      expect(env["REQUEST_METHOD"]).to eq("POST")
+      expect(env["rack.input"].read).to eq("<xml/>")
+      expect(env["CONTENT_TYPE"]).to eq("application/xml")
 
     end
 
@@ -331,9 +359,9 @@ describe ShamRack do
 
       RestClient.put("http://env.xyz/thing1", "stuff", :content_type => "text/plain")
 
-      env["REQUEST_METHOD"].should == "PUT"
-      env["CONTENT_TYPE"].should == "text/plain"
-      env["rack.input"].read.should == "stuff"
+      expect(env["REQUEST_METHOD"]).to eq("PUT")
+      expect(env["CONTENT_TYPE"]).to eq("text/plain")
+      expect(env["rack.input"].read).to eq("stuff")
 
     end
 
@@ -342,9 +370,9 @@ describe ShamRack do
       patron = Patron::Session.new
       response = patron.put("http://env.xyz/resource", "stuff", "Content-Type" => "text/plain")
 
-      env["REQUEST_METHOD"].should == "PUT"
-      env["CONTENT_TYPE"].should == "text/plain"
-      env["rack.input"].read.should == "stuff"
+      expect(env["REQUEST_METHOD"]).to eq("PUT")
+      expect(env["CONTENT_TYPE"]).to eq("text/plain")
+      expect(env["rack.input"].read).to eq("stuff")
 
     end
 
@@ -352,8 +380,8 @@ describe ShamRack do
 
       RestClient.delete("http://env.xyz/thing/1")
 
-      env["REQUEST_METHOD"].should == "DELETE"
-      env["PATH_INFO"].should == "/thing/1"
+      expect(env["REQUEST_METHOD"]).to eq("DELETE")
+      expect(env["PATH_INFO"]).to eq("/thing/1")
 
     end
 
@@ -362,8 +390,8 @@ describe ShamRack do
       patron = Patron::Session.new
       response = patron.delete("http://env.xyz/resource")
 
-      env["REQUEST_METHOD"].should == "DELETE"
-      env["PATH_INFO"].should == "/resource"
+      expect(env["REQUEST_METHOD"]).to eq("DELETE")
+      expect(env["PATH_INFO"]).to eq("/resource")
 
     end
 

data/spec/spec_helper.rb

@@ -1,9 +1,8 @@
 require "rubygems"
 require "rspec"
-require "rr"
+require "rspec/mocks"
+require "test_apps"
 
 RSpec.configure do |config|
-  config.mock_with RR::Adapters::RSpec2
+  config.raise_errors_for_deprecations!
 end
-
-require "test_apps"

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: sham_rack
 version: !ruby/object:Gem::Version
-  version: 1.3.6
+  version: 1.4.0
 platform: ruby
 authors:
 - Mike Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-05 00:00:00.000000000 Z
+date: 2017-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ShamRack plumbs Net::HTTP directly into Rack, for quick and easy HTTP
   testing.
 email: mdub@dogbiscuit.org
@@ -31,21 +31,20 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Rakefile
+- benchmark/benchmark.rb
+- benchmark/hello_app.rb
+- lib/sham_rack.rb
+- lib/sham_rack/allowances.rb
 - lib/sham_rack/net_http.rb
 - lib/sham_rack/patron.rb
 - lib/sham_rack/registration.rb
 - lib/sham_rack/stub_web_service.rb
 - lib/sham_rack/version.rb
-- lib/sham_rack.rb
-- README.markdown
-- CHANGES.markdown
 - spec/sham_rack/stub_web_service_spec.rb
 - spec/sham_rack_spec.rb
 - spec/spec_helper.rb
 - spec/test_apps.rb
-- Rakefile
-- benchmark/benchmark.rb
-- benchmark/hello_app.rb
 homepage: http://github.com/mdub/sham_rack
 licenses: []
 metadata: {}
@@ -55,17 +54,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: shamrack
-rubygems_version: 2.0.0
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Net::HTTP-to-Rack plumbing

data/CHANGES.markdown

@@ -1,42 +0,0 @@
-## 1-May-2012 [mdub@dogbiscuit.org]
-
-* Validate arguments to `ShamRack#mount`.
-* Update for compatibility with patron-0.4.x.
-
-## 18-Oct-2010 [mdub@dogbiscuit.org]
-
-* Add support for Patron.
-
-## 02-Sep-2010 [mdub@dogbiscuit.org]
-
-* Fixes to support Ruby-1.9.x.
-
-## 08-Jul-2010 [jyurek@thoughtbot.com]
-
-* Add support for Mechanize.
-
-## 11-Mar-2010 [mdub@dogbiscuit.org]
-
-* Added generic `StubWebService`.
-
-## 15-Jan-2010 [jeremy.burks@gmail.com]
-
-* Fix an incompatibility with rest-client 1.2.0.
-
-## 27-Nov-2009 [mdub@dogbiscuit.org]
-
-* Change of approach: extend rather than reimplement `Net:HTTP`.  This should improve coverage of all the weird and wonderful ways of using the `Net:HTTP` API.
-
-## 5-Jun-2009 [mdub@dogbiscuit.org]
-
-* Add support for `Net::HTTP.get_response`.
-* Pass back headers provided by Rack app in the `HTTPResponse`.
-
-## 3-Jun-2009 [mdub@dogbiscuit.org]
-
-* Introduced `ShamRack#at` to simplify registration of apps.
-
-## 13-May-2009 [mdub@dogbiscuit.org]
-
-* Added accessors on HTTP object for address, port and rack_app.
-* Added accessors to imitate "net/https".

data/README.markdown

@@ -1,123 +0,0 @@
-ShamRack
-========
-
-ShamRack plumbs HTTP requests into [Rack][rack].
-
-What's it for, again?
----------------------
-
-Well, it makes it easy to _stub out external (HTTP) services_, which is handy in development and testing environments, or when you want to _test your HTTP client code_.
-
-You can also use it to _test your Rack application_ (or Sinatra, or Rails, or Merb) using a variety of HTTP client libraries, to check interoperability. For instance, you could test your app using:
-
-* [`rest-client`][rest-client]
-* [`httparty`][httparty]
-* [`oauth`][oauth]
-
-all without having to boot it in a server.
-
-Installing it
--------------
-
-    gem install sham_rack
-
-Using it
---------
-
-### A simple inline application
-
-    require 'sham_rack'
-
-    ShamRack.at("www.greetings.com") do |env|
-      ["200 OK", { "Content-type" => "text/plain" }, ["Hello, world!"]]
-    end
-      
-    require 'open-uri'
-    open("http://www.greetings.com/").read            #=> "Hello, world!"
-
-### Sinatra integration
-
-    ShamRack.at("sinatra.xyz").sinatra do
-      get "/hello/:subject" do
-        "Hello, #{params[:subject]}"
-      end
-    end
-
-    open("http://sinatra.xyz/hello/stranger").read  #=> "Hello, stranger"
-
-### Rackup support
-
-    ShamRack.at("rackup.xyz").rackup do
-      use Some::Middleware
-      use Some::Other::Middleware
-      run MyApp.new
-    end
-
-### Any old Rack app
-
-    ShamRack.at("google.com").mount(my_google_stub) 
-
-### General-purpose stubbing
-
-    @stub_app = ShamRack.at("stubbed.com").stub
-    @stub_app.register_resource("/greeting", "Hello, world!", "text/plain")
-    
-    open("http://stubbed.com/greeting").read       #=> "Hello, world!"
-    @stub_app.last_request.path                    #=> "/greeting"
-
-Or, just use Sinatra, as described above ... it's almost as succinct, and heaps more powerful.
-
-### When you're done testing
-
-    ShamRack.unmount_all
-
-    open("http://stubbed.com/greeting").read       #=> OpenURI::HTTPError
-
-Supported HTTP client libraries
--------------------------------
-
-### Net::HTTP and friends
-
-ShamRack supports requests made using Net::HTTP, or any of the numerous APIs built on top of it:
-
-    uri = URI.parse("http://www.greetings.com/")
-    Net::HTTP.get_response(uri).body                      #=> "Hello, world!"
-    
-    require 'open-uri'
-    open("http://www.greetings.com/").read                #=> "Hello, world!"
-
-    require 'restclient'
-    RestClient.get("http://www.greetings.com/").to_s      #=> "Hello, world!"
-
-    require 'mechanize'
-    Mechanize.new.get("http://www.greetings.com/").body   #=> "Hello, world!"
-
-### Patron (experimental)
-
-We've recently added support for [Patron][patron]:
-
-    require 'sham_rack/patron'
-
-    patron = Patron::Session.new
-    patron.get("http://www.greetings.com/").body          #=> "Hello, world!"
-
-What's the catch?
------------------
-
-* Your Rack request-handling code runs in the same Ruby VM, in fact the same Thread, as your request.
-
-Thanks to
----------
-
-* Blaine Cook for [FakeWeb][fakeweb], which was an inspiration for ShamRack.
-* Perryn Fowler for his efforts plumbing Net::HTTP into ActionController::TestProcess.
-* Christian Neukirchen et al for the chewy goodness that is [Rack][rack].
-
-[rack]: http://rack.rubyforge.org/
-[sinatra]: http://www.sinatrarb.com/
-[rest-client]: http://github.com/adamwiggins/rest-client
-[httparty]: http://github.com/jnunemaker/httparty
-[oauth]: http://oauth.rubyforge.org/
-[fakeweb]: http://fakeweb.rubyforge.org/
-[mechanize]: http://mechanize.rubyforge.org
-[patron]: http://github.com/toland/Patron