activesupport 5.1.1 → 6.1.1

data/CHANGELOG.md

@@ -1,653 +1,571 @@
-## Rails 5.1.0 (April 27, 2017) ##
+## Rails 6.1.1 (January 07, 2021) ##
 
-*   `ActiveSupport::EventedFileUpdateChecker` no longer listens to
-    directories outside of the application directory.
+*   Change `IPAddr#to_json` to match the behavior of the json gem returning the string representation
+    instead of the instance variables of the object.
 
-    *radiospiel*
+    Before:
 
-*   Return unmapped timezones from `country_zones`
+    ```ruby
+    IPAddr.new("127.0.0.1").to_json
+    # => "{\"addr\":2130706433,\"family\":2,\"mask_addr\":4294967295}"
+    ```
 
-    If a country doesn't exist in the MAPPINGS hash then create a new
-    `ActiveSupport::Timezone` instance using the supplied timezone id.
+    After:
 
-    Fixes #28431.
+    ```ruby
+    IPAddr.new("127.0.0.1").to_json
+    # => "\"127.0.0.1\""
+    ```
 
-    *Andrew White*
 
-*   Add ActiveSupport::Deprecation::DeprecatedConstantAccessor
+## Rails 6.1.0 (December 09, 2020) ##
 
-    Provides transparent deprecation of constants, compatible with exceptions.
-    Example usage:
+*   Ensure `MemoryStore` disables compression by default. Reverts behavior of
+    `MemoryStore` to its prior rails `5.1` behavior.
 
-        module Example
-          include ActiveSupport::Deprecation::DeprecatedConstantAccessor
-          deprecate_constant 'OldException', 'Elsewhere::NewException'
-        end
+    *Max Gurewitz*
 
-    *Dominic Cleal*
+*   Calling `iso8601` on negative durations retains the negative sign on individual
+    digits instead of prepending it.
 
-*   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`.
+    This change is required so we can interoperate with PostgreSQL, which prefers
+    negative signs for each component.
 
-    *Kevin McPhillips* & *Andrew White*
+    Compatibility with other iso8601 parsers which support leading negatives as well
+    as negatives per component is still retained.
 
-*   Remove implicit coercion deprecation of durations
+    Before:
 
-    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:
+        (-1.year - 1.day).iso8601
+        # => "-P1Y1D"
 
-        redis.expire("foo", 5.minutes)
+    After:
 
-    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.
+        (-1.year - 1.day).iso8601
+        # => "P-1Y-1D"
 
-    *Andrew White*
+    *Vipul A M*
 
-*   Update `titleize` regex to allow apostrophes
+*   Remove deprecated `ActiveSupport::Notifications::Instrumenter#end=`.
 
-    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:
+    *Rafael Mendonça França*
 
-        >> "This was 'fake news'".titleize
-        => "This Was 'fake News'"
+*   Deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
 
-    This is fixed by extending the look-behind to also check for a word
-    character on the other side of the apostrophe.
+    *Rafael Mendonça França*
 
-    Fixes #28312.
+*   Remove deprecated `ActiveSupport::Multibyte::Unicode.pack_graphemes`,
+    `ActiveSupport::Multibyte::Unicode.unpack_graphemes`,
+    `ActiveSupport::Multibyte::Unicode.normalize`,
+    `ActiveSupport::Multibyte::Unicode.downcase`,
+    `ActiveSupport::Multibyte::Unicode.upcase` and `ActiveSupport::Multibyte::Unicode.swapcase`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `rfc3339` aliases to `xmlschema` for `Time` and `ActiveSupport::TimeWithZone`
+*   Remove deprecated `ActiveSupport::Multibyte::Chars#consumes?` and `ActiveSupport::Multibyte::Chars#normalize`.
 
-    For naming consistency when using the RFC 3339 profile of ISO 8601 in applications.
+    *Rafael Mendonça França*
 
-    *Andrew White*
+*   Remove deprecated file `active_support/core_ext/range/include_range`.
 
-*   Add `Time.rfc3339` parsing method
+    *Rafael Mendonça França*
 
