activesupport 5.0.7.2 → 5.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c93a6ec74305893c50054e579965712f900e475786e4c5e4ecfaa5535393707
-  data.tar.gz: d567933dc1d8bcbb26b2196bd1c8cf3c73bbbd22cedffa788dc30bb3903cbc64
+  metadata.gz: 0ece0ba787f6df68f2378c0e387d18f2a56a00359a4885e0d155ba9e57811caa
+  data.tar.gz: 4fc1a1e4b58d382f0fd49539f28707234d7828c46a79c9bca397c1d327ca25b4
 SHA512:
-  metadata.gz: 8d85066fd3f4036cccf567138f8412d679ae15c1c4f3300e96f2fd93c8a7516229c62a3481641e2a7a048b22490ab23f7aafb0e7ace9e6f33364d86b46cc4531
-  data.tar.gz: 82219cb259ee1d7c39a10f8d1c35858629badee5da7fa5f027442410db07e9d9b57d0e6d4dd20c8f8864c7ea3be8775bcd14b8942e185b0490fe5a177cca7822
+  metadata.gz: 78703452ca309f7344f0e8d544bbe093147dba9cbd09917ed4aa72f2e1121ff3cf1835cd062a169d680dd2d7457d892a771d2947f7ce9b1729199a48dd745947
+  data.tar.gz: ac4bdb64bfd7815044ec53ccd8008f6c62733c525437069d466a33f1af0d0566ded8017daa872269d4921bf777f67662edb0043d68dee271e0defe25b3c42ec7

data/CHANGELOG.md

@@ -1,14 +1,19 @@
-## Rails 5.0.7.2 (March 11, 2019) ##
+## Rails 5.1.7 (March 27, 2019) ##
 
 *   No changes.
 
 
-## Rails 5.0.7.1 (November 27, 2018) ##
+## Rails 5.1.6.2 (March 11, 2019) ##
 
 *   No changes.
 
 
-## Rails 5.0.7 (March 29, 2018) ##
+## Rails 5.1.6.1 (November 27, 2018) ##
+
+*   No changes.
+
+
+## Rails 5.1.6 (March 29, 2018) ##
 
 *   Return all mappings for a timezone identifier in `country_zones`
 
@@ -27,992 +32,757 @@
     *Andrew White*
 
 
-## Rails 5.0.6 (September 07, 2017) ##
+## Rails 5.1.5 (February 14, 2018) ##
 
 *   No changes.
 
 
-## Rails 5.0.6.rc1 (August 24, 2017) ##
+## Rails 5.1.4 (September 07, 2017) ##
 
 *   No changes.
 
 
-## Rails 5.0.5 (July 31, 2017) ##
+## Rails 5.1.4.rc1 (August 24, 2017) ##
 
 *   No changes.
 
 
-## Rails 5.0.5.rc2 (July 25, 2017) ##
+## Rails 5.1.3 (August 03, 2017) ##
 
 *   No changes.
 
 
-## Rails 5.0.5.rc1 (July 19, 2017) ##
+## Rails 5.1.3.rc3 (July 31, 2017) ##
 
-*   No changes.
+*   Fix modulo operations involving durations
 
+    Rails 5.1 introduce an `ActiveSupport::Duration::Scalar` class as a wrapper
+    around a numeric value as a way of ensuring a duration was the outcome of
+    an expression. However the implementation was missing support for modulo
+    operations. This support has now been added and should result in a duration
+    being returned from expressions involving modulo operations.
 
-## Rails 5.0.4 (June 19, 2017) ##
+    Prior to Rails 5.1:
 
-*   No changes.
+        5.minutes % 2.minutes
+        => 60
 
+    Now:
 
-## Rails 5.0.3 (May 12, 2017) ##
+        5.minutes % 2.minutes
+        => 1 minute
 
-*   `ActiveSupport::EventedFileUpdateChecker` no longer listens to
-    directories outside of the application directory.
+    Fixes #29603 and #29743.
 
-    *radiospiel*
+    *Sayan Chakraborty*, *Andrew White*
 
-*   Return unmapped timezones from `country_zones`
+*   Fix division where a duration is the denominator
 
-    If a country doesn't exist in the MAPPINGS hash then create a new
-    `ActiveSupport::Timezone` instance using the supplied timezone id.
+    PR #29163 introduced a change in behavior when a duration was the denominator
+    in a calculation - this was incorrect as dividing by a duration should always
+    return a `Numeric`. The behavior of previous versions of Rails has been restored.
 
-    Fixes #28431.
+    Fixes #29592.
 
     *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`.
-    Properly pass through the frozen `Time` or `ActiveSupport::TimeWithZone` object
-    when calling `#to_time`.
-
-    *Kevin McPhillips* & *Andrew White*
-
-*   Fix inconsistent results when parsing large durations and constructing durations from code
 
-        ActiveSupport::Duration.parse('P3Y') == 3.years # It should be true
-
-    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
-    `Marshal.method(:load).super_method.call(sourse, proc)` just to be able to pass a proc.
-
-    *Jeff Latz*
-
-*   `ActiveSupport::Gzip.decompress` now checks checksum and length in footer.
-
-    *Dylan Thacker-Smith*
-
-*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
-
-    *Adam Rice*
-
-
-## Rails 5.0.1 (December 21, 2016) ##
+## Rails 5.1.3.rc2 (July 25, 2017) ##
 
 *   No changes.
 
 
-## Rails 5.0.1.rc2 (December 10, 2016) ##
+## Rails 5.1.3.rc1 (July 19, 2017) ##
 
 *   No changes.
 
 
