Class: Rack::Test::Session

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
Utils
Defined in:
lib/rack/test.rb

Overview

This class represents a series of requests issued to a Rack app, sharing a single cookie jar

Rack::Test::Session’s methods are most often called through Rack::Test::Methods, which will automatically build a session when it’s first used.

Instance Method Summary collapse

Methods included from Utils

build_file_part, build_multipart, build_nested_query, build_parts, build_primitive_part, get_parts

Constructor Details

#initialize(mock_session) ⇒ Session

Creates a Rack::Test::Session for a given Rack app or Rack::MockSession.

Note: Generally, you won’t need to initialize a Rack::Test::Session directly. Instead, you should include Rack::Test::Methods into your testing context. (See README.rdoc for an example)



35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/rack/test.rb', line 35

def initialize(mock_session)
  @headers = {}
  @env = {}
  @digest_username = nil
  @digest_password = nil

  @rack_mock_session = if mock_session.is_a?(MockSession)
    mock_session
  else
    MockSession.new(mock_session)
  end

  @default_host = @rack_mock_session.default_host
end

Instance Method Details

#basic_authorize(username, password) ⇒ Object Also known as: authorize

Set the username and password for HTTP Basic authorization, to be included in subsequent requests in the HTTP_AUTHORIZATION header.

Example:

basic_authorize "bryan", "secret"



166
167
168
169
 
# File 'lib/rack/test.rb', line 166

def basic_authorize(username, password)
   = ["#{username}:#{password}"].pack('m0')
  header('Authorization', "Basic #{}")
end

#custom_request(verb, uri, params = {}, env = {}, &block) ⇒ Object

Issue a request using the given verb for the given URI. See #get

Example:

custom_request "LINK", "/"



126
127
128
129
130
 
# File 'lib/rack/test.rb', line 126

def custom_request(verb, uri, params = {}, env = {}, &block)
  uri = parse_uri(uri, env)
  env = env_for(uri, env.merge(method: verb.to_s.upcase, params: params))
  process_request(uri, env, &block)
end

#delete(uri, params = {}, env = {}, &block) ⇒ Object

Issue a DELETE request for the given URI. See #get

Example:

delete "/"



89
90
91
 
# File 'lib/rack/test.rb', line 89

def delete(uri, params = {}, env = {}, &block)
  custom_request('DELETE', uri, params, env, &block)
end

#digest_authorize(username, password) ⇒ Object

Set the username and password for HTTP Digest authorization, to be included in subsequent requests in the HTTP_AUTHORIZATION header.

Example:

digest_authorize "bryan", "secret"



178
179
180
181
 
# File 'lib/rack/test.rb', line 178

def digest_authorize(username, password)
  @digest_username = username
  @digest_password = password
end

#env(name, value) ⇒ Object

Set an env var to be included on all subsequent requests through the session. Use a value of nil to remove a previously configured env.

Example:

env "rack.session", {:csrf => 'token'}



153
154
155
156
157
158
159
 
# File 'lib/rack/test.rb', line 153

def env(name, value)
  if value.nil?
    @env.delete(name)
  else
    @env[name] = value
  end
end

#follow_redirect! ⇒ Object

Rack::Test will not follow any redirects automatically. This method will follow the redirect returned (including setting the Referer header on the new request) in the last response. If the last response was not a redirect, an error will be raised.



187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
 
# File 'lib/rack/test.rb', line 187

def follow_redirect!
  unless last_response.redirect?
    raise Error, 'Last response was not a redirect. Cannot follow_redirect!'
  end
  request_method, params =
    if last_response.status == 307
      [last_request.request_method.downcase.to_sym, last_request.params]
    else
      [:get, {}]
    end

  # Compute the next location by appending the location header with the
  # last request, as per https://tools.ietf.org/html/rfc7231#section-7.1.2
  # Adding two absolute locations returns the right-hand location
  next_location = URI.parse(last_request.url) + URI.parse(last_response['Location'])

  send(
    request_method, next_location.to_s, params,
    'HTTP_REFERER' => last_request.url,
    'rack.session' => last_request.session,
    'rack.session.options' => last_request.session_options
  )
end

#get(uri, params = {}, env = {}, &block) ⇒ Object

Issue a GET request for the given URI with the given params and Rack environment. Stores the issues request object in #last_request and the app’s response in #last_response. Yield #last_response to a block if given.

Example:

get "/"



57
58
59
 
# File 'lib/rack/test.rb', line 57

def get(uri, params = {}, env = {}, &block)
  custom_request('GET', uri, params, env, &block)
end

#head(uri, params = {}, env = {}, &block) ⇒ Object

Issue a HEAD request for the given URI. See #get

Example:

head "/"



105
106
107
 
# File 'lib/rack/test.rb', line 105

def head(uri, params = {}, env = {}, &block)
  custom_request('HEAD', uri, params, env, &block)
end

#header(name, value) ⇒ Object

Set a header to be included on all subsequent requests through the session. Use a value of nil to remove a previously configured header.

In accordance with the Rack spec, headers will be included in the Rack environment hash in HTTP_USER_AGENT form.

Example:

header "User-Agent", "Firefox"



140
141
142
143
144
145
146
 
# File 'lib/rack/test.rb', line 140

def header(name, value)
  if value.nil?
    @headers.delete(name)
  else
    @headers[name] = value
  end
end

#options(uri, params = {}, env = {}, &block) ⇒ Object

Issue an OPTIONS request for the given URI. See #get

Example:

options "/"



97
98
99
 
# File 'lib/rack/test.rb', line 97

def options(uri, params = {}, env = {}, &block)
  custom_request('OPTIONS', uri, params, env, &block)
end

#patch(uri, params = {}, env = {}, &block) ⇒ Object

Issue a PATCH request for the given URI. See #get

Example:

patch "/"



81
82
83
 
# File 'lib/rack/test.rb', line 81

def patch(uri, params = {}, env = {}, &block)
  custom_request('PATCH', uri, params, env, &block)
end

#post(uri, params = {}, env = {}, &block) ⇒ Object

Issue a POST request for the given URI. See #get

Example:

post "/signup", "name" => "Bryan"



65
66
67
 
# File 'lib/rack/test.rb', line 65

def post(uri, params = {}, env = {}, &block)
  custom_request('POST', uri, params, env, &block)
end

#put(uri, params = {}, env = {}, &block) ⇒ Object

Issue a PUT request for the given URI. See #get

Example:

put "/"



73
74
75
 
# File 'lib/rack/test.rb', line 73

def put(uri, params = {}, env = {}, &block)
  custom_request('PUT', uri, params, env, &block)
end

#request(uri, env = {}, &block) ⇒ Object

Issue a request to the Rack app for the given URI and optional Rack environment. Stores the issues request object in #last_request and the app’s response in #last_response. Yield #last_response to a block if given.

Example:

request "/"



116
117
118
119
120
 
# File 'lib/rack/test.rb', line 116

def request(uri, env = {}, &block)
  uri = parse_uri(uri, env)
  env = env_for(uri, env)
  process_request(uri, env, &block)
end