activesupport 4.2.11.3 → 5.2.8.1

data/CHANGELOG.md

@@ -1,688 +1,720 @@
-## Rails 4.2.11.3 (May 15, 2020) ##
+## Rails 5.2.8.1 (July 12, 2022) ##
 
 *   No changes.
 
 
-## Rails 4.2.11.2 (May 15, 2020) ##
+## Rails 5.2.8 (May 09, 2022) ##
 
 *   No changes.
 
 
-## Rails 4.2.11.1 (March 11, 2019) ##
+## Rails 5.2.7.1 (April 26, 2022) ##
 
-*   No changes.
+*   Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
 
+    Add the method `ERB::Util.xml_name_escape` to escape dangerous characters
+    in names of tags and names of attributes, following the specification of XML.
 
-## Rails 4.2.11 (November 27, 2018) ##
+    *Álvaro Martín Fraguas*
 
-*   No changes.
 
+## Rails 5.2.7 (March 10, 2022) ##
 
-## Rails 4.2.10 (September 27, 2017) ##
+*   Restore support to Ruby 2.2.
 
-*   No changes.
+    *ojab*
 
 
-## Rails 4.2.9 (June 26, 2017) ##
+## Rails 5.2.6.3 (March 08, 2022) ##
 
-*   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`.
+*   No changes.
 
-    *Kevin McPhillips* & *Andrew White*
 
-*   Restore the return type of `DateTime#utc`
+## Rails 5.2.6.2 (February 11, 2022) ##
 
-    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.
+*   Fix Reloader method signature to work with the new Executor signature
 
-    *Andrew White*
 
-*   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.
+## Rails 5.2.6.1 (February 11, 2022) ##
 
-    *Jeff Latz*
+*   No changes.
 
-*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
 
-    *Adam Rice*
+## Rails 5.2.6 (May 05, 2021) ##
 
-*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
-    `Time.now` and `Date.today`.
+*   No changes.
 
-    *Yuki Nishijima*
 
+## Rails 5.2.5 (March 26, 2021) ##
 
-## Rails 4.2.8 (February 21, 2017) ##
+*   No changes.
 
-*   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*
+## Rails 5.2.4.6 (May 05, 2021) ##
 
-*   Add `DateTime#subsec` to return the fraction of a second as a `Rational`.
+*   No changes.
 
-    *Andrew White*
 
-*   Add additional aliases for `DateTime#utc` to mirror the ones on
-    `ActiveSupport::TimeWithZone` and `Time`.
+## Rails 5.2.4.5 (February 10, 2021) ##
 
-    *Andrew White*
+*   No changes.
 
-*   Add `DateTime#localtime` to return an instance of `Time` in the system's
-    local timezone. Also aliased to `getlocal`.
 
-    *Andrew White*, *Yuichiro Kaneko*
+## Rails 5.2.4.4 (September 09, 2020) ##
 
-*   Add `Time#sec_fraction` to return the fraction of a second as a `Rational`.
+*   No changes.
 
-    *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:
+## Rails 5.2.4.3 (May 18, 2020) ##
 
-        >> ENV['TZ'] = 'US/Eastern'
+*   [CVE-2020-8165] Deprecate Marshal.load on raw cache read in RedisCacheStore
 
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T06:23:12.000-04:00"
+*   [CVE-2020-8165] Avoid Marshal.load on raw cache value in MemCacheStore
 
-        >> ActiveSupport.to_time_preserves_timezone = true
+## Rails 5.2.4.2 (March 19, 2020) ##
 
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T10:23:12.000Z"
+*   No changes.
 
-    Fixes #24617.
 
-    *Andrew White*
+## Rails 5.2.4.1 (December 18, 2019) ##
 
-*   Add `init_with` to `ActiveSupport::TimeWithZone` and `ActiveSupport::TimeZone`
+*   No changes.
 
-    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.
 
-    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.
+## Rails 5.2.4 (November 27, 2019) ##
 
-    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.
+*   Make ActiveSupport::Logger Fiber-safe. Fixes #36752.
 
-    Fixes #26296.
+    Use `Fiber.current.__id__` in `ActiveSupport::Logger#local_level=` in order
+    to make log level local to Ruby Fibers in addition to Threads.
 
-    *Andrew White*
+    Example:
 
-*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+        logger = ActiveSupport::Logger.new(STDOUT)
+        logger.level = 1
+        p "Main is debug? #{logger.debug?}"
 
-    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:
+        Fiber.new {
+          logger.local_level = 0
+          p "Thread is debug? #{logger.debug?}"
+        }.resume
 