-## Rails 5.0.1.rc1 (December 01, 2016) ##
+## Rails 5.1.2 (June 26, 2017) ##
 
-*   Ensure duration parsing is consistent across DST changes
+*   Cache: Restore the `options = nil` argument for `LocalStore#clear`
+    that was removed in 5.1.0. Restores compatibility with backends that
+    take an options argument and use the local cache strategy.
 
-    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.
+    *Jeremy Daer*
 
-    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.
+*   Fix implicit coercion calculations with scalars and durations
 
-    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.
+    Previously calculations where the scalar is first would be converted to a duration
+    of seconds but this causes issues with dates being converted to times, e.g:
 
-    Fixes #26941.
+        Time.zone = "Beijing"           # => Asia/Shanghai
+        date = Date.civil(2017, 5, 20)  # => Mon, 20 May 2017
+        2 * 1.day                       # => 172800 seconds
+        date + 2 * 1.day                # => Mon, 22 May 2017 00:00:00 CST +08:00
 
-    *Andrew White*
+    Now the `ActiveSupport::Duration::Scalar` calculation methods will try to maintain
+    the part structure of the duration where possible, e.g:
 
-*   Fix `DateAndTime::Calculations#copy_time_to`. Copy `nsec` instead of `usec`.
+        Time.zone = "Beijing"           # => Asia/Shanghai
+        date = Date.civil(2017, 5, 20)  # => Mon, 20 May 2017
+        2 * 1.day                       # => 2 days
+        date + 2 * 1.day                # => Mon, 22 May 2017
 
-    Jumping forward or backward between weeks now preserves nanosecond digits.
+    Fixes #29160, #28970.
 
-    *Josua Schmid*
+    *Andrew White*
 
-*   Avoid bumping the class serial when invoking executor.
 
-    *Matthew Draper*
+## Rails 5.1.1 (May 12, 2017) ##
 
-*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+*   No changes.
 
-    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"
+## Rails 5.1.0 (April 27, 2017) ##
 
-        t = Time.zone.local(2016,11,6,1)
-        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+*   `ActiveSupport::EventedFileUpdateChecker` no longer listens to
+    directories outside of the application directory.
 
-        t.in(1.hour)
-        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+    *radiospiel*
 
-    Fixes #26580.
+*   Return unmapped timezones from `country_zones`
 
-    *Thomas Balthazar*
+    If a country doesn't exist in the MAPPINGS hash then create a new
+    `ActiveSupport::Timezone` instance using the supplied timezone id.
 
-*   Fix `thread_mattr_accessor` subclass no longer overwrites parent.
+    Fixes #28431.
 
-    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.
+    *Andrew White*
 
-    Given:
+*   Add ActiveSupport::Deprecation::DeprecatedConstantAccessor
 
-        class Account
-          thread_mattr_accessor :user
-        end
+    Provides transparent deprecation of constants, compatible with exceptions.
+    Example usage:
 
-        class Customer < Account
+        module Example
+          include ActiveSupport::Deprecation::DeprecatedConstantAccessor
+          deprecate_constant 'OldException', 'Elsewhere::NewException'
         end
 
-        Account.user = "DHH"
-        Customer.user = "Rafael"
-
-    Before:
+    *Dominic Cleal*
 
-        Account.user  # => "Rafael"
+*   Fixed bug in `DateAndTime::Compatibility#to_time` that caused it to
+    raise `RuntimeError: can't modify frozen Time` when called on any frozen `Time`.
+    Properly pass through the frozen `Time` or `ActiveSupport::TimeWithZone` object
+    when calling `#to_time`.
 
-    After:
+    *Kevin McPhillips* & *Andrew White*
 
-        Account.user  # => "DHH"
+*   Remove implicit coercion deprecation of durations
 
-    *Shinichi Maeshima*
+    In #28204 we deprecated implicit conversion of durations to a numeric which
+    represented the number of seconds in the duration because of unwanted side
+    effects with calculations on durations and dates. This unfortunately had
+    the side effect of forcing a explicit cast when configuring third-party
+    libraries like expiration in Redis, e.g:
 
-*   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.
+        redis.expire("foo", 5.minutes)
 
-    Fixes #26039.
+    To work around this we've removed the deprecation and added a private class
+    that wraps the numeric and can perform calculation involving durations and
+    ensure that they remain a duration irrespective of the order of operations.
 
     *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.
+*   Update `titleize` regex to allow apostrophes
 
-    *Andrey Novikov*
+    In 4b685aa the regex in `titleize` was updated to not match apostrophes to
+    better reflect the nature of the transformation. Unfortunately, this had the
+    side effect of breaking capitalization on the first word of a sub-string, e.g:
 
-*   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.
+        >> "This was 'fake news'".titleize
+        => "This Was 'fake News'"
 
-    *Alexey Shein*
-
-*   Make `getlocal` and `getutc` always return instances of `Time` for
-    `ActiveSupport::TimeWithZone` and `DateTime`. This eliminates a possible
-    stack level too deep error in `to_time` where `ActiveSupport::TimeWithZone`
-    was wrapping a `DateTime` instance. As a consequence of this the internal
-    time value in `ActiveSupport::TimeWithZone` is now always an instance of
-    `Time` in the UTC timezone, whether that's as the UTC time directly or
-    a representation of the local time in the timezone. There should be no
-    consequences of this internal change and if there are it's a bug due to
-    leaky abstractions.
-
-    *Andrew White*
-
-*   Add `DateTime#subsec` to return the fraction of a second as a `Rational`.
-
-    *Andrew White*
+    This is fixed by extending the look-behind to also check for a word
+    character on the other side of the apostrophe.
 
