activesupport 4.2.11.3 → 5.0.7.2

data/CHANGELOG.md

@@ -1,29 +1,77 @@
-## Rails 4.2.11.3 (May 15, 2020) ##
+## Rails 5.0.7.2 (March 11, 2019) ##
 
 *   No changes.
 
 
-## Rails 4.2.11.2 (May 15, 2020) ##
+## Rails 5.0.7.1 (November 27, 2018) ##
 
 *   No changes.
 
 
-## Rails 4.2.11.1 (March 11, 2019) ##
+## Rails 5.0.7 (March 29, 2018) ##
+
+*   Return all mappings for a timezone identifier in `country_zones`
+
+    Some timezones like `Europe/London` have multiple mappings in
+    `ActiveSupport::TimeZone::MAPPING` so return all of them instead
+    of the first one found by using `Hash#value`. e.g:
+
+        # Before
+        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh"]
+
+        # After
+        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh", "London"]
+
+    Fixes #31668.
+
+    *Andrew White*
+
+
+## Rails 5.0.6 (September 07, 2017) ##
 
 *   No changes.
 
 
-## Rails 4.2.11 (November 27, 2018) ##
+## Rails 5.0.6.rc1 (August 24, 2017) ##
 
 *   No changes.
 
 
-## Rails 4.2.10 (September 27, 2017) ##
+## Rails 5.0.5 (July 31, 2017) ##
 
 *   No changes.
 
 
-## Rails 4.2.9 (June 26, 2017) ##
+## Rails 5.0.5.rc2 (July 25, 2017) ##
+
+*   No changes.
+
+
+## Rails 5.0.5.rc1 (July 19, 2017) ##
+
+*   No changes.
+
+
+## Rails 5.0.4 (June 19, 2017) ##
+
+*   No changes.
+
+
+## Rails 5.0.3 (May 12, 2017) ##
+
+*   `ActiveSupport::EventedFileUpdateChecker` no longer listens to
+    directories outside of the application directory.
+
+    *radiospiel*
+
+*   Return unmapped timezones from `country_zones`
+
+    If a country doesn't exist in the MAPPINGS hash then create a new
+    `ActiveSupport::Timezone` instance using the supplied timezone id.
+
+    Fixes #28431.
+
+    *Andrew White*
 
 *   Fixed bug in `DateAndTime::Compatibility#to_time` that caused it to
     raise `RuntimeError: can't modify frozen Time` when called on any frozen `Time`.
@@ -32,16 +80,21 @@
 
     *Kevin McPhillips* & *Andrew White*
 
-*   Restore the return type of `DateTime#utc`
+*   Fix inconsistent results when parsing large durations and constructing durations from code
 
-    In Rails 5.0 the return type of `DateTime#utc` was changed to `Time` to be
-    consistent with the new `DateTime#localtime` method. When these changes were
-    backported in #27553 this inadvertently changed the return type in a patcn
-    release. Since `DateTime#localtime` was new in Rails 4.2.8 it's okay to
-    restore the return type of `DateTime#utc` but keep `DateTime#localtime` as
-    returning `Time` without breaking backwards compatibility.
+        ActiveSupport::Duration.parse('P3Y') == 3.years # It should be true
 
-    *Andrew White*
+    Duration parsing made independent from any moment of time:
+    Fixed length in seconds is assigned to each duration part during parsing.
+
+    Methods on `Numeric` like `2.days` now use these predefined durations
+    to avoid duplicating of duration constants through the codebase and
+    eliminate creation of intermediate durations.
+
+    *Andrey Novikov, Andrew White*
+
+
+## Rails 5.0.2 (March 01, 2017) ##
 
 *   In Core Extensions, make `MarshalWithAutoloading#load` pass through the second, optional
     argument for `Marshal#load( source [, proc] )`. This way we don't have to do
@@ -49,17 +102,170 @@
 
     *Jeff Latz*
 
+*   `ActiveSupport::Gzip.decompress` now checks checksum and length in footer.
+
+    *Dylan Thacker-Smith*
+
 *   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
 
     *Adam Rice*
 
-*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
-    `Time.now` and `Date.today`.
 
-    *Yuki Nishijima*
+## Rails 5.0.1 (December 21, 2016) ##
+
+*   No changes.
+
+
+## Rails 5.0.1.rc2 (December 10, 2016) ##
+
+*   No changes.
+
+
+## Rails 5.0.1.rc1 (December 01, 2016) ##
+
+*   Ensure duration parsing is consistent across DST changes
+
+    Previously `ActiveSupport::Duration.parse` used `Time.current` and
+    `Time#advance` to calculate the number of seconds in the duration
+    from an arbitrary collection of parts. However as `advance` tries to
+    be consistent across DST boundaries this meant that either the
+    duration was shorter or longer depending on the time of year.
+
+    This was fixed by using an absolute reference point in UTC which
+    isn't subject to DST transitions. An arbitrary date of Jan 1st, 2000
+    was chosen for no other reason that it seemed appropriate.
+
+    Additionally, duration parsing should now be marginally faster as we
+    are no longer creating instances of `ActiveSupport::TimeWithZone`
+    every time we parse a duration string.
+
+    Fixes #26941.
+
+    *Andrew White*
+
+*   Fix `DateAndTime::Calculations#copy_time_to`. Copy `nsec` instead of `usec`.
+
+    Jumping forward or backward between weeks now preserves nanosecond digits.
 
+    *Josua Schmid*
 
