activesupport 5.2.7.1 → 6.0.0.beta1

data/CHANGELOG.md

@@ -1,143 +1,27 @@
-## Rails 5.2.7.1 (April 26, 2022) ##
+## Rails 6.0.0.beta1 (January 18, 2019) ##
 
-*   Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
+*   Remove deprecated `Module#reachable?` method.
 
-    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.
-
-    *Álvaro Martín Fraguas*
-
-
-## Rails 5.2.7 (March 10, 2022) ##
-
-*   Restore support to Ruby 2.2.
-
-    *ojab*
-
-
-## Rails 5.2.6.3 (March 08, 2022) ##
-
-*   No changes.
-
-
-## Rails 5.2.6.2 (February 11, 2022) ##
-
-*   Fix Reloader method signature to work with the new Executor signature
-
-
-## Rails 5.2.6.1 (February 11, 2022) ##
-
-*   No changes.
-
-
-## Rails 5.2.6 (May 05, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.5 (March 26, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.6 (May 05, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.5 (February 10, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.4 (September 09, 2020) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.3 (May 18, 2020) ##
-
-*   [CVE-2020-8165] Deprecate Marshal.load on raw cache read in RedisCacheStore
-
-*   [CVE-2020-8165] Avoid Marshal.load on raw cache value in MemCacheStore
-
-## Rails 5.2.4.2 (March 19, 2020) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.1 (December 18, 2019) ##
-
-*   No changes.
-
-
-## Rails 5.2.4 (November 27, 2019) ##
-
-*   Make ActiveSupport::Logger Fiber-safe. Fixes #36752.
-
-    Use `Fiber.current.__id__` in `ActiveSupport::Logger#local_level=` in order
-    to make log level local to Ruby Fibers in addition to Threads.
-
-    Example:
-
-        logger = ActiveSupport::Logger.new(STDOUT)
-        logger.level = 1
-        p "Main is debug? #{logger.debug?}"
-
-        Fiber.new {
-          logger.local_level = 0
-          p "Thread is debug? #{logger.debug?}"
-        }.resume
-
-        p "Main is debug? #{logger.debug?}"
-
-    Before:
-
-        Main is debug? false
-        Thread is debug? true
-        Main is debug? true
-
-    After:
-
-        Main is debug? false
-        Thread is debug? true
-        Main is debug? false
-
-    *Alexander Varnin*
-
-
-## Rails 5.2.3 (March 27, 2019) ##
-
-*   Add `ActiveSupport::HashWithIndifferentAccess#assoc`.
+    *Rafael Mendonça França*
 
-    `assoc` can now be called with either a string or a symbol.
+*   Remove deprecated `#acronym_regex` method from `Inflections`.
 
-    *Stefan Schüßler*
+    *Rafael Mendonça França*
 
 *   Fix `String#safe_constantize` throwing a `LoadError` for incorrectly cased constant references.
 
     *Keenan Brock*
 
-*   Allow Range#=== and Range#cover? on Range
+*   Preserve key order passed to `ActiveSupport::CacheStore#fetch_multi`.
 
-    `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.
+    `fetch_multi(*names)` now returns its results in the same order as the `*names` requested, rather than returning cache hits followed by cache misses.
 
-    *utilum*
+    *Gannon McGibbon*
 
 *   If the same block is `included` multiple times for a Concern, an exception is no longer raised.
 
     *Mark J. Titorenko*, *Vlad Bokov*
 
-
-## Rails 5.2.2.1 (March 11, 2019) ##
-
-*   No changes.
-
-
-## Rails 5.2.2 (December 04, 2018) ##
-
 *   Fix bug where `#to_options` for `ActiveSupport::HashWithIndifferentAccess`
     would not act as alias for `#symbolize_keys`.
 
@@ -147,564 +31,286 @@
 
     *Jan Habermann*, *Xavier Noria*
 