-*   Add additional aliases for `DateTime#utc` to mirror the ones on
-    `ActiveSupport::TimeWithZone` and `Time`.
+    Fixes #28312.
 
     *Andrew White*
 
-*   Add `DateTime#localtime` to return an instance of `Time` in the system's
-    local timezone. Also aliased to `getlocal`.
+*   Add `rfc3339` aliases to `xmlschema` for `Time` and `ActiveSupport::TimeWithZone`
 
-    *Andrew White*, *Yuichiro Kaneko*
-
-*   Add `Time#sec_fraction` to return the fraction of a second as a `Rational`.
+    For naming consistency when using the RFC 3339 profile of ISO 8601 in applications.
 
     *Andrew White*
 
-*   Add `ActiveSupport.to_time_preserves_timezone` config option to control
-    how `to_time` handles timezones. In Ruby 2.4+ the behavior will change
-    from converting to the local system timezone, to preserving the timezone
-    of the receiver. This config option defaults to false so that apps made
-    with earlier versions of Rails are not affected when upgrading, e.g:
-
-        >> ENV['TZ'] = 'US/Eastern'
-
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T06:23:12.000-04:00"
+*   Add `Time.rfc3339` parsing method
 
-        >> ActiveSupport.to_time_preserves_timezone = true
-
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T10:23:12.000Z"
-
-    Fixes #24617.
+    `Time.xmlschema` and consequently its alias `iso8601` accepts timestamps
+    without a offset in contravention of the RFC 3339 standard. This method
+    enforces that constraint and raises an `ArgumentError` if it doesn't.
 
     *Andrew White*
 
-*   `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"]
+*   Add `ActiveSupport::TimeZone.rfc3339` parsing method
 
-        >> ActiveSupport::TimeZone.country_zones(:uy).map(&:to_s)
-        => ["(GMT-03:00) Montevideo"]
+    Previously, there was no way to get a RFC 3339 timestamp into a specific
+    timezone without either using `parse` or chaining methods. The new method
+    allows parsing directly into the timezone, e.g:
 
-    *Andrey Novikov*
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.rfc3339("1999-12-31T14:00:00Z")
+        => Fri, 31 Dec 1999 14:00:00 HST -10:00
 
-*   `Array#sum` compat with Ruby 2.4's native method.
+    This new method has stricter semantics than the current `parse` method,
+    and will raise an `ArgumentError` instead of returning nil, e.g:
 
-    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.
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.rfc3339("foobar")
+        ArgumentError: invalid date
+        >> Time.zone.parse("foobar")
+        => nil
 
-    Native Ruby 2.4:
+    It will also raise an `ArgumentError` when either the time or offset
+    components are missing, e.g:
 
-        %w[ a b ].sum
-        # => TypeError: String can't be coerced into Fixnum
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.rfc3339("1999-12-31")
+        ArgumentError: invalid date
+        >> Time.zone.rfc3339("1999-12-31T14:00:00")
+        ArgumentError: invalid date
 
-    With `Enumerable#sum` shim:
-
-        %w[ a b ].sum
-        # => 'ab'
+    *Andrew White*
 
-    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`.
+*   Add `ActiveSupport::TimeZone.iso8601` parsing method
 
-    *Jeremy Daer*
+    Previously, there was no way to get a ISO 8601 timestamp into a specific
+    timezone without either using `parse` or chaining methods. The new method
+    allows parsing directly into the timezone, e.g:
 
-*   `ActiveSupport::Duration` supports ISO8601 formatting and parsing.
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.iso8601("1999-12-31T14:00:00Z")
+        => Fri, 31 Dec 1999 14:00:00 HST -10:00
 
-        ActiveSupport::Duration.parse('P3Y6M4DT12H30M5S')
-        # => 3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds
+    If the timestamp is a ISO 8601 date (YYYY-MM-DD), then the time is set
+    to midnight, e.g:
 
-        (3.years + 3.days).iso8601
-        # => "P3Y3D"
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.iso8601("1999-12-31")
+        => Fri, 31 Dec 1999 00:00:00 HST -10:00
 
-    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.
+    This new method has stricter semantics than the current `parse` method,
+    and will raise an `ArgumentError` instead of returning nil, e.g:
 
-    (Will be used to support the PostgreSQL interval data type.)
+        >> Time.zone = "Hawaii"
+        => "Hawaii"
+        >> Time.zone.iso8601("foobar")
+        ArgumentError: invalid date
+        >> Time.zone.parse("foobar")
+        => nil
 
-    *Andrey Novikov*, *Arnau Siches*, *Andrew White*
+    *Andrew White*
 
-*   `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.
+*   Deprecate implicit coercion of `ActiveSupport::Duration`
 
-        cache.fetch('key', force: true) # => ArgumentError
+    Currently `ActiveSupport::Duration` implicitly converts to a seconds
+    value when used in a calculation except for the explicit examples of
+    addition and subtraction where the duration is the receiver, e.g:
 
-    *Santosh Wadghule*
+        >> 2 * 1.day
+        => 172800
 
-*   Fix behavior of JSON encoding for `Exception`.
+    This results in lots of confusion especially when using durations
+    with dates because adding/subtracting a value from a date treats
+    integers as a day and not a second, e.g:
 
-    *namusyaka*
+        >> Date.today
+        => Wed, 01 Mar 2017
+        >> Date.today + 2 * 1.day
+        => Mon, 10 Apr 2490
 