-    `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.
+*   Remove deprecated file `active_support/core_ext/hash/transform_values`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `ActiveSupport::TimeZone.rfc3339` parsing method
+*   Remove deprecated file `active_support/core_ext/hash/compact`.
 
-    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:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("1999-12-31T14:00:00Z")
-        => Fri, 31 Dec 1999 14:00:00 HST -10:00
+*   Remove deprecated file `active_support/core_ext/array/prepend_and_append`.
 
-    This new method has stricter semantics than the current `parse` method,
-    and will raise an `ArgumentError` instead of returning nil, e.g:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("foobar")
-        ArgumentError: invalid date
-        >> Time.zone.parse("foobar")
-        => nil
+*   Remove deprecated file `active_support/core_ext/numeric/inquiry`.
 
-    It will also raise an `ArgumentError` when either the time or offset
-    components are missing, e.g:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("1999-12-31")
-        ArgumentError: invalid date
-        >> Time.zone.rfc3339("1999-12-31T14:00:00")
-        ArgumentError: invalid date
+*   Remove deprecated file `active_support/core_ext/module/reachable`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `ActiveSupport::TimeZone.iso8601` parsing method
+*   Remove deprecated `Module#parent_name`, `Module#parent` and `Module#parents`.
 
-    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:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("1999-12-31T14:00:00Z")
-        => Fri, 31 Dec 1999 14:00:00 HST -10:00
+*   Remove deprecated `ActiveSupport::LoggerThreadSafeLevel#after_initialize`.
 
-    If the timestamp is a ISO 8601 date (YYYY-MM-DD), then the time is set
-    to midnight, e.g:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("1999-12-31")
-        => Fri, 31 Dec 1999 00:00:00 HST -10:00
+*   Remove deprecated `LoggerSilence` constant.
 
-    This new method has stricter semantics than the current `parse` method,
-    and will raise an `ArgumentError` instead of returning nil, e.g:
+    *Rafael Mendonça França*
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("foobar")
-        ArgumentError: invalid date
-        >> Time.zone.parse("foobar")
-        => nil
+*   Remove deprecated fallback to `I18n.default_local` when `config.i18n.fallbacks` is empty.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Deprecate implicit coercion of `ActiveSupport::Duration`
+*   Remove entries from local cache on `RedisCacheStore#delete_matched`
 
-    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:
+    Fixes #38627
 
-        >> 2 * 1.day
-        => 172800
+    *ojab*
 
-    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:
+*   Speed up `ActiveSupport::SecurityUtils.fixed_length_secure_compare` by using
+    `OpenSSL.fixed_length_secure_compare`, if available.
 
-        >> Date.today
-        => Wed, 01 Mar 2017
-        >> Date.today + 2 * 1.day
-        => Mon, 10 Apr 2490
+    *Nate Matykiewicz*
 
-    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:
+*   `ActiveSupport::Cache::MemCacheStore` now checks `ENV["MEMCACHE_SERVERS"]` before falling back to `"localhost:11211"` if configured without any addresses.
 
-        >> 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
+    ```ruby
+    config.cache_store = :mem_cache_store
 
-    In Rails 5.2 it will raise `TypeError`, e.g:
+    # is now equivalent to
 
-        >> 2 * 1.day
-        TypeError: ActiveSupport::Duration can't be coerced into Integer
+    config.cache_store = :mem_cache_store, ENV["MEMCACHE_SERVERS"] || "localhost:11211"
 
-    This is the same behavior as with other types in Ruby, e.g:
+    # instead of
 
-        >> 2 * "foo"
-        TypeError: String can't be coerced into Integer
-        >> "foo" * 2
-        => "foofoo"
+    config.cache_store = :mem_cache_store, "localhost:11211" # ignores ENV["MEMCACHE_SERVERS"]
+    ```
 
-    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:
+    *Sam Bostock*
 
-        >> Date.today
-        => Wed, 01 Mar 2017
-        >> Date.today + 1.day * 2
-        => Fri, 03 Mar 2017
+*   `ActiveSupport::Subscriber#attach_to` now accepts an `inherit_all:` argument. When set to true,
+    it allows a subscriber to receive events for methods defined in the subscriber's ancestor class(es).
 
