Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fork of Blaine Cook's FakeWeb for fixes and new features
branch: master

This branch is 4 commits ahead, 364 commits behind chrisk:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



FakeWeb is a helper for faking web requests. It works at a global level, without modifying code or writing extensive stubs.


Using a string response

FakeWeb.register_uri("", :string => "Hello World!")

=> "Hello World!"

=> FakeWeb is bypassed and the response from a real request is returned

Replaying a recorded response

page = `curl -is`
FakeWeb.register_uri('', :response => page)

# => Full response, including headers

Adding a custom status to the response

FakeWeb.register_uri('', :string => "Nothing to be found 'round here",
                                            :status => ["404", "Not Found"])

Net::HTTP.start('') do |req|
  response = req.get('/')
  response.code     # => "404"
  response.message  # => "Not Found"
  response.body     # => "Nothing to be found 'round here"

Requesting with OpenURI

FakeWeb.register_uri('', :string => "Hello, World!")

=> "Hello, World!"

Clearing registered URIs

The FakeWeb registry is a singleton that lasts for the duration of your program, maintaining every fake responses you register. If needed, you can clean out the registry and remove all registered URIs:



FakeWeb is a helper for faking web requests. This makes testing easier, because you can decouple your test environment from live services without modifying code. It allows for a range of request behaviour, from simple stubbing of HTTP responses to re-playing complete recorded responses.

In addition to the conceptual advantage of having idempotent request behaviour, FakeWeb makes tests run faster than if they were made to remote (or even local) web servers. It also makes it possible to run tests without a network connection or in situations where the server is behind a firewall or has host based access controls.

FakeWeb is tested with Net::HTTP and OpenURI. It should work with any web client library that uses Net::HTTP for its underlying requests (e.g., Flickr.rb, Ruby/Amazon, soap4r, etc.)

Known Issues

  • Request bodies are ignored, including PUT and POST parameters. If you need different responses for different request bodies, you need to request different URLs, and register different responses for each.


FakeWeb - Ruby Helper for Faking Web Requests Copyright 2006 Blaine Cook <>.

FakeWeb is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

FakeWeb is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with FakeWeb; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Something went wrong with that request. Please try again.