-*   Make `number_to_phone` format number with regexp pattern.
+    To fix this we're implementing `coerce` so that we can provide a
+    deprecation warning with the intent of removing the implicit coercion
+    in Rails 5.2, e.g:
 
-        number_to_phone(18812345678, pattern: /(\d{3})(\d{4})(\d{4})/)
-        # => 188-1234-5678
+        >> 2 * 1.day
+        DEPRECATION WARNING: Implicit coercion of ActiveSupport::Duration
+        to a Numeric is deprecated and will raise a TypeError in Rails 5.2.
+        => 172800
 
-    *Pan Gaoyong*
+    In Rails 5.2 it will raise `TypeError`, e.g:
 
-*   Match `String#to_time`'s behaviour to that of ruby's implementation for edge cases.
+        >> 2 * 1.day
+        TypeError: ActiveSupport::Duration can't be coerced into Integer
 
-    `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.
+    This is the same behavior as with other types in Ruby, e.g:
 
-    Fixes #22958.
+        >> 2 * "foo"
+        TypeError: String can't be coerced into Integer
+        >> "foo" * 2
+        => "foofoo"
 
-    *Siim Liiser*
+    As part of this deprecation add `*` and `/` methods to `AS::Duration`
+    so that calculations that keep the duration as the receiver work
+    correctly whether the final receiver is a `Date` or `Time`, e.g:
 
-*   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.
+        >> Date.today
+        => Wed, 01 Mar 2017
+        >> Date.today + 1.day * 2
+        => Fri, 03 Mar 2017
 
-    Fixes #24228.
+    Fixes #27457.
 
     *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.
+*   Update `DateTime#change` to support `:usec` and `:nsec` options.
 
-    *Olek Janiszewski*
+    Adding support for these options now allows us to update the `DateTime#end_of`
+    methods to match the equivalent `Time#end_of` methods, e.g:
 
-*   Deprecate `Module.local_constants`. Please use `Module.constants(false)` instead.
+        datetime = DateTime.now.end_of_day
+        datetime.nsec == 999999999 # => true
 
-    *Yuichiro Kaneko*
+    Fixes #21424.
 
-*   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.
+    *Dan Moore*, *Andrew White*
 
-    *Matthew Draper*
+*   Add `ActiveSupport::Duration#before` and `#after` as aliases for `#until` and `#since`
 
-*   Deprecate arguments on `assert_nothing_raised`.
+    These read more like English and require less mental gymnastics to read and write.
 
-    `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*
+    Before:
 
-*   Make `benchmark('something', silence: true)` actually work.
+        2.weeks.since(customer_start_date)
+        5.days.until(today)
 
-    *DHH*
+    After:
 
-*   Add `#on_weekday?` method to `Date`, `Time`, and `DateTime`.
+        2.weeks.after(customer_start_date)
+        5.days.before(today)
 
-    `#on_weekday?` returns `true` if the receiving date/time does not fall on a Saturday
-    or Sunday.
+    *Nick Johnstone*
 
-    *Vipul A M*
+*   Soft-deprecated the top-level `HashWithIndifferentAccess` constant.
+    `ActiveSupport::HashWithIndifferentAccess` should be used instead.
 
-*   Add `Array#second_to_last` and `Array#third_to_last` methods.
+    Fixes #28157.
 
-    *Brian Christian*
+    *Robin Dupret*
 
-*   Fix regression in `Hash#dig` for HashWithIndifferentAccess.
+*   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
+    `Marshal.method(:load).super_method.call(source, proc)` just to be able to pass a proc.
 
-    *Jon Moss*
+    *Jeff Latz*
 
-*   Change `number_to_currency` behavior for checking negativity.
+*   `ActiveSupport::Gzip.decompress` now checks checksum and length in footer.
 
-    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".
+    *Dylan Thacker-Smith*
 
-        -0.0.to_f.negative? => false
-        -0.0.to_f.phase? => 3.14
+*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
 
-    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.
+    *Adam Rice*
 
-    *Prathamesh Sonpatki*, *Rafael Mendonça França*
+*   Deprecate `ActiveSupport.halt_callback_chains_on_return_false`.
 
-*   Match `HashWithIndifferentAccess#default`'s behaviour with `Hash#default`.
+    *Rafael Mendonça França*
 
-    *David Cornu*
+*   Remove deprecated behavior that halts callbacks when the return is false.
 
-*   Adds `:exception_object` key to `ActiveSupport::Notifications::Instrumenter`
-    payload when an exception is raised.
+    *Rafael Mendonça França*
 
-    Adds new key/value pair to payload when an exception is raised:
-    e.g. `:exception_object => #<RuntimeError: FAIL>`.
+*   Deprecate passing string to `:if` and `:unless` conditional options
+    on `set_callback` and `skip_callback`.
 
-    *Ryan T. Hosford*
+    *Ryuta Kamizono*
 
-*   Support extended grapheme clusters and UAX 29.
+*   Raise `ArgumentError` when passing string to define callback.
 
-    *Adam Roben*
+    *Ryuta Kamizono*
 
-*   Add petabyte and exabyte numeric conversion.
+*   Updated Unicode version to 9.0.0
 
-    *Akshay Vishnoi*
+    Now we can handle new emojis such like "👩‍👩‍👧‍👦" ("\u{1F469}\u{200D}\u{1F469}\u{200D}\u{1F467}\u{200D}\u{1F466}").
 
-*   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.
+    version 8.0.0
 
-    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:
+        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 4
+        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👦👧‍👩‍👩‍"
 
-        module Current
-          thread_mattr_accessor :account
-          thread_mattr_accessor :user
+    version 9.0.0
 