-    Fixes #27457.
+    ```ruby
+    class ActionControllerSubscriber < ActiveSupport::Subscriber
+      attach_to :action_controller
 
-    *Andrew White*
+      def start_processing(event)
+        info "Processing by #{event.payload[:controller]}##{event.payload[:action]} as #{format}"
+      end
 
-*   Update `DateTime#change` to support `:usec` and `:nsec` options.
+      def redirect_to(event)
+        info { "Redirected to #{event.payload[:location]}" }
+      end
+    end
 
-    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:
+    # We detach ActionControllerSubscriber from the :action_controller namespace so that our CustomActionControllerSubscriber
+    # can provide its own instrumentation for certain events in the namespace
+    ActionControllerSubscriber.detach_from(:action_controller)
 
-        datetime = DateTime.now.end_of_day
-        datetime.nsec == 999999999 # => true
+    class CustomActionControllerSubscriber < ActionControllerSubscriber
+      attach_to :action_controller, inherit_all: true
 
-    Fixes #21424.
+      def start_processing(event)
+        info "A custom response to start_processing events"
+      end
 
-    *Dan Moore*, *Andrew White*
+      # => CustomActionControllerSubscriber will process events for "start_processing.action_controller" notifications
+      # using its own #start_processing implementation, while retaining ActionControllerSubscriber's instrumentation
+      # for "redirect_to.action_controller" notifications
+    end
+    ```
 
-*   Add `ActiveSupport::Duration#before` and `#after` as aliases for `#until` and `#since`
+    *Adrianna Chang*
 
-    These read more like English and require less mental gymnastics to read and write.
+*   Allow the digest class used to generate non-sensitive digests to be configured with `config.active_support.hash_digest_class`.
 
-    Before:
+    `config.active_support.use_sha1_digests` is deprecated in favour of `config.active_support.hash_digest_class = ::Digest::SHA1`.
 
-        2.weeks.since(customer_start_date)
-        5.days.until(today)
+    *Dirkjan Bussink*
 
-    After:
+*   Fix bug to make memcached write_entry expire correctly with unless_exist
 
-        2.weeks.after(customer_start_date)
-        5.days.before(today)
+    *Jye Lee*
 
-    *Nick Johnstone*
+*   Add `ActiveSupport::Duration` conversion methods
 
-*   Soft-deprecated the top-level `HashWithIndifferentAccess` constant.
-    `ActiveSupport::HashWithIndifferentAccess` should be used instead.
+    `in_seconds`, `in_minutes`, `in_hours`, `in_days`, `in_weeks`, `in_months`, and `in_years` return the respective duration covered.
 
-    Fixes #28157.
+    *Jason York*
 
-    *Robin Dupret*
+*   Fixed issue in `ActiveSupport::Cache::RedisCacheStore` not passing options
+    to `read_multi` causing `fetch_multi` to not work properly
 
-*   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.
+    *Rajesh Sharma*
 
-    *Jeff Latz*
+*   Fixed issue in `ActiveSupport::Cache::MemCacheStore` which caused duplicate compression,
+    and caused the provided `compression_threshold` to not be respected.
 
-*   `ActiveSupport::Gzip.decompress` now checks checksum and length in footer.
+    *Max Gurewitz*
 
-    *Dylan Thacker-Smith*
+*   Prevent `RedisCacheStore` and `MemCacheStore` from performing compression
+    when reading entries written with `raw: true`.
 
-*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
+    *Max Gurewitz*
 
-    *Adam Rice*
+*   `URI.parser` is deprecated and will be removed in Rails 6.2. Use
+    `URI::DEFAULT_PARSER` instead.
 
-*   Deprecate `ActiveSupport.halt_callback_chains_on_return_false`.
+    *Jean Boussier*
 
-    *Rafael Mendonça França*
-
-*   Remove deprecated behavior that halts callbacks when the return is false.
+*   `require_dependency` has been documented to be _obsolete_ in `:zeitwerk`
+    mode. The method is not deprecated as such (yet), but applications are
+    encouraged to not use it.
 
