Pruebas Unitarias

  1. Los fuentes de este ejemplo están en https://github.com/crguezl/rack-unit-test
  2. Fuentes en GitHub de Rack::Test: https://github.com/brynary/rack-test

[~/rack/rack-unit-test(master)]$ cat rack_hello_world.rb 
# my_app.rb
#
require 'rack'

class MyApp
  def call env
    [200, {"Content-Type" => "text/html"}, ["Hello"]] 
  end
end

[~/rack/rack-unit-test(master)]$ cat test_hello_world.rb 
require "test/unit"
require "rack/test"
require './rack_hello_world'

class AppTest < Test::Unit::TestCase
  include Rack::Test::Methods

  def app
    Rack::Builder.new do
      run MyApp.new
    end.to_app
  end

  def test_index
    get "/"
    #puts last_response.inspect
    assert last_response.ok?
  end

  def test_body
    get "/"
    assert_equal last_response.body,  'Hello', "body must be hello"
  end
end
  1. The Rack::Test::Methods module serves as the primary integration point for using Rack::Test in a testing environment.

    It depends on an app method being defined in the same context,

      def app
        Rack::Builder.new do
          run MyApp.new
        end.to_app
      end
    

    and provides the Rack::Test API methods (see Rack::Test::Session for their documentation).

  2. The get method issue a GET request for the given URI. Stores the issues request object in #last_request and the app's response in #last_response (whose class is Rack::MockResponse) .

    Yield #last_response to a block if given.

      def test_index
        get "/"
        assert last_response.ok?
      end
    

  3. Otros métodos que se pueden usar son:
    1. (Object) basic_authorize(username, password) (also: #authorize) Set the username and password for HTTP Basic authorization, to be included in subsequent requests in the HTTP_AUTHORIZATION header.
    2. (Object) delete(uri, params = {}, env = {}, &block) Issue a DELETE request for the given URI.
    3. (Object) digest_authorize(username, password) Set the username and password for HTTP Digest authorization, to be included in subsequent requests in the HTTP_AUTHORIZATION header.
    4. (Object) env(name, value) Set an env var to be included on all subsequent requests through the session.
    5. (Object) follow_redirect! Rack::Test will not follow any redirects automatically.
    6. (Object) get(uri, params = {}, env = {}, &block) Issue a GET request for the given URI with the given params and Rack environment.
    7. (Object) head(uri, params = {}, env = {}, &block) Issue a HEAD request for the given URI.
    8. (Object) header(name, value) Set a header to be included on all subsequent requests through the session.
    9. (Session) initialize(mock_session) constructor Creates a Rack::Test::Session for a given Rack app or Rack::MockSession.
    10. (Object) options(uri, params = {}, env = {}, &block) Issue an OPTIONS request for the given URI.
    11. (Object) patch(uri, params = {}, env = {}, &block) Issue a PATCH request for the given URI.
    12. (Object) post(uri, params = {}, env = {}, &block) Issue a POST request for the given URI.
    13. (Object) put(uri, params = {}, env = {}, &block) Issue a PUT request for the given URI.
    14. (Object) request(uri, env = {}, &block) Issue a request to the Rack app for the given URI and optional Rack environment.

  4. The #last_response object has methods:
              =~(other) body() empty?() match(other)
    
    and attributes:
    errors          [RW]
    original_headers[R]
    Headers
    
  5. Si se usan middleware adicionales es necesario especificarlo en app:
      def app 
        Rack::Builder.new do
          use(Rack::Session::Cookie, {:key => 'rack session',·
                                      #:domain => 'localhost',
                                      #:path => '/', #:expire_after => 2592000,·
                                      :secret => 'change_me'})
          run RockPaperScissors::App.new
        end.to_app
      end
    
  6. El método last_response.body returns the last response received in the session. Raises an error if no requests have been sent yet.

[~/rack/rack-unit-test(master)]$ cat Rakefile 
task :default => :test
desc "run the tests"
task :test do
  sh "ruby test_hello_world.rb"
end

[~/rack/rack-unit-test(master)]$ cat Gemfile
source 'https://rubygems.org'

gem 'rack'
gem 'rack-test'

[~/rack/rack-unit-test(master)]$ rake
ruby test_hello_world.rb
Run options: 

# Running tests:

..

Finished tests in 0.015253s, 131.1217 tests/s, 131.1217 assertions/s.

2 tests, 2 assertions, 0 failures, 0 errors, 0 skips

Casiano Rodriguez León 2015-06-18