-*   Fix bug where `URI.unescape` would fail with mixed Unicode/escaped character input:
-
-        URI.unescape("\xe3\x83\x90")  # => "バ"
-        URI.unescape("%E3%83%90")  # => "バ"
-        URI.unescape("\xe3\x83\x90%E3%83%90")  # => Encoding::CompatibilityError
-
-    *Ashe Connor*, *Aaron Patterson*
-
-
-## Rails 5.2.1.1 (November 27, 2018) ##
-
-*   No changes.
-
-
-## Rails 5.2.1 (August 07, 2018) ##
-
-*   Redis cache store: `delete_matched` no longer blocks the Redis server.
-    (Switches from evaled Lua to a batched SCAN + DEL loop.)
-
-    *Gleb Mazovetskiy*
-
-*   Fix bug where `ActiveSupport::Timezone.all` would fail when tzinfo data for
-    any timezone defined in `ActiveSupport::TimeZone::MAPPING` is missing.
-
-    *Dominik Sander*
-
-*   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.
-
-    *Godfrey Chan*
-
-*   Fix `ActiveSupport::Cache#read_multi` bug with local cache enabled that was
-    returning instances of `ActiveSupport::Cache::Entry` instead of the raw values.
-
-    *Jason Lee*
-
-
-## Rails 5.2.0 (April 09, 2018) ##
-
-*   Caching: MemCache and Redis `read_multi` and `fetch_multi` speedup.
-    Read from the local in-memory cache before consulting the backend.
-
-    *Gabriel Sobrinho*
-
-*   Return all mappings for a timezone identifier in `country_zones`.
-
-    Some timezones like `Europe/London` have multiple mappings in
-    `ActiveSupport::TimeZone::MAPPING` so return all of them instead
-    of the first one found by using `Hash#value`. e.g:
-
-        # Before
-        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh"]
-
-        # After
-        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh", "London"]
-
-    Fixes #31668.
-
-    *Andrew White*
-
-*   Add support for connection pooling on RedisCacheStore.
-
-    *fatkodima*
-
-*   Support hash as first argument in `assert_difference`. This allows to specify multiple
-    numeric differences in the same assertion.
-
-        assert_difference ->{ Article.count } => 1, ->{ Post.count } => 2
-
-    *Julien Meichelbeck*
-
-*   Add missing instrumentation for `read_multi` in `ActiveSupport::Cache::Store`.
+*   Deprecate `ActiveSupport::Multibyte::Unicode#pack_graphemes(array)` and `ActiveSuppport::Multibyte::Unicode#unpack_graphemes(string)`
+    in favor of `array.flatten.pack("U*")` and `string.scan(/\X/).map(&:codepoints)`, respectively.
 
-    *Ignatius Reza Lesmana*
+    *Francesco Rodríguez*
 
-*   `assert_changes` will always assert that the expression changes,
-    regardless of `from:` and `to:` argument combinations.
+*   Deprecate `ActiveSupport::Multibyte::Chars.consumes?` in favor of `String#is_utf8?`.
 
-    *Daniel Ma*
-
-*   Use SHA-1 to generate non-sensitive digests, such as the ETag header.
-
-    Enabled by default for new apps; upgrading apps can opt in by setting
-    `config.active_support.use_sha1_digests = true`.
-
-    *Dmitri Dolguikh*, *Eugene Kenny*
-
-*   Changed default behaviour of `ActiveSupport::SecurityUtils.secure_compare`,
-    to make it not leak length information even for variable length string.
-
-    Renamed old `ActiveSupport::SecurityUtils.secure_compare` to `fixed_length_secure_compare`,
-    and started raising `ArgumentError` in case of length mismatch of passed strings.
-
-    *Vipul A M*
-
-*   Make `ActiveSupport::TimeZone.all` return only time zones that are in
-    `ActiveSupport::TimeZone::MAPPING`.
-
-    Fixes #7245.
-
-    *Chris LaRose*
-
-*   MemCacheStore: Support expiring counters.
-
-    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.
-
-    ```
-    Rails.cache.increment("my_counter", 1, expires_in: 2.minutes)
-    ```
-
-    *Takumasa Ochi*
-
-*   Handle `TZInfo::AmbiguousTime` errors.
-
-    Make `ActiveSupport::TimeWithZone` match Ruby's handling of ambiguous
-    times by choosing the later period, e.g.
-
-    Ruby:
-    ```
-    ENV["TZ"] = "Europe/Moscow"
-    Time.local(2014, 10, 26, 1, 0, 0)   # => 2014-10-26 01:00:00 +0300
-    ```
-
-    Before:
-    ```
-    >> "2014-10-26 01:00:00".in_time_zone("Moscow")
-    TZInfo::AmbiguousTime: 26/10/2014 01:00 is an ambiguous local time.
-    ```
-
-    After:
-    ```
-    >> "2014-10-26 01:00:00".in_time_zone("Moscow")
-    => Sun, 26 Oct 2014 01:00:00 MSK +03:00
-    ```
-
-    Fixes #17395.
-
-    *Andrew White*
-
-*   Redis cache store.
+    *Francesco Rodríguez*
 
