actionpack 4.2.10 → 5.0.0

data/CHANGELOG.md

@@ -1,670 +1,822 @@
-## Rails 4.2.10 (September 27, 2017) ##
+## Rails 5.0.0 (June 30, 2016) ##
 
-*   Fix regression in behavior of `normalize_path`.
+*   Add `ActionController#helpers` to get access to the view context at the controller
+    level.
 
-    In Rails 5 there was a change to ensure the encoding of the original string
-    in a path was maintained. This was incorrectly backported to Rails 4.2 which
-    caused a regression.
+    *Rafael Mendonça França*
 
-    *Eileen M. Uchitelle*
+*   Routing: Refactor `:action` default handling to ensure that path
+    parameters are not mutated during route generation.
 
-## Rails 4.2.9 (June 26, 2017) ##
+    *Andrew White*
 
-*   Use more specific check for :format in route path
+*   Add extension synonyms `yml` and `yaml` for MIME type `application/x-yaml`.
 
-    The current check for whether to add an optional format to the path is very lax
-    and will match things like `:format_id` where there are nested resources, e.g:
+    *bogdanvlviv*
 
-    ``` ruby
-    resources :formats do
-      resources :items
-    end
-    ```
+*   Adds support for including ActionController::Cookies in API controllers.
+    Previously, including the module would raise when trying to define
+    a `cookies` helper method. Skip calling #helper_method if it is not
+    defined -- if we don't have helpers, we needn't define one.
 
-    Fix this by using a more restrictive regex pattern that looks for the patterns
-    `(.:format)`, `.:format` or `/` at the end of the path. Note that we need to
-    allow for multiple closing parenthesis since the route may be of this form:
+    Fixes #24304
 
-    ``` ruby
-    get "/books(/:action(.:format))", controller: "books"
-    ```
+    *Ryan T. Hosford*
 
-    This probably isn't what's intended since it means that the default index action
-    route doesn't support a format but we have a test for it so we need to allow it.
+*   ETags: Introduce `Response#strong_etag=` and `#weak_etag=` and analogous
+    options for `fresh_when` and `stale?`. `Response#etag=` sets a weak ETag.
 
-    Fixes #28517.
+    Strong ETags are desirable when you're serving byte-for-byte identical
+    responses that support Range requests, like PDFs or videos (typically
+    done by reproxying the response from a backend storage service).
+    Also desirable when fronted by some CDNs that support strong ETags
+    only, like Akamai.
 
-    *Andrew White*
+    *Jeremy Daer*
 