-    *Rafael Mendonça França*
+    In `:zeitwerk` mode, semantics match Ruby's and you do not need to be
+    defensive with load order. Just refer to classes and modules normally. If
+    the constant name is dynamic, camelize if needed, and constantize.
 
-*   Deprecate passing string to `:if` and `:unless` conditional options
-    on `set_callback` and `skip_callback`.
+    *Xavier Noria*
 
-    *Ryuta Kamizono*
+*   Add 3rd person aliases of `Symbol#start_with?` and `Symbol#end_with?`.
 
-*   Raise `ArgumentError` when passing string to define callback.
+    ```ruby
+    :foo.starts_with?("f") # => true
+    :foo.ends_with?("o")   # => true
+    ```
 
     *Ryuta Kamizono*
 
-*   Updated Unicode version to 9.0.0
-
-    Now we can handle new emojis such like "👩‍👩‍👧‍👦" ("\u{1F469}\u{200D}\u{1F469}\u{200D}\u{1F467}\u{200D}\u{1F466}").
-
-    version 8.0.0
-
-        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 4
-        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👦👧‍👩‍👩‍"
-
-    version 9.0.0
-
-        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 1
-        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👩‍👩‍👧‍👦"
-
-    *Fumiaki MATSUSHIMA*
+*   Add override of unary plus for `ActiveSupport::Duration`.
 
-*   Changed `ActiveSupport::Inflector#transliterate` to raise `ArgumentError` when it receives
-    anything except a string.
+    `+ 1.second` is now identical to `+1.second` to prevent errors
+    where a seemingly innocent change of formatting leads to a change in the code behavior.
 
-    *Kevin McPhillips*
-
-*   Fixed bugs that `StringInquirer#respond_to_missing?` and
-    `ArrayInquirer#respond_to_missing?` do not fallback to `super`.
-
-    *Akira Matsuda*
-
-*   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.
-
-    Changed duration of months and years in seconds to more accurate and logical:
-
-     1. The value of 365.2425 days in Gregorian year is more accurate
-        as it accounts for every 400th non-leap year.
+    Before:
+    ```ruby
+    +1.second.class
+    # => ActiveSupport::Duration
+    (+ 1.second).class
+    # => Integer
+    ```
 
-     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`.
+    After:
+    ```ruby
+    +1.second.class
+    # => ActiveSupport::Duration
+    (+ 1.second).class
+    # => ActiveSupport::Duration
+    ```
 
-    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.
+    Fixes #39079.
 
-    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.
+    *Roman Kushnir*
 
-    *Andrey Novikov*, *Andrew White*
+*   Add subsec to `ActiveSupport::TimeWithZone#inspect`.
 
-*   Change return value of `Rational#duplicable?`, `ComplexClass#duplicable?`
-    to false.
+    Before:
 
-    *utilum*
+        Time.at(1498099140).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00 UTC +00:00"
+        Time.at(1498099140, 123456780, :nsec).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00 UTC +00:00"
+        Time.at(1498099140 + Rational("1/3")).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00 UTC +00:00"
 
-*   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+.
+    After:
 
-    *Yuji Yaginuma*
+        Time.at(1498099140).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00.000000000 UTC +00:00"
+        Time.at(1498099140, 123456780, :nsec).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00.123456780 UTC +00:00"
+        Time.at(1498099140 + Rational("1/3")).in_time_zone.inspect
+        # => "Thu, 22 Jun 2017 02:39:00.333333333 UTC +00:00"
 
-*   Remove deprecated class `ActiveSupport::Concurrency::Latch`.
+    *akinomaeni*
 
-    *Andrew White*
+*   Calling `ActiveSupport::TaggedLogging#tagged` without a block now returns a tagged logger.
 
-*   Remove deprecated separator argument from `parameterize`.
+    ```ruby
+    logger.tagged("BCX").info("Funky time!") # => [BCX] Funky time!
+    ```
 
-    *Andrew White*
+    *Eugene Kenny*
 