-## Rails 4.2.8 (February 21, 2017) ##
+*   Avoid bumping the class serial when invoking executor.
+
+    *Matthew Draper*
+
+*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+
+    Previously calls to `in` were being sent to the non-DST aware
+    method `Time#since` via `method_missing`. It is now aliased to
+    the DST aware `ActiveSupport::TimeWithZone#+` which handles
+    transitions across DST boundaries, e.g:
+
+        Time.zone = "US/Eastern"
+
+        t = Time.zone.local(2016,11,6,1)
+        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+
+        t.in(1.hour)
+        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+
+    Fixes #26580.
+
+    *Thomas Balthazar*
+
+*   Fix `thread_mattr_accessor` subclass no longer overwrites parent.
+
+    Assigning a value to a subclass using `thread_mattr_accessor` no
+    longer changes the value of the parent class. This brings the
+    behavior inline with the documentation.
+
+    Given:
+
+        class Account
+          thread_mattr_accessor :user
+        end
+
+        class Customer < Account
+        end
+
+        Account.user = "DHH"
+        Customer.user = "Rafael"
+
+    Before:
+
+        Account.user  # => "Rafael"
+
+    After:
+
+        Account.user  # => "DHH"
+
+    *Shinichi Maeshima*
+
+*   Since weeks are no longer converted to days, add `:weeks` to the list of
+    parts that `ActiveSupport::TimeWithZone` will recognize as possibly being
+    of variable duration to take account of DST transitions.
+
+    Fixes #26039.
+
+    *Andrew White*
+
+*   Fix `ActiveSupport::TimeZone#strptime`. Now raises `ArgumentError` when the
+    given time doesn't match the format. The error is the same as the one given
+    by Ruby's `Date.strptime`. Previously it raised
+    `NoMethodError: undefined method empty? for nil:NilClass.` due to a bug.
+
+    Fixes #25701.
+
+    *John Gesimondo*
+
+
+## Rails 5.0.0 (June 30, 2016) ##
+
+*   Support parsing JSON time in ISO8601 local time strings in
+    `ActiveSupport::JSON.decode` when `parse_json_times` is enabled.
+    Strings in the format of `YYYY-MM-DD hh:mm:ss` (without a `Z` at
+    the end) will be parsed in the local timezone (`Time.zone`). In
+    addition, date strings (`YYYY-MM-DD`) are now parsed into `Date`
+    objects.
+
+    *Grzegorz Witek*
+
+*   `Date.to_s` doesn't produce too many spaces. For example, `to_s(:short)`
+    will now produce `01 Feb` instead of ` 1 Feb`.
+
+    Fixes #25251.
+
+    *Sean Griffin*
+
+*   Rescuable: If a handler doesn't match the exception, check for handlers
+    matching the exception's cause.
+
+    *Jeremy Daer*
+
+*   `ActiveSupport::Duration` supports weeks and hours.
+
+        [1.hour.inspect, 1.hour.value, 1.hour.parts]
+        # => ["3600 seconds", 3600, [[:seconds, 3600]]]   # Before
+        # => ["1 hour", 3600, [[:hours, 1]]]              # After
+
+        [1.week.inspect, 1.week.value, 1.week.parts]
+        # => ["7 days", 604800, [[:days, 7]]]             # Before
+        # => ["1 week", 604800, [[:weeks, 1]]]            # After
+
+    This brings us into closer conformance with ISO8601 and relieves some
+    astonishment about getting `1.hour.inspect # => 3600 seconds`.
+
+    Compatibility: The duration's `value` remains the same, so apps using
+    durations are oblivious to the new time periods. Apps, libraries, and
+    plugins that work with the internal `parts` hash will need to broaden
+    their time period handling to cover hours & weeks.
+
+    *Andrey Novikov*
+
+*   Time zones: Ensure that the UTC offset reflects DST changes that occurred
+    since the app started. Removes UTC offset caching, reducing performance,
+    but this is still relatively quick and isn't in any hot paths.
+
+    *Alexey Shein*
 
 *   Make `getlocal` and `getutc` always return instances of `Time` for
     `ActiveSupport::TimeWithZone` and `DateTime`. This eliminates a possible
@@ -111,578 +317,702 @@
 
     *Andrew White*
 
-*   Add `init_with` to `ActiveSupport::TimeWithZone` and `ActiveSupport::TimeZone`
+*   `ActiveSupport::TimeZone.country_zones(country_code)` looks up the
+    country's time zones by its two-letter ISO3166 country code, e.g.
+
+        >> ActiveSupport::TimeZone.country_zones(:jp).map(&:to_s)
+        => ["(GMT+09:00) Osaka"]
 
-    It is helpful to be able to run apps concurrently written in successive
-    versions of Rails to aid migration, e.g. run Rails 4.2 and 5.0 variants
-    of your application at the same time to carry out A/B testing.
+        >> ActiveSupport::TimeZone.country_zones(:uy).map(&:to_s)
+        => ["(GMT-03:00) Montevideo"]
 
-    To do this serialization formats need to be cross compatible and the
-    change in 3aa26cf didn't meet this criteria because the Psych loader
-    checks for the existence of `init_with` before setting the instance
-    variables and the wrapping behavior of `ActiveSupport::TimeWithZone`
-    tries to see if the `Time` instance responds to `init_with` before the
-    `@time` variable is set.
+    *Andrey Novikov*
 
-    To fix this we backported just the `init_with` behavior from the change
-    in 3aa26cf. If the revived instance is then written out to YAML again
-    it will revert to the default Rails 4.2 behavior of converting it to
-    a UTC timestamp string.
+*   `Array#sum` compat with Ruby 2.4's native method.
 
-    Fixes #26296.
+    Ruby 2.4 introduces `Array#sum`, but it only supports numeric elements,
+    breaking our `Enumerable#sum` which supports arbitrary `Object#+`.
+    To fix, override `Array#sum` with our compatible implementation.
 
-    *Andrew White*
+    Native Ruby 2.4:
 
-*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+        %w[ a b ].sum
+        # => TypeError: String can't be coerced into Fixnum
 
-    Previously calls to `in` were being sent to the non-DST aware
-    method `Time#since` via `method_missing`. It is now aliased to
-    the DST aware `ActiveSupport::TimeWithZone#since` which handles
-    transitions across DST boundaries, e.g:
+    With `Enumerable#sum` shim:
 
-        Time.zone = "US/Eastern"
+        %w[ a b ].sum
+        # => 'ab'
 
-        t = Time.zone.local(2016,11,6,1)
-        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+    We tried shimming the fast path and falling back to the compatible path
+    if it fails, but that ends up slower even in simple cases due to the cost
+    of exception handling. Our only choice is to override the native `Array#sum`
+    with our `Enumerable#sum`.
 