+*   ETags: No longer strips quotes (") from ETag values before comparing them.
+    Quotes are significant, part of the ETag. A quoted ETag and an unquoted
+    one are not the same entity.
 
-## Rails 4.2.8 (February 21, 2017) ##
+    *Jeremy Daer*
 
-*   No changes.
+*   ETags: Support `If-None-Match: *`. Rarely useful for GET requests; meant
+    to provide some optimistic concurrency control for PUT requests.
 
+    *Jeremy Daer*
 
-## Rails 4.2.7 (July 12, 2016) ##
+*   `ActionDispatch::ParamsParser` is deprecated and was removed from the middleware
+    stack. To configure the parameter parsers use `ActionDispatch::Request.parameter_parsers=`.
 
-*   No changes.
+    *tenderlove*
 
+*   When a `respond_to` collector with a block doesn't have a response, then
+    a `:no_content` response should be rendered.  This brings the default
+    rendering behavior introduced by https://github.com/rails/rails/issues/19036
+    to controller methods employing `respond_to`.
 
-## Rails 4.2.6 (March 07, 2016) ##
+    *Justin Coyne*
 
-*   No changes.
+*   Add `ActionController::Parameters#dig` on Ruby 2.3 and greater, which
+    behaves the same as `Hash#dig`.
 
+    *Sean Griffin*
 
-## Rails 4.2.5.2 (February 26, 2016) ##
+*   Add request headers in the payload of the `start_processing.action_controller`
+    and `process_action.action_controller` notifications.
 
-*   Do not allow render with unpermitted parameter.
+    *Gareth du Plooy*
 
-    Fixes CVE-2016-2098.
+*   Add `action_dispatch_integration_test` load hook. The hook can be used to
+    extend `ActionDispatch::IntegrationTest` once it has been loaded.
 
-    *Arthur Neves*
+    *Yuichiro Kaneko*
 
+*   Update default rendering policies when the controller action did
+    not explicitly indicate a response.
 
-## Rails 4.2.5.1 (January 25, 2015) ##
+    For API controllers, the implicit render always renders "204 No Content"
+    and does not account for any templates.
 
-*   No changes.
+    For other controllers, the following conditions are checked:
 
+    First, if a template exists for the controller action, it is rendered.
+    This template lookup takes into account the action name, locales, format,
+    variant, template handlers, etc. (see `render` for details).
 
-## Rails 4.2.5 (November 12, 2015) ##
+    Second, if other templates exist for the controller action but is not in
+    the right format (or variant, etc.), an `ActionController::UnknownFormat`
+    is raised. The list of available templates is assumed to be a complete
+    enumeration of all the possible formats (or variants, etc.); that is,
+    having only HTML and JSON templates indicate that the controller action is
+    not meant to handle XML requests.
 
-*   `ActionController::TestCase` can teardown gracefully if an error is raised
-    early in the `setup` chain.
+    Third, if the current request is an "interactive" browser request (the user
+    navigated here by entering the URL in the address bar, submitting a form,
+    clicking on a link, etc. as opposed to an XHR or non-browser API request),
+    `ActionView::UnknownFormat` is raised to display a helpful error
+    message.
 
-    *Yves Senn*
+    Finally, it falls back to the same "204 No Content" behavior as API controllers.
 
-*   Parse RSS/ATOM responses as XML, not HTML.
+    *Godfrey Chan*, *Jon Moss*, *Kasper Timm Hansen*, *Mike Clark*, *Matthew Draper*
 
-    *Alexander Kaupanin*
+*   Add "application/gzip" as a default mime type.
 
-*   Fix regression in mounted engine named routes generation for app deployed to
-    a subdirectory. `relative_url_root` was prepended to the path twice (e.g.
-    "/subdir/subdir/engine_path" instead of "/subdir/engine_path")
+    *Mehmet Emin İNAÇ*
 
-    Fixes #20920. Fixes #21459.
+*   Add request encoding and response parsing to integration tests.
 
-    *Matthew Erhard*
+    What previously was:
 
-*   `url_for` does not modify its arguments when generating polymorphic URLs.
+    ```ruby
+    require 'test_helper'
+
+    class ApiTest < ActionDispatch::IntegrationTest
+      test 'creates articles' do
+        assert_difference -> { Article.count } do
+          post articles_path(format: :json),
+            params: { article: { title: 'Ahoy!' } }.to_json,
+            headers: { 'Content-Type' => 'application/json' }
+        end
+
+        assert_equal({ 'id' => Article.last.id, 'title' => 'Ahoy!' }, JSON.parse(response.body))
+      end
+    end
+    ```
 
-    *Bernerd Schaefer*
+    Can now be written as:
 
-*   Update `ActionController::TestSession#fetch` to behave more like
-    `ActionDispatch::Request::Session#fetch` when using non-string keys.
+    ```ruby
+    require 'test_helper'
 
-    *Jeremy Friesen*
+    class ApiTest < ActionDispatch::IntegrationTest
+      test 'creates articles' do
+        assert_difference -> { Article.count } do
+          post articles_path, params: { article: { title: 'Ahoy!' } }, as: :json
+        end
 
+        assert_equal({ 'id' => Article.last.id, 'title' => 'Ahoy!' }, response.parsed_body)
+      end
+    end
+    ```
 
-## Rails 4.2.4 (August 24, 2015) ##
+    Passing `as: :json` to integration test request helpers will set the format,
+    content type and encode the parameters as JSON.
 
-*   ActionController::TestSession now accepts a default value as well as
-    a block for generating a default value based off the key provided.
+    Then on the response side, `parsed_body` will parse the body according to the
+    content type the response has.
 
-    This fixes calls to session#fetch in ApplicationController instances that
-    take more two arguments or a block from raising `ArgumentError: wrong
-    number of arguments (2 for 1)` when performing controller tests.
+    Currently JSON is the only supported MIME type. Add your own with
+    `ActionDispatch::IntegrationTest.register_encoder`.
 
-    *Matthew Gerrior*
+    *Kasper Timm Hansen*
 
-*   Fix to keep original header instance in `ActionDispatch::SSL`
+*   Add "image/svg+xml" as a default mime type.
 
-    `ActionDispatch::SSL` changes headers to `Hash`.
-    So some headers will be broken if there are some middlewares
-    on `ActionDispatch::SSL` and if it uses `Rack::Utils::HeaderHash`.
+    *DHH*
 
-    *Fumiaki Matsushima*
+*   Add `-g` and `-c` options to `bin/rails routes`. These options return the url `name`, `verb` and
+    `path` field that match the pattern or match a specific controller.
 
+    Deprecate `CONTROLLER` env variable in `bin/rails routes`.
 
-## Rails 4.2.3 (June 25, 2015) ##
+    See #18902.
 
-*   Fix rake routes not showing the right format when
-    nesting multiple routes.
+    *Anton Davydov*, *Vipul A M*
 
-    See #18373.
+*   Response etags to always be weak: Prefixes 'W/' to value returned by
+   `ActionDispatch::Http::Cache::Response#etag=`, such that etags set in
+   `fresh_when` and `stale?` are weak.
 
-    *Ravil Bayramgalin*
+    Fixes #17556.
 
-*   Fix regression where a gzip file response would have a Content-type,
-    even when it was a 304 status code.
+    *Abhishek Yadav*
 
-    See #19271.
+*   Provide the name of HTTP Status code in assertions.
 
-    *Kohei Suzuki*
+    *Sean Collins*
 
-*   Fix handling of empty X_FORWARDED_HOST header in raw_host_with_port
+*   More explicit error message when running `rake routes`. `CONTROLLER` argument
+    can now be supplied in different ways:
+    `Rails::WelcomeController`, `Rails::Welcome`, `rails/welcome`.
 
-    Previously, an empty X_FORWARDED_HOST header would cause
-    Actiondispatch::Http:URL.raw_host_with_port to return nil, causing
-    Actiondispatch::Http:URL.host to raise a NoMethodError.
+    Fixes #22918.
 
-    *Adam Forsyth*
+    *Edouard Chin*
 
-*   Fallback to `ENV['RAILS_RELATIVE_URL_ROOT']` in `url_for`.
+*   Allow `ActionController::Parameters` instances as an argument to URL
+    helper methods. An `ArgumentError` will be raised if the passed parameters
+    are not secure.
 
-    Fixed an issue where the `RAILS_RELATIVE_URL_ROOT` environment variable is not
-    prepended to the path when `url_for` is called. If `SCRIPT_NAME` (used by Rack)
-    is set, it takes precedence.
+    Fixes #22832.
 
-    Fixes #5122.
+    *Prathamesh Sonpatki*
 
-    *Yasyf Mohamedali*
+*   Add option for per-form CSRF tokens.
 
-*   Fix regression in functional tests. Responses should have default headers
-    assigned.
+    *Greg Ose*, *Ben Toews*
 
-    See #18423.
+*   Fix `ActionController::Parameters#convert_parameters_to_hashes` to return filtered
+    or unfiltered values based on from where it is called, `to_h` or `to_unsafe_h`
+    respectively.
 
-    *Jeremy Kemper*, *Yves Senn*
+    Fixes #22841.
 
+    *Prathamesh Sonpatki*
 
-## Rails 4.2.2 (June 16, 2015) ##
+*   Add `ActionController::Parameters#include?`
 
-* No Changes *
+    *Justin Coyne*
 
+*   Deprecate `redirect_to :back` in favor of `redirect_back`, which accepts a
+    required `fallback_location` argument, thus eliminating the possibility of a
+    `RedirectBackError`.
 
-## Rails 4.2.1 (March 19, 2015) ##
+    *Derek Prior*
 
-*   Non-string authenticity tokens do not raise NoMethodError when decoding
-    the masked token.
+*   Add `redirect_back` method to `ActionController::Redirecting` to provide a
+    way to safely redirect to the `HTTP_REFERER` if it is present, falling back
+    to a provided redirect otherwise.
 
-    *Ville Lautanala*
+    *Derek Prior*
 
-*   Explicitly ignored wildcard verbs when searching for HEAD routes before fallback
+*   `ActionController::TestCase` will be moved to its own gem in Rails 5.1.
 
-    Fixes an issue where a mounted rack app at root would intercept the HEAD
-    request causing an incorrect behavior during the fall back to GET requests.
+    With the speed improvements made to `ActionDispatch::IntegrationTest` we no
+    longer need to keep two separate code bases for testing controllers. In
+    Rails 5.1 `ActionController::TestCase` will be deprecated and moved into a
+    gem outside of Rails source.
+
+    This is a documentation deprecation so that going forward new tests will use
+    `ActionDispatch::IntegrationTest` instead of `ActionController::TestCase`.
+
+    *Eileen M. Uchitelle*
+
+*   Add a `response_format` option to `ActionDispatch::DebugExceptions`
+    to configure the format of the response when errors occur in
+    development mode.
+
+    If `response_format` is `:default` the debug info will be rendered
+    in an HTML page. In the other hand, if the provided value is `:api`
+    the debug info will be rendered in the original response format.
+
+    *Jorge Bejar*
+
+*   Change the `protect_from_forgery` prepend default to `false`.
+
+    Per this comment
+    https://github.com/rails/rails/pull/18334#issuecomment-69234050 we want
+    `protect_from_forgery` to default to `prepend: false`.
+
+    `protect_from_forgery` will now be inserted into the callback chain at the
+    point it is called in your application. This is useful for cases where you
+    want to `protect_from_forgery` after you perform required authentication
+    callbacks or other callbacks that are required to run after forgery protection.
+
+    If you want `protect_from_forgery` callbacks to always run first, regardless of
+    position they are called in your application then you can add `prepend: true`
+    to your `protect_from_forgery` call.
 
     Example:
+
     ```ruby
-    draw do
-        get '/home' => 'test#index'
-        mount rack_app, at: '/'
-    end
-    head '/home'
-    assert_response :success
+    protect_from_forgery prepend: true
     ```
-    In this case, a HEAD request runs through the routes the first time and fails
-    to match anything. Then, it runs through the list with the fallback and matches
-    `get '/home'`. The original behavior would match the rack app in the first pass.
 
-    *Terence Sun*
+    *Eileen M. Uchitelle*
 
-*   Preserve default format when generating URLs
+*   In url_for, never append a question mark to the URL when the query string
+    is empty anyway.  (It used to do that when called like `url_for(controller:
+    'x', action: 'y', q: {})`.)
 
-    Fixes an issue that would cause the format set in default_url_options to be
-    lost when generating URLs with fewer positional arguments than parameters in
-    the route definition.
+    *Paul Grayson*
 
-    Backport of #18627
+*   Catch invalid UTF-8 querystring values and respond with BadRequest
 
-    *Tekin Suleyman*, *Dominic Baggott*
+    Check querystring params for invalid UTF-8 characters, and raise an
+    ActionController::BadRequest error if present. Previously these strings
+    would typically trigger errors further down the stack.
 
-*   Default headers, removed in controller actions, are no longer reapplied on
-    the test response.
+    *Grey Baker*
 
-    *Jonas Baumann*
+*   Parse RSS/ATOM responses as XML, not HTML.
 
-*   Ensure `append_info_to_payload` is called even if an exception is raised.
+    *Alexander Kaupanin*
 
-    Fixes an issue where when an exception is raised in the request the additonal
-    payload data is not available.
+*   Show helpful message in `BadRequest` exceptions due to invalid path
+    parameter encodings.
 
-    See:
-    * #14903
-    * https://github.com/roidrage/lograge/issues/37
+    Fixes #21923.
 
-    *Dieter Komendera*, *Margus Pärt*
+    *Agis Anastasopoulos*
 
-*   Correctly rely on the response's status code to handle calls to `head`.
+*   Add the ability of returning arbitrary headers to `ActionDispatch::Static`.
 
-    *Robin Dupret*
+    Now ActionDispatch::Static can accept HTTP headers so that developers
+    will have control of returning arbitrary headers like
+    'Access-Control-Allow-Origin' when a response is delivered. They can be
+    configured with `#config`:
 
-*   Using `head` method returns empty response_body instead
-    of returning a single space " ".
+    Example:
 
-    The old behavior was added as a workaround for a bug in an early
-    version of Safari, where the HTTP headers are not returned correctly
-    if the response body has a 0-length. This is been fixed since and
-    the workaround is no longer necessary.
+        config.public_file_server.headers = {
+          "Cache-Control"               => "public, max-age=60",
+          "Access-Control-Allow-Origin" => "http://rubyonrails.org"
+        }
 
-    Fixes #18253.
+    *Yuki Nishijima*
 
-    *Prathamesh Sonpatki*
+*   Allow multiple `root` routes in same scope level. Example:
 
-*   Fix how polymorphic routes works with objects that implement `to_model`.
+    Example:
 
-    *Travis Grathwell*
+        root 'blog#show', constraints: ->(req) { Hostname.blog_site?(req.host) }
+        root 'landing#show'
 
-*   Fixed handling of positional url helper arguments when `format: false`.
+    *Rafael Sales*
 
-    Fixes #17819.
+*   Fix regression in mounted engine named routes generation for app deployed to
+    a subdirectory. `relative_url_root` was prepended to the path twice (e.g.
+    "/subdir/subdir/engine_path" instead of "/subdir/engine_path")
 
-    *Andrew White*, *Tatiana Soukiassian*
+    Fixes #20920. Fixes #21459.
 
-*   Fixed usage of optional scopes in URL helpers.
+    *Matthew Erhard*
 
-    *Alex Robbin*
+*   `ActionDispatch::Response#new` no longer applies default headers. If you want
+    default headers applied to the response object, then call
+    `ActionDispatch::Response.create`. This change only impacts people who are
+    directly constructing an `ActionDispatch::Response` object.
 
+*   Accessing mime types via constants like `Mime::HTML` is deprecated. Please
+    change code like this:
 
-## Rails 4.2.0 (December 20, 2014) ##
+        Mime::HTML
 
-*   Add `ActionController::Parameters#to_unsafe_h` to return an unfiltered
-    `Hash` representation of Parameters object. This is now a preferred way to
-    retrieve unfiltered parameters as we will stop inheriting `AC::Parameters`
-    object in Rails 5.0.
+    To this:
 
-    *Prem Sichanugrist*
+        Mime[:html]
 
-*   Restore handling of a bare `Authorization` header, without `token=`
-    prefix.
+    This change is so that Rails will not manage a list of constants, and fixes
+    an issue where if a type isn't registered you could possibly get the wrong
+    object.
 
-    Fixes #17108.
+    `Mime[:html]` is available in older versions of Rails, too, so you can
+    safely change libraries and plugins and maintain compatibility with
+    multiple versions of Rails.
 
-    *Guo Xiang Tan*
+*   `url_for` does not modify its arguments when generating polymorphic URLs.
 
-*   Deprecate use of string keys in URL helpers.
+    *Bernerd Schaefer*
 
-    Use symbols instead.
-    Fixes #16958.
+*   Make it easier to opt in to `config.force_ssl` and `config.ssl_options` by
+    making them less dangerous to try and easier to disable.
+
+    SSL redirect:
+      * Move `:host` and `:port` options within `redirect: { … }`. Deprecate.
+      * Introduce `:status` and `:body` to customize the redirect response.
+        The 301 permanent default makes it difficult to test the redirect and
+        back out of it since browsers remember the 301. Test with a 302 or 307
+        instead, then switch to 301 once you're confident that all is well.
+
+    HTTP Strict Transport Security (HSTS):
+      * Shorter max-age. Shorten the default max-age from 1 year to 180 days,
+        the low end for https://www.ssllabs.com/ssltest/ grading and greater
+        than the 18-week minimum to qualify for browser preload lists.
+      * Disabling HSTS. Setting `hsts: false` now sets `hsts { expires: 0 }`
+        instead of omitting the header. Omitting does nothing to disable HSTS
+        since browsers hang on to your previous settings until they expire.
+        Sending `{ hsts: { expires: 0 }}` flushes out old browser settings and
+        actually disables HSTS:
+          http://tools.ietf.org/html/rfc6797#section-6.1.1
+      * HSTS Preload. Introduce `preload: true` to set the `preload` flag,
+        indicating that your site may be included in browser preload lists,
+        including Chrome, Firefox, Safari, IE11, and Edge. Submit your site:
+          https://hstspreload.appspot.com
+
+    *Jeremy Daer*
 
-    *Byron Bischoff*, *Melanie Gilman*
+*   Update `ActionController::TestSession#fetch` to behave more like
+    `ActionDispatch::Request::Session#fetch` when using non-string keys.
 
-*   Deprecate the `only_path` option on `*_path` helpers.
+    *Jeremy Friesen*
 
-    In cases where this option is set to `true`, the option is redundant and can
-    be safely removed; otherwise, the corresponding `*_url` helper should be
-    used instead.
+*   Using strings or symbols for middleware class names is deprecated. Convert
+    things like this:
 
-    Fixes #17294.
+      middleware.use "Foo::Bar"
 
-    *Dan Olson*, *Godfrey Chan*
+    to this:
 
-*   Improve Journey compliance to RFC 3986.
+      middleware.use Foo::Bar
 
-    The scanner in Journey failed to recognize routes that use literals
-    from the sub-delims section of RFC 3986. It's now able to parse those
-    authorized delimiters and route as expected.
+*   `ActionController::TestSession` now accepts a default value as well as
+    a block for generating a default value based off the key provided.
 
-    Fixes #17212.
+    This fixes calls to `session#fetch` in `ApplicationController` instances that
+    take more two arguments or a block from raising `ArgumentError: wrong
+    number of arguments (2 for 1)` when performing controller tests.
 
-    *Nicolas Cavigneaux*
+    *Matthew Gerrior*
 
-*   Deprecate implicit Array conversion for Response objects. It was added
-    (using `#to_ary`) so we could conveniently use implicit splatting:
+*   Fix `ActionController::Parameters#fetch` overwriting `KeyError` returned by
+    default block.
 
-        status, headers, body = response
+    *Jonas Schuber Erlandsson*, *Roque Pinel*
 
-    But it also means `response + response` works and `[response].flatten`
-    cascades down to the Rack body. Nonsense behavior. Instead, rely on
-    explicit conversion and splatting with `#to_a`:
+*   `ActionController::Parameters` no longer inherits from
+    `HashWithIndifferentAccess`
 
-        status, header, body = *response
+    Inheriting from `HashWithIndifferentAccess` allowed users to call any
+    enumerable methods on `Parameters` object, resulting in a risk of losing the
+    `permitted?` status or even getting back a pure `Hash` object instead of
+    a `Parameters` object with proper sanitization.
 
-    *Jeremy Kemper*
+    By not inheriting from `HashWithIndifferentAccess`, we are able to make
+    sure that all methods that are defined in `Parameters` object will return
+    a proper `Parameters` object with a correct `permitted?` flag.
 
-*   Don't rescue `IPAddr::InvalidAddressError`.
+    *Prem Sichanugrist*
 
-    `IPAddr::InvalidAddressError` does not exist in Ruby 1.9.3
-    and fails for JRuby in 1.9 mode.
+*   Replaced `ActiveSupport::Concurrency::Latch` with `Concurrent::CountDownLatch`
+    from the concurrent-ruby gem.
 
-    *Peter Suschlik*
+    *Jerry D'Antonio*
 
-*   Fix bug where the router would ignore any constraints added to redirect
-    routes.
+*   Add ability to filter parameters based on parent keys.
 
-    Fixes #16605.
+        # matches {credit_card: {code: "xxxx"}}
+        # doesn't match {file: { code: "xxxx"}}
+        config.filter_parameters += [ "credit_card.code" ]
 
-    *Agis Anastasopoulos*
+    See #13897.
 
-*   Allow `config.action_dispatch.trusted_proxies` to accept an IPAddr object.
+    *Guillaume Malette*
 
-    Example:
+*   Deprecate passing first parameter as `Hash` and default status code for `head` method.
 
-        # config/environments/production.rb
-        config.action_dispatch.trusted_proxies = IPAddr.new('4.8.15.0/16')
+    *Mehmet Emin İNAÇ*
 
-    *Sam Aarons*
+*   Adds`Rack::Utils::ParameterTypeError` and `Rack::Utils::InvalidParameterError`
+    to the rescue_responses hash in `ExceptionWrapper` (Rack recommends
+    integrators serve 400s for both of these).
 
-*   Avoid duplicating routes for HEAD requests.
+    *Grey Baker*
 
-    Instead of duplicating the routes, we will first match the HEAD request to
-    HEAD routes. If no match is found, we will then map the HEAD request to
-    GET routes.
+*   Add support for API only apps.
+    `ActionController::API` is added as a replacement of
+    `ActionController::Base` for this kind of applications.
 
-    *Guo Xiang Tan*, *Andrew White*
+    *Santiago Pastorino*, *Jorge Bejar*
 
-*   Requests that hit `ActionDispatch::Static` can now take advantage
-    of gzipped assets on disk. By default a gzip asset will be served if
-    the client supports gzip and a compressed file is on disk.
+*   Remove `assigns` and `assert_template`. Both methods have been extracted
+    into a gem at https://github.com/rails/rails-controller-testing.
 
-    *Richard Schneeman*
+    See #18950.
 
-*   `ActionController::Parameters` will stop inheriting from `Hash` and
-    `HashWithIndifferentAccess` in the next major release. If you use any method
-    that is not available on `ActionController::Parameters` you should consider
-    calling `#to_h` to convert it to a `Hash` first before calling that method.
+    *Alan Guo Xiang Tan*
 
-    *Prem Sichanugrist*
+*   `FileHandler` and `Static` middleware initializers accept `index` argument
+    to configure the directory index file name. Defaults to `index` (as in
+    `index.html`).
 
-*   `ActionController::Parameters#to_h` now returns a `Hash` with unpermitted
-    keys removed. This change is to reflect on a security concern where some
-    method performed on an `ActionController::Parameters` may yield a `Hash`
-    object which does not maintain `permitted?` status. If you would like to
-    get a `Hash` with all the keys intact, duplicate and mark it as permitted
-    before calling `#to_h`.
+    See #20017.
 
-        params = ActionController::Parameters.new({
-          name: 'Senjougahara Hitagi',
-          oddity: 'Heavy stone crab'
-        })
-        params.to_h
-        # => {}
+    *Eliot Sykes*
 
-        unsafe_params = params.dup.permit!
-        unsafe_params.to_h
-        # => {"name"=>"Senjougahara Hitagi", "oddity"=>"Heavy stone crab"}
+*   Deprecate `:nothing` option for `render` method.
 
-        safe_params = params.permit(:name)
-        safe_params.to_h
-        # => {"name"=>"Senjougahara Hitagi"}
+    *Mehmet Emin İNAÇ*
 
-    This change is consider a stopgap as we cannot change the code to stop
-    `ActionController::Parameters` to inherit from `HashWithIndifferentAccess`
-    in the next minor release.
+*   Fix `rake routes` not showing the right format when
+    nesting multiple routes.
 
-    *Prem Sichanugrist*
+    See #18373.
 
-*   Deprecated `TagAssertions`.
+    *Ravil Bayramgalin*
 
-    *Kasper Timm Hansen*
+*   Add ability to override default form builder for a controller.
 
-*   Use the Active Support JSON encoder for cookie jars using the `:json` or
-    `:hybrid` serializer. This allows you to serialize custom Ruby objects into
-    cookies by defining the `#as_json` hook on such objects.
+        class AdminController < ApplicationController
+          default_form_builder AdminFormBuilder
+        end
 
-    Fixes #16520.
+    *Kevin McPhillips*
 
-    *Godfrey Chan*
+*   For actions with no corresponding templates, render `head :no_content`
+    instead of raising an error. This allows for slimmer API controller
+    methods that simply work, without needing further instructions.
 
-*   Add `config.action_dispatch.cookies_digest` option for setting custom
-    digest. The default remains the same - 'SHA1'.
+    See #19036.
 
-    *Łukasz Strzałkowski*
+    *Stephen Bussey*
 
-*   Move `respond_with` (and the class-level `respond_to`) to
-    the `responders` gem.
+*   Provide friendlier access to request variants.
 
-    *José Valim*
+        request.variant = :phone
+        request.variant.phone?  # true
+        request.variant.tablet? # false
 
-*   When your templates change, browser caches bust automatically.
+        request.variant = [:phone, :tablet]
+        request.variant.phone?                  # true
+        request.variant.desktop?                # false
+        request.variant.any?(:phone, :desktop)  # true
+        request.variant.any?(:desktop, :watch)  # false
 
-    New default: the template digest is automatically included in your ETags.
-    When you call `fresh_when @post`, the digest for `posts/show.html.erb`
-    is mixed in so future changes to the HTML will blow HTTP caches for you.
-    This makes it easy to HTTP-cache many more of your actions.
+    *George Claghorn*
 
-    If you render a different template, you can now pass the `:template`
-    option to include its digest instead:
+*   Fix regression where a gzip file response would have a Content-type,
+    even when it was a 304 status code.
+
+    See #19271.
 
-        fresh_when @post, template: 'widgets/show'
+    *Kohei Suzuki*
 
-    Pass `template: false` to skip the lookup. To turn this off entirely, set:
+*   Fix handling of empty `X_FORWARDED_HOST` header in `raw_host_with_port`.
 
-        config.action_controller.etag_with_template_digest = false
+    Previously, an empty `X_FORWARDED_HOST` header would cause
+    `Actiondispatch::Http:URL.raw_host_with_port` to return `nil`, causing
+    `Actiondispatch::Http:URL.host` to raise a `NoMethodError`.
 
-    *Jeremy Kemper*
+    *Adam Forsyth*
 
-*   Remove deprecated `AbstractController::Helpers::ClassMethods::MissingHelperError`
-    in favor of `AbstractController::Helpers::MissingHelperError`.
+*   Allow `Bearer` as token-keyword in `Authorization-Header`.
 
-    *Yves Senn*
+    Additionally to `Token`, the keyword `Bearer` is acceptable as a keyword
+    for the auth-token. The `Bearer` keyword is described in the original
+    OAuth RFC and used in libraries like Angular-JWT.
 
-*   Fix `assert_template` not being able to assert that no files were rendered.
+    See #19094.
+
+    *Peter Schröder*
+
+*   Drop request class from `RouteSet` constructor.
+
+    If you would like to use a custom request class, please subclass and implement
+    the `request_class` method.
+
+    *tenderlove@ruby-lang.org*
+
+*   Fallback to `ENV['RAILS_RELATIVE_URL_ROOT']` in `url_for`.
+
+    Fixed an issue where the `RAILS_RELATIVE_URL_ROOT` environment variable is not
+    prepended to the path when `url_for` is called. If `SCRIPT_NAME` (used by Rack)
+    is set, it takes precedence.
+
+    Fixes #5122.
+
+    *Yasyf Mohamedali*
+
+*   Partitioning of routes is now done when the routes are being drawn. This
+    helps to decrease the time spent filtering the routes during the first request.
 
     *Guo Xiang Tan*
 
-*   Extract source code for the entire exception stack trace for
-    better debugging and diagnosis.
+*   Fix regression in functional tests. Responses should have default headers
+    assigned.
 
-    *Ryan Dao*
+    See #18423.
 
-*   Allows ActionDispatch::Request::LOCALHOST to match any IPv4 127.0.0.0/8
-    loopback address.
+    *Jeremy Kemper*, *Yves Senn*
 
-    *Earl St Sauver*, *Sven Riedel*
+*   Deprecate `AbstractController#skip_action_callback` in favor of individual skip_callback methods
+    (which can be made to raise an error if no callback was removed).
 
-*   Preserve original path in `ShowExceptions` middleware by stashing it as
-    `env["action_dispatch.original_path"]`
+    *Iain Beeston*
 
-    `ActionDispatch::ShowExceptions` overwrites `PATH_INFO` with the status code
-    for the exception defined in `ExceptionWrapper`, so the path
-    the user was visiting when an exception occurred was not previously
-    available to any custom exceptions_app. The original `PATH_INFO` is now
-    stashed in `env["action_dispatch.original_path"]`.
+*   Alias the `ActionDispatch::Request#uuid` method to `ActionDispatch::Request#request_id`.
+    Due to implementation, `config.log_tags = [:request_id]` also works in substitute
+    for `config.log_tags = [:uuid]`.
 
-    *Grey Baker*
+    *David Ilizarov*
 
-*   Use `String#bytesize` instead of `String#size` when checking for cookie
-    overflow.
+*   Change filter on /rails/info/routes to use an actual path regexp from rails
+    and not approximate javascript version. Oniguruma supports much more
+    extensive list of features than javascript regexp engine.
 
-    *Agis Anastasopoulos*
+    Fixes #18402.
+
+    *Ravil Bayramgalin*
+
+*   Non-string authenticity tokens do not raise NoMethodError when decoding
+    the masked token.
 
-*   `render nothing: true` or rendering a `nil` body no longer add a single
-    space to the response body.
+    *Ville Lautanala*
 
-    The old behavior was added as a workaround for a bug in an early version of
-    Safari, where the HTTP headers are not returned correctly if the response
-    body has a 0-length. This is been fixed since and the workaround is no
-    longer necessary.
+*   Add `http_cache_forever` to Action Controller, so we can cache a response
+    that never gets expired.
 
-    Use `render body: ' '` if the old behavior is desired.
+    *arthurnn*
 
-    See #14883 for details.
+*   `ActionController#translate` supports symbols as shortcuts.
+    When a shortcut is given it also performs the lookup without the action
+    name.
 
-    *Godfrey Chan*
+    *Max Melentiev*
 
-*   Prepend a JS comment to JSONP callbacks. Addresses CVE-2014-4671
-    ("Rosetta Flash").
+*   Expand `ActionController::ConditionalGet#fresh_when` and `stale?` to also
+    accept a collection of records as the first argument, so that the
+    following code can be written in a shorter form.
 
-    *Greg Campbell*
+        # Before
+        def index
+          @articles = Article.all
+          fresh_when(etag: @articles, last_modified: @articles.maximum(:updated_at))
+        end
 
-*   Because URI paths may contain non US-ASCII characters we need to force
-    the encoding of any unescaped URIs to UTF-8 if they are US-ASCII.
-    This essentially replicates the functionality of the monkey patch to
-    URI.parser.unescape in active_support/core_ext/uri.rb.
+        # After
+        def index
+          @articles = Article.all
+          fresh_when(@articles)
+        end
 
-    Fixes #16104.
+    *claudiob*
 
-    *Karl Entwistle*
+*   Explicitly ignored wildcard verbs when searching for HEAD routes before fallback
 
-*   Generate shallow paths for all children of shallow resources.
+    Fixes an issue where a mounted rack app at root would intercept the HEAD
+    request causing an incorrect behavior during the fall back to GET requests.
 
-    Fixes #15783.
+    Example:
 
-    *Seb Jacobs*
+        draw do
+            get '/home' => 'test#index'
+            mount rack_app, at: '/'
+        end
+        head '/home'
+        assert_response :success
 
-*   JSONP responses are now rendered with the `text/javascript` content type
-    when rendering through a `respond_to` block.
+    In this case, a HEAD request runs through the routes the first time and fails
+    to match anything. Then, it runs through the list with the fallback and matches
+    `get '/home'`. The original behavior would match the rack app in the first pass.
 
-    Fixes #15081.
+    *Terence Sun*
 
-    *Lucas Mazza*
+*   Discarded flash messages get removed before storing into session.
 
-*   Add `config.action_controller.always_permitted_parameters` to configure which
-    parameters are permitted globally. The default value of this configuration is
-    `['controller', 'action']`.
+    *Samuel Cochran*
 
-    *Gary S. Weaver*, *Rafael Chacon*
+*   Migrating xhr methods to keyword arguments syntax
+    in `ActionController::TestCase` and `ActionDispatch::Integration`
 
-*   Fix env['PATH_INFO'] missing leading slash when a rack app mounted at '/'.
+    Old syntax:
 
-    Fixes #15511.
+        xhr :get, :create, params: { id: 1 }
 
-    *Larry Lv*
+    New syntax example:
 
-*   ActionController::Parameters#require now accepts `false` values.
+        get :create, params: { id: 1 }, xhr: true
 
-    Fixes #15685.
+    *Kir Shatrov*
 
-    *Sergio Romano*
+*   Migrating to keyword arguments syntax in `ActionController::TestCase` and
+    `ActionDispatch::Integration` HTTP request methods.
 
-*   With authorization header `Authorization: Token token=`, `authenticate` now
-    recognize token as nil, instead of "token".
+    Example:
 
-    Fixes #14846.
+        post :create, params: { y: x }, session: { a: 'b' }
+        get :view, params: { id: 1 }
+        get :view, params: { id: 1 }, format: :json
 
-    *Larry Lv*
+    *Kir Shatrov*
 
-*   Ensure the controller is always notified as soon as the client disconnects
-    during live streaming, even when the controller is blocked on a write.
+*   Preserve default url options when generating URLs.
 
-    *Nicholas Jakobsen*, *Matthew Draper*
+    Fixes an issue that would cause `default_url_options` to be lost when
+    generating URLs with fewer positional arguments than parameters in the
+    route definition.
 
-*   Routes specifying 'to:' must be a string that contains a "#" or a rack
-    application.  Use of a symbol should be replaced with `action: symbol`.
-    Use of a string without a "#" should be replaced with `controller: string`.
+    *Tekin Suleyman*
 
-    *Aaron Patterson*
+*   Deprecate `*_via_redirect` integration test methods.
 
-*   Fix URL generation with `:trailing_slash` such that it does not add
-    a trailing slash after `.:format`
+    Use `follow_redirect!` manually after the request call for the same behavior.
 
-    *Dan Langevin*
+    *Aditya Kapoor*
 
-*   Build full URI as string when processing path in integration tests for
-    performance reasons. One consequence of this is that the leading slash
-    is now required in integration test `process` helpers, whereas previously
-    it could be omitted. The fact that this worked was a unintended consequence
-    of the implementation and was never an intentional feature.
+*   Add `ActionController::Renderer` to render arbitrary templates
+    outside controller actions.
 
-    *Guo Xiang Tan*
+    Its functionality is accessible through class methods `render` and
+    `renderer` of `ActionController::Base`.
 
-*   Fix `'Stack level too deep'` when rendering `head :ok` in an action method
-    called 'status' in a controller.
+    *Ravil Bayramgalin*
 
-    Fixes #13905.
+*   Support `:assigns` option when rendering with controllers/mailers.
 
-    *Christiaan Van den Poel*
+    *Ravil Bayramgalin*
 
-*   Add MKCALENDAR HTTP method (RFC 4791).
+*   Default headers, removed in controller actions, are no longer reapplied on
+    the test response.
 
-    *Sergey Karpesh*
+    *Jonas Baumann*
 
-*   Instrument fragment cache metrics.
+*   Deprecate all `*_filter` callbacks in favor of `*_action` callbacks.
 
-    Adds `:controller`: and `:action` keys to the instrumentation payload
-    for the `*_fragment.action_controller` notifications. This allows tracking
-    e.g. the fragment cache hit rates for each controller action.
+    *Rafael Mendonça França*
 
-    *Daniel Schierbeck*
+*   Allow you to pass `prepend: false` to `protect_from_forgery` to have the
+    verification callback appended instead of prepended to the chain.
+    This allows you to let the verification step depend on prior callbacks.
 
-*   Always use the provided port if the protocol is relative.
+    Example:
 
-    Fixes #15043.
+        class ApplicationController < ActionController::Base
+          before_action :authenticate
+          protect_from_forgery prepend: false, unless: -> { @authenticated_by.oauth? }
 
-    *Guilherme Cavalcanti*, *Andrew White*
+          private
+            def authenticate
+              if oauth_request?
+                # authenticate with oauth
+                @authenticated_by = 'oauth'.inquiry
+              else
+                # authenticate with cookies
+                @authenticated_by = 'cookie'.inquiry
+              end
+            end
+        end
 
-*   Moved `params[request_forgery_protection_token]` into its own method
-    and improved tests.
+    *Josef Šimánek*
 
-    Fixes #11316.
+*   Remove `ActionController::HideActions`.
 
-    *Tom Kadwill*
+    *Ravil Bayramgalin*
 
-*   Added verification of route constraints given as a Proc or an object responding
-    to `:matches?`. Previously, when given an non-complying object, it would just
-    silently fail to enforce the constraint. It will now raise an `ArgumentError`
-    when setting up the routes.
+*   Remove `respond_to`/`respond_with` placeholder methods, this functionality
+    has been extracted to the `responders` gem.
 
-    *Xavier Defrang*
+    *Carlos Antonio da Silva*
 
-*   Properly treat the entire IPv6 User Local Address space as private for
-    purposes of remote IP detection. Also handle uppercase private IPv6
-    addresses.
+*   Remove deprecated assertion files.
 
-    Fixes #12638.
+    *Rafael Mendonça França*
 
-    *Caleb Spare*
+*   Remove deprecated usage of string keys in URL helpers.
 
-*   Fixed an issue with migrating legacy json cookies.
+    *Rafael Mendonça França*
 
-    Previously, the `VerifyAndUpgradeLegacySignedMessage` assumes all incoming
-    cookies are marshal-encoded. This is not the case when `secret_token` is
-    used in conjunction with the `:json` or `:hybrid` serializer.
+*   Remove deprecated `only_path` option on `*_path` helpers.
 
-    In those case, when upgrading to use `secret_key_base`, this would cause a
-    `TypeError: incompatible marshal file format` and a 500 error for the user.
+    *Rafael Mendonça França*
 
-    Fixes #14774.
+*   Remove deprecated `NamedRouteCollection#helpers`.
 
-    *Godfrey Chan*
+    *Rafael Mendonça França*
 
-*   Make URL escaping more consistent:
+*   Remove deprecated support to define routes with `:to` option that doesn't contain `#`.
 
-    1. Escape '%' characters in URLs - only unescaped data should be passed to URL helpers
-    2. Add an `escape_segment` helper to `Router::Utils` that escapes '/' characters
-    3. Use `escape_segment` rather than `escape_fragment` in optimized URL generation
-    4. Use `escape_segment` rather than `escape_path` in URL generation
+    *Rafael Mendonça França*
 
-    For point 4 there are two exceptions. Firstly, when a route uses wildcard segments
-    (e.g. `*foo`) then we use `escape_path` as the value may contain '/' characters. This
-    means that wildcard routes can't be optimized. Secondly, if a `:controller` segment
-    is used in the path then this uses `escape_path` as the controller may be namespaced.
+*   Remove deprecated `ActionDispatch::Response#to_ary`.
 
-    Fixes #14629, #14636 and #14070.
+    *Rafael Mendonça França*
 
-    *Andrew White*, *Edho Arief*
+*   Remove deprecated `ActionDispatch::Request#deep_munge`.
 
-*   Add alias `ActionDispatch::Http::UploadedFile#to_io` to
-    `ActionDispatch::Http::UploadedFile#tempfile`.
+    *Rafael Mendonça França*
 
-    *Tim Linquist*
+*   Remove deprecated `ActionDispatch::Http::Parameters#symbolized_path_parameters`.
 
-*   Returns null type format when format is not know and controller is using `any`
-    format block.
+    *Rafael Mendonça França*
 
-    Fixes #14462.
+*   Remove deprecated option `use_route` in controller tests.
 
     *Rafael Mendonça França*
 
-*   Improve routing error page with fuzzy matching search.
+*   Ensure `append_info_to_payload` is called even if an exception is raised.
+
+    Fixes an issue where when an exception is raised in the request the additional
+    payload data is not available.
+
+    See #14903.
+
+    *Dieter Komendera*, *Margus Pärt*
+
+*   Correctly rely on the response's status code to handle calls to `head`.
+
+    *Robin Dupret*
+
+*   Using `head` method returns empty response_body instead
+    of returning a single space " ".
 
-    *Winston*
+    The old behavior was added as a workaround for a bug in an early
+    version of Safari, where the HTTP headers are not returned correctly
+    if the response body has a 0-length. This is been fixed since and
+    the workaround is no longer necessary.
 
-*   Only make deeply nested routes shallow when parent is shallow.
+    Fixes #18253.
 
-    Fixes #14684.
+    *Prathamesh Sonpatki*
 
-    *Andrew White*, *James Coglan*
+*   Fix how polymorphic routes works with objects that implement `to_model`.
 
-*   Append link to bad code to backtrace when exception is `SyntaxError`.
+    *Travis Grathwell*
 
-    *Boris Kuznetsov*
+*   Stop converting empty arrays in `params` to `nil`.
 
-*   Swapped the parameters of assert_equal in `assert_select` so that the
-    proper values were printed correctly.
+    This behavior was introduced in response to CVE-2012-2660, CVE-2012-2694
+    and CVE-2013-0155
 
-    Fixes #14422.
+    ActiveRecord now issues a safe query when passing an empty array into
+    a where clause, so there is no longer a need to defend against this type
+    of input (any nils are still stripped from the array).
 
-    *Vishal Lal*
+    *Chris Sinjakli*
 
-*   The method `shallow?` returns false if the parent resource is a singleton so
-    we need to check if we're not inside a nested scope before copying the :path
-    and :as options to their shallow equivalents.
+*   Remove `ActionController::ModelNaming` module.
 
-    Fixes #14388.
+    *claudiob*
 
-    *Andrew White*
+*   Fixed usage of optional scopes in url helpers.
 
-*   Make logging of CSRF failures optional (but on by default) with the
-    `log_warning_on_csrf_failure` configuration setting in
-    `ActionController::RequestForgeryProtection`.
+    *Alex Robbin*
 
-    *John Barton*
+*   Fixed handling of positional url helper arguments when `format: false`.
 
-*   Fix URL generation in controller tests with request-dependent
-    `default_url_options` methods.
+    Fixes #17819.
 
-    *Tony Wooster*
+    *Andrew White*, *Tatiana Soukiassian*
 
-Please check [4-1-stable](https://github.com/rails/rails/blob/4-1-stable/actionpack/CHANGELOG.md) for previous changes.
+Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/actionpack/CHANGELOG.md) for previous changes.