-          def self.reset() self.account = self.user = nil end
-        end
+        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 1
+        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👩‍👩‍👧‍👦"
 
-        class ApplicationController < ActionController::Base
-          before_action :set_current
-          after_action { Current.reset }
+    *Fumiaki MATSUSHIMA*
 
-          private
-            def set_current
-              Current.account = Account.find(params[:account_id])
-              Current.user    = Current.account.users.find(params[:user_id])
-            end
-        end
+*   Changed `ActiveSupport::Inflector#transliterate` to raise `ArgumentError` when it receives
+    anything except a string.
 
-        class MessagesController < ApplicationController
-          def create
-            @message = Message.create!(message_params)
-          end
-        end
+    *Kevin McPhillips*
 
-        class Message < ApplicationRecord
-          has_many :events
-          after_create :track_created
+*   Fixed bugs that `StringInquirer#respond_to_missing?` and
+    `ArrayInquirer#respond_to_missing?` do not fallback to `super`.
 
-          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
-
-    *DHH*
-
-
-*   Deprecated `Module#qualified_const_` in favour of the builtin Module#const_
-    methods.
+    *Akira Matsuda*
 
-    *Genadi Samokovarov*
+*   Fix inconsistent results when parsing large durations and constructing durations from code
 
-*   Deprecate passing string to define callback.
+        ActiveSupport::Duration.parse('P3Y') == 3.years # It should be true
 
-    *Yuichiro Kaneko*
+    Duration parsing made independent from any moment of time:
+    Fixed length in seconds is assigned to each duration part during parsing.
 
-*   `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`.
+    Changed duration of months and years in seconds to more accurate and logical:
 
-    `ActiveSupport::Cache::LocaleCache#set_cache_value` is deprecated and replaced with `write_cache_value`.
+     1. The value of 365.2425 days in Gregorian year is more accurate
+        as it accounts for every 400th non-leap year.
 
-    *Michael Grosser*
+     2. Month's length is bound to year's duration, which makes
+        sensible comparisons like `12.months == 1.year` to be `true`
+        and nonsensical ones like `30.days == 1.month` to be `false`.
 
-*   Implements an evented file watcher to asynchronously detect changes in the
-    application source code, routes, locales, etc.
+    Calculations on times and dates with durations shouldn't be affected as
+    duration's numeric value isn't used in calculations, only parts are used.
 
-    This watcher is disabled by default, applications my enable it in the configuration:
+    Methods on `Numeric` like `2.days` now use these predefined durations
+    to avoid duplication of duration constants through the codebase and
+    eliminate creation of intermediate durations.
 
-        # config/environments/development.rb
-        config.file_watcher = ActiveSupport::EventedFileUpdateChecker
+    *Andrey Novikov*, *Andrew White*
 