-        t.in(1.hour)
-        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+    *Jeremy Daer*
 
-    Fixes #26580.
+*   `ActiveSupport::Duration` supports ISO8601 formatting and parsing.
 
-    *Thomas Balthazar*
+        ActiveSupport::Duration.parse('P3Y6M4DT12H30M5S')
+        # => 3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds
 
+        (3.years + 3.days).iso8601
+        # => "P3Y3D"
 
-## Rails 4.2.7 (July 12, 2016) ##
+    Inspired by Arnau Siches' [ISO8601 gem](https://github.com/arnau/ISO8601/)
+    and rewritten by Andrey Novikov with suggestions from Andrew White. Test
+    data from the ISO8601 gem redistributed under MIT license.
 
-*   Fixed `ActiveSupport::Logger.broadcast` so that calls to `#silence` now
-    properly delegate to all loggers. Silencing now properly suppresses logging
-    to both the log and the console.
+    (Will be used to support the PostgreSQL interval data type.)
 
-    *Kevin McPhillips*
+    *Andrey Novikov*, *Arnau Siches*, *Andrew White*
 
-*   Backported `ActiveSupport::LoggerThreadSafeLevel`. Assigning the
-    `Rails.logger.level` is now thread safe.
+*   `Cache#fetch(key, force: true)` forces a cache miss, so it must be called
+    with a block to provide a new value to cache. Fetching with `force: true`
+    but without a block now raises ArgumentError.
 
-    *Kevin McPhillips*
+        cache.fetch('key', force: true) # => ArgumentError
 
-*   Fixed a problem with ActiveSupport::SafeBuffer.titleize calling capitalize
-    on nil.
+    *Santosh Wadghule*
 
-    *Brian McManus*
+*   Fix behavior of JSON encoding for `Exception`.
 
-*   Time zones: Ensure that the UTC offset reflects DST changes that occurred
-    since the app started. Removes UTC offset caching, reducing performance,
-    but this is still relatively quick and isn't in any hot paths.
+    *namusyaka*
 
-    *Alexey Shein*
+*   Make `number_to_phone` format number with regexp pattern.
+
+        number_to_phone(18812345678, pattern: /(\d{3})(\d{4})(\d{4})/)
+        # => 188-1234-5678
+
+    *Pan Gaoyong*
+
+*   Match `String#to_time`'s behaviour to that of ruby's implementation for edge cases.
+
+    `nil` is now returned instead of the current date if the string provided does
+    contain time information, but none that is used to build the `Time` object.
+
+    Fixes #22958.
+
+    *Siim Liiser*
+
+*   Rely on the native DateTime#<=> implementation to handle non-datetime like
+    objects instead of returning `nil` ourselves. This restores the ability
+    of `DateTime` instances to be compared with a `Numeric` that represents an
+    astronomical julian day number.
+
+    Fixes #24228.
+
+    *Andrew White*
+
+*   Add `String#upcase_first` method.
+
+    *Glauco Custódio*, *bogdanvlviv*
 
 *   Prevent `Marshal.load` from looping infinitely when trying to autoload a constant
     which resolves to a different name.
 
     *Olek Janiszewski*
 
+*   Deprecate `Module.local_constants`. Please use `Module.constants(false)` instead.
 
-## Rails 4.2.6 (March 07, 2016) ##
+    *Yuichiro Kaneko*
 
-*   No changes.
+*   Publish `ActiveSupport::Executor` and `ActiveSupport::Reloader` APIs to allow
+    components and libraries to manage, and participate in, the execution of
+    application code, and the application reloading process.
 
+    *Matthew Draper*
 
-## Rails 4.2.5.2 (February 26, 2016) ##
+*   Deprecate arguments on `assert_nothing_raised`.
 
-*   No changes.
+    `assert_nothing_raised` does not assert the arguments that have been passed
+    in (usually a specific exception class) since the method only yields the
+    block. So as not to confuse the users that the arguments have meaning, they
+    are being deprecated.
 
+    *Tara Scherner de la Fuente*
 
-## Rails 4.2.5.1 (January 25, 2015) ##
+*   Make `benchmark('something', silence: true)` actually work.
 
-*   No changes.
+    *DHH*
 
+*   Add `#on_weekday?` method to `Date`, `Time`, and `DateTime`.
 
-## Rails 4.2.5 (November 12, 2015) ##
+    `#on_weekday?` returns `true` if the receiving date/time does not fall on a Saturday
+    or Sunday.
 
-*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
-        twz = DateTime.now.in_time_zone
-        twz.eql?(twz.dup) => true
+    *Vipul A M*
 
-    Fixes #14178.
+*   Add `Array#second_to_last` and `Array#third_to_last` methods.
 
-    *Roque Pinel*
+    *Brian Christian*
 
-*   Handle invalid UTF-8 characters in `MessageVerifier.verify`.
+*   Fix regression in `Hash#dig` for HashWithIndifferentAccess.
 
-    *Roque Pinel*, *Grey Baker*
+    *Jon Moss*
 
+*   Change `number_to_currency` behavior for checking negativity.
 
-## Rails 4.2.4 (August 24, 2015) ##
+    Used `to_f.negative` instead of using `to_f.phase` for checking negativity
+    of a number in number_to_currency helper.
+    This change works same for all cases except when number is "-0.0".
 
-*   Fix a `SystemStackError` when encoding an `Enumerable` with `json` gem and
-    with the Active Support JSON encoder loaded.
+        -0.0.to_f.negative? => false
+        -0.0.to_f.phase? => 3.14
 
-    Fixes #20775.
+    This change reverts changes from https://github.com/rails/rails/pull/6512.
+    But it should be acceptable as we could not find any currency which
+    supports negative zeros.
 
-    *Sammy Larbi*, *Prathamesh Sonpatki*
+    *Prathamesh Sonpatki*, *Rafael Mendonça França*
 