-*   Remove deprecated method `Numeric#to_formatted_s`.
+*   Align `Range#cover?` extension behavior with Ruby behavior for backwards ranges.
 
-    *Andrew White*
+    `(1..10).cover?(5..3)` now returns `false`, as it does in plain Ruby.
 
-*   Remove deprecated method `alias_method_chain`.
+    Also update `#include?` and `#===` behavior to match.
 
-    *Andrew White*
+    *Michael Groeneman*
 
-*   Remove deprecated constant `MissingSourceFile`.
+*   Update to TZInfo v2.0.0.
 
-    *Andrew White*
+    This changes the output of `ActiveSupport::TimeZone.utc_to_local`, but
+    can be controlled with the
+    `ActiveSupport.utc_to_local_returns_utc_offset_times` config.
 
-*   Remove deprecated methods `Module.qualified_const_defined?`,
-    `Module.qualified_const_get` and `Module.qualified_const_set`.
+    New Rails 6.1 apps have it enabled by default, existing apps can upgrade
+    via the config in config/initializers/new_framework_defaults_6_1.rb
 
-    *Andrew White*
+    See the `utc_to_local_returns_utc_offset_times` documentation for details.
 
-*   Remove deprecated `:prefix` option from `number_to_human_size`.
+    *Phil Ross*, *Jared Beck*
 
-    *Andrew White*
+*   Add Date and Time `#yesterday?` and `#tomorrow?` alongside `#today?`.
 
-*   Remove deprecated method `ActiveSupport::HashWithIndifferentAccess.new_from_hash_copying_default`.
+    Aliased to `#prev_day?` and `#next_day?` to match the existing `#prev/next_day` methods.
 
-    *Andrew White*
+    *Jatin Dhankhar*
 
-*   Remove deprecated file `active_support/core_ext/time/marshal.rb`.
+*   Add `Enumerable#pick` to complement `ActiveRecord::Relation#pick`.
 
-    *Andrew White*
+    *Eugene Kenny*
 
-*   Remove deprecated file `active_support/core_ext/struct.rb`.
+*   [Breaking change] `ActiveSupport::Callbacks#halted_callback_hook` now receive a 2nd argument:
 
-    *Andrew White*
+    `ActiveSupport::Callbacks#halted_callback_hook` now receive the name of the callback
+    being halted as second argument.
+    This change will allow you to differentiate which callbacks halted the chain
+    and act accordingly.
 
-*   Remove deprecated file `active_support/core_ext/module/method_transplanting.rb`.
+    ```ruby
+      class Book < ApplicationRecord
+        before_save { throw(:abort) }
+        before_create { throw(:abort) }
 
-    *Andrew White*
+        def halted_callback_hook(filter, callback_name)
+          Rails.logger.info("Book couldn't be #{callback_name}d")
+        end
 
-*   Remove deprecated method `Module.local_constants`.
+        Book.create # => "Book couldn't be created"
+        book.save # => "Book couldn't be saved"
+      end
+    ```
 
-    *Andrew White*
+    *Edouard Chin*
 
-*   Remove deprecated file `active_support/core_ext/kernel/debugger.rb`.
+*   Support `prepend` with `ActiveSupport::Concern`.
 
-    *Andrew White*
+    Allows a module with `extend ActiveSupport::Concern` to be prepended.
 
-*   Remove deprecated method `ActiveSupport::Cache::Store#namespaced_key`.
+        module Imposter
+          extend ActiveSupport::Concern
 
-    *Andrew White*
+          # Same as `included`, except only run when prepended.
+          prepended do
+          end
+        end
 
-*   Remove deprecated method `ActiveSupport::Cache::Strategy::LocalCache::LocalStore#set_cache_value`.
+        class Person
+          prepend Imposter
+        end
 
-    *Andrew White*
+    Class methods are prepended to the base class, concerning is also
+    updated: `concerning :Imposter, prepend: true do`.
 
-*   Remove deprecated method `ActiveSupport::Cache::MemCacheStore#escape_key`.
+    *Jason Karns*, *Elia Schito*
 