+*   Fix duration being rounded to a full second.
     ```
-    # Defaults to `redis://localhost:6379/0`. Only use for dev/test.
-    config.cache_store = :redis_cache_store
-
-    # 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"
-
-    # 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
-      ]
-
-    # Or pass a builder block
-    config.cache_store = :redis_cache_store,
-      namespace: 'myapp-cache', compress: true,
-      redis: -> { Redis.new … }
+      time = DateTime.parse("2018-1-1")
+      time += 0.51.seconds
     ```
+    Will now correctly add 0.51 second and not 1 full second.
 
-    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.
-
-    Redis cache server setup guide: https://redis.io/topics/lru-cache
+    *Edouard Chin*
 
-    *Jeremy Daer*
+*   Deprecate `ActiveSupport::Multibyte::Unicode#normalize` and `ActiveSuppport::Multibyte::Chars#normalize`
+    in favor of `String#unicode_normalize`
 
-*   Cache: Enable compression by default for values > 1kB.
+    *Francesco Rodríguez*
 
-    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.
+*   Deprecate `ActiveSupport::Multibyte::Unicode#downcase/upcase/swapcase` in favor of
+    `String#downcase/upcase/swapcase`.
 
-    To disable compression, pass `compress: false` to the initializer.
+    *Francesco Rodríguez*
 
-    *Jeremy Daer*
+*   Add `ActiveSupport::ParameterFilter`.
 
-*   Allow `Range#include?` on TWZ ranges.
+    *Yoshiyuki Kinjo*
 
-    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?`.
+*   Rename `Module#parent`, `Module#parents`, and `Module#parent_name` to
+    `module_parent`, `module_parents`, and `module_parent_name`.
 
-    Fixes #30799.
+    *Gannon McGibbon*
 
-    *Andrew White*
+*   Deprecate the use of `LoggerSilence` in favor of `ActiveSupport::LoggerSilence`
 
-*   Fix acronym support in `humanize`.
+    *Edouard Chin*
 
-    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.
+*   Deprecate using negative limits in `String#first` and `String#last`.
 
-    Fixes #31052.
+    *Gannon McGibbon*, *Eric Turner*
 
-    *Andrew White*
+*   Fix bug where `#without` for `ActiveSupport::HashWithIndifferentAccess` would fail
+    with symbol arguments
 
-*   Add same method signature for `Time#prev_year` and `Time#next_year`
-    in accordance with `Date#prev_year`, `Date#next_year`.
-
-    Allows pass argument for `Time#prev_year` and `Time#next_year`.
-
-    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)
+    *Abraham Chan*
 
-    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)
-    ```
+*   Treat `#delete_prefix`, `#delete_suffix` and `#unicode_normalize` results as non-`html_safe`.
+    Ensure safety of arguments for `#insert`, `#[]=` and `#replace` calls on `html_safe` Strings.
 
-    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
+    *Janosch Müller*
 
-    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
-    ```
+*   Changed `ActiveSupport::TaggedLogging.new` to return a new logger instance instead
+    of mutating the one received as parameter.
 
-    *bogdanvlviv*
+    *Thierry Joyal*
 
-*   Add same method signature for `Time#prev_month` and `Time#next_month`
-    in accordance with `Date#prev_month`, `Date#next_month`.
+*   Define `unfreeze_time` as an alias of `travel_back` in `ActiveSupport::Testing::TimeHelpers`.
 
-    Allows pass argument for `Time#prev_month` and `Time#next_month`.
+    The alias is provided for symmetry with `freeze_time`.
 
-    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)
+    *Ryan Davidson*
 