-*   Fix not calling `#default` on `HashWithIndifferentAcess#to_hash` when only
-    `default_proc` is set, which could raise.
+*   Match `HashWithIndifferentAccess#default`'s behaviour with `Hash#default`.
 
-    *Simon Eskildsen*
+    *David Cornu*
 
-*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`
+*   Adds `:exception_object` key to `ActiveSupport::Notifications::Instrumenter`
+    payload when an exception is raised.
 
-    *Simon Eskildsen*
+    Adds new key/value pair to payload when an exception is raised:
+    e.g. `:exception_object => #<RuntimeError: FAIL>`.
 
+    *Ryan T. Hosford*
 
-## Rails 4.2.3 (June 25, 2015) ##
+*   Support extended grapheme clusters and UAX 29.
 
-*   Fix a range of values for parameters of the Time#change
+    *Adam Roben*
 
-    *Nikolay Kondratyev*
+*   Add petabyte and exabyte numeric conversion.
 
-*   Add some missing `require 'active_support/deprecation'`
+    *Akshay Vishnoi*
 
-    *Akira Matsuda*
+*   Add thread_m/cattr_accessor/reader/writer suite of methods for declaring class and module variables that live per-thread.
+    This makes it easy to declare per-thread globals that are encapsulated. Note: This is a sharp edge. A wild proliferation
+    of globals is A Bad Thing. But like other sharp tools, when it's right, it's right.
 
+    Here's an example of a simple event tracking system where the object being tracked needs not pass a creator that it
+    doesn't need itself along:
 
-## Rails 4.2.2 (June 16, 2015) ##
+        module Current
+          thread_mattr_accessor :account
+          thread_mattr_accessor :user
 
-*   Fix XSS vulnerability in `ActiveSupport::JSON.encode` method.
+          def self.reset() self.account = self.user = nil end
+        end
 
-    CVE-2015-3226.
+        class ApplicationController < ActionController::Base
+          before_action :set_current
+          after_action { Current.reset }
 
-    *Rafael Mendonça França*
+          private
+            def set_current
+              Current.account = Account.find(params[:account_id])
+              Current.user    = Current.account.users.find(params[:user_id])
+            end
+        end
 
-*   Fix denial of service vulnerability in the XML processing.
+        class MessagesController < ApplicationController
+          def create
+            @message = Message.create!(message_params)
+          end
+        end
 
-    CVE-2015-3227.
+        class Message < ApplicationRecord
+          has_many :events
+          after_create :track_created
 
-    *Aaron Patterson*
+          private
+            def track_created
+              events.create! origin: self, action: :create
+            end
+        end
 
+        class Event < ApplicationRecord
+          belongs_to :creator, class_name: 'User'
+          before_validation { self.creator ||= Current.user }
+        end
 
-## Rails 4.2.1 (March 19, 2015) ##
+    *DHH*
 
-*   Fixed a problem where String#truncate_words would get stuck with a complex
-    string.
 
-    *Henrik Nygren*
+*   Deprecated `Module#qualified_const_` in favour of the builtin Module#const_
+    methods.
 
-*   Fixed a roundtrip problem with AS::SafeBuffer where primitive-like strings
-    will be dumped as primitives:
+    *Genadi Samokovarov*
 
-    Before:
+*   Deprecate passing string to define callback.
 
-        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
-        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => true
-        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => false
-        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => 1
-        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => 1.1
+    *Yuichiro Kaneko*
 
-     After:
+*   `ActiveSupport::Cache::Store#namespaced_key`,
+    `ActiveSupport::Cache::MemCachedStore#escape_key`, and
+    `ActiveSupport::Cache::FileStore#key_file_path`
+    are deprecated and replaced with `normalize_key` that now calls `super`.
 
-        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
-        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => "true"
-        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => "false"
-        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => "1"
-        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => "1.1"
+    `ActiveSupport::Cache::LocaleCache#set_cache_value` is deprecated and replaced with `write_cache_value`.
 
-    *Godfrey Chan*
+    *Michael Grosser*
 
-*   Replace fixed `:en` with `I18n.default_locale` in `Duration#inspect`.
+*   Implements an evented file watcher to asynchronously detect changes in the
+    application source code, routes, locales, etc.
 
-    *Dominik Masur*
+    This watcher is disabled by default, applications my enable it in the configuration:
 
-*   Add missing time zone definitions for Russian Federation and sync them
-    with `zone.tab` file from tzdata version 2014j (latest).
+        # config/environments/development.rb
+        config.file_watcher = ActiveSupport::EventedFileUpdateChecker
 