-        Time.zone = "US/Eastern"
+        p "Main is debug? #{logger.debug?}"
+
+    Before:
 
-        t = Time.zone.local(2016,11,6,1)
-        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? true
 
-        t.in(1.hour)
-        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+    After:
 
-    Fixes #26580.
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? false
 
-    *Thomas Balthazar*
+    *Alexander Varnin*
 
 
-## Rails 4.2.7 (July 12, 2016) ##
+## Rails 5.2.3 (March 27, 2019) ##
 
-*   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.
+*   Add `ActiveSupport::HashWithIndifferentAccess#assoc`.
 
-    *Kevin McPhillips*
+    `assoc` can now be called with either a string or a symbol.
 
-*   Backported `ActiveSupport::LoggerThreadSafeLevel`. Assigning the
-    `Rails.logger.level` is now thread safe.
+    *Stefan Schüßler*
 
-    *Kevin McPhillips*
+*   Fix `String#safe_constantize` throwing a `LoadError` for incorrectly cased constant references.
 
-*   Fixed a problem with ActiveSupport::SafeBuffer.titleize calling capitalize
-    on nil.
+    *Keenan Brock*
 
-    *Brian McManus*
+*   Allow Range#=== and Range#cover? on Range
 
-*   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.
+    `Range#cover?` can now accept a range argument like `Range#include?` and
+    `Range#===`. `Range#===` works correctly on Ruby 2.6. `Range#include?` is moved
+    into a new file, with these two methods.
 
-    *Alexey Shein*
+    *utilum*
 
-*   Prevent `Marshal.load` from looping infinitely when trying to autoload a constant
-    which resolves to a different name.
+*   If the same block is `included` multiple times for a Concern, an exception is no longer raised.
 
-    *Olek Janiszewski*
+    *Mark J. Titorenko*, *Vlad Bokov*
 
 
-## Rails 4.2.6 (March 07, 2016) ##
+## Rails 5.2.2.1 (March 11, 2019) ##
 
 *   No changes.
 
 
-## Rails 4.2.5.2 (February 26, 2016) ##
+## Rails 5.2.2 (December 04, 2018) ##
 
-*   No changes.
+*   Fix bug where `#to_options` for `ActiveSupport::HashWithIndifferentAccess`
+    would not act as alias for `#symbolize_keys`.
 
+    *Nick Weiland*
 
-## Rails 4.2.5.1 (January 25, 2015) ##
+*   Improve the logic that detects non-autoloaded constants.
 
-*   No changes.
+    *Jan Habermann*, *Xavier Noria*
 
+*   Fix bug where `URI.unescape` would fail with mixed Unicode/escaped character input:
 
-## Rails 4.2.5 (November 12, 2015) ##
+        URI.unescape("\xe3\x83\x90")  # => "バ"
+        URI.unescape("%E3%83%90")  # => "バ"
+        URI.unescape("\xe3\x83\x90%E3%83%90")  # => Encoding::CompatibilityError
 
-*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
-        twz = DateTime.now.in_time_zone
-        twz.eql?(twz.dup) => true
+    *Ashe Connor*, *Aaron Patterson*
 
-    Fixes #14178.
 
-    *Roque Pinel*
+## Rails 5.2.1.1 (November 27, 2018) ##
 
-*   Handle invalid UTF-8 characters in `MessageVerifier.verify`.
+*   No changes.
 
-    *Roque Pinel*, *Grey Baker*
 
+## Rails 5.2.1 (August 07, 2018) ##
 
-## Rails 4.2.4 (August 24, 2015) ##
+*   Redis cache store: `delete_matched` no longer blocks the Redis server.
+    (Switches from evaled Lua to a batched SCAN + DEL loop.)
 
-*   Fix a `SystemStackError` when encoding an `Enumerable` with `json` gem and
-    with the Active Support JSON encoder loaded.
+    *Gleb Mazovetskiy*
 
-    Fixes #20775.
+*   Fix bug where `ActiveSupport::Timezone.all` would fail when tzinfo data for
+    any timezone defined in `ActiveSupport::TimeZone::MAPPING` is missing.
 
-    *Sammy Larbi*, *Prathamesh Sonpatki*
+    *Dominik Sander*
 
-*   Fix not calling `#default` on `HashWithIndifferentAcess#to_hash` when only
-    `default_proc` is set, which could raise.
+*   Fix bug where `ActiveSupport::Cache` will massively inflate the storage
+    size when compression is enabled (which is true by default). This patch
+    does not attempt to repair existing data: please manually flush the cache
+    to clear out the problematic entries.
 
-    *Simon Eskildsen*
+    *Godfrey Chan*
 