-    *Andrew White*
+*   Deprecate using `Range#include?` method to check the inclusion of a value
+    in a date time range. It is recommended to use `Range#cover?` method
+    instead of `Range#include?` to check the inclusion of a value
+    in a date time range.
 
-*   Remove deprecated method `ActiveSupport::Cache::FileStore#key_file_path`.
+    *Vishal Telangre*
 
-    *Andrew White*
+*   Support added for a `round_mode` parameter, in all number helpers. (See: `BigDecimal::mode`.)
 
-*   Ensure duration parsing is consistent across DST changes.
+    ```ruby
+    number_to_currency(1234567890.50, precision: 0, round_mode: :half_down) # => "$1,234,567,890"
+    number_to_percentage(302.24398923423, precision: 5, round_mode: :down) # => "302.24398%"
+    number_to_rounded(389.32314, precision: 0, round_mode: :ceil) # => "390"
+    number_to_human_size(483989, precision: 2, round_mode: :up) # => "480 KB"
+    number_to_human(489939, precision: 2, round_mode: :floor) # => "480 Thousand"
 
-    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.
+    485000.to_s(:human, precision: 2, round_mode: :half_even) # => "480 Thousand"
+    ```
 
-    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.
+    *Tom Lord*
 
-    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.
+*   `Array#to_sentence` no longer returns a frozen string.
 
-    Fixes #26941.
+    Before:
 
-    *Andrew White*
+        ['one', 'two'].to_sentence.frozen?
+        # => true
 
-*   Use `Hash#compact` and `Hash#compact!` from Ruby 2.4. Old Ruby versions
-    will continue to get these methods from Active Support as before.
+    After:
 
-    *Prathamesh Sonpatki*
+        ['one', 'two'].to_sentence.frozen?
+        # => false
 
-*   Fix `ActiveSupport::TimeZone#strptime`.
-    Support for timestamps in format of seconds (%s) and milliseconds (%Q).
+    *Nicolas Dular*
 
-    Fixes #26840.
+*   When an instance of `ActiveSupport::Duration` is converted to an `iso8601` duration string, if `weeks` are mixed with `date` parts, the `week` part will be converted to days.
+    This keeps the parser and serializer on the same page.
 
-    *Lev Denisov*
+    ```ruby
+    duration = ActiveSupport::Duration.build(1000000)
+    # 1 week, 4 days, 13 hours, 46 minutes, and 40.0 seconds
 
-*   Fix `DateAndTime::Calculations#copy_time_to`. Copy `nsec` instead of `usec`.
+    duration_iso = duration.iso8601
+    # P11DT13H46M40S
 
-    Jumping forward or backward between weeks now preserves nanosecond digits.
+    ActiveSupport::Duration.parse(duration_iso)
+    # 11 days, 13 hours, 46 minutes, and 40 seconds
 
-    *Josua Schmid*
+    duration = ActiveSupport::Duration.build(604800)
+    # 1 week
 
-*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+    duration_iso = duration.iso8601
+    # P1W
 
-    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:
+    ActiveSupport::Duration.parse(duration_iso)
+    # 1 week
+    ```
 
-        Time.zone = "US/Eastern"
+    *Abhishek Sarkar*
 
-        t = Time.zone.local(2016,11,6,1)
-        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+*   Add block support to `ActiveSupport::Testing::TimeHelpers#travel_back`.
 
-        t.in(1.hour)
-        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+    *Tim Masliuchenko*
 
-    Fixes #26580.
+*   Update `ActiveSupport::Messages::Metadata#fresh?` to work for cookies with expiry set when
+    `ActiveSupport.parse_json_times = true`.
 
-    *Thomas Balthazar*
+    *Christian Gregg*
 
-*   Remove unused parameter `options = nil` for `#clear` of
-    `ActiveSupport::Cache::Strategy::LocalCache::LocalStore` and
-    `ActiveSupport::Cache::Strategy::LocalCache`.
+*   Support symbolic links for `content_path` in `ActiveSupport::EncryptedFile`.
 
-    *Yosuke Kabuto*
+    *Takumi Shotoku*
 
