Code: https://github.com/rack/rack-test
Rack::Test is a small, simple testing API for Rack apps. It can be used on its own or as a reusable starting point for Web frameworks and testing libraries to build on.
These examples use test/unit
but it's equally possible to use rack-test
with other testing frameworks such as minitest
or rspec
.
require "test/unit" require "rack/test" require "json" class HomepageTest < Test::Unit::TestCase include Rack::Test::Methods def app lambda { |env| [200, {'content-type' => 'text/plain'}, ['All responses are OK']] } end def test_response_is_ok # Optionally set headers used for all requests in this spec: #header 'accept-charset', 'utf-8' # First argument is treated as the path get '/' assert last_response.ok? assert_equal 'All responses are OK', last_response.body end def delete_with_url_params_and_body # First argument can have a query string # # Second argument is used as the parameters for the request, which will be # included in the request body for non-GET requests. delete '/?foo=bar', JSON.generate('baz' => 'zot') end def post_with_json # Third argument is the rack environment to use for the request. The following # entries in the submitted rack environment are treated specially (in addition # to options supported by `Rack::MockRequest#env_for`: # # :cookie : Set a cookie for the current session before submitting the request. # # :query_params : Set parameters for the query string (as opposed to the body). # Value should be a hash of parameters. # # :xhr : Set HTTP_X_REQUESTED_WITH env key to XMLHttpRequest. post(uri, JSON.generate('baz' => 'zot'), 'CONTENT_TYPE' => 'application/json') end end
rack-test
will test the app returned by the app
method. If you are loading middleware in a config.ru
file, and want to test that, you should load the Rack app created from the config.ru
file:
OUTER_APP = Rack::Builder.parse_file("config.ru").first class TestApp < Test::Unit::TestCase include Rack::Test::Methods def app OUTER_APP end def test_root get "/" assert last_response.ok? end end
If your application does not automatically use the Rack::Lint
middleware in test mode, and you want to test that requests to and responses from your application are compliant with the Rack specification, you should manually use the Rack::Lint
middleware:
class TestApp < Test::Unit::TestCase include Rack::Test::Methods APP = Rack::Lint.new(YOUR_APP) def app APP end end
To install the latest release as a gem:
Or add to your Gemfile
:
Contributions are welcome. Please make sure to:
History.md
is updatedrack-test
is released under the MIT License.
History.md
is up-to-date, including correct version and dategit commit . -m 'Release $VERSION'
git push
git tag -a -m 'Tag the $VERSION release' $VERSION
git push --tags
gem build rack-test.gemspec
gem push rack-test-$VERSION.gem
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4