-*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`
+*   Fix `ActiveSupport::Cache#read_multi` bug with local cache enabled that was
+    returning instances of `ActiveSupport::Cache::Entry` instead of the raw values.
 
-    *Simon Eskildsen*
+    *Jason Lee*
 
 
-## Rails 4.2.3 (June 25, 2015) ##
+## Rails 5.2.0 (April 09, 2018) ##
 
-*   Fix a range of values for parameters of the Time#change
+*   Caching: MemCache and Redis `read_multi` and `fetch_multi` speedup.
+    Read from the local in-memory cache before consulting the backend.
 
-    *Nikolay Kondratyev*
+    *Gabriel Sobrinho*
 
-*   Add some missing `require 'active_support/deprecation'`
+*   Return all mappings for a timezone identifier in `country_zones`.
 
-    *Akira Matsuda*
+    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"]
 
-## Rails 4.2.2 (June 16, 2015) ##
+        # After
+        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh", "London"]
 
-*   Fix XSS vulnerability in `ActiveSupport::JSON.encode` method.
+    Fixes #31668.
 
-    CVE-2015-3226.
+    *Andrew White*
 
-    *Rafael Mendonça França*
+*   Add support for connection pooling on RedisCacheStore.
 
-*   Fix denial of service vulnerability in the XML processing.
+    *fatkodima*
 
-    CVE-2015-3227.
+*   Support hash as first argument in `assert_difference`. This allows to specify multiple
+    numeric differences in the same assertion.
 
-    *Aaron Patterson*
+        assert_difference ->{ Article.count } => 1, ->{ Post.count } => 2
 
+    *Julien Meichelbeck*
 
-## Rails 4.2.1 (March 19, 2015) ##
+*   Add missing instrumentation for `read_multi` in `ActiveSupport::Cache::Store`.
 
-*   Fixed a problem where String#truncate_words would get stuck with a complex
-    string.
+    *Ignatius Reza Lesmana*
 
-    *Henrik Nygren*
+*   `assert_changes` will always assert that the expression changes,
+    regardless of `from:` and `to:` argument combinations.
 
-*   Fixed a roundtrip problem with AS::SafeBuffer where primitive-like strings
-    will be dumped as primitives:
+    *Daniel Ma*
 
-    Before:
+*   Use SHA-1 to generate non-sensitive digests, such as the ETag header.
 
-        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
+    Enabled by default for new apps; upgrading apps can opt in by setting
+    `config.active_support.use_sha1_digests = true`.
 
-     After:
+    *Dmitri Dolguikh*, *Eugene Kenny*
 
-        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"
+*   Changed default behaviour of `ActiveSupport::SecurityUtils.secure_compare`,
+    to make it not leak length information even for variable length string.
 
-    *Godfrey Chan*
+    Renamed old `ActiveSupport::SecurityUtils.secure_compare` to `fixed_length_secure_compare`,
+    and started raising `ArgumentError` in case of length mismatch of passed strings.
 
-*   Replace fixed `:en` with `I18n.default_locale` in `Duration#inspect`.
+    *Vipul A M*
 
-    *Dominik Masur*
+*   Make `ActiveSupport::TimeZone.all` return only time zones that are in
+    `ActiveSupport::TimeZone::MAPPING`.
 
-*   Add missing time zone definitions for Russian Federation and sync them
-    with `zone.tab` file from tzdata version 2014j (latest).
+    Fixes #7245.
 
-    *Andrey Novikov*
+    *Chris LaRose*
 
+*   MemCacheStore: Support expiring counters.
 
-## Rails 4.2.0 (December 20, 2014) ##
+    Pass `expires_in: [seconds]` to `#increment` and `#decrement` options
+    to set the Memcached TTL (time-to-live) if the counter doesn't exist.
+    If the counter exists, Memcached doesn't extend its expiry when it's
+    incremented or decremented.
 
-*   The decorated `load` and `require` methods are now kept private.
+    ```
+    Rails.cache.increment("my_counter", 1, expires_in: 2.minutes)
+    ```
 
-    Fixes #17553.
+    *Takumasa Ochi*
 
-    *Xavier Noria*
+*   Handle `TZInfo::AmbiguousTime` errors.
 
-*   `String#remove` and `String#remove!` accept multiple arguments.
+    Make `ActiveSupport::TimeWithZone` match Ruby's handling of ambiguous
+    times by choosing the later period, e.g.
 
-    *Pavel Pravosud*
+    Ruby:
+    ```
+    ENV["TZ"] = "Europe/Moscow"
+    Time.local(2014, 10, 26, 1, 0, 0)   # => 2014-10-26 01:00:00 +0300
+    ```
 
