actionpack 5.2.3
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of actionpack might be problematic. Click here for more details.
- checksums.yaml +7 -0
- data/CHANGELOG.md +429 -0
- data/MIT-LICENSE +21 -0
- data/README.rdoc +57 -0
- data/lib/abstract_controller.rb +27 -0
- data/lib/abstract_controller/asset_paths.rb +12 -0
- data/lib/abstract_controller/base.rb +265 -0
- data/lib/abstract_controller/caching.rb +66 -0
- data/lib/abstract_controller/caching/fragments.rb +166 -0
- data/lib/abstract_controller/callbacks.rb +212 -0
- data/lib/abstract_controller/collector.rb +43 -0
- data/lib/abstract_controller/error.rb +6 -0
- data/lib/abstract_controller/helpers.rb +194 -0
- data/lib/abstract_controller/logger.rb +14 -0
- data/lib/abstract_controller/railties/routes_helpers.rb +20 -0
- data/lib/abstract_controller/rendering.rb +127 -0
- data/lib/abstract_controller/translation.rb +31 -0
- data/lib/abstract_controller/url_for.rb +35 -0
- data/lib/action_controller.rb +66 -0
- data/lib/action_controller/api.rb +149 -0
- data/lib/action_controller/api/api_rendering.rb +16 -0
- data/lib/action_controller/base.rb +276 -0
- data/lib/action_controller/caching.rb +46 -0
- data/lib/action_controller/form_builder.rb +50 -0
- data/lib/action_controller/log_subscriber.rb +78 -0
- data/lib/action_controller/metal.rb +256 -0
- data/lib/action_controller/metal/basic_implicit_render.rb +13 -0
- data/lib/action_controller/metal/conditional_get.rb +274 -0
- data/lib/action_controller/metal/content_security_policy.rb +52 -0
- data/lib/action_controller/metal/cookies.rb +16 -0
- data/lib/action_controller/metal/data_streaming.rb +152 -0
- data/lib/action_controller/metal/etag_with_flash.rb +18 -0
- data/lib/action_controller/metal/etag_with_template_digest.rb +57 -0
- data/lib/action_controller/metal/exceptions.rb +53 -0
- data/lib/action_controller/metal/flash.rb +61 -0
- data/lib/action_controller/metal/force_ssl.rb +99 -0
- data/lib/action_controller/metal/head.rb +60 -0
- data/lib/action_controller/metal/helpers.rb +123 -0
- data/lib/action_controller/metal/http_authentication.rb +519 -0
- data/lib/action_controller/metal/implicit_render.rb +73 -0
- data/lib/action_controller/metal/instrumentation.rb +107 -0
- data/lib/action_controller/metal/live.rb +312 -0
- data/lib/action_controller/metal/mime_responds.rb +313 -0
- data/lib/action_controller/metal/parameter_encoding.rb +51 -0
- data/lib/action_controller/metal/params_wrapper.rb +293 -0
- data/lib/action_controller/metal/redirecting.rb +133 -0
- data/lib/action_controller/metal/renderers.rb +181 -0
- data/lib/action_controller/metal/rendering.rb +122 -0
- data/lib/action_controller/metal/request_forgery_protection.rb +445 -0
- data/lib/action_controller/metal/rescue.rb +28 -0
- data/lib/action_controller/metal/streaming.rb +223 -0
- data/lib/action_controller/metal/strong_parameters.rb +1086 -0
- data/lib/action_controller/metal/testing.rb +16 -0
- data/lib/action_controller/metal/url_for.rb +58 -0
- data/lib/action_controller/railtie.rb +89 -0
- data/lib/action_controller/railties/helpers.rb +24 -0
- data/lib/action_controller/renderer.rb +117 -0
- data/lib/action_controller/template_assertions.rb +11 -0
- data/lib/action_controller/test_case.rb +629 -0
- data/lib/action_dispatch.rb +112 -0
- data/lib/action_dispatch/http/cache.rb +222 -0
- data/lib/action_dispatch/http/content_security_policy.rb +272 -0
- data/lib/action_dispatch/http/filter_parameters.rb +84 -0
- data/lib/action_dispatch/http/filter_redirect.rb +37 -0
- data/lib/action_dispatch/http/headers.rb +132 -0
- data/lib/action_dispatch/http/mime_negotiation.rb +175 -0
- data/lib/action_dispatch/http/mime_type.rb +342 -0
- data/lib/action_dispatch/http/mime_types.rb +50 -0
- data/lib/action_dispatch/http/parameter_filter.rb +86 -0
- data/lib/action_dispatch/http/parameters.rb +126 -0
- data/lib/action_dispatch/http/rack_cache.rb +63 -0
- data/lib/action_dispatch/http/request.rb +430 -0
- data/lib/action_dispatch/http/response.rb +519 -0
- data/lib/action_dispatch/http/upload.rb +84 -0
- data/lib/action_dispatch/http/url.rb +350 -0
- data/lib/action_dispatch/journey.rb +7 -0
- data/lib/action_dispatch/journey/formatter.rb +189 -0
- data/lib/action_dispatch/journey/gtg/builder.rb +164 -0
- data/lib/action_dispatch/journey/gtg/simulator.rb +41 -0
- data/lib/action_dispatch/journey/gtg/transition_table.rb +158 -0
- data/lib/action_dispatch/journey/nfa/builder.rb +78 -0
- data/lib/action_dispatch/journey/nfa/dot.rb +36 -0
- data/lib/action_dispatch/journey/nfa/simulator.rb +49 -0
- data/lib/action_dispatch/journey/nfa/transition_table.rb +120 -0
- data/lib/action_dispatch/journey/nodes/node.rb +140 -0
- data/lib/action_dispatch/journey/parser.rb +199 -0
- data/lib/action_dispatch/journey/parser.y +50 -0
- data/lib/action_dispatch/journey/parser_extras.rb +31 -0
- data/lib/action_dispatch/journey/path/pattern.rb +198 -0
- data/lib/action_dispatch/journey/route.rb +203 -0
- data/lib/action_dispatch/journey/router.rb +156 -0
- data/lib/action_dispatch/journey/router/utils.rb +102 -0
- data/lib/action_dispatch/journey/routes.rb +82 -0
- data/lib/action_dispatch/journey/scanner.rb +64 -0
- data/lib/action_dispatch/journey/visitors.rb +268 -0
- data/lib/action_dispatch/journey/visualizer/fsm.css +30 -0
- data/lib/action_dispatch/journey/visualizer/fsm.js +134 -0
- data/lib/action_dispatch/journey/visualizer/index.html.erb +52 -0
- data/lib/action_dispatch/middleware/callbacks.rb +36 -0
- data/lib/action_dispatch/middleware/cookies.rb +685 -0
- data/lib/action_dispatch/middleware/debug_exceptions.rb +205 -0
- data/lib/action_dispatch/middleware/debug_locks.rb +124 -0
- data/lib/action_dispatch/middleware/exception_wrapper.rb +147 -0
- data/lib/action_dispatch/middleware/executor.rb +21 -0
- data/lib/action_dispatch/middleware/flash.rb +300 -0
- data/lib/action_dispatch/middleware/public_exceptions.rb +57 -0
- data/lib/action_dispatch/middleware/reloader.rb +12 -0
- data/lib/action_dispatch/middleware/remote_ip.rb +183 -0
- data/lib/action_dispatch/middleware/request_id.rb +43 -0
- data/lib/action_dispatch/middleware/session/abstract_store.rb +92 -0
- data/lib/action_dispatch/middleware/session/cache_store.rb +54 -0
- data/lib/action_dispatch/middleware/session/cookie_store.rb +118 -0
- data/lib/action_dispatch/middleware/session/mem_cache_store.rb +28 -0
- data/lib/action_dispatch/middleware/show_exceptions.rb +62 -0
- data/lib/action_dispatch/middleware/ssl.rb +150 -0
- data/lib/action_dispatch/middleware/stack.rb +116 -0
- data/lib/action_dispatch/middleware/static.rb +130 -0
- data/lib/action_dispatch/middleware/templates/rescues/_request_and_response.html.erb +22 -0
- data/lib/action_dispatch/middleware/templates/rescues/_request_and_response.text.erb +23 -0
- data/lib/action_dispatch/middleware/templates/rescues/_source.html.erb +27 -0
- data/lib/action_dispatch/middleware/templates/rescues/_source.text.erb +8 -0
- data/lib/action_dispatch/middleware/templates/rescues/_trace.html.erb +52 -0
- data/lib/action_dispatch/middleware/templates/rescues/_trace.text.erb +9 -0
- data/lib/action_dispatch/middleware/templates/rescues/diagnostics.html.erb +16 -0
- data/lib/action_dispatch/middleware/templates/rescues/diagnostics.text.erb +9 -0
- data/lib/action_dispatch/middleware/templates/rescues/invalid_statement.html.erb +21 -0
- data/lib/action_dispatch/middleware/templates/rescues/invalid_statement.text.erb +13 -0
- data/lib/action_dispatch/middleware/templates/rescues/layout.erb +161 -0
- data/lib/action_dispatch/middleware/templates/rescues/missing_template.html.erb +11 -0
- data/lib/action_dispatch/middleware/templates/rescues/missing_template.text.erb +3 -0
- data/lib/action_dispatch/middleware/templates/rescues/routing_error.html.erb +32 -0
- data/lib/action_dispatch/middleware/templates/rescues/routing_error.text.erb +11 -0
- data/lib/action_dispatch/middleware/templates/rescues/template_error.html.erb +20 -0
- data/lib/action_dispatch/middleware/templates/rescues/template_error.text.erb +7 -0
- data/lib/action_dispatch/middleware/templates/rescues/unknown_action.html.erb +6 -0
- data/lib/action_dispatch/middleware/templates/rescues/unknown_action.text.erb +3 -0
- data/lib/action_dispatch/middleware/templates/routes/_route.html.erb +16 -0
- data/lib/action_dispatch/middleware/templates/routes/_table.html.erb +200 -0
- data/lib/action_dispatch/railtie.rb +55 -0
- data/lib/action_dispatch/request/session.rb +234 -0
- data/lib/action_dispatch/request/utils.rb +78 -0
- data/lib/action_dispatch/routing.rb +260 -0
- data/lib/action_dispatch/routing/endpoint.rb +17 -0
- data/lib/action_dispatch/routing/inspector.rb +225 -0
- data/lib/action_dispatch/routing/mapper.rb +2267 -0
- data/lib/action_dispatch/routing/polymorphic_routes.rb +352 -0
- data/lib/action_dispatch/routing/redirection.rb +201 -0
- data/lib/action_dispatch/routing/route_set.rb +890 -0
- data/lib/action_dispatch/routing/routes_proxy.rb +69 -0
- data/lib/action_dispatch/routing/url_for.rb +236 -0
- data/lib/action_dispatch/system_test_case.rb +147 -0
- data/lib/action_dispatch/system_testing/browser.rb +49 -0
- data/lib/action_dispatch/system_testing/driver.rb +59 -0
- data/lib/action_dispatch/system_testing/server.rb +31 -0
- data/lib/action_dispatch/system_testing/test_helpers/screenshot_helper.rb +96 -0
- data/lib/action_dispatch/system_testing/test_helpers/setup_and_teardown.rb +31 -0
- data/lib/action_dispatch/system_testing/test_helpers/undef_methods.rb +26 -0
- data/lib/action_dispatch/testing/assertion_response.rb +47 -0
- data/lib/action_dispatch/testing/assertions.rb +24 -0
- data/lib/action_dispatch/testing/assertions/response.rb +107 -0
- data/lib/action_dispatch/testing/assertions/routing.rb +222 -0
- data/lib/action_dispatch/testing/integration.rb +652 -0
- data/lib/action_dispatch/testing/request_encoder.rb +55 -0
- data/lib/action_dispatch/testing/test_process.rb +50 -0
- data/lib/action_dispatch/testing/test_request.rb +71 -0
- data/lib/action_dispatch/testing/test_response.rb +53 -0
- data/lib/action_pack.rb +26 -0
- data/lib/action_pack/gem_version.rb +17 -0
- data/lib/action_pack/version.rb +10 -0
- metadata +318 -0
@@ -0,0 +1,69 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
require "active_support/core_ext/array/extract_options"
|
4
|
+
|
5
|
+
module ActionDispatch
|
6
|
+
module Routing
|
7
|
+
class RoutesProxy #:nodoc:
|
8
|
+
include ActionDispatch::Routing::UrlFor
|
9
|
+
|
10
|
+
attr_accessor :scope, :routes
|
11
|
+
alias :_routes :routes
|
12
|
+
|
13
|
+
def initialize(routes, scope, helpers, script_namer = nil)
|
14
|
+
@routes, @scope = routes, scope
|
15
|
+
@helpers = helpers
|
16
|
+
@script_namer = script_namer
|
17
|
+
end
|
18
|
+
|
19
|
+
def url_options
|
20
|
+
scope.send(:_with_routes, routes) do
|
21
|
+
scope.url_options
|
22
|
+
end
|
23
|
+
end
|
24
|
+
|
25
|
+
private
|
26
|
+
def respond_to_missing?(method, _)
|
27
|
+
super || @helpers.respond_to?(method)
|
28
|
+
end
|
29
|
+
|
30
|
+
def method_missing(method, *args)
|
31
|
+
if @helpers.respond_to?(method)
|
32
|
+
self.class.class_eval <<-RUBY, __FILE__, __LINE__ + 1
|
33
|
+
def #{method}(*args)
|
34
|
+
options = args.extract_options!
|
35
|
+
options = url_options.merge((options || {}).symbolize_keys)
|
36
|
+
|
37
|
+
if @script_namer
|
38
|
+
options[:script_name] = merge_script_names(
|
39
|
+
options[:script_name],
|
40
|
+
@script_namer.call(options)
|
41
|
+
)
|
42
|
+
end
|
43
|
+
|
44
|
+
args << options
|
45
|
+
@helpers.#{method}(*args)
|
46
|
+
end
|
47
|
+
RUBY
|
48
|
+
public_send(method, *args)
|
49
|
+
else
|
50
|
+
super
|
51
|
+
end
|
52
|
+
end
|
53
|
+
|
54
|
+
# Keeps the part of the script name provided by the global
|
55
|
+
# context via ENV["SCRIPT_NAME"], which `mount` doesn't know
|
56
|
+
# about since it depends on the specific request, but use our
|
57
|
+
# script name resolver for the mount point dependent part.
|
58
|
+
def merge_script_names(previous_script_name, new_script_name)
|
59
|
+
return new_script_name unless previous_script_name
|
60
|
+
|
61
|
+
resolved_parts = new_script_name.count("/")
|
62
|
+
previous_parts = previous_script_name.count("/")
|
63
|
+
context_parts = previous_parts - resolved_parts + 1
|
64
|
+
|
65
|
+
(previous_script_name.split("/").slice(0, context_parts).join("/")) + new_script_name
|
66
|
+
end
|
67
|
+
end
|
68
|
+
end
|
69
|
+
end
|
@@ -0,0 +1,236 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module ActionDispatch
|
4
|
+
module Routing
|
5
|
+
# In <tt>config/routes.rb</tt> you define URL-to-controller mappings, but the reverse
|
6
|
+
# is also possible: a URL can be generated from one of your routing definitions.
|
7
|
+
# URL generation functionality is centralized in this module.
|
8
|
+
#
|
9
|
+
# See ActionDispatch::Routing for general information about routing and routes.rb.
|
10
|
+
#
|
11
|
+
# <b>Tip:</b> If you need to generate URLs from your models or some other place,
|
12
|
+
# then ActionController::UrlFor is what you're looking for. Read on for
|
13
|
+
# an introduction. In general, this module should not be included on its own,
|
14
|
+
# as it is usually included by url_helpers (as in Rails.application.routes.url_helpers).
|
15
|
+
#
|
16
|
+
# == URL generation from parameters
|
17
|
+
#
|
18
|
+
# As you may know, some functions, such as ActionController::Base#url_for
|
19
|
+
# and ActionView::Helpers::UrlHelper#link_to, can generate URLs given a set
|
20
|
+
# of parameters. For example, you've probably had the chance to write code
|
21
|
+
# like this in one of your views:
|
22
|
+
#
|
23
|
+
# <%= link_to('Click here', controller: 'users',
|
24
|
+
# action: 'new', message: 'Welcome!') %>
|
25
|
+
# # => <a href="/users/new?message=Welcome%21">Click here</a>
|
26
|
+
#
|
27
|
+
# link_to, and all other functions that require URL generation functionality,
|
28
|
+
# actually use ActionController::UrlFor under the hood. And in particular,
|
29
|
+
# they use the ActionController::UrlFor#url_for method. One can generate
|
30
|
+
# the same path as the above example by using the following code:
|
31
|
+
#
|
32
|
+
# include UrlFor
|
33
|
+
# url_for(controller: 'users',
|
34
|
+
# action: 'new',
|
35
|
+
# message: 'Welcome!',
|
36
|
+
# only_path: true)
|
37
|
+
# # => "/users/new?message=Welcome%21"
|
38
|
+
#
|
39
|
+
# Notice the <tt>only_path: true</tt> part. This is because UrlFor has no
|
40
|
+
# information about the website hostname that your Rails app is serving. So if you
|
41
|
+
# want to include the hostname as well, then you must also pass the <tt>:host</tt>
|
42
|
+
# argument:
|
43
|
+
#
|
44
|
+
# include UrlFor
|
45
|
+
# url_for(controller: 'users',
|
46
|
+
# action: 'new',
|
47
|
+
# message: 'Welcome!',
|
48
|
+
# host: 'www.example.com')
|
49
|
+
# # => "http://www.example.com/users/new?message=Welcome%21"
|
50
|
+
#
|
51
|
+
# By default, all controllers and views have access to a special version of url_for,
|
52
|
+
# that already knows what the current hostname is. So if you use url_for in your
|
53
|
+
# controllers or your views, then you don't need to explicitly pass the <tt>:host</tt>
|
54
|
+
# argument.
|
55
|
+
#
|
56
|
+
# For convenience reasons, mailers provide a shortcut for ActionController::UrlFor#url_for.
|
57
|
+
# So within mailers, you only have to type +url_for+ instead of 'ActionController::UrlFor#url_for'
|
58
|
+
# in full. However, mailers don't have hostname information, and you still have to provide
|
59
|
+
# the +:host+ argument or set the default host that will be used in all mailers using the
|
60
|
+
# configuration option +config.action_mailer.default_url_options+. For more information on
|
61
|
+
# url_for in mailers read the ActionMailer#Base documentation.
|
62
|
+
#
|
63
|
+
#
|
64
|
+
# == URL generation for named routes
|
65
|
+
#
|
66
|
+
# UrlFor also allows one to access methods that have been auto-generated from
|
67
|
+
# named routes. For example, suppose that you have a 'users' resource in your
|
68
|
+
# <tt>config/routes.rb</tt>:
|
69
|
+
#
|
70
|
+
# resources :users
|
71
|
+
#
|
72
|
+
# This generates, among other things, the method <tt>users_path</tt>. By default,
|
73
|
+
# this method is accessible from your controllers, views and mailers. If you need
|
74
|
+
# to access this auto-generated method from other places (such as a model), then
|
75
|
+
# you can do that by including Rails.application.routes.url_helpers in your class:
|
76
|
+
#
|
77
|
+
# class User < ActiveRecord::Base
|
78
|
+
# include Rails.application.routes.url_helpers
|
79
|
+
#
|
80
|
+
# def base_uri
|
81
|
+
# user_path(self)
|
82
|
+
# end
|
83
|
+
# end
|
84
|
+
#
|
85
|
+
# User.find(1).base_uri # => "/users/1"
|
86
|
+
#
|
87
|
+
module UrlFor
|
88
|
+
extend ActiveSupport::Concern
|
89
|
+
include PolymorphicRoutes
|
90
|
+
|
91
|
+
included do
|
92
|
+
unless method_defined?(:default_url_options)
|
93
|
+
# Including in a class uses an inheritable hash. Modules get a plain hash.
|
94
|
+
if respond_to?(:class_attribute)
|
95
|
+
class_attribute :default_url_options
|
96
|
+
else
|
97
|
+
mattr_writer :default_url_options
|
98
|
+
end
|
99
|
+
|
100
|
+
self.default_url_options = {}
|
101
|
+
end
|
102
|
+
|
103
|
+
include(*_url_for_modules) if respond_to?(:_url_for_modules)
|
104
|
+
end
|
105
|
+
|
106
|
+
def initialize(*)
|
107
|
+
@_routes = nil
|
108
|
+
super
|
109
|
+
end
|
110
|
+
|
111
|
+
# Hook overridden in controller to add request information
|
112
|
+
# with +default_url_options+. Application logic should not
|
113
|
+
# go into url_options.
|
114
|
+
def url_options
|
115
|
+
default_url_options
|
116
|
+
end
|
117
|
+
|
118
|
+
# Generate a URL based on the options provided, default_url_options and the
|
119
|
+
# routes defined in routes.rb. The following options are supported:
|
120
|
+
#
|
121
|
+
# * <tt>:only_path</tt> - If true, the relative URL is returned. Defaults to +false+.
|
122
|
+
# * <tt>:protocol</tt> - The protocol to connect to. Defaults to 'http'.
|
123
|
+
# * <tt>:host</tt> - Specifies the host the link should be targeted at.
|
124
|
+
# If <tt>:only_path</tt> is false, this option must be
|
125
|
+
# provided either explicitly, or via +default_url_options+.
|
126
|
+
# * <tt>:subdomain</tt> - Specifies the subdomain of the link, using the +tld_length+
|
127
|
+
# to split the subdomain from the host.
|
128
|
+
# If false, removes all subdomains from the host part of the link.
|
129
|
+
# * <tt>:domain</tt> - Specifies the domain of the link, using the +tld_length+
|
130
|
+
# to split the domain from the host.
|
131
|
+
# * <tt>:tld_length</tt> - Number of labels the TLD id composed of, only used if
|
132
|
+
# <tt>:subdomain</tt> or <tt>:domain</tt> are supplied. Defaults to
|
133
|
+
# <tt>ActionDispatch::Http::URL.tld_length</tt>, which in turn defaults to 1.
|
134
|
+
# * <tt>:port</tt> - Optionally specify the port to connect to.
|
135
|
+
# * <tt>:anchor</tt> - An anchor name to be appended to the path.
|
136
|
+
# * <tt>:trailing_slash</tt> - If true, adds a trailing slash, as in "/archive/2009/"
|
137
|
+
# * <tt>:script_name</tt> - Specifies application path relative to domain root. If provided, prepends application path.
|
138
|
+
#
|
139
|
+
# Any other key (<tt>:controller</tt>, <tt>:action</tt>, etc.) given to
|
140
|
+
# +url_for+ is forwarded to the Routes module.
|
141
|
+
#
|
142
|
+
# url_for controller: 'tasks', action: 'testing', host: 'somehost.org', port: '8080'
|
143
|
+
# # => 'http://somehost.org:8080/tasks/testing'
|
144
|
+
# url_for controller: 'tasks', action: 'testing', host: 'somehost.org', anchor: 'ok', only_path: true
|
145
|
+
# # => '/tasks/testing#ok'
|
146
|
+
# url_for controller: 'tasks', action: 'testing', trailing_slash: true
|
147
|
+
# # => 'http://somehost.org/tasks/testing/'
|
148
|
+
# url_for controller: 'tasks', action: 'testing', host: 'somehost.org', number: '33'
|
149
|
+
# # => 'http://somehost.org/tasks/testing?number=33'
|
150
|
+
# url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp"
|
151
|
+
# # => 'http://somehost.org/myapp/tasks/testing'
|
152
|
+
# url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp", only_path: true
|
153
|
+
# # => '/myapp/tasks/testing'
|
154
|
+
#
|
155
|
+
# Missing routes keys may be filled in from the current request's parameters
|
156
|
+
# (e.g. +:controller+, +:action+, +:id+ and any other parameters that are
|
157
|
+
# placed in the path). Given that the current action has been reached
|
158
|
+
# through <tt>GET /users/1</tt>:
|
159
|
+
#
|
160
|
+
# url_for(only_path: true) # => '/users/1'
|
161
|
+
# url_for(only_path: true, action: 'edit') # => '/users/1/edit'
|
162
|
+
# url_for(only_path: true, action: 'edit', id: 2) # => '/users/2/edit'
|
163
|
+
#
|
164
|
+
# Notice that no +:id+ parameter was provided to the first +url_for+ call
|
165
|
+
# and the helper used the one from the route's path. Any path parameter
|
166
|
+
# implicitly used by +url_for+ can always be overwritten like shown on the
|
167
|
+
# last +url_for+ calls.
|
168
|
+
def url_for(options = nil)
|
169
|
+
full_url_for(options)
|
170
|
+
end
|
171
|
+
|
172
|
+
def full_url_for(options = nil) # :nodoc:
|
173
|
+
case options
|
174
|
+
when nil
|
175
|
+
_routes.url_for(url_options.symbolize_keys)
|
176
|
+
when Hash, ActionController::Parameters
|
177
|
+
route_name = options.delete :use_route
|
178
|
+
merged_url_options = options.to_h.symbolize_keys.reverse_merge!(url_options)
|
179
|
+
_routes.url_for(merged_url_options, route_name)
|
180
|
+
when String
|
181
|
+
options
|
182
|
+
when Symbol
|
183
|
+
HelperMethodBuilder.url.handle_string_call self, options
|
184
|
+
when Array
|
185
|
+
components = options.dup
|
186
|
+
polymorphic_url(components, components.extract_options!)
|
187
|
+
when Class
|
188
|
+
HelperMethodBuilder.url.handle_class_call self, options
|
189
|
+
else
|
190
|
+
HelperMethodBuilder.url.handle_model_call self, options
|
191
|
+
end
|
192
|
+
end
|
193
|
+
|
194
|
+
# Allows calling direct or regular named route.
|
195
|
+
#
|
196
|
+
# resources :buckets
|
197
|
+
#
|
198
|
+
# direct :recordable do |recording|
|
199
|
+
# route_for(:bucket, recording.bucket)
|
200
|
+
# end
|
201
|
+
#
|
202
|
+
# direct :threadable do |threadable|
|
203
|
+
# route_for(:recordable, threadable.parent)
|
204
|
+
# end
|
205
|
+
#
|
206
|
+
# This maintains the context of the original caller on
|
207
|
+
# whether to return a path or full URL, e.g:
|
208
|
+
#
|
209
|
+
# threadable_path(threadable) # => "/buckets/1"
|
210
|
+
# threadable_url(threadable) # => "http://example.com/buckets/1"
|
211
|
+
#
|
212
|
+
def route_for(name, *args)
|
213
|
+
public_send(:"#{name}_url", *args)
|
214
|
+
end
|
215
|
+
|
216
|
+
protected
|
217
|
+
|
218
|
+
def optimize_routes_generation?
|
219
|
+
_routes.optimize_routes_generation? && default_url_options.empty?
|
220
|
+
end
|
221
|
+
|
222
|
+
private
|
223
|
+
|
224
|
+
def _with_routes(routes) # :doc:
|
225
|
+
old_routes, @_routes = @_routes, routes
|
226
|
+
yield
|
227
|
+
ensure
|
228
|
+
@_routes = old_routes
|
229
|
+
end
|
230
|
+
|
231
|
+
def _routes_context # :doc:
|
232
|
+
self
|
233
|
+
end
|
234
|
+
end
|
235
|
+
end
|
236
|
+
end
|
@@ -0,0 +1,147 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
gem "capybara", ">= 2.15"
|
4
|
+
|
5
|
+
require "capybara/dsl"
|
6
|
+
require "capybara/minitest"
|
7
|
+
require "action_controller"
|
8
|
+
require "action_dispatch/system_testing/driver"
|
9
|
+
require "action_dispatch/system_testing/browser"
|
10
|
+
require "action_dispatch/system_testing/server"
|
11
|
+
require "action_dispatch/system_testing/test_helpers/screenshot_helper"
|
12
|
+
require "action_dispatch/system_testing/test_helpers/setup_and_teardown"
|
13
|
+
require "action_dispatch/system_testing/test_helpers/undef_methods"
|
14
|
+
|
15
|
+
module ActionDispatch
|
16
|
+
# = System Testing
|
17
|
+
#
|
18
|
+
# System tests let you test applications in the browser. Because system
|
19
|
+
# tests use a real browser experience, you can test all of your JavaScript
|
20
|
+
# easily from your test suite.
|
21
|
+
#
|
22
|
+
# To create a system test in your application, extend your test class
|
23
|
+
# from <tt>ApplicationSystemTestCase</tt>. System tests use Capybara as a
|
24
|
+
# base and allow you to configure the settings through your
|
25
|
+
# <tt>application_system_test_case.rb</tt> file that is generated with a new
|
26
|
+
# application or scaffold.
|
27
|
+
#
|
28
|
+
# Here is an example system test:
|
29
|
+
#
|
30
|
+
# require 'application_system_test_case'
|
31
|
+
#
|
32
|
+
# class Users::CreateTest < ApplicationSystemTestCase
|
33
|
+
# test "adding a new user" do
|
34
|
+
# visit users_path
|
35
|
+
# click_on 'New User'
|
36
|
+
#
|
37
|
+
# fill_in 'Name', with: 'Arya'
|
38
|
+
# click_on 'Create User'
|
39
|
+
#
|
40
|
+
# assert_text 'Arya'
|
41
|
+
# end
|
42
|
+
# end
|
43
|
+
#
|
44
|
+
# When generating an application or scaffold, an +application_system_test_case.rb+
|
45
|
+
# file will also be generated containing the base class for system testing.
|
46
|
+
# This is where you can change the driver, add Capybara settings, and other
|
47
|
+
# configuration for your system tests.
|
48
|
+
#
|
49
|
+
# require "test_helper"
|
50
|
+
#
|
51
|
+
# class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
|
52
|
+
# driven_by :selenium, using: :chrome, screen_size: [1400, 1400]
|
53
|
+
# end
|
54
|
+
#
|
55
|
+
# By default, <tt>ActionDispatch::SystemTestCase</tt> is driven by the
|
56
|
+
# Selenium driver, with the Chrome browser, and a browser size of 1400x1400.
|
57
|
+
#
|
58
|
+
# Changing the driver configuration options is easy. Let's say you want to use
|
59
|
+
# the Firefox browser instead of Chrome. In your +application_system_test_case.rb+
|
60
|
+
# file add the following:
|
61
|
+
#
|
62
|
+
# require "test_helper"
|
63
|
+
#
|
64
|
+
# class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
|
65
|
+
# driven_by :selenium, using: :firefox
|
66
|
+
# end
|
67
|
+
#
|
68
|
+
# +driven_by+ has a required argument for the driver name. The keyword
|
69
|
+
# arguments are +:using+ for the browser and +:screen_size+ to change the
|
70
|
+
# size of the browser screen. These two options are not applicable for
|
71
|
+
# headless drivers and will be silently ignored if passed.
|
72
|
+
#
|
73
|
+
# Headless browsers such as headless Chrome and headless Firefox are also supported.
|
74
|
+
# You can use these browsers by setting the +:using+ argument to +:headless_chrome+ or +:headless_firefox+.
|
75
|
+
#
|
76
|
+
# To use a headless driver, like Poltergeist, update your Gemfile to use
|
77
|
+
# Poltergeist instead of Selenium and then declare the driver name in the
|
78
|
+
# +application_system_test_case.rb+ file. In this case, you would leave out
|
79
|
+
# the +:using+ option because the driver is headless, but you can still use
|
80
|
+
# +:screen_size+ to change the size of the browser screen, also you can use
|
81
|
+
# +:options+ to pass options supported by the driver. Please refer to your
|
82
|
+
# driver documentation to learn about supported options.
|
83
|
+
#
|
84
|
+
# require "test_helper"
|
85
|
+
# require "capybara/poltergeist"
|
86
|
+
#
|
87
|
+
# class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
|
88
|
+
# driven_by :poltergeist, screen_size: [1400, 1400], options:
|
89
|
+
# { js_errors: true }
|
90
|
+
# end
|
91
|
+
#
|
92
|
+
# Because <tt>ActionDispatch::SystemTestCase</tt> is a shim between Capybara
|
93
|
+
# and Rails, any driver that is supported by Capybara is supported by system
|
94
|
+
# tests as long as you include the required gems and files.
|
95
|
+
class SystemTestCase < IntegrationTest
|
96
|
+
include Capybara::DSL
|
97
|
+
include Capybara::Minitest::Assertions
|
98
|
+
include SystemTesting::TestHelpers::SetupAndTeardown
|
99
|
+
include SystemTesting::TestHelpers::ScreenshotHelper
|
100
|
+
include SystemTesting::TestHelpers::UndefMethods
|
101
|
+
|
102
|
+
def initialize(*) # :nodoc:
|
103
|
+
super
|
104
|
+
self.class.driver.use
|
105
|
+
end
|
106
|
+
|
107
|
+
def self.start_application # :nodoc:
|
108
|
+
Capybara.app = Rack::Builder.new do
|
109
|
+
map "/" do
|
110
|
+
run Rails.application
|
111
|
+
end
|
112
|
+
end
|
113
|
+
|
114
|
+
SystemTesting::Server.new.run
|
115
|
+
end
|
116
|
+
|
117
|
+
class_attribute :driver, instance_accessor: false
|
118
|
+
|
119
|
+
# System Test configuration options
|
120
|
+
#
|
121
|
+
# The default settings are Selenium, using Chrome, with a screen size
|
122
|
+
# of 1400x1400.
|
123
|
+
#
|
124
|
+
# Examples:
|
125
|
+
#
|
126
|
+
# driven_by :poltergeist
|
127
|
+
#
|
128
|
+
# driven_by :selenium, screen_size: [800, 800]
|
129
|
+
#
|
130
|
+
# driven_by :selenium, using: :chrome
|
131
|
+
#
|
132
|
+
# driven_by :selenium, using: :headless_chrome
|
133
|
+
#
|
134
|
+
# driven_by :selenium, using: :firefox
|
135
|
+
#
|
136
|
+
# driven_by :selenium, using: :headless_firefox
|
137
|
+
def self.driven_by(driver, using: :chrome, screen_size: [1400, 1400], options: {})
|
138
|
+
self.driver = SystemTesting::Driver.new(driver, using: using, screen_size: screen_size, options: options)
|
139
|
+
end
|
140
|
+
|
141
|
+
driven_by :selenium
|
142
|
+
|
143
|
+
ActiveSupport.run_load_hooks(:action_dispatch_system_test_case, self)
|
144
|
+
end
|
145
|
+
|
146
|
+
SystemTestCase.start_application
|
147
|
+
end
|