-    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)
-    ```
+*   Add support for tracing constant autoloads. Just throw
 
-    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
+        ActiveSupport::Dependencies.logger = Rails.logger
+        ActiveSupport::Dependencies.verbose = true
 
-    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
-    ```
+    in an initializer.
 
-    *bogdanvlviv*
+    *Xavier Noria*
 
-*   Add same method signature for `Time#prev_day` and `Time#next_day`
-    in accordance with `Date#prev_day`, `Date#next_day`.
+*   Maintain `html_safe?` on html_safe strings when sliced.
 
-    Allows pass argument for `Time#prev_day` and `Time#next_day`.
+        string = "<div>test</div>".html_safe
+        string[-1..1].html_safe? # => true
 
-    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)
+    *Elom Gomez*, *Yumin Wong*
 
-    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)
-    ```
+*   Add `Array#extract!`.
 
-    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
+    The method removes and returns the elements for which the block returns a true value.
+    If no block is given, an Enumerator is returned instead.
 
-    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
-    ```
+        numbers = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+        odd_numbers = numbers.extract! { |number| number.odd? } # => [1, 3, 5, 7, 9]
+        numbers # => [0, 2, 4, 6, 8]
 
     *bogdanvlviv*
 
-*   `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 #26132.
-
-    *Paul Kuruvilla*
-
-*   Remove deprecated `halt_callback_chains_on_return_false` option.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated `:if` and `:unless` string filter for callbacks.
-
-    *Rafael Mendonça França*
-
-*   `Hash#slice` now falls back to Ruby 2.5+'s built-in definition if defined.
-
-    *Akira Matsuda*
-
-*   Deprecate `secrets.secret_token`.
-
-    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`.
-
-    `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`.
-
-    *claudiob*, *Kasper Timm Hansen*
-
-*   Return an instance of `HashWithIndifferentAccess` from `HashWithIndifferentAccess#transform_keys`.
+*   Support not to cache `nil` for `ActiveSupport::Cache#fetch`.
 
-    *Yuji Yaginuma*
+        cache.fetch('bar', skip_nil: true) { nil }
+        cache.exist?('bar') # => false
 
-*   Add key rotation support to `MessageEncryptor` and `MessageVerifier`.
+    *Martin Hong*
 
-    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.
+*   Add "event object" support to the notification system.
+    Before this change, end users were forced to create hand made artisanal
+    event objects on their own, like this:
 
-    *Michael J Coyne*
+        ActiveSupport::Notifications.subscribe('wait') do |*args|
+          @event = ActiveSupport::Notifications::Event.new(*args)
+        end
 
-*   Deprecate `Module#reachable?` method.
+        ActiveSupport::Notifications.instrument('wait') do
+          sleep 1
+        end
 
-    *bogdanvlviv*
-
-*   Add `config/credentials.yml.enc` to store production app secrets.
-
-    Allows saving any authentication credentials for third party services
-    directly in repo encrypted with `config/master.key` or `ENV["RAILS_MASTER_KEY"]`.
-
-    This will eventually replace `Rails.application.secrets` and the encrypted
-    secrets introduced in Rails 5.1.
+        @event.duration # => 1000.138
 
-    *DHH*, *Kasper Timm Hansen*
+    After this change, if the block passed to `subscribe` only takes one
+    parameter, the framework will yield an event object to the block.  Now
+    end users are no longer required to make their own:
 
-*   Add `ActiveSupport::EncryptedFile` and `ActiveSupport::EncryptedConfiguration`.
+        ActiveSupport::Notifications.subscribe('wait') do |event|
+          @event = event
+        end
 
-    Allows for stashing encrypted files or configuration directly in repo by
-    encrypting it with a key.
+        ActiveSupport::Notifications.instrument('wait') do
+          sleep 1
+        end
 
-    Backs the new credentials setup above, but can also be used independently.
+        p @event.allocations # => 7
+        p @event.cpu_time    # => 0.256
+        p @event.idle_time   # => 1003.2399
 
-    *DHH*, *Kasper Timm Hansen*
+    Now you can enjoy event objects without making them yourself.  Neat!
 
-*   `Module#delegate_missing_to` now raises `DelegationError` if target is nil,
-    similar to `Module#delegate`.
+    *Aaron "t.lo" Patterson*
 
-    *Anton Khamets*
+*   Add cpu_time, idle_time, and allocations to Event.
 