-*   `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.
+    Before:
+    ```
+    >> "2014-10-26 01:00:00".in_time_zone("Moscow")
+    TZInfo::AmbiguousTime: 26/10/2014 01:00 is an ambiguous local time.
+    ```
 
-    *Pablo Herrero*
+    After:
+    ```
+    >> "2014-10-26 01:00:00".in_time_zone("Moscow")
+    => Sun, 26 Oct 2014 01:00:00 MSK +03:00
+    ```
 
-*   Corrected `Inflector#underscore` handling of multiple successive acroynms.
+    Fixes #17395.
 
-    *James Le Cuirot*
+    *Andrew White*
 
-*   Delegation now works with ruby reserved words passed to `:to` option.
+*   Redis cache store.
 
-    Fixes #16956.
+    ```
+    # Defaults to `redis://localhost:6379/0`. Only use for dev/test.
+    config.cache_store = :redis_cache_store
 
-    *Agis Anastasopoulos*
+    # Supports all common cache store options (:namespace, :compress,
+    # :compress_threshold, :expires_in, :race_condition_ttl) and all
+    # Redis options.
+    cache_password = Rails.application.secrets.redis_cache_password
+    config.cache_store = :redis_cache_store, driver: :hiredis,
+      namespace: 'myapp-cache', compress: true, timeout: 1,
+      url: "redis://:#{cache_password}@myapp-cache-1:6379/0"
 
-*   Added method `#eql?` to `ActiveSupport::Duration`, in addition to `#==`.
+    # Supports Redis::Distributed with multiple hosts
+    config.cache_store = :redis_cache_store, driver: :hiredis
+      namespace: 'myapp-cache', compress: true,
+      url: %w[
+        redis://myapp-cache-1:6379/0
+        redis://myapp-cache-1:6380/0
+        redis://myapp-cache-2:6379/0
+        redis://myapp-cache-2:6380/0
+        redis://myapp-cache-3:6379/0
+        redis://myapp-cache-3:6380/0
+      ]
 
-    Currently, the following returns `false`, contrary to expectation:
+    # Or pass a builder block
+    config.cache_store = :redis_cache_store,
+      namespace: 'myapp-cache', compress: true,
+      redis: -> { Redis.new … }
+    ```
 
-        1.minute.eql?(1.minute)
+    Deployment note: Take care to use a *dedicated Redis cache* rather
+    than pointing this at your existing Redis server. It won't cope well
+    with mixed usage patterns and it won't expire cache entries by default.
 
-    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.
+    Redis cache server setup guide: https://redis.io/topics/lru-cache
 
-        1.minute.eql?(60.seconds)  # => true
-        1.minute.eql?(60)          # => false
+    *Jeremy Daer*
 
-    *Joost Lubach*
+*   Cache: Enable compression by default for values > 1kB.
 
-*   `Time#change` can now change nanoseconds (`:nsec`) as a higher-precision
-    alternative to microseconds (`:usec`).
+    Compression has long been available, but opt-in and at a 16kB threshold.
+    It wasn't enabled by default due to CPU cost. Today it's cheap and typical
+    cache data is eminently compressible, such as HTML or JSON fragments.
+    Compression dramatically reduces Memcached/Redis mem usage, which means
+    the same cache servers can store more data, which means higher hit rates.
 
-    *Agis Anastasooulos*
+    To disable compression, pass `compress: false` to the initializer.
 
-*   `MessageVerifier.new` raises an appropriate exception if the secret is `nil`.
-    This prevents `MessageVerifier#generate` from raising a cryptic error later on.
+    *Jeremy Daer*
 
-    *Kostiantyn Kahanskyi*
+*   Allow `Range#include?` on TWZ ranges.
 
-*   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.
+    In #11474 we prevented TWZ ranges being iterated over which matched
+    Ruby's handling of Time ranges and as a consequence `include?`
+    stopped working with both Time ranges and TWZ ranges. However in
+    ruby/ruby@b061634 support was added for `include?` to use `cover?`
+    for 'linear' objects. Since we have no way of making Ruby consider
+    TWZ instances as 'linear' we have to override `Range#include?`.
 
-    *Akira Matsuda*, *Godfrey Chan*
+    Fixes #30799.
 
-*   Fixed a bug in `Inflector#underscore` where acroynms in nested constant names
-    are incorrectly parsed as camelCase.
+    *Andrew White*
 
-    Fixes #8015.
+*   Fix acronym support in `humanize`.
 