-*   Fix `thread_mattr_accessor` subclass no longer overwrites parent.
+*   Improve `Range#===`, `Range#include?`, and `Range#cover?` to work with beginless (startless)
+    and endless range targets.
 
-    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.
+    *Allen Hsu*, *Andrew Hodgkinson*
 
-    Given:
+*   Don't use `Process#clock_gettime(CLOCK_THREAD_CPUTIME_ID)` on Solaris.
 
-        class Account
-          thread_mattr_accessor :user
-        end
+    *Iain Beeston*
 
-        class Customer < Account
-        end
+*   Prevent `ActiveSupport::Duration.build(value)` from creating instances of
+    `ActiveSupport::Duration` unless `value` is of type `Numeric`.
 
-        Account.user = "DHH"
-        Customer.user = "Rafael"
+    Addresses the errant set of behaviours described in #37012 where
+    `ActiveSupport::Duration` comparisons would fail confusingly
+    or return unexpected results when comparing durations built from instances of `String`.
 
     Before:
 
-        Account.user  # => "Rafael"
-
-    After:
+        small_duration_from_string = ActiveSupport::Duration.build('9')
+        large_duration_from_string = ActiveSupport::Duration.build('100000000000000')
+        small_duration_from_int = ActiveSupport::Duration.build(9)
 
-        Account.user  # => "DHH"
+        large_duration_from_string > small_duration_from_string
+        # => false
 
-    *Shinichi Maeshima*
+        small_duration_from_string == small_duration_from_int
+        # => false
 
-*   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.
+        small_duration_from_int < large_duration_from_string
+        # => ArgumentError (comparison of ActiveSupport::Duration::Scalar with ActiveSupport::Duration failed)
 
-    Fixes #26039.
+        large_duration_from_string > small_duration_from_int
+        # => ArgumentError (comparison of String with ActiveSupport::Duration failed)
 
-    *Andrew White*
-
-*   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.
-
-    *Xavier Noria*
-
-*   Allow `MessageEncryptor` to take advantage of authenticated encryption modes.
-
-    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.
-
-    *Bart de Water*
+    After:
 
-*   Introduce `assert_changes` and `assert_no_changes`.
+        small_duration_from_string = ActiveSupport::Duration.build('9')
+        # => TypeError (can't build an ActiveSupport::Duration from a String)
 
-    `assert_changes` is a more general `assert_difference` that works with any
-    value.
+    *Alexei Emam*
 
-        assert_changes 'Error.current', from: nil, to: 'ERR' do
-          expected_bad_operation
-        end
+*   Add `ActiveSupport::Cache::Store#delete_multi` method to delete multiple keys from the cache store.
 
-    Can be called with strings, to be evaluated in the binding (context) of
-    the block given to the assertion, or a lambda.
-
-        assert_changes -> { Error.current }, from: nil, to: 'ERR' do
-          expected_bad_operation
-        end
+    *Peter Zhu*
 
-    The `from` and `to` arguments are compared with the case operator (`===`).
+*   Support multiple arguments in `HashWithIndifferentAccess` for `merge` and `update` methods, to
+    follow Ruby 2.6 addition.
 
-        assert_changes 'Error.current', from: nil, to: Error do
-          expected_bad_operation
-        end
+    *Wojciech Wnętrzak*
 
-    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.
+*   Allow initializing `thread_mattr_*` attributes via `:default` option.
 
-        user = User.start_registration
-        assert_changes 'user.token', to: /\w{32}/ do
-          user.finish_registration
+        class Scraper
+          thread_mattr_reader :client, default: Api::Client.new
         end
 
-    *Genadi Samokovarov*
-
-*   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.
+    *Guilherme Mansur*
 
-    Fixes #25701.
+*   Add `compact_blank` for those times when you want to remove #blank? values from
+    an Enumerable (also `compact_blank!` on Hash, Array, ActionController::Parameters).
 
-    *John Gesimondo*
+    *Dana Sherson*
 
-*   `travel/travel_to` travel time helpers, now raise on nested calls,
-    as this can lead to confusing time stubbing.
+*   Make ActiveSupport::Logger Fiber-safe.
 