-    This feature depends on the [listen](https://github.com/guard/listen) gem:
+*   Change return value of `Rational#duplicable?`, `ComplexClass#duplicable?`
+    to false.
 
-        group :development do
-          gem 'listen', '~> 3.0.5'
-        end
+    *utilum*
 
-    *Puneet Agarwal* and *Xavier Noria*
+*   Change return value of `NilClass#duplicable?`, `FalseClass#duplicable?`,
+    `TrueClass#duplicable?`, `Symbol#duplicable?` and `Numeric#duplicable?`
+    to true with Ruby 2.4+. These classes can dup with Ruby 2.4+.
 
-*   Added `Time.days_in_year` to return the number of days in the given year, or the
-    current year if no argument is provided.
+    *Yuji Yaginuma*
 
-    *Jon Pascoe*
+*   Remove deprecated class `ActiveSupport::Concurrency::Latch`.
 
-*   Updated `parameterize` to preserve the case of a string, optionally.
+    *Andrew White*
 
-    Example:
+*   Remove deprecated separator argument from `parameterize`.
 
-        parameterize("Donald E. Knuth", separator: '_') # => "donald_e_knuth"
-        parameterize("Donald E. Knuth", preserve_case: true) # => "Donald-E-Knuth"
+    *Andrew White*
 
-    *Swaathi Kakarla*
+*   Remove deprecated method `Numeric#to_formatted_s`.
 
-*   `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`.
+    *Andrew White*
 
-    *Gordon Chan*
+*   Remove deprecated method `alias_method_chain`.
 
-*   Change Integer#year to return a Fixnum instead of a Float to improve
-    consistency.
+    *Andrew White*
 
-    Integer#years returned a Float while the rest of the accompanying methods
-    (days, weeks, months, etc.) return a Fixnum.
+*   Remove deprecated constant `MissingSourceFile`.
 
-    Before:
+    *Andrew White*
 
-    1.year # => 31557600.0
+*   Remove deprecated methods `Module.qualified_const_defined?`,
+    `Module.qualified_const_get` and `Module.qualified_const_set`.
 
-    After:
+    *Andrew White*
 
-    1.year # => 31557600
+*   Remove deprecated `:prefix` option from `number_to_human_size`.
 
-    *Konstantinos Rousis*
+    *Andrew White*
 
-*   Handle invalid UTF-8 strings when HTML escaping.
+*   Remove deprecated method `ActiveSupport::HashWithIndifferentAccess.new_from_hash_copying_default`.
 
-    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.
+    *Andrew White*
 
-    *Grey Baker*
+*   Remove deprecated file `active_support/core_ext/time/marshal.rb`.
 
-*   Update `ActiveSupport::Multibyte::Chars#slice!` to return `nil` if the
-    arguments are out of bounds, to mirror the behavior of `String#slice!`
+    *Andrew White*
 
-    *Gourav Tiwari*
+*   Remove deprecated file `active_support/core_ext/struct.rb`.
 
-*   Fix `number_to_human` so that 999999999 rounds to "1 Billion" instead of
-    "1000 Million".
+    *Andrew White*
 
-    *Max Jacobson*
+*   Remove deprecated file `active_support/core_ext/module/method_transplanting.rb`.
 
-*   Fix `ActiveSupport::Deprecation#deprecate_methods` to report using the
-    current deprecator instance, where applicable.
+    *Andrew White*
 
-    *Brandon Dunne*
+*   Remove deprecated method `Module.local_constants`.
 
-*   `Cache#fetch` instrumentation marks whether it was a `:hit`.
+    *Andrew White*
 
-    *Robin Clowers*
+*   Remove deprecated file `active_support/core_ext/kernel/debugger.rb`.
 
-*   `assert_difference` and `assert_no_difference` now returns the result of the
-    yielded block.
+    *Andrew White*
 
-    Example:
+*   Remove deprecated method `ActiveSupport::Cache::Store#namespaced_key`.
 
-      post = assert_difference -> { Post.count }, 1 do
-        Post.create
-      end
+    *Andrew White*
 
-    *Lucas Mazza*
+*   Remove deprecated method `ActiveSupport::Cache::Strategy::LocalCache::LocalStore#set_cache_value`.
 
-*   Short-circuit `blank?` on date and time values since they are never blank.
+    *Andrew White*
 
-    Fixes #21657.
+*   Remove deprecated method `ActiveSupport::Cache::MemCacheStore#escape_key`.
 
     *Andrew White*
 
-*   Replaced deprecated `ThreadSafe::Cache` with its successor `Concurrent::Map` now that
-    the thread_safe gem has been merged into concurrent-ruby.
-
-    *Jerry D'Antonio*
+*   Remove deprecated method `ActiveSupport::Cache::FileStore#key_file_path`.
 
-*   Updated Unicode version to 8.0.0
+    *Andrew White*
 
-    *Anshul Sharma*
+*   Ensure duration parsing is consistent across DST changes.
 
-*   `number_to_currency` and `number_with_delimiter` now accept custom `delimiter_pattern` option
-     to handle placement of delimiter, to support currency formats like INR
+    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.
 
-     Example:
+    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.
 
-        number_to_currency(1230000, delimiter_pattern: /(\d+?)(?=(\d\d)+(\d)(?!\d))/, unit: '₹', format: "%u %n")
-        # => '₹ 12,30,000.00'
+    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.
 
-    *Vipul A M*
+    Fixes #26941.
 
-*   Deprecate `:prefix` option of `number_to_human_size` with no replacement.
+    *Andrew White*
 
-    *Jean Boussier*
+*   Use `Hash#compact` and `Hash#compact!` from Ruby 2.4. Old Ruby versions
+    will continue to get these methods from Active Support as before.
 
-*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
-        twz = DateTime.now.in_time_zone
-        twz.eql?(twz.dup) => true
+    *Prathamesh Sonpatki*
 
-    Fixes #14178.
+*   Fix `ActiveSupport::TimeZone#strptime`.
+    Support for timestamps in format of seconds (%s) and milliseconds (%Q).
 
-    *Roque Pinel*
+    Fixes #26840.
 
-*   ActiveSupport::HashWithIndifferentAccess `select` and `reject` will now return
-    enumerator if called without block.
+    *Lev Denisov*
 
-    Fixes #20095.
+*   Fix `DateAndTime::Calculations#copy_time_to`. Copy `nsec` instead of `usec`.
 
-    *Bernard Potocki*
+    Jumping forward or backward between weeks now preserves nanosecond digits.
 
-*   Removed `ActiveSupport::Concurrency::Latch`, superseded by `Concurrent::CountDownLatch`
-    from the concurrent-ruby gem.
+    *Josua Schmid*
 
-    *Jerry D'Antonio*
+*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
 
-*   Fix not calling `#default` on `HashWithIndifferentAccess#to_hash` when only
-    `default_proc` is set, which could raise.
+    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:
 
-    *Simon Eskildsen*
+        Time.zone = "US/Eastern"
 
-*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`.
+        t = Time.zone.local(2016,11,6,1)
+        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
 
-    *Simon Eskildsen*
+        t.in(1.hour)
+        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
 
-*   Fix a range of values for parameters of the Time#change.
+    Fixes #26580.
 
-    *Nikolay Kondratyev*
+    *Thomas Balthazar*
 
-*   Add `Enumerable#pluck` to get the same values from arrays as from ActiveRecord
-    associations.
+*   Remove unused parameter `options = nil` for `#clear` of
+    `ActiveSupport::Cache::Strategy::LocalCache::LocalStore` and
+    `ActiveSupport::Cache::Strategy::LocalCache`.
 
-    Fixes #20339.
+    *Yosuke Kabuto*
 
-    *Kevin Deisz*
+*   Fix `thread_mattr_accessor` subclass no longer overwrites parent.
 
-*   Add a bang version to `ActiveSupport::OrderedOptions` get methods which will raise
-    an `KeyError` if the value is `.blank?`.
+    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.
 
-    Before:
+    Given:
 
-        if (slack_url = Rails.application.secrets.slack_url).present?
-          # Do something worthwhile
-        else
-          # Raise as important secret password is not specified
+        class Account
+          thread_mattr_accessor :user
         end
 
-    After:
-
-        slack_url = Rails.application.secrets.slack_url!
-
-    *Aditya Sanghi*, *Gaurish Sharma*
-
-*   Remove deprecated `Class#superclass_delegating_accessor`.
-    Use `Class#class_attribute` instead.
-
-    *Akshay Vishnoi*
-
-*   Patch `Delegator` to work with `#try`.
-
-    Fixes #5790.
-
-    *Nate Smith*
-
-*   Add `Integer#positive?` and `Integer#negative?` query methods
-    in the vein of `Fixnum#zero?`.
-
-    This makes it nicer to do things like `bunch_of_numbers.select(&:positive?)`.
-
-    *DHH*
-
-*   Encoding `ActiveSupport::TimeWithZone` to YAML now preserves the timezone information.
-
-    Fixes #9183.
-
-    *Andrew White*
-
-*   Added `ActiveSupport::TimeZone#strptime` to allow parsing times as if
-    from a given timezone.
-
-    *Paul A Jungwirth*
-
-*   `ActiveSupport::Callbacks#skip_callback` now raises an `ArgumentError` if
-    an unrecognized callback is removed.
-
-    *Iain Beeston*
-
-*   Added `ActiveSupport::ArrayInquirer` and `Array#inquiry`.
-
-    Wrapping an array in an `ArrayInquirer` gives a friendlier way to check its
-    contents:
-
-        variants = ActiveSupport::ArrayInquirer.new([:phone, :tablet])
-
-        variants.phone?    # => true
-        variants.tablet?   # => true
-        variants.desktop?  # => false
-
-        variants.any?(:phone, :tablet)   # => true
-        variants.any?(:phone, :desktop)  # => true
-        variants.any?(:desktop, :watch)  # => false
-
-    `Array#inquiry` is a shortcut for wrapping the receiving array in an
-    `ArrayInquirer`.
-
-    *George Claghorn*
-
-*   Deprecate `alias_method_chain` in favour of `Module#prepend` introduced in
-    Ruby 2.0.
-
-    *Kir Shatrov*
-
-*   Added `#without` on `Enumerable` and `Array` to return a copy of an
-    enumerable without the specified elements.
-
-    *Todd Bealmear*
-
-*   Fixed a problem where `String#truncate_words` would get stuck with a complex
-    string.
-
-    *Henrik Nygren*
+        class Customer < Account
+        end
 
-*   Fixed a roundtrip problem with `AS::SafeBuffer` where primitive-like strings
-    will be dumped as primitives:
+        Account.user = "DHH"
+        Customer.user = "Rafael"
 
     Before:
 
-        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
+        Account.user  # => "Rafael"
 
     After:
 
-        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`.
-
-    *Jack Xu*
-
-*   `config_accessor` became a private method, as with Ruby's `attr_accessor`.
-
-    *Akira Matsuda*
-
-*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
-    `Time.now` and `Date.today`.
-
-    *Yuki Nishijima*
-
-*   Add `file_fixture` to `ActiveSupport::TestCase`.
-    It provides a simple mechanism to access sample files in your test cases.
-
-    By default file fixtures are stored in `test/fixtures/files`. This can be
-    configured per test-case using the `file_fixture_path` class attribute.
-
-    *Yves Senn*
-
-*   Return value of yielded block in `File.atomic_write`.
-
-    *Ian Ker-Seymer*
-
-*   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`.
-
-    Fixes #18550.
-
-    *Aditya Kapoor*
-
-*   Add missing time zone definitions for Russian Federation and sync them
-    with `zone.tab` file from tzdata version 2014j (latest).
-
-    *Andrey Novikov*
-
-*   Add `SecureRandom.base58` for generation of random base58 strings.
-
-    *Matthew Draper*, *Guillermo Iguaran*
+        Account.user  # => "DHH"
 
-*   Add `#prev_day` and `#next_day` counterparts to `#yesterday` and
-    `#tomorrow` for `Date`, `Time`, and `DateTime`.
+    *Shinichi Maeshima*
 
-    *George Claghorn*
+*   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.
 
-*   Add `same_time` option to `#next_week` and `#prev_week` for `Date`, `Time`,
-    and `DateTime`.
+    Fixes #26039.
 
-    *George Claghorn*
+    *Andrew White*
 
-*   Add `#on_weekend?`, `#next_weekday`, `#prev_weekday` methods to `Date`,
-    `Time`, and `DateTime`.
+*   Defines `Regexp.match?` for Ruby versions prior to 2.4. The predicate
+    has the same interface, but it does not have the performance boost. Its
+    purpose is to be able to write 2.4 compatible code.
 
-    `#on_weekend?` returns `true` if the receiving date/time falls on a Saturday
-    or Sunday.
+    *Xavier Noria*
 
-    `#next_weekday` returns a new date/time representing the next day that does
-    not fall on a Saturday or Sunday.
+*   Allow `MessageEncryptor` to take advantage of authenticated encryption modes.
 
-    `#prev_weekday` returns a new date/time representing the previous day that
-    does not fall on a Saturday or Sunday.
+    AEAD modes like `aes-256-gcm` provide both confidentiality and data
+    authenticity, eliminating the need to use `MessageVerifier` to check if the
+    encrypted data has been tampered with. This speeds up encryption/decryption
+    and results in shorter cipher text.
 
-    *George Claghorn*
+    *Bart de Water*
 
-*   Added ability to `TaggedLogging` to allow loggers to be instantiated multiple times
-    so that they don't share tags with each other.
+*   Introduce `assert_changes` and `assert_no_changes`.
 
-        Rails.logger = Logger.new(STDOUT)
+    `assert_changes` is a more general `assert_difference` that works with any
+    value.
 
-        # 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"
+        assert_changes 'Error.current', from: nil, to: 'ERR' do
+          expected_bad_operation
+        end
 
-        # 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"
+    Can be called with strings, to be evaluated in the binding (context) of
+    the block given to the assertion, or a lambda.
 
-    *Alexander Staubo*
+        assert_changes -> { Error.current }, from: nil, to: 'ERR' do
+          expected_bad_operation
+        end
 
-*   Change the default test order from `:sorted` to `:random`.
+    The `from` and `to` arguments are compared with the case operator (`===`).
 
-    *Rafael Mendonça França*
+        assert_changes 'Error.current', from: nil, to: Error do
+          expected_bad_operation
+        end
 
-*   Remove deprecated `ActiveSupport::JSON::Encoding::CircularReferenceError`.
+    This is pretty useful, if you need to loosely compare a value. For example,
+    you need to test a token has been generated and it has that many random
+    characters.
 
-    *Rafael Mendonça França*
-
-*   Remove deprecated methods `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string=`
-    and `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string`.
+        user = User.start_registration
+        assert_changes 'user.token', to: /\w{32}/ do
+          user.finish_registration
+        end
 
-    *Rafael Mendonça França*
+    *Genadi Samokovarov*
 
-*   Remove deprecated `ActiveSupport::SafeBuffer#prepend`.
+*   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.
 
-    *Rafael Mendonça França*
+    Fixes #25701.
 
-*   Remove deprecated methods at `Kernel`.
+    *John Gesimondo*
 
-    `silence_stderr`, `silence_stream`, `capture` and `quietly`.
+*   `travel/travel_to` travel time helpers, now raise on nested calls,
+    as this can lead to confusing time stubbing.
 
-    *Rafael Mendonça França*
+    Instead of:
 
-*   Remove deprecated `active_support/core_ext/big_decimal/yaml_conversions`
-    file.
+        travel_to 2.days.from_now do
+          # 2 days from today
+          travel_to 3.days.from_now do
+            # 5 days from today
+          end
+        end
 
-    *Rafael Mendonça França*
+    preferred way to achieve above is:
 
-*   Remove deprecated methods `ActiveSupport::Cache::Store.instrument` and
-    `ActiveSupport::Cache::Store.instrument=`.
+        travel 2.days do
+          # 2 days from today
+        end
 
-    *Rafael Mendonça França*
+        travel 5.days do
+          # 5 days from today
+        end
 
-*   Change the way in which callback chains can be halted.
+    *Vipul A M*
 
-    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.
+*   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.
 
-*   Add `ActiveSupport.halt_callback_chains_on_return_false`
+    *Grzegorz Witek*
 
-    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`.
+*   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.
 
-    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)`.
+    *Kevin McPhillips*
 
-    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.
+*   Remove deprecated arguments in `assert_nothing_raised`.
 
-    *claudiob*, *Roque Pinel*
+    *Rafel Mendonça França*
 
-*   Changes arguments and default value of CallbackChain's `:terminator` option
+*   `Date.to_s` doesn't produce too many spaces. For example, `to_s(:short)`
+    will now produce `01 Feb` instead of ` 1 Feb`.
 
-    Chains of callbacks defined without an explicit `:terminator` option will
-    now be halted as soon as a `before_` callback throws `:abort`.
+    Fixes #25251.
 
-    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.
+    *Sean Griffin*
 
-    *claudiob*
+*   Introduce `Module#delegate_missing_to`.
 
-*   Deprecate `MissingSourceFile` in favor of `LoadError`.
+    When building a decorator, a common pattern emerges:
 
-    `MissingSourceFile` was just an alias to `LoadError` and was not being
-    raised inside the framework.
+        class Partition
+          def initialize(first_event)
+            @events = [ first_event ]
+          end
 
-    *Rafael Mendonça França*
+          def people
+            if @events.first.detail.people.any?
+              @events.collect { |e| Array(e.detail.people) }.flatten.uniq
+            else
+              @events.collect(&:creator).uniq
+            end
+          end
 
-*   Remove `Object#itself` as it is implemented in Ruby 2.2.
+          private
+            def respond_to_missing?(name, include_private = false)
+              @events.respond_to?(name, include_private)
+            end
 
-    *Cristian Bica*
+            def method_missing(method, *args, &block)
+              @events.send(method, *args, &block)
+            end
+        end
 
-*   Add support for error dispatcher classes in `ActiveSupport::Rescuable`.
-    Now it acts closer to Ruby's rescue.
+    With `Module#delegate_missing_to`, the above is condensed to:
 
-    Example:
+        class Partition
+          delegate_missing_to :@events
 
-        class BaseController < ApplicationController
-          module ErrorDispatcher
-            def self.===(other)
-              Exception === other && other.respond_to?(:status)
-            end
+          def initialize(first_event)
+            @events = [ first_event ]
           end
 
-          rescue_from ErrorDispatcher do |error|
-            render status: error.status, json: { error: error.to_s }
+          def people
+            if @events.first.detail.people.any?
+              @events.collect { |e| Array(e.detail.people) }.flatten.uniq
+            else
+              @events.collect(&:creator).uniq
+            end
           end
         end
 
-    *Genadi Samokovarov*
+    *Genadi Samokovarov*, *DHH*
 
-*   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.
+*   Rescuable: If a handler doesn't match the exception, check for handlers
+    matching the exception's cause.
 
-    *Logan Leger*
+    *Jeremy Daer*
 
-Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [5-0-stable](https://github.com/rails/rails/blob/5-0-stable/activesupport/CHANGELOG.md) for previous changes.