-*   Update `String#camelize` to provide feedback when wrong option is passed.
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-    `String#camelize` was returning nil without any feedback when an
-    invalid option was passed as a parameter.
+*   RedisCacheStore: support key expiry in increment/decrement.
 
-    Previously:
+    Pass `:expires_in` to `#increment` and `#decrement` to set a Redis EXPIRE on the key.
 
-        'one_two'.camelize(true)
-        # => nil
+    If the key is already set to expire, RedisCacheStore won't extend its expiry.
 
-    Now:
+        Rails.cache.increment("some_key", 1, expires_in: 2.minutes)
 
-        'one_two'.camelize(true)
-        # => ArgumentError: Invalid option, use either :upper or :lower.
+    *Jason Lee*
 
-    *Ricardo Díaz*
+*   Allow `Range#===` and `Range#cover?` on Range.
 
-*   Fix modulo operations involving durations.
+    `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.
 
-    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.
+    *Requiring active_support/core_ext/range/include_range is now deprecated.*
+    *Use `require "active_support/core_ext/range/compare_range"` instead.*
 
-    Prior to Rails 5.1:
+    *utilum*
 
-        5.minutes % 2.minutes
-        # => 60
+*   Add `index_with` to Enumerable.
 
-    Now:
+    Allows creating a hash from an enumerable with the value from a passed block
+    or a default argument.
 
-        5.minutes % 2.minutes
-        # => 1 minute
+        %i( title body ).index_with { |attr| post.public_send(attr) }
+        # => { title: "hey", body: "what's up?" }
 
-    Fixes #29603 and #29743.
+        %i( title body ).index_with(nil)
+        # => { title: nil, body: nil }
 
-    *Sayan Chakraborty*, *Andrew White*
+    Closely linked with `index_by`, which creates a hash where the keys are extracted from a block.
 
-*   Fix division where a duration is the denominator.
+    *Kasper Timm Hansen*
 
-    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.
+*   Fix bug where `ActiveSupport::Timezone.all` would fail when tzinfo data for
+    any timezone defined in `ActiveSupport::TimeZone::MAPPING` is missing.
 
-    Fixes #29592.
+    *Dominik Sander*
 
-    *Andrew White*
+*   Redis cache store: `delete_matched` no longer blocks the Redis server.
+    (Switches from evaled Lua to a batched SCAN + DEL loop.)
 
-*   Add purpose and expiry support to `ActiveSupport::MessageVerifier` and
-   `ActiveSupport::MessageEncryptor`.
+    *Gleb Mazovetskiy*
 
-    For instance, to ensure a message is only usable for one intended purpose:
+*   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.
 
-        token = @verifier.generate("x", purpose: :shipping)
+    *Godfrey Chan*
 
-        @verifier.verified(token, purpose: :shipping) # => "x"
-        @verifier.verified(token)                     # => nil
+*   Fix bug where `URI.unescape` would fail with mixed Unicode/escaped character input:
 
-    Or make it expire after a set time:
+        URI.unescape("\xe3\x83\x90")  # => "バ"
+        URI.unescape("%E3%83%90")  # => "バ"
+        URI.unescape("\xe3\x83\x90%E3%83%90")  # => Encoding::CompatibilityError
 
-        @verifier.generate("x", expires_in: 1.month)
-        @verifier.generate("y", expires_at: Time.now.end_of_year)
+    *Ashe Connor*, *Aaron Patterson*
 
-    Showcased with `ActiveSupport::MessageVerifier`, but works the same for
-    `ActiveSupport::MessageEncryptor`'s `encrypt_and_sign` and `decrypt_and_verify`.
+*   Add `before?` and `after?` methods to `Date`, `DateTime`,
+    `Time`, and `TimeWithZone`.
 
-    Pull requests: #29599, #29854
+    *Nick Holden*
 
-    *Assain Jaleel*
+*   `ActiveSupport::Inflector#ordinal` and `ActiveSupport::Inflector#ordinalize` now support
+    translations through I18n.
 
-*   Make the order of `Hash#reverse_merge!` consistent with `HashWithIndifferentAccess`.
+        # locale/fr.rb
 