-    *Andrey Novikov*
+    This feature depends on the [listen](https://github.com/guard/listen) gem:
 
+        group :development do
+          gem 'listen', '~> 3.0.5'
+        end
 
-## Rails 4.2.0 (December 20, 2014) ##
+    *Puneet Agarwal* and *Xavier Noria*
 
-*   The decorated `load` and `require` methods are now kept private.
+*   Added `Time.days_in_year` to return the number of days in the given year, or the
+    current year if no argument is provided.
 
-    Fixes #17553.
+    *Jon Pascoe*
 
-    *Xavier Noria*
+*   Updated `parameterize` to preserve the case of a string, optionally.
 
-*   `String#remove` and `String#remove!` accept multiple arguments.
+    Example:
 
-    *Pavel Pravosud*
+        parameterize("Donald E. Knuth", separator: '_') # => "donald_e_knuth"
+        parameterize("Donald E. Knuth", preserve_case: true) # => "Donald-E-Knuth"
 
-*   `TimeWithZone#strftime` now delegates every directive to `Time#strftime` except for '%Z',
-    it also now correctly handles escaped '%' characters placed just before time zone related directives.
+    *Swaathi Kakarla*
 
-    *Pablo Herrero*
+*   `HashWithIndifferentAccess.new` respects the default value or proc on objects
+    that respond to `#to_hash`. `.new_from_hash_copying_default` simply invokes `.new`.
+    All calls to `.new_from_hash_copying_default` are replaced with `.new`.
 
-*   Corrected `Inflector#underscore` handling of multiple successive acroynms.
+    *Gordon Chan*
 
-    *James Le Cuirot*
+*   Change Integer#year to return a Fixnum instead of a Float to improve
+    consistency.
 
-*   Delegation now works with ruby reserved words passed to `:to` option.
+    Integer#years returned a Float while the rest of the accompanying methods
+    (days, weeks, months, etc.) return a Fixnum.
 
-    Fixes #16956.
+    Before:
 
-    *Agis Anastasopoulos*
+    1.year # => 31557600.0
 
-*   Added method `#eql?` to `ActiveSupport::Duration`, in addition to `#==`.
+    After:
 
-    Currently, the following returns `false`, contrary to expectation:
+    1.year # => 31557600
 
-        1.minute.eql?(1.minute)
+    *Konstantinos Rousis*
 
-    Adding method `#eql?` will make this behave like expected. Method `#eql?` is
-    just a bit stricter than `#==`, as it checks whether the argument is also a duration. Their
-    parts may be different though.
+*   Handle invalid UTF-8 strings when HTML escaping.
 
-        1.minute.eql?(60.seconds)  # => true
-        1.minute.eql?(60)          # => false
+    Use `ActiveSupport::Multibyte::Unicode.tidy_bytes` to handle invalid UTF-8
+    strings in `ERB::Util.unwrapped_html_escape` and `ERB::Util.html_escape_once`.
+    Prevents user-entered input passed from a querystring into a form field from
+    causing invalid byte sequence errors.
 
-    *Joost Lubach*
+    *Grey Baker*
 
-*   `Time#change` can now change nanoseconds (`:nsec`) as a higher-precision
-    alternative to microseconds (`:usec`).
+*   Update `ActiveSupport::Multibyte::Chars#slice!` to return `nil` if the
+    arguments are out of bounds, to mirror the behavior of `String#slice!`
 
-    *Agis Anastasooulos*
+    *Gourav Tiwari*
 
-*   `MessageVerifier.new` raises an appropriate exception if the secret is `nil`.
-    This prevents `MessageVerifier#generate` from raising a cryptic error later on.
+*   Fix `number_to_human` so that 999999999 rounds to "1 Billion" instead of
+    "1000 Million".
 
-    *Kostiantyn Kahanskyi*
+    *Max Jacobson*
 
-*   Introduced new configuration option `active_support.test_order` for
-    specifying the order in which test cases are executed. This option currently defaults
-    to `:sorted` but will be changed to `:random` in Rails 5.0.
+*   Fix `ActiveSupport::Deprecation#deprecate_methods` to report using the
+    current deprecator instance, where applicable.
 
-    *Akira Matsuda*, *Godfrey Chan*
+    *Brandon Dunne*
 
-*   Fixed a bug in `Inflector#underscore` where acroynms in nested constant names
-    are incorrectly parsed as camelCase.
+*   `Cache#fetch` instrumentation marks whether it was a `:hit`.
 
-    Fixes #8015.
+    *Robin Clowers*
 
-    *Fred Wu*, *Matthew Draper*
+*   `assert_difference` and `assert_no_difference` now returns the result of the
+    yielded block.
 
-*   Make `Time#change` throw an exception if the `:usec` option is out of range and
-    the time has an offset other than UTC or local.
+    Example:
 
-    *Agis Anastasopoulos*
+      post = assert_difference -> { Post.count }, 1 do
+        Post.create
+      end
 
-*   `Method` objects now report themselves as not `duplicable?`. This allows
-    hashes and arrays containing `Method` objects to be `deep_dup`ed.
+    *Lucas Mazza*
 
-    *Peter Jaros*
+*   Short-circuit `blank?` on date and time values since they are never blank.
 
-*   `determine_constant_from_test_name` does no longer shadow `NameError`s
-    which happens during constant autoloading.
+    Fixes #21657.
 
-    Fixes #9933.
+    *Andrew White*
 
-    *Guo Xiang Tan*
+*   Replaced deprecated `ThreadSafe::Cache` with its successor `Concurrent::Map` now that
+    the thread_safe gem has been merged into concurrent-ruby.
 
-*   Added instance_eval version to Object#try and Object#try!, so you can do this:
+    *Jerry D'Antonio*
 
-        person.try { name.first }
+*   Updated Unicode version to 8.0.0
 
-    instead of:
+    *Anshul Sharma*
 
-        person.try { |person| person.name.first }
+*   `number_to_currency` and `number_with_delimiter` now accept custom `delimiter_pattern` option
+     to handle placement of delimiter, to support currency formats like INR
 
-    *DHH*, *Ari Pollak*
+     Example:
 
-*   Fix the `ActiveSupport::Duration#instance_of?` method to return the right
-    value with the class itself since it was previously delegated to the
-    internal value.
+        number_to_currency(1230000, delimiter_pattern: /(\d+?)(?=(\d\d)+(\d)(?!\d))/, unit: '₹', format: "%u %n")
+        # => '₹ 12,30,000.00'
 
-    *Robin Dupret*
+    *Vipul A M*
 
-*   Fix rounding errors with `#travel_to` by resetting the usec on any passed time to zero, so we only travel
-    with per-second precision, not anything deeper than that.
+*   Deprecate `:prefix` option of `number_to_human_size` with no replacement.
 
-    *DHH*
+    *Jean Boussier*
 
-*   Fix DateTime comparison with `DateTime::Infinity` object.
+*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
+        twz = DateTime.now.in_time_zone
+        twz.eql?(twz.dup) => true
 
-    *Rafael Mendonça França*
+    Fixes #14178.
 
-*   Added Object#itself which returns the object itself. Useful when dealing with a chaining scenario, like Active Record scopes:
+    *Roque Pinel*
 
-        Event.public_send(state.presence_in([ :trashed, :drafted ]) || :itself).order(:created_at)
+*   ActiveSupport::HashWithIndifferentAccess `select` and `reject` will now return
+    enumerator if called without block.
 
-    *DHH*
+    Fixes #20095.
 
-*   `Object#with_options` executes block in merging option context when
-    explicit receiver in not passed.
+    *Bernard Potocki*
 
-    *Pavel Pravosud*
+*   Removed `ActiveSupport::Concurrency::Latch`, superseded by `Concurrent::CountDownLatch`
+    from the concurrent-ruby gem.
 
-*   Fixed a compatibility issue with the `Oj` gem when cherry-picking the file
-    `active_support/core_ext/object/json` without requiring `active_support/json`.
+    *Jerry D'Antonio*
 
-    Fixes #16131.
+*   Fix not calling `#default` on `HashWithIndifferentAccess#to_hash` when only
+    `default_proc` is set, which could raise.
 
-    *Godfrey Chan*
+    *Simon Eskildsen*
 
-*   Make `Hash#with_indifferent_access` copy the default proc too.
+*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`.
 
-    *arthurnn*, *Xanders*
+    *Simon Eskildsen*
 
-*   Add `String#truncate_words` to truncate a string by a number of words.
+*   Fix a range of values for parameters of the Time#change.
 
-    *Mohamed Osama*
+    *Nikolay Kondratyev*
 
-*   Deprecate `capture` and `quietly`.
+*   Add `Enumerable#pluck` to get the same values from arrays as from ActiveRecord
+    associations.
 
-    These methods are not thread safe and may cause issues when used in threaded environments.
-    To avoid problems we are deprecating them.
+    Fixes #20339.
 
-    *Tom Meier*
+    *Kevin Deisz*
 
-*   `DateTime#to_f` now preserves the fractional seconds instead of always
-    rounding to `.0`.
+*   Add a bang version to `ActiveSupport::OrderedOptions` get methods which will raise
+    an `KeyError` if the value is `.blank?`.
 
-    Fixes #15994.
+    Before:
 
-    *John Paul Ashenfelter*
+        if (slack_url = Rails.application.secrets.slack_url).present?
+          # Do something worthwhile
+        else
+          # Raise as important secret password is not specified
+        end
 
-*   Add `Hash#transform_values` to simplify a common pattern where the values of a
-    hash must change, but the keys are left the same.
+    After:
 
-    *Sean Griffin*
+        slack_url = Rails.application.secrets.slack_url!
 
-*   Always instrument `ActiveSupport::Cache`.
+    *Aditya Sanghi*, *Gaurish Sharma*
 
-    Since `ActiveSupport::Notifications` only instruments items when there
-    are attached subscribers, we don't need to disable instrumentation.
+*   Remove deprecated `Class#superclass_delegating_accessor`.
+    Use `Class#class_attribute` instead.
 
-    *Peter Wagenet*
+    *Akshay Vishnoi*
 
-*   Make the `apply_inflections` method case-insensitive when checking
-    whether a word is uncountable or not.
+*   Patch `Delegator` to work with `#try`.
 
-    *Robin Dupret*
+    Fixes #5790.
 
-*   Make Dependencies pass a name to NameError error.
+    *Nate Smith*
 
-    *arthurnn*
+*   Add `Integer#positive?` and `Integer#negative?` query methods
+    in the vein of `Fixnum#zero?`.
 
-*   Fixed `ActiveSupport::Cache::FileStore` exploding with long paths.
+    This makes it nicer to do things like `bunch_of_numbers.select(&:positive?)`.
 
-    *Adam Panzer*, *Michael Grosser*
+    *DHH*
 
-*   Fixed `ActiveSupport::TimeWithZone#-` so precision is not unnecessarily lost
-    when working with objects with a nanosecond component.
+*   Encoding `ActiveSupport::TimeWithZone` to YAML now preserves the timezone information.
 
-    `ActiveSupport::TimeWithZone#-` should return the same result as if we were
-    using `Time#-`:
+    Fixes #9183.
 
-        Time.now.end_of_day - Time.now.beginning_of_day # => 86399.999999999
+    *Andrew White*
 
-    Before:
+*   Added `ActiveSupport::TimeZone#strptime` to allow parsing times as if
+    from a given timezone.
 
-        Time.zone.now.end_of_day.nsec # => 999999999
-        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day # => 86400.0
+    *Paul A Jungwirth*
 
-    After:
+*   `ActiveSupport::Callbacks#skip_callback` now raises an `ArgumentError` if
+    an unrecognized callback is removed.
 
-        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day
-        # => 86399.999999999
+    *Iain Beeston*
 
-    *Gordon Chan*
+*   Added `ActiveSupport::ArrayInquirer` and `Array#inquiry`.
 
-*   Fixed precision error in NumberHelper when using Rationals.
+    Wrapping an array in an `ArrayInquirer` gives a friendlier way to check its
+    contents:
 
-    Before:
+        variants = ActiveSupport::ArrayInquirer.new([:phone, :tablet])
 
-        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
-        # => "330.00"
+        variants.phone?    # => true
+        variants.tablet?   # => true
+        variants.desktop?  # => false
 
-    After:
+        variants.any?(:phone, :tablet)   # => true
+        variants.any?(:phone, :desktop)  # => true
+        variants.any?(:desktop, :watch)  # => false
 
-        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
-        # => "333.33"
+    `Array#inquiry` is a shortcut for wrapping the receiving array in an
+    `ArrayInquirer`.
 
-    See #15379.
+    *George Claghorn*
 
-    *Juanjo Bazán*
+*   Deprecate `alias_method_chain` in favour of `Module#prepend` introduced in
+    Ruby 2.0.
 
-*   Removed deprecated `Numeric#ago` and friends
+    *Kir Shatrov*
 
-    Replacements:
+*   Added `#without` on `Enumerable` and `Array` to return a copy of an
+    enumerable without the specified elements.
 
-        5.ago   => 5.seconds.ago
-        5.until => 5.seconds.until
-        5.since => 5.seconds.since
-        5.from_now => 5.seconds.from_now
+    *Todd Bealmear*
 
-    See #12389 for the history and rationale behind this.
+*   Fixed a problem where `String#truncate_words` would get stuck with a complex
+    string.
 
-    *Godfrey Chan*
+    *Henrik Nygren*
 
-*   DateTime `advance` now supports partial days.
+*   Fixed a roundtrip problem with `AS::SafeBuffer` where primitive-like strings
+    will be dumped as primitives:
 
     Before:
 
-        DateTime.now.advance(days: 1, hours: 12)
+        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
+        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => true
+        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => false
+        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => 1
+        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => 1.1
 
     After:
 
-        DateTime.now.advance(days: 1.5)
+        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
+        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => "true"
+        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => "false"
+        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => "1"
+        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => "1.1"
+
+    *Godfrey Chan*
+
+*   Enable `number_to_percentage` to keep the number's precision by allowing
+    `:precision` to be `nil`.
 
-    Fixes #12005.
+    *Jack Xu*
 
-    *Shay Davidson*
+*   `config_accessor` became a private method, as with Ruby's `attr_accessor`.
 
-*   `Hash#deep_transform_keys` and `Hash#deep_transform_keys!` now transform hashes
-    in nested arrays.  This change also applies to `Hash#deep_stringify_keys`,
-    `Hash#deep_stringify_keys!`, `Hash#deep_symbolize_keys` and
-    `Hash#deep_symbolize_keys!`.
+    *Akira Matsuda*
 
-    *OZAWA Sakuro*
+*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
+    `Time.now` and `Date.today`.
 
-*   Fixed confusing `DelegationError` in `Module#delegate`.
+    *Yuki Nishijima*
 
-    See #15186.
+*   Add `file_fixture` to `ActiveSupport::TestCase`.
+    It provides a simple mechanism to access sample files in your test cases.
 
-    *Vladimir Yarotsky*
+    By default file fixtures are stored in `test/fixtures/files`. This can be
+    configured per test-case using the `file_fixture_path` class attribute.
 
-*   Fixed `ActiveSupport::Subscriber` so that no duplicate subscriber is created
-    when a subscriber method is redefined.
+    *Yves Senn*
 
-    *Dennis Schön*
+*   Return value of yielded block in `File.atomic_write`.
 
-*   Remove deprecated string based terminators for `ActiveSupport::Callbacks`.
+    *Ian Ker-Seymer*
 
-    *Eileen M. Uchitelle*
+*   Duplicate frozen array when assigning it to a `HashWithIndifferentAccess` so
+    that it doesn't raise a `RuntimeError` when calling `map!` on it in `convert_value`.
 
-*   Fixed an issue when using
-    `ActiveSupport::NumberHelper::NumberToDelimitedConverter` to
-    convert a value that is an `ActiveSupport::SafeBuffer` introduced
-    in 2da9d67.
+    Fixes #18550.
 
-    See #15064.
+    *Aditya Kapoor*
 
-    *Mark J. Titorenko*
+*   Add missing time zone definitions for Russian Federation and sync them
+    with `zone.tab` file from tzdata version 2014j (latest).
 
-*   `TimeZone#parse` defaults the day of the month to '1' if any other date
-    components are specified. This is more consistent with the behavior of
-    `Time#parse`.
+    *Andrey Novikov*
 
-    *Ulysse Carion*
+*   Add `SecureRandom.base58` for generation of random base58 strings.
 
-*   `humanize` strips leading underscores, if any.
+    *Matthew Draper*, *Guillermo Iguaran*
 
-    Before:
+*   Add `#prev_day` and `#next_day` counterparts to `#yesterday` and
+    `#tomorrow` for `Date`, `Time`, and `DateTime`.
 
-        '_id'.humanize # => ""
+    *George Claghorn*
 
-    After:
+*   Add `same_time` option to `#next_week` and `#prev_week` for `Date`, `Time`,
+    and `DateTime`.
 
-        '_id'.humanize # => "Id"
+    *George Claghorn*
 
-    *Xavier Noria*
+*   Add `#on_weekend?`, `#next_weekday`, `#prev_weekday` methods to `Date`,
+    `Time`, and `DateTime`.
 
-*   Fixed backward compatibility issues introduced in 326e652.
+    `#on_weekend?` returns `true` if the receiving date/time falls on a Saturday
+    or Sunday.
 
-    Empty Hash or Array should not be present in serialization result.
+    `#next_weekday` returns a new date/time representing the next day that does
+    not fall on a Saturday or Sunday.
 
-        {a: []}.to_query # => ""
-        {a: {}}.to_query # => ""
+    `#prev_weekday` returns a new date/time representing the previous day that
+    does not fall on a Saturday or Sunday.
 
-    For more info see #14948.
+    *George Claghorn*
 
-    *Bogdan Gusiev*
+*   Added ability to `TaggedLogging` to allow loggers to be instantiated multiple times
+    so that they don't share tags with each other.
 
-*   Add `Digest::UUID::uuid_v3` and `Digest::UUID::uuid_v5` to support stable
-    UUID fixtures on PostgreSQL.
+        Rails.logger = Logger.new(STDOUT)
 
-    *Roderick van Domburg*
+        # Before
+        custom_logger = ActiveSupport::TaggedLogging.new(Rails.logger)
+        custom_logger.push_tags "custom_tag"
+        custom_logger.info "test"  # => "[custom_tag] [custom_tag] test"
+        Rails.logger.info "test"   # => "[custom_tag] [custom_tag] test"
 
-*   Fixed `ActiveSupport::Duration#eql?` so that `1.second.eql?(1.second)` is
-    true.
+        # After
+        custom_logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT))
+        custom_logger.push_tags "custom_tag"
+        custom_logger.info "test"  # => "[custom_tag] test"
+        Rails.logger.info "test"   # => "test"
 
