- Notifications
You must be signed in to change notification settings - Fork0
Rack::Test is a small, simple testing API for Rack apps.
License
gmalette/rack-test
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Code:https://github.com/rack/rack-test
Rack::Test is a small, simple testing API for Rack apps. It can be used on itsown or as a reusable starting point for Web frameworks and testing librariesto build on.
- Allows for submitting requests and testing responses
- Maintains a cookie jar across requests
- Supports request headers used for subsequent requests
- Follow redirects when requested
These examples usetest/unit but it's equally possible to userack-test withother testing frameworks such asminitest orrspec.
require"test/unit"require"rack/test"require"json"classHomepageTest <Test::Unit::TestCaseincludeRack::Test::Methodsdefapplambda{ |env|[200,{'content-type'=>'text/plain'},['All responses are OK']]}enddeftest_response_is_ok# Optionally set headers used for all requests in this spec:#header 'accept-charset', 'utf-8'# First argument is treated as the pathget'/'assertlast_response.ok?assert_equal'All responses are OK',last_response.bodyenddefdelete_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')enddefpost_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')endend
rack-test will test the app returned by theapp method. If you are loading middlewarein aconfig.ru file, and want to test that, you should load the Rack app created fromtheconfig.ru file:
OUTER_APP=Rack::Builder.parse_file("config.ru").firstclassTestApp <Test::Unit::TestCaseincludeRack::Test::MethodsdefappOUTER_APPenddeftest_rootget"/"assertlast_response.ok?endend
To install the latest release as a gem:
gem install rack-testOr add to yourGemfile:
gem 'rack-test'Contributions are welcome. Please make sure to:
- Use a regular forking workflow
- Write tests for the new or changed behaviour
- Provide an explanation/motivation in your commit message / PR message
- Ensure
History.mdis updated
- Contributions from Bryan Helmkamp, Jeremy Evans, Simon Rozet, and others
- Much of the original code was extracted from Merb 1.0's request helper
rack-test is released under theMIT License.
- Ruby 2.0+
- JRuby 9.1+
- Bump VERSION in lib/rack/test/version.rb
- Ensure
History.mdis up-to-date, including correct version and date git commit . -m 'Release $VERSION'git pushgit tag -a -m 'Tag the $VERSION release' $VERSIONgit push --tagsgem build rack-test.gemspecgem push rack-test-$VERSION.gem- Add a discussion post for the release
About
Rack::Test is a small, simple testing API for Rack apps.
Resources
License
Stars
Watchers
Forks
Packages0
Languages
- Ruby99.9%
- Logos0.1%