-    *Erol Fornoles*
+        {
+          fr: {
+            number: {
+              nth: {
+                ordinals: lambda do |_key, number:, **_options|
+                  if number.to_i.abs == 1
+                    'er'
+                  else
+                    'e'
+                  end
+                end,
 
-*   Add `freeze_time` helper which freezes time to `Time.now` in tests.
+                ordinalized: lambda do |_key, number:, **_options|
+                  "#{number}#{ActiveSupport::Inflector.ordinal(number)}"
+                end
+              }
+            }
+          }
+        }
 
-    *Prathamesh Sonpatki*
 
-*   Default `ActiveSupport::MessageEncryptor` to use AES 256 GCM encryption.
+    *Christian Blais*
 
-    On for new Rails 5.2 apps. Upgrading apps can find the config as a new
-    framework default.
+*   Add `:private` option to ActiveSupport's `Module#delegate`
+    in order to delegate methods as private:
 
-    *Assain Jaleel*
+        class User < ActiveRecord::Base
+          has_one :profile
+          delegate :date_of_birth, to: :profile, private: true
 
-*   Cache: `write_multi`.
+          def age
+            Date.today.year - date_of_birth.year
+          end
+        end
 
-        Rails.cache.write_multi foo: 'bar', baz: 'qux'
+        # User.new.age  # => 29
+        # User.new.date_of_birth
+        # => NoMethodError: private method `date_of_birth' called for #<User:0x00000008221340>
 
-    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.
+    *Tomas Valent*
 
-    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`.
+*   `String#truncate_bytes` to truncate a string to a maximum bytesize without
+    breaking multibyte characters or grapheme clusters like 👩‍👩‍👦‍👦.
 
     *Jeremy Daer*
 
-*   Add default option to module and class attribute accessors.
-
-        mattr_accessor :settings, default: {}
-
-    Works for `mattr_reader`, `mattr_writer`, `cattr_accessor`, `cattr_reader`,
-    and `cattr_writer` as well.
-
-    *Genadi Samokovarov*
-
-*   Add `Date#prev_occurring` and `Date#next_occurring` to return specified next/previous occurring day of week.
-
-    *Shota Iguchi*
-
-*   Add default option to `class_attribute`.
-
-    Before:
-
-        class_attribute :settings
-        self.settings = {}
-
-    Now:
-
-        class_attribute :settings, default: {}
+*   `String#strip_heredoc` preserves frozenness.
 
-    *DHH*
+        "foo".freeze.strip_heredoc.frozen?  # => true
 
-*   `#singularize` and `#pluralize` now respect uncountables for the specified locale.
+    Fixes that frozen string literals would inadvertently become unfrozen:
 
-    *Eilis Hamilton*
+        # frozen_string_literal: true
 
-*   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.
+        foo = <<-MSG.strip_heredoc
+          la la la
+        MSG
 
-    *DHH*
+        foo.frozen?  # => false !??
 
-*   Fix implicit coercion calculations with scalars and durations.
-
-    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:
-
-        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
-
-    Now, the `ActiveSupport::Duration::Scalar` calculation methods will try to maintain
-    the part structure of the duration where possible, e.g:
-
-        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
-
-    Fixes #29160, #28970.
-
-    *Andrew White*
-
-*   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.
-
-    *DHH*
-
-*   Pass gem name and deprecation horizon to deprecation notifications.
-
-    *Willem van Bergen*
-
-*   Add support for `:offset` and `:zone` to `ActiveSupport::TimeWithZone#change`.
-
-    *Andrew White*
-
-*   Add support for `:offset` to `Time#change`.
+    *Jeremy Daer*
 
-    Fixes #28723.
+*   Rails 6 requires Ruby 2.5.0 or newer.
 
-    *Andrew White*
+    *Jeremy Daer*, *Kasper Timm Hansen*
 
-*   Add `fetch_values` for `HashWithIndifferentAccess`.
+*   Adds parallel testing to Rails.
 
-    The method was originally added to `Hash` in Ruby 2.3.0.
+    Parallelize your test suite with forked processes or threads.
 
-    *Josh Pencheon*
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
 
-Please check [5-1-stable](https://github.com/rails/rails/blob/5-1-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [5-2-stable](https://github.com/rails/rails/blob/5-2-stable/activesupport/CHANGELOG.md) for previous changes.