-    *Fred Wu*, *Matthew Draper*
+    Acronym inflections are stored with lowercase keys in the hash but
+    the match wasn't being lowercased before being looked up in the hash.
+    This shouldn't have any performance impact because before it would
+    fail to find the acronym and perform the `downcase` operation anyway.
 
-*   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.
+    Fixes #31052.
 
-    *Agis Anastasopoulos*
+    *Andrew White*
 
-*   `Method` objects now report themselves as not `duplicable?`. This allows
-    hashes and arrays containing `Method` objects to be `deep_dup`ed.
+*   Add same method signature for `Time#prev_year` and `Time#next_year`
+    in accordance with `Date#prev_year`, `Date#next_year`.
 
-    *Peter Jaros*
+    Allows pass argument for `Time#prev_year` and `Time#next_year`.
 
-*   `determine_constant_from_test_name` does no longer shadow `NameError`s
-    which happens during constant autoloading.
+    Before:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_year    # => 2016-09-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_year(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
 
-    Fixes #9933.
+    Time.new(2017, 9, 16, 17, 0).next_year    # => 2018-09-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_year(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
+    ```
 
-    *Guo Xiang Tan*
+    After:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_year    # => 2016-09-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_year(1) # => 2016-09-16 17:00:00 +0300
 
-*   Added instance_eval version to Object#try and Object#try!, so you can do this:
+    Time.new(2017, 9, 16, 17, 0).next_year    # => 2018-09-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_year(1) # => 2018-09-16 17:00:00 +0300
+    ```
 
-        person.try { name.first }
+    *bogdanvlviv*
 
-    instead of:
+*   Add same method signature for `Time#prev_month` and `Time#next_month`
+    in accordance with `Date#prev_month`, `Date#next_month`.
 
-        person.try { |person| person.name.first }
+    Allows pass argument for `Time#prev_month` and `Time#next_month`.
 
-    *DHH*, *Ari Pollak*
+    Before:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_month    # => 2017-08-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_month(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
 
-*   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.
+    Time.new(2017, 9, 16, 17, 0).next_month    # => 2017-10-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_month(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
+    ```
 
-    *Robin Dupret*
+    After:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_month    # => 2017-08-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_month(1) # => 2017-08-16 17:00:00 +0300
 
-*   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.
+    Time.new(2017, 9, 16, 17, 0).next_month    # => 2017-10-16 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_month(1) # => 2017-10-16 17:00:00 +0300
+    ```
 
-    *DHH*
+    *bogdanvlviv*
 
-*   Fix DateTime comparison with `DateTime::Infinity` object.
+*   Add same method signature for `Time#prev_day` and `Time#next_day`
+    in accordance with `Date#prev_day`, `Date#next_day`.
 
-    *Rafael Mendonça França*
+    Allows pass argument for `Time#prev_day` and `Time#next_day`.
 
-*   Added Object#itself which returns the object itself. Useful when dealing with a chaining scenario, like Active Record scopes:
+    Before:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_day    # => 2017-09-15 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_day(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
 
-        Event.public_send(state.presence_in([ :trashed, :drafted ]) || :itself).order(:created_at)
+    Time.new(2017, 9, 16, 17, 0).next_day    # => 2017-09-17 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_day(1)
+    # => ArgumentError: wrong number of arguments (given 1, expected 0)
+    ```
 
-    *DHH*
+    After:
+    ```
+    Time.new(2017, 9, 16, 17, 0).prev_day    # => 2017-09-15 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).prev_day(1) # => 2017-09-15 17:00:00 +0300
 
-*   `Object#with_options` executes block in merging option context when
-    explicit receiver in not passed.
+    Time.new(2017, 9, 16, 17, 0).next_day    # => 2017-09-17 17:00:00 +0300
+    Time.new(2017, 9, 16, 17, 0).next_day(1) # => 2017-09-17 17:00:00 +0300
+    ```
 
-    *Pavel Pravosud*
+    *bogdanvlviv*
 
-*   Fixed a compatibility issue with the `Oj` gem when cherry-picking the file
-    `active_support/core_ext/object/json` without requiring `active_support/json`.
+*   `IO#to_json` now returns the `to_s` representation, rather than
+    attempting to convert to an array. This fixes a bug where `IO#to_json`
+    would raise an `IOError` when called on an unreadable object.
 
-    Fixes #16131.
+    Fixes #26132.
 
-    *Godfrey Chan*
+    *Paul Kuruvilla*
 
-*   Make `Hash#with_indifferent_access` copy the default proc too.
+*   Remove deprecated `halt_callback_chains_on_return_false` option.
 
