Module: ActionDispatch::Integration::Runner

Includes:
Assertions
Included in:
ActionDispatch::IntegrationTest::Behavior
Defined in:
lib/action_dispatch/testing/integration.rb

Constant Summary collapse

APP_SESSIONS = 
{}

Constants included from Assertions::ResponseAssertions

Assertions::ResponseAssertions::RESPONSE_PREDICATES

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Assertions

#html_document

Methods included from Assertions::RoutingAssertions

#assert_generates, #assert_recognizes, #assert_routing, #setup, #with_routing

Methods included from Assertions::ResponseAssertions

#assert_in_body, #assert_not_in_body, #assert_redirected_to, #assert_response

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method) ⇒ Object (private)

Delegate unhandled messages to the current session instance.



443
444
445
446
447
448
449
450
451
 
# File 'lib/action_dispatch/testing/integration.rb', line 443

def method_missing(method, ...)
  if integration_session.respond_to?(method)
    integration_session.public_send(method, ...).tap do
      copy_session_variables!
    end
  else
    super
  end
end

Instance Attribute Details

#app ⇒ Object (readonly)

Returns the value of attribute app.



340
341
342
 
# File 'lib/action_dispatch/testing/integration.rb', line 340

def app
  @app
end

#root_session ⇒ Object

:nodoc:



341
342
343
 
# File 'lib/action_dispatch/testing/integration.rb', line 341

def root_session
  @root_session
end

Instance Method Details

#assertions ⇒ Object

:nodoc:



413
414
415
 
# File 'lib/action_dispatch/testing/integration.rb', line 413

def assertions # :nodoc:
  root_session ? root_session.assertions : super
end

#assertions=(assertions) ⇒ Object

:nodoc:



417
418
419
 
# File 'lib/action_dispatch/testing/integration.rb', line 417

def assertions=(assertions) # :nodoc:
  root_session ? root_session.assertions = assertions : super
end

#before_setup ⇒ Object

:nodoc:



348
349
350
351
 
# File 'lib/action_dispatch/testing/integration.rb', line 348

def before_setup # :nodoc:
  @app = nil
  super
end

#copy_session_variables! ⇒ Object

Copy the instance variables from the current session instance into the test instance.



423
424
425
426
427
 
# File 'lib/action_dispatch/testing/integration.rb', line 423

def copy_session_variables! # :nodoc:
  @controller = @integration_session.controller
  @response   = @integration_session.response
  @request    = @integration_session.request
end

#create_session(app) ⇒ Object 



363
364
365
366
367
368
369
370
371
372
373
 
# File 'lib/action_dispatch/testing/integration.rb', line 363

def create_session(app)
  klass = APP_SESSIONS[app] ||= Class.new(Integration::Session) {
    # If the app is a Rails app, make url_helpers available on the session. This
    # makes app.url_for and app.foo_path available in the console.
    if app.respond_to?(:routes) && app.routes.is_a?(ActionDispatch::Routing::RouteSet)
      include app.routes.url_helpers
      include app.routes.mounted_helpers
    end
  }
  klass.new(app)
end

#default_url_options ⇒ Object 



429
430
431
 
# File 'lib/action_dispatch/testing/integration.rb', line 429

def default_url_options
  integration_session.default_url_options
end

#default_url_options=(options) ⇒ Object 



433
434
435
 
# File 'lib/action_dispatch/testing/integration.rb', line 433

def default_url_options=(options)
  integration_session.default_url_options = options
end

#initialize(*args, &blk) ⇒ Object 



343
344
345
346
 
# File 'lib/action_dispatch/testing/integration.rb', line 343

def initialize(*args, &blk)
  super(*args, &blk)
  @integration_session = nil
end

#integration_session ⇒ Object 



353
354
355
 
# File 'lib/action_dispatch/testing/integration.rb', line 353

def integration_session
  @integration_session ||= create_session(app)
end

#open_session ⇒ Object

Open a new session instance. If a block is given, the new session is yielded to the block before being returned.

session = open_session do |sess|
  sess.extend(CustomAssertions)
end

By default, a single session is automatically created for you, but you can use this method to open multiple sessions that ought to be tested simultaneously.



405
406
407
408
409
410
411
 
# File 'lib/action_dispatch/testing/integration.rb', line 405

def open_session
  dup.tap do |session|
    session.reset!
    session.root_session = self.root_session || self
    yield session if block_given?
  end
end

#remove! ⇒ Object

:nodoc:



375
376
377
 
# File 'lib/action_dispatch/testing/integration.rb', line 375

def remove! # :nodoc:
  @integration_session = nil
end

#reset! ⇒ Object

Reset the current session. This is useful for testing multiple sessions in a single test case.



359
360
361
 
# File 'lib/action_dispatch/testing/integration.rb', line 359

def reset!
  @integration_session = create_session(app)
end