-    This fixes the current situation of:
+    *Alexander Staubo*
 
-        1.second.eql?(1.second) # => false
+*   Change the default test order from `:sorted` to `:random`.
 
-    `eql?` also requires that the other object is an `ActiveSupport::Duration`.
-    This requirement makes `ActiveSupport::Duration`'s behavior consistent with
-    the behavior of Ruby's numeric types:
+    *Rafael Mendonça França*
 
-        1.eql?(1.0) # => false
-        1.0.eql?(1) # => false
+*   Remove deprecated `ActiveSupport::JSON::Encoding::CircularReferenceError`.
 
-        1.second.eql?(1) # => false (was true)
-        1.eql?(1.second) # => false
+    *Rafael Mendonça França*
 
-        { 1 => "foo", 1.0 => "bar" }
-        # => { 1 => "foo", 1.0 => "bar" }
+*   Remove deprecated methods `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string=`
+    and `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string`.
 
-        { 1 => "foo", 1.second => "bar" }
-        # now => { 1 => "foo", 1.second => "bar" }
-        # was => { 1 => "bar" }
+    *Rafael Mendonça França*
 
-    And though the behavior of these hasn't changed, for reference:
+*   Remove deprecated `ActiveSupport::SafeBuffer#prepend`.
 
-        1 == 1.0 # => true
-        1.0 == 1 # => true
+    *Rafael Mendonça França*
 