-    *arthurnn*, *Xanders*
+    *Rafael Mendonça França*
 
-*   Add `String#truncate_words` to truncate a string by a number of words.
+*   Remove deprecated `:if` and `:unless` string filter for callbacks.
 
-    *Mohamed Osama*
+    *Rafael Mendonça França*
 
-*   Deprecate `capture` and `quietly`.
+*   `Hash#slice` now falls back to Ruby 2.5+'s built-in definition if defined.
 
-    These methods are not thread safe and may cause issues when used in threaded environments.
-    To avoid problems we are deprecating them.
+    *Akira Matsuda*
 
-    *Tom Meier*
+*   Deprecate `secrets.secret_token`.
 
-*   `DateTime#to_f` now preserves the fractional seconds instead of always
-    rounding to `.0`.
+    The architecture for secrets had a big upgrade between Rails 3 and Rails 4,
+    when the default changed from using `secret_token` to `secret_key_base`.
 
-    Fixes #15994.
+    `secret_token` has been soft deprecated in documentation for four years
+    but is still in place to support apps created before Rails 4.
+    Deprecation warnings have been added to help developers upgrade their
+    applications to `secret_key_base`.
 
-    *John Paul Ashenfelter*
+    *claudiob*, *Kasper Timm Hansen*
 
-*   Add `Hash#transform_values` to simplify a common pattern where the values of a
-    hash must change, but the keys are left the same.
+*   Return an instance of `HashWithIndifferentAccess` from `HashWithIndifferentAccess#transform_keys`.
 
-    *Sean Griffin*
+    *Yuji Yaginuma*
 
-*   Always instrument `ActiveSupport::Cache`.
+*   Add key rotation support to `MessageEncryptor` and `MessageVerifier`.
 
-    Since `ActiveSupport::Notifications` only instruments items when there
-    are attached subscribers, we don't need to disable instrumentation.
+    This change introduces a `rotate` method to both the `MessageEncryptor` and
+    `MessageVerifier` classes. This method accepts the same arguments and
+    options as the given classes' constructor. The `encrypt_and_verify` method
+    for `MessageEncryptor` and the `verified` method for `MessageVerifier` also
+    accept an optional keyword argument `:on_rotation` block which is called
+    when a rotated instance is used to decrypt or verify the message.
 
-    *Peter Wagenet*
+    *Michael J Coyne*
 
-*   Make the `apply_inflections` method case-insensitive when checking
-    whether a word is uncountable or not.
+*   Deprecate `Module#reachable?` method.
 
-    *Robin Dupret*
+    *bogdanvlviv*
 
-*   Make Dependencies pass a name to NameError error.
+*   Add `config/credentials.yml.enc` to store production app secrets.
 
-    *arthurnn*
+    Allows saving any authentication credentials for third party services
+    directly in repo encrypted with `config/master.key` or `ENV["RAILS_MASTER_KEY"]`.
 
-*   Fixed `ActiveSupport::Cache::FileStore` exploding with long paths.
+    This will eventually replace `Rails.application.secrets` and the encrypted
+    secrets introduced in Rails 5.1.
 
-    *Adam Panzer*, *Michael Grosser*
+    *DHH*, *Kasper Timm Hansen*
 
-*   Fixed `ActiveSupport::TimeWithZone#-` so precision is not unnecessarily lost
-    when working with objects with a nanosecond component.
+*   Add `ActiveSupport::EncryptedFile` and `ActiveSupport::EncryptedConfiguration`.
 
-    `ActiveSupport::TimeWithZone#-` should return the same result as if we were
-    using `Time#-`:
+    Allows for stashing encrypted files or configuration directly in repo by
+    encrypting it with a key.
 
-        Time.now.end_of_day - Time.now.beginning_of_day # => 86399.999999999
+    Backs the new credentials setup above, but can also be used independently.
 
-    Before:
+    *DHH*, *Kasper Timm Hansen*
 
-        Time.zone.now.end_of_day.nsec # => 999999999
-        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day # => 86400.0
+*   `Module#delegate_missing_to` now raises `DelegationError` if target is nil,
+    similar to `Module#delegate`.
 
-    After:
+    *Anton Khamets*
 
-        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day
-        # => 86399.999999999
+*   Update `String#camelize` to provide feedback when wrong option is passed.
 
-    *Gordon Chan*
+    `String#camelize` was returning nil without any feedback when an
+    invalid option was passed as a parameter.
 
-*   Fixed precision error in NumberHelper when using Rationals.
+    Previously:
 
-    Before:
+        'one_two'.camelize(true)
+        # => nil
 
-        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
-        # => "330.00"
+    Now:
 