-    Instead of:
+    Use `Fiber.current.__id__` in `ActiveSupport::Logger#local_level=` in order
+    to make log level local to Ruby Fibers in addition to Threads.
 
-        travel_to 2.days.from_now do
-          # 2 days from today
-          travel_to 3.days.from_now do
-            # 5 days from today
-          end
-        end
+    Example:
 
-    preferred way to achieve above is:
+        logger = ActiveSupport::Logger.new(STDOUT)
+        logger.level = 1
+        puts "Main is debug? #{logger.debug?}"
 
-        travel 2.days do
-          # 2 days from today
-        end
+        Fiber.new {
+          logger.local_level = 0
+          puts "Thread is debug? #{logger.debug?}"
+        }.resume
 
-        travel 5.days do
-          # 5 days from today
-        end
+        puts "Main is debug? #{logger.debug?}"
 
-    *Vipul A M*
-
-*   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*
+    Before:
 
-*   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.
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? true
 
-    *Kevin McPhillips*
+    After:
 
-*   Remove deprecated arguments in `assert_nothing_raised`.
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? false
 
-    *Rafel Mendonça França*
+    Fixes #36752.
 
-*   `Date.to_s` doesn't produce too many spaces. For example, `to_s(:short)`
-    will now produce `01 Feb` instead of ` 1 Feb`.
+    *Alexander Varnin*
 
-    Fixes #25251.
+*   Allow the `on_rotation` proc used when decrypting/verifying a message to be
+    passed at the constructor level.
 
-    *Sean Griffin*
+    Before:
 
-*   Introduce `Module#delegate_missing_to`.
+        crypt = ActiveSupport::MessageEncryptor.new('long_secret')
+        crypt.decrypt_and_verify(encrypted_message, on_rotation: proc { ... })
+        crypt.decrypt_and_verify(another_encrypted_message, on_rotation: proc { ... })
 
-    When building a decorator, a common pattern emerges:
+    After:
 
-        class Partition
-          def initialize(first_event)
-            @events = [ first_event ]
-          end
+        crypt = ActiveSupport::MessageEncryptor.new('long_secret', on_rotation: proc { ... })
+        crypt.decrypt_and_verify(encrypted_message)
+        crypt.decrypt_and_verify(another_encrypted_message)
 
-          def people
-            if @events.first.detail.people.any?
-              @events.collect { |e| Array(e.detail.people) }.flatten.uniq
-            else
-              @events.collect(&:creator).uniq
-            end
-          end
+    *Edouard Chin*
 
-          private
-            def respond_to_missing?(name, include_private = false)
-              @events.respond_to?(name, include_private)
-            end
+*   `delegate_missing_to` would raise a `DelegationError` if the object
+    delegated to was `nil`. Now the `allow_nil` option has been added to enable
+    the user to specify they want `nil` returned in this case.
 
-            def method_missing(method, *args, &block)
-              @events.send(method, *args, &block)
-            end
-        end
+    *Matthew Tanous*
 
-    With `Module#delegate_missing_to`, the above is condensed to:
+*   `truncate` would return the original string if it was too short to be truncated
+    and a frozen string if it were long enough to be truncated. Now truncate will
+    consistently return an unfrozen string regardless. This behavior is consistent
+    with `gsub` and `strip`.
 
-        class Partition
-          delegate_missing_to :@events
+    Before:
 
-          def initialize(first_event)
-            @events = [ first_event ]
-          end
+        'foobar'.truncate(5).frozen?
+        # => true
+        'foobar'.truncate(6).frozen?
+        # => false
 
-          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
+    After:
 
-    *Genadi Samokovarov*, *DHH*
+        'foobar'.truncate(5).frozen?
+        # => false
+        'foobar'.truncate(6).frozen?
+        # => false
 
-*   Rescuable: If a handler doesn't match the exception, check for handlers
-    matching the exception's cause.
+    *Jordan Thomas*
 
-    *Jeremy Daer*
 
-Please check [5-0-stable](https://github.com/rails/rails/blob/5-0-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/activesupport/CHANGELOG.md) for previous changes.