-        1 == 1.second # => true
-        1.second == 1 # => true
+*   Remove deprecated methods at `Kernel`.
 
-    *Emily Dobervich*
+    `silence_stderr`, `silence_stream`, `capture` and `quietly`.
 
-*   `ActiveSupport::SafeBuffer#prepend` acts like `String#prepend` and modifies
-    instance in-place, returning self. `ActiveSupport::SafeBuffer#prepend!` is
-    deprecated.
+    *Rafael Mendonça França*
 
-    *Pavel Pravosud*
+*   Remove deprecated `active_support/core_ext/big_decimal/yaml_conversions`
+    file.
 
-*   `HashWithIndifferentAccess` better respects `#to_hash` on objects it
-    receives. In particular, `.new`, `#update`, `#merge`, and `#replace` accept
-    objects which respond to `#to_hash`, even if those objects are not hashes
-    directly.
+    *Rafael Mendonça França*
 
-    *Peter Jaros*
+*   Remove deprecated methods `ActiveSupport::Cache::Store.instrument` and
+    `ActiveSupport::Cache::Store.instrument=`.
 
-*   Deprecate `Class#superclass_delegating_accessor`, use `Class#class_attribute` instead.
+    *Rafael Mendonça França*
 
-    *Akshay Vishnoi*
+*   Change the way in which callback chains can be halted.
 