-    After:
+        'one_two'.camelize(true)
+        # => ArgumentError: Invalid option, use either :upper or :lower.
 
-        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
-        # => "333.33"
+    *Ricardo Díaz*
 
-    See #15379.
+*   Fix modulo operations involving durations.
 
-    *Juanjo Bazán*
+    Rails 5.1 introduced `ActiveSupport::Duration::Scalar` as a wrapper
+    around numeric values 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.
 
-*   Removed deprecated `Numeric#ago` and friends
+    Prior to Rails 5.1:
 
-    Replacements:
+        5.minutes % 2.minutes
+        # => 60
 
-        5.ago   => 5.seconds.ago
-        5.until => 5.seconds.until
-        5.since => 5.seconds.since
-        5.from_now => 5.seconds.from_now
+    Now:
 
-    See #12389 for the history and rationale behind this.
+        5.minutes % 2.minutes
+        # => 1 minute
 
-    *Godfrey Chan*
+    Fixes #29603 and #29743.
 
-*   DateTime `advance` now supports partial days.
+    *Sayan Chakraborty*, *Andrew White*
 
-    Before:
+*   Fix division where a duration is the denominator.
 
-        DateTime.now.advance(days: 1, hours: 12)
+    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.
 
-    After:
+    Fixes #29592.
 
-        DateTime.now.advance(days: 1.5)
+    *Andrew White*
 
-    Fixes #12005.
+*   Add purpose and expiry support to `ActiveSupport::MessageVerifier` and
+   `ActiveSupport::MessageEncryptor`.
 
-    *Shay Davidson*
+    For instance, to ensure a message is only usable for one intended purpose:
 
-*   `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!`.
+        token = @verifier.generate("x", purpose: :shipping)
 
-    *OZAWA Sakuro*
+        @verifier.verified(token, purpose: :shipping) # => "x"
+        @verifier.verified(token)                     # => nil
 
-*   Fixed confusing `DelegationError` in `Module#delegate`.
+    Or make it expire after a set time:
 
-    See #15186.
+        @verifier.generate("x", expires_in: 1.month)
+        @verifier.generate("y", expires_at: Time.now.end_of_year)
 
-    *Vladimir Yarotsky*
+    Showcased with `ActiveSupport::MessageVerifier`, but works the same for
+    `ActiveSupport::MessageEncryptor`'s `encrypt_and_sign` and `decrypt_and_verify`.
 
-*   Fixed `ActiveSupport::Subscriber` so that no duplicate subscriber is created
-    when a subscriber method is redefined.
+    Pull requests: #29599, #29854
 
-    *Dennis Schön*
+    *Assain Jaleel*
 
-*   Remove deprecated string based terminators for `ActiveSupport::Callbacks`.
+*   Make the order of `Hash#reverse_merge!` consistent with `HashWithIndifferentAccess`.
 
-    *Eileen M. Uchitelle*
+    *Erol Fornoles*
 
-*   Fixed an issue when using
-    `ActiveSupport::NumberHelper::NumberToDelimitedConverter` to
-    convert a value that is an `ActiveSupport::SafeBuffer` introduced
-    in 2da9d67.
+*   Add `freeze_time` helper which freezes time to `Time.now` in tests.
 
-    See #15064.
+    *Prathamesh Sonpatki*
 
-    *Mark J. Titorenko*
+*   Default `ActiveSupport::MessageEncryptor` to use AES 256 GCM encryption.
 
-*   `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`.
+    On for new Rails 5.2 apps. Upgrading apps can find the config as a new
+    framework default.
 
-    *Ulysse Carion*
+    *Assain Jaleel*
 
-*   `humanize` strips leading underscores, if any.
+*   Cache: `write_multi`.
 
-    Before:
+        Rails.cache.write_multi foo: 'bar', baz: 'qux'
 
-        '_id'.humanize # => ""
+    Plus faster fetch_multi with stores that implement `write_multi_entries`.
+    Keys that aren't found may be written to the cache store in one shot
+    instead of separate writes.
 
-    After:
+    The default implementation simply calls `write_entry` for each entry.
+    Stores may override if they're capable of one-shot bulk writes, like
+    Redis `MSET`.
 
-        '_id'.humanize # => "Id"
+    *Jeremy Daer*
 
-    *Xavier Noria*
+*   Add default option to module and class attribute accessors.
 
-*   Fixed backward compatibility issues introduced in 326e652.
+        mattr_accessor :settings, default: {}
 
-    Empty Hash or Array should not be present in serialization result.
+    Works for `mattr_reader`, `mattr_writer`, `cattr_accessor`, `cattr_reader`,
+    and `cattr_writer` as well.
 
-        {a: []}.to_query # => ""
-        {a: {}}.to_query # => ""
+    *Genadi Samokovarov*
 
-    For more info see #14948.
+*   Add `Date#prev_occurring` and `Date#next_occurring` to return specified next/previous occurring day of week.
 
-    *Bogdan Gusiev*
+    *Shota Iguchi*
 
-*   Add `Digest::UUID::uuid_v3` and `Digest::UUID::uuid_v5` to support stable
-    UUID fixtures on PostgreSQL.
+*   Add default option to `class_attribute`.
 
-    *Roderick van Domburg*
+    Before:
 
-*   Fixed `ActiveSupport::Duration#eql?` so that `1.second.eql?(1.second)` is
-    true.
+        class_attribute :settings
+        self.settings = {}
 
-    This fixes the current situation of:
+    Now:
 
-        1.second.eql?(1.second) # => false
+        class_attribute :settings, default: {}
 
-    `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:
+    *DHH*
 
-        1.eql?(1.0) # => false
-        1.0.eql?(1) # => false
+*   `#singularize` and `#pluralize` now respect uncountables for the specified locale.
 
-        1.second.eql?(1) # => false (was true)
-        1.eql?(1.second) # => false
+    *Eilis Hamilton*
 
-        { 1 => "foo", 1.0 => "bar" }
-        # => { 1 => "foo", 1.0 => "bar" }
+*   Add `ActiveSupport::CurrentAttributes` to provide a thread-isolated attributes singleton.
+    Primary use case is keeping all the per-request attributes easily available to the whole system.
 
-        { 1 => "foo", 1.second => "bar" }
-        # now => { 1 => "foo", 1.second => "bar" }
-        # was => { 1 => "bar" }
+    *DHH*
 
-    And though the behavior of these hasn't changed, for reference:
+*   Fix implicit coercion calculations with scalars and durations.
 
-        1 == 1.0 # => true
-        1.0 == 1 # => true
+    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:
 
-        1 == 1.second # => true
-        1.second == 1 # => true
+        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
 
-    *Emily Dobervich*
+    Now, the `ActiveSupport::Duration::Scalar` calculation methods will try to maintain
+    the part structure of the duration where possible, e.g:
 
-*   `ActiveSupport::SafeBuffer#prepend` acts like `String#prepend` and modifies
-    instance in-place, returning self. `ActiveSupport::SafeBuffer#prepend!` is
-    deprecated.
+        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
 
-    *Pavel Pravosud*
+    Fixes #29160, #28970.
 
-*   `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.
+    *Andrew White*
 
-    *Peter Jaros*
+*   Add support for versioned cache entries. This enables the cache stores to recycle cache keys, greatly saving
+    on storage in cases with frequent churn. Works together with the separation of `#cache_key` and `#cache_version`
+    in Active Record and its use in Action Pack's fragment caching.
 
-*   Deprecate `Class#superclass_delegating_accessor`, use `Class#class_attribute` instead.
+    *DHH*
 
-    *Akshay Vishnoi*
+*   Pass gem name and deprecation horizon to deprecation notifications.
 
-*   Ensure classes which `include Enumerable` get `#to_json` in addition to
-    `#as_json`.
+    *Willem van Bergen*
 
-    *Sammy Larbi*
+*   Add support for `:offset` and `:zone` to `ActiveSupport::TimeWithZone#change`.
 
-*   Change the signature of `fetch_multi` to return a hash rather than an
-    array. This makes it consistent with the output of `read_multi`.
+    *Andrew White*
 
-    *Parker Selbert*
+*   Add support for `:offset` to `Time#change`.
 
-*   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.
+    Fixes #28723.
 
-        # app/models/concerns/authentication.rb
-        concern :Authentication do
-          included do
-            after_create :generate_private_key
-          end
+    *Andrew White*
 
-          class_methods do
-            def authenticate(credentials)
-              # ...
-            end
-          end
+*   Add `fetch_values` for `HashWithIndifferentAccess`.
 
-          def generate_private_key
-            # ...
-          end
-        end
+    The method was originally added to `Hash` in Ruby 2.3.0.
 
-        # app/models/user.rb
-        class User < ActiveRecord::Base
-          include Authentication
-        end
+    *Josh Pencheon*
 
-    *Jeremy Kemper*
 
-Please check [4-1-stable](https://github.com/rails/rails/blob/4-1-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [5-1-stable](https://github.com/rails/rails/blob/5-1-stable/activesupport/CHANGELOG.md) for previous changes.