-*   Ensure classes which `include Enumerable` get `#to_json` in addition to
-    `#as_json`.
+    The preferred method to halt a callback chain from now on is to explicitly
+    `throw(:abort)`.
+    In the past, callbacks could only be halted by explicitly providing a
+    terminator and by having a callback match the conditions of the terminator.
 
-    *Sammy Larbi*
+*   Add `ActiveSupport.halt_callback_chains_on_return_false`
 
-*   Change the signature of `fetch_multi` to return a hash rather than an
-    array. This makes it consistent with the output of `read_multi`.
+    Setting `ActiveSupport.halt_callback_chains_on_return_false`
+    to `true` will let an app support the deprecated way of halting Active Record,
+    and Active Model callback chains by returning `false`.
 
-    *Parker Selbert*
+    Setting the value to `false` will tell the app to ignore any `false` value
+    returned by those callbacks, and only halt the chain upon `throw(:abort)`.
 
-*   Introduce `Concern#class_methods` as a sleek alternative to clunky
-    `module ClassMethods`. Add `Kernel#concern` to define at the toplevel
-    without chunky `module Foo; extend ActiveSupport::Concern` boilerplate.
+    When the configuration option is missing, its value is `true`, so older apps
+    ported to Rails 5.0 will not break (but display a deprecation warning).
+    For new Rails 5.0 apps, its value is set to `false` in an initializer, so
+    these apps will support the new behavior by default.
 
-        # app/models/concerns/authentication.rb
-        concern :Authentication do
-          included do
-            after_create :generate_private_key
-          end
+    *claudiob*, *Roque Pinel*
+
+*   Changes arguments and default value of CallbackChain's `:terminator` option
+
+    Chains of callbacks defined without an explicit `:terminator` option will
+    now be halted as soon as a `before_` callback throws `:abort`.
+
+    Chains of callbacks defined with a `:terminator` option will maintain their
+    existing behavior of halting as soon as a `before_` callback matches the
+    terminator's expectation.
+
+    *claudiob*
+
+*   Deprecate `MissingSourceFile` in favor of `LoadError`.
+
+    `MissingSourceFile` was just an alias to `LoadError` and was not being
+    raised inside the framework.
+
+    *Rafael Mendonça França*
 
-          class_methods do
-            def authenticate(credentials)
-              # ...
+*   Remove `Object#itself` as it is implemented in Ruby 2.2.
+
+    *Cristian Bica*
+
+*   Add support for error dispatcher classes in `ActiveSupport::Rescuable`.
+    Now it acts closer to Ruby's rescue.
+
+    Example:
+
+        class BaseController < ApplicationController
+          module ErrorDispatcher
+            def self.===(other)
+              Exception === other && other.respond_to?(:status)
             end
           end
 
-          def generate_private_key
-            # ...
+          rescue_from ErrorDispatcher do |error|
+            render status: error.status, json: { error: error.to_s }
           end
         end
 
-        # app/models/user.rb
-        class User < ActiveRecord::Base
-          include Authentication
-        end
+    *Genadi Samokovarov*
+
+*   Add `#verified` and `#valid_message?` methods to `ActiveSupport::MessageVerifier`
+
+    Previously, the only way to decode a message with `ActiveSupport::MessageVerifier`
+    was to use `#verify`, which would raise an exception on invalid messages. Now
+    `#verified` can also be used, which returns `nil` on messages that cannot be
+    decoded.
+
+    Previously, there was no way to check if a message's format was valid without
+    attempting to decode it. `#valid_message?` is a boolean convenience method that
+    checks whether the message is valid without actually decoding it.
 
-    *Jeremy Kemper*
+    *Logan Leger*
 
-Please check [4-1-stable](https://github.com/rails/rails/blob/4-1-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activesupport/CHANGELOG.md) for previous changes.