activesupport 5.1.7 → 7.0.4.1

data/CHANGELOG.md

@@ -1,788 +1,462 @@
-## Rails 5.1.7 (March 27, 2019) ##
+## Rails 7.0.4.1 (January 17, 2023) ##
 
-*   No changes.
-
-
-## Rails 5.1.6.2 (March 11, 2019) ##
-
-*   No changes.
+*   Avoid regex backtracking in Inflector.underscore
 
+    [CVE-2023-22796]
 
-## Rails 5.1.6.1 (November 27, 2018) ##
-
-*   No changes.
 
+## Rails 7.0.4 (September 09, 2022) ##
 
-## Rails 5.1.6 (March 29, 2018) ##
+*   Redis cache store is now compatible with redis-rb 5.0.
 
-*   Return all mappings for a timezone identifier in `country_zones`
+    *Jean Boussier*
 
-    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:
+*   Fix `NoMethodError` on custom `ActiveSupport::Deprecation` behavior.
 
-        # Before
-        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh"]
+    `ActiveSupport::Deprecation.behavior=` was supposed to accept any object
+    that responds to `call`, but in fact its internal implementation assumed that
+    this object could respond to `arity`, so it was restricted to only `Proc` objects.
 
-        # After
-        ActiveSupport::TimeZone.country_zones("GB") # => ["Edinburgh", "London"]
+    This change removes this `arity` restriction of custom behaviors.
 
-    Fixes #31668.
+    *Ryo Nakamura*
 
-    *Andrew White*
 
-
-## Rails 5.1.5 (February 14, 2018) ##
+## Rails 7.0.3.1 (July 12, 2022) ##
 
 *   No changes.
 
 
-## Rails 5.1.4 (September 07, 2017) ##
+## Rails 7.0.3 (May 09, 2022) ##
 
 *   No changes.
 
 
-## Rails 5.1.4.rc1 (August 24, 2017) ##
-
-*   No changes.
-
-
-## Rails 5.1.3 (August 03, 2017) ##
-
-*   No changes.
-
-
-## Rails 5.1.3.rc3 (July 31, 2017) ##
-
-*   Fix modulo operations involving durations
-
-    Rails 5.1 introduce an `ActiveSupport::Duration::Scalar` class as a wrapper
-    around a numeric value as a way of ensuring a duration was the outcome of
-    an expression. However the implementation was missing support for modulo
-    operations. This support has now been added and should result in a duration
-    being returned from expressions involving modulo operations.
+## Rails 7.0.2.4 (April 26, 2022) ##
 
-    Prior to Rails 5.1:
+*   Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
 
-        5.minutes % 2.minutes
-        => 60
+    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.
 
-    Now:
+    *Álvaro Martín Fraguas*
 
-        5.minutes % 2.minutes
-        => 1 minute
-
-    Fixes #29603 and #29743.
-
-    *Sayan Chakraborty*, *Andrew White*
-
-*   Fix division where a duration is the denominator
-
-    PR #29163 introduced a change in behavior when a duration was the denominator
-    in a calculation - this was incorrect as dividing by a duration should always
-    return a `Numeric`. The behavior of previous versions of Rails has been restored.
-
-    Fixes #29592.
-
-    *Andrew White*
-
-
-## Rails 5.1.3.rc2 (July 25, 2017) ##
+## Rails 7.0.2.3 (March 08, 2022) ##
 
 *   No changes.
 
 
-## Rails 5.1.3.rc1 (July 19, 2017) ##
-
-*   No changes.
-
-
-## Rails 5.1.2 (June 26, 2017) ##
-
-*   Cache: Restore the `options = nil` argument for `LocalStore#clear`
-    that was removed in 5.1.0. Restores compatibility with backends that
-    take an options argument and use the local cache strategy.
-
-    *Jeremy Daer*
-
-*   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
+## Rails 7.0.2.2 (February 11, 2022) ##
 
-    Now the `ActiveSupport::Duration::Scalar` calculation methods will try to maintain
-    the part structure of the duration where possible, e.g:
+*   Fix Reloader method signature to work with the new Executor signature
 
-        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*
-
-
-## Rails 5.1.1 (May 12, 2017) ##
+## Rails 7.0.2.1 (February 11, 2022) ##
 
 *   No changes.
 
 
-## Rails 5.1.0 (April 27, 2017) ##
-
-*   `ActiveSupport::EventedFileUpdateChecker` no longer listens to
-    directories outside of the application directory.
+## Rails 7.0.2 (February 08, 2022) ##
 
-    *radiospiel*
+*   Fix `ActiveSupport::EncryptedConfiguration` to be compatible with Psych 4
 
-*   Return unmapped timezones from `country_zones`
+    *Stephen Sugden*
 
-    If a country doesn't exist in the MAPPINGS hash then create a new
-    `ActiveSupport::Timezone` instance using the supplied timezone id.
+*   Improve `File.atomic_write` error handling.
 
-    Fixes #28431.
+    *Daniel Pepper*
 
-    *Andrew White*
-
-*   Add ActiveSupport::Deprecation::DeprecatedConstantAccessor
-
-    Provides transparent deprecation of constants, compatible with exceptions.
-    Example usage:
 
-        module Example
-          include ActiveSupport::Deprecation::DeprecatedConstantAccessor
-          deprecate_constant 'OldException', 'Elsewhere::NewException'
-        end
+## Rails 7.0.1 (January 06, 2022) ##
 
-    *Dominic Cleal*
+*   Fix `Class#descendants` and `DescendantsTracker#descendants` compatibility with Ruby 3.1.
 
-*   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`.
+    [The native `Class#descendants` was reverted prior to Ruby 3.1 release](https://bugs.ruby-lang.org/issues/14394#note-33),
+    but `Class#subclasses` was kept, breaking the feature detection.
 
-    *Kevin McPhillips* & *Andrew White*
+    *Jean Boussier*
 
-*   Remove implicit coercion deprecation of durations
 
-    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:
+## Rails 7.0.0 (December 15, 2021) ##
 
-        redis.expire("foo", 5.minutes)
+*   Fix `ActiveSupport::Duration.build` to support negative values.
 
-    To work around this we've removed the deprecation and added a private class
-    that wraps the numeric and can perform calculation involving durations and
-    ensure that they remain a duration irrespective of the order of operations.
-
-    *Andrew White*
+    The algorithm to collect the `parts` of the `ActiveSupport::Duration`
+    ignored the sign of the `value` and accumulated incorrect part values. This
+    impacted `ActiveSupport::Duration#sum` (which is dependent on `parts`) but
+    not `ActiveSupport::Duration#eql?` (which is dependent on `value`).
 
-*   Update `titleize` regex to allow apostrophes
+    *Caleb Buxton*, *Braden Staudacher*
 
-    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:
-
-        >> "This was 'fake news'".titleize
-        => "This Was 'fake News'"
-
-    This is fixed by extending the look-behind to also check for a word
-    character on the other side of the apostrophe.
-
-    Fixes #28312.
-
-    *Andrew White*
-
-*   Add `rfc3339` aliases to `xmlschema` for `Time` and `ActiveSupport::TimeWithZone`
-
-    For naming consistency when using the RFC 3339 profile of ISO 8601 in applications.
-
-    *Andrew White*
 
-*   Add `Time.rfc3339` parsing method
+## Rails 7.0.0.rc3 (December 14, 2021) ##
 
-    `Time.xmlschema` and consequently its alias `iso8601` accepts timestamps
-    without a offset in contravention of the RFC 3339 standard. This method
-    enforces that constraint and raises an `ArgumentError` if it doesn't.
-
-    *Andrew White*
-
-*   Add `ActiveSupport::TimeZone.rfc3339` parsing method
-
-    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:
-
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("1999-12-31T14:00:00Z")
-        => Fri, 31 Dec 1999 14:00:00 HST -10:00
-
-    This new method has stricter semantics than the current `parse` method,
-    and will raise an `ArgumentError` instead of returning nil, e.g:
-
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("foobar")
-        ArgumentError: invalid date
-        >> Time.zone.parse("foobar")
-        => nil
-
-    It will also raise an `ArgumentError` when either the time or offset
-    components are missing, e.g:
-
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.rfc3339("1999-12-31")
-        ArgumentError: invalid date
-        >> Time.zone.rfc3339("1999-12-31T14:00:00")
-        ArgumentError: invalid date
-
-    *Andrew White*
-
-*   Add `ActiveSupport::TimeZone.iso8601` parsing method
-
-    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:
-
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("1999-12-31T14:00:00Z")
-        => Fri, 31 Dec 1999 14:00:00 HST -10:00
-
-    If the timestamp is a ISO 8601 date (YYYY-MM-DD), then the time is set
-    to midnight, e.g:
-
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("1999-12-31")
-        => Fri, 31 Dec 1999 00:00:00 HST -10:00
+*   No changes.
 
-    This new method has stricter semantics than the current `parse` method,
-    and will raise an `ArgumentError` instead of returning nil, e.g:
 
-        >> Time.zone = "Hawaii"
-        => "Hawaii"
-        >> Time.zone.iso8601("foobar")
-        ArgumentError: invalid date
-        >> Time.zone.parse("foobar")
-        => nil
+## Rails 7.0.0.rc2 (December 14, 2021) ##
 
-    *Andrew White*
+*   No changes.
 
-*   Deprecate implicit coercion of `ActiveSupport::Duration`
+## Rails 7.0.0.rc1 (December 06, 2021) ##
 
-    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:
+*   Deprecate passing a format to `#to_s` in favor of `#to_formatted_s` in `Array`, `Range`, `Date`, `DateTime`, `Time`,
+    `BigDecimal`, `Float` and, `Integer`.
 
-        >> 2 * 1.day
-        => 172800
+    *Rafael Mendonça França*
 
-    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:
+*   Document `ActiveSupport::Testing::Deprecation`.
 
-        >> Date.today
-        => Wed, 01 Mar 2017
-        >> Date.today + 2 * 1.day
-        => Mon, 10 Apr 2490
+    *Sam Bostock & Sam Jordan*
 
-    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:
+*   Add `Pathname#existence`.
 
-        >> 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
+    Pathname.new("file").existence&.read
+    ```
 
-    In Rails 5.2 it will raise `TypeError`, e.g:
+    *Timo Schilling*
 
-        >> 2 * 1.day
-        TypeError: ActiveSupport::Duration can't be coerced into Integer
+*   Remove deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
 
-    This is the same behavior as with other types in Ruby, e.g:
+    *Rafael Mendonça França*
 
-        >> 2 * "foo"
-        TypeError: String can't be coerced into Integer
-        >> "foo" * 2
-        => "foofoo"
+*   Remove deprecated support to use `Range#include?` to check the inclusion of a value in
+    a date time range is deprecated.
 
-    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:
+    *Rafael Mendonça França*
 
-        >> Date.today
-        => Wed, 01 Mar 2017
-        >> Date.today + 1.day * 2
-        => Fri, 03 Mar 2017
+*   Remove deprecated `URI.parser`.
 
-    Fixes #27457.
+    *Rafael Mendonça França*
 
-    *Andrew White*
+*   Remove deprecated `config.active_support.use_sha1_digests`.
 
-*   Update `DateTime#change` to support `:usec` and `:nsec` options.
+    *Rafael Mendonça França*
 
-    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:
+*   Invoking `Object#with_options` without a `&block` argument returns the
+    `ActiveSupport::OptionMerger` instance.
 
-        datetime = DateTime.now.end_of_day
-        datetime.nsec == 999999999 # => true
+    *Sean Doyle*
 
-    Fixes #21424.
+*   `Rails.application.executor` hooks can now be called around every test
 
-    *Dan Moore*, *Andrew White*
+    This helps to better simulate request or job local state being reset around tests and prevents state
+    leaking from one test to another.
 
-*   Add `ActiveSupport::Duration#before` and `#after` as aliases for `#until` and `#since`
+    However it requires the executor hooks executed in the test environment to be re-entrant.
 
-    These read more like English and require less mental gymnastics to read and write.
+    To enable this, set `config.active_support.executor_around_test_case = true` (this is the default in Rails 7).
 
-    Before:
+    *Jean Boussier*
 
-        2.weeks.since(customer_start_date)
-        5.days.until(today)
+*   `ActiveSupport::DescendantsTracker` now mostly delegate to `Class#descendants` on Ruby 3.1
 
-    After:
+    Ruby now provides a fast `Class#descendants` making `ActiveSupport::DescendantsTracker` mostly useless.
 
-        2.weeks.after(customer_start_date)
-        5.days.before(today)
+    As a result the following methods are deprecated:
 
-    *Nick Johnstone*
+      - `ActiveSupport::DescendantsTracker.direct_descendants`
+      - `ActiveSupport::DescendantsTracker#direct_descendants`
 
-*   Soft-deprecated the top-level `HashWithIndifferentAccess` constant.
-    `ActiveSupport::HashWithIndifferentAccess` should be used instead.
+    *Jean Boussier*
 
-    Fixes #28157.
+*   Fix the `Digest::UUID.uuid_from_hash` behavior for namespace IDs that are different from the ones defined on `Digest::UUID`.
 
-    *Robin Dupret*
+    The new behavior will be enabled by setting the
+    `config.active_support.use_rfc4122_namespaced_uuids` option to `true`
+    and is the default for new apps.
 
-*   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.
+    The old behavior is the default for upgraded apps and will output a
+    deprecation warning every time a value that is different than one of
+    the constants defined on the `Digest::UUID` extension is used as the
+    namespace ID.
 
-    *Jeff Latz*
+    *Alex Robbin*, *Erich Soares Machado*, *Eugene Kenny*
 
-*   `ActiveSupport::Gzip.decompress` now checks checksum and length in footer.
+*   `ActiveSupport::Inflector::Inflections#clear(:acronyms)` is now supported,
+    and `inflector.clear` / `inflector.clear(:all)` also clears acronyms.
 
-    *Dylan Thacker-Smith*
+    *Alex Ghiculescu*, *Oliver Peate*
 
-*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
 
-    *Adam Rice*
+## Rails 7.0.0.alpha2 (September 15, 2021) ##
 
-*   Deprecate `ActiveSupport.halt_callback_chains_on_return_false`.
+*   No changes.
 
-    *Rafael Mendonça França*
 
-*   Remove deprecated behavior that halts callbacks when the return is false.
+## Rails 7.0.0.alpha1 (September 15, 2021) ##
 
-    *Rafael Mendonça França*
+*   `ActiveSupport::Dependencies` no longer installs a `const_missing` hook. Before this, you could push to the autoload paths and have constants autoloaded. This feature, known as the `classic` autoloader, has been removed.
 
-*   Deprecate passing string to `:if` and `:unless` conditional options
-    on `set_callback` and `skip_callback`.
+    *Xavier Noria*
 
-    *Ryuta Kamizono*
+*   Private internal classes of `ActiveSupport::Dependencies` have been deleted, like `ActiveSupport::Dependencies::Reference`, `ActiveSupport::Dependencies::Blamable`, and others.
 
-*   Raise `ArgumentError` when passing string to define callback.
+    *Xavier Noria*
 
-    *Ryuta Kamizono*
+*   The private API of `ActiveSupport::Dependencies` has been deleted. That includes methods like `hook!`, `unhook!`, `depend_on`, `require_or_load`, `mechanism`, and many others.
 
-*   Updated Unicode version to 9.0.0
+    *Xavier Noria*
 
-    Now we can handle new emojis such like "👩‍👩‍👧‍👦" ("\u{1F469}\u{200D}\u{1F469}\u{200D}\u{1F467}\u{200D}\u{1F466}").
+*   Improves the performance of `ActiveSupport::NumberHelper` formatters by avoiding the use of exceptions as flow control.
 
-    version 8.0.0
+    *Mike Dalessio*
 
-        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 4
-        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👦👧‍👩‍👩‍"
+*   Removed rescue block from `ActiveSupport::Cache::RedisCacheStore#handle_exception`
 
-    version 9.0.0
+    Previously, if you provided a `error_handler` to `redis_cache_store`, any errors thrown by
+    the error handler would be rescued and logged only. Removed the `rescue` clause from `handle_exception`
+    to allow these to be thrown.
 
-        "👩‍👩‍👧‍👦".mb_chars.grapheme_length # => 1
-        "👩‍👩‍👧‍👦".mb_chars.reverse # => "👩‍👩‍👧‍👦"
+    *Nicholas A. Stuart*
 
-    *Fumiaki MATSUSHIMA*
+*   Allow entirely opting out of deprecation warnings.
 
-*   Changed `ActiveSupport::Inflector#transliterate` to raise `ArgumentError` when it receives
-    anything except a string.
+    Previously if you did `app.config.active_support.deprecation = :silence`, some work would
+    still be done on each call to `ActiveSupport::Deprecation.warn`. In very hot paths, this could
+    cause performance issues.
 
-    *Kevin McPhillips*
+    Now, you can make `ActiveSupport::Deprecation.warn` a no-op:
 
-*   Fixed bugs that `StringInquirer#respond_to_missing?` and
-    `ArrayInquirer#respond_to_missing?` do not fallback to `super`.
+    ```ruby
+    config.active_support.report_deprecations = false
+    ```
 
-    *Akira Matsuda*
+    This is the default in production for new apps. It is the equivalent to:
 
-*   Fix inconsistent results when parsing large durations and constructing durations from code
+    ```ruby
+    config.active_support.deprecation = :silence
+    config.active_support.disallowed_deprecation = :silence
+    ```
 
-        ActiveSupport::Duration.parse('P3Y') == 3.years # It should be true
+    but will take a more optimised code path.
 
-    Duration parsing made independent from any moment of time:
-    Fixed length in seconds is assigned to each duration part during parsing.
+    *Alex Ghiculescu*
 
-    Changed duration of months and years in seconds to more accurate and logical:
+*   Faster tests by parallelizing only when overhead is justified by the number
+    of them.
 
-     1. The value of 365.2425 days in Gregorian year is more accurate
-        as it accounts for every 400th non-leap year.
+    Running tests in parallel adds overhead in terms of database
+    setup and fixture loading. Now, Rails will only parallelize test executions when
+    there are enough tests to make it worth it.
 
-     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`.
+    This threshold is 50 by default, and is configurable via config setting in
+    your test.rb:
 
-    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.
+    ```ruby
+    config.active_support.test_parallelization_threshold = 100
+    ```
 
-    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.
+    It's also configurable at the test case level:
 
-    *Andrey Novikov*, *Andrew White*
+    ```ruby
+    class ActiveSupport::TestCase
+      parallelize threshold: 100
+    end
+    ```
 
-*   Change return value of `Rational#duplicable?`, `ComplexClass#duplicable?`
-    to false.
+    *Jorge Manrubia*
 
-    *utilum*
+*   OpenSSL constants are now used for Digest computations.
 
-*   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+.
+    *Dirkjan Bussink*
 
-    *Yuji Yaginuma*
+*   `TimeZone.iso8601` now accepts valid ordinal values similar to Ruby's `Date._iso8601` method.
+    A valid ordinal value will be converted to an instance of `TimeWithZone` using the `:year`
+    and `:yday` fragments returned from `Date._iso8601`.
 
-*   Remove deprecated class `ActiveSupport::Concurrency::Latch`.
+    ```ruby
+    twz = ActiveSupport::TimeZone["Eastern Time (US & Canada)"].iso8601("21087")
+    twz.to_a[0, 6] == [0, 0, 0, 28, 03, 2021]
+    ```
 
-    *Andrew White*
+    *Steve Laing*
 
-*   Remove deprecated separator argument from `parameterize`.
+*   `Time#change` and methods that call it (e.g. `Time#advance`) will now
+    return a `Time` with the timezone argument provided, if the caller was
+    initialized with a timezone argument.
 
-    *Andrew White*
+    Fixes [#42467](https://github.com/rails/rails/issues/42467).
 
-*   Remove deprecated method `Numeric#to_formatted_s`.
+    *Alex Ghiculescu*
 
-    *Andrew White*
+*   Allow serializing any module or class to JSON by name.
 
-*   Remove deprecated method `alias_method_chain`.
+    *Tyler Rick*, *Zachary Scott*
 
-    *Andrew White*
+*   Raise `ActiveSupport::EncryptedFile::MissingKeyError` when the
+    `RAILS_MASTER_KEY` environment variable is blank (e.g. `""`).
 
-*   Remove deprecated constant `MissingSourceFile`.
+    *Sunny Ripert*
 
-    *Andrew White*
+*   The `from:` option is added to `ActiveSupport::TestCase#assert_no_changes`.
 
-*   Remove deprecated methods `Module.qualified_const_defined?`,
-    `Module.qualified_const_get` and `Module.qualified_const_set`.
+    It permits asserting on the initial value that is expected not to change.
 
-    *Andrew White*
+    ```ruby
+    assert_no_changes -> { Status.all_good? }, from: true do
+      post :create, params: { status: { ok: true } }
+    end
+    ```
 
-*   Remove deprecated `:prefix` option from `number_to_human_size`.
+    *George Claghorn*
 
-    *Andrew White*
+*   Deprecate `ActiveSupport::SafeBuffer`'s incorrect implicit conversion of objects into string.
 
-*   Remove deprecated method `ActiveSupport::HashWithIndifferentAccess.new_from_hash_copying_default`.
+    Except for a few methods like `String#%`, objects must implement `#to_str`
+    to be implicitly converted to a String in string operations. In some
+    circumstances `ActiveSupport::SafeBuffer` was incorrectly calling the
+    explicit conversion method (`#to_s`) on them. This behavior is now
+    deprecated.
 
-    *Andrew White*
+    *Jean Boussier*
 
-*   Remove deprecated file `active_support/core_ext/time/marshal.rb`.
+*   Allow nested access to keys on `Rails.application.credentials`.
 
-    *Andrew White*
+    Previously only top level keys in `credentials.yml.enc` could be accessed with method calls. Now any key can.
 
-*   Remove deprecated file `active_support/core_ext/struct.rb`.
+    For example, given these secrets:
 
-    *Andrew White*
+    ```yml
+    aws:
+      access_key_id: 123
+      secret_access_key: 345
+    ```
 
-*   Remove deprecated file `active_support/core_ext/module/method_transplanting.rb`.
+    `Rails.application.credentials.aws.access_key_id` will now return the same thing as
+    `Rails.application.credentials.aws[:access_key_id]`.
 
-    *Andrew White*
+    *Alex Ghiculescu*
 
-*   Remove deprecated method `Module.local_constants`.
+*   Added a faster and more compact `ActiveSupport::Cache` serialization format.
 
-    *Andrew White*
+    It can be enabled with `config.active_support.cache_format_version = 7.0` or
+    `config.load_defaults 7.0`. Regardless of the configuration Active Support
+    7.0 can read cache entries serialized by Active Support 6.1 which allows to
+    upgrade without invalidating the cache. However Rails 6.1 can't read the
+    new format, so all readers must be upgraded before the new format is enabled.
 
-*   Remove deprecated file `active_support/core_ext/kernel/debugger.rb`.
+    *Jean Boussier*
 
-    *Andrew White*
+*   Add `Enumerable#sole`, per `ActiveRecord::FinderMethods#sole`.  Returns the
+    sole item of the enumerable, raising if no items are found, or if more than
+    one is.
 
-*   Remove deprecated method `ActiveSupport::Cache::Store#namespaced_key`.
+    *Asherah Connor*
 
-    *Andrew White*
+*   Freeze `ActiveSupport::Duration#parts` and remove writer methods.
 
-*   Remove deprecated method `ActiveSupport::Cache::Strategy::LocalCache::LocalStore#set_cache_value`.
+    Durations are meant to be value objects and should not be mutated.
 
     *Andrew White*
 
-*   Remove deprecated method `ActiveSupport::Cache::MemCacheStore#escape_key`.
-
-    *Andrew White*
+*   Fix `ActiveSupport::TimeZone#utc_to_local` with fractional seconds.
 
-*   Remove deprecated method `ActiveSupport::Cache::FileStore#key_file_path`.
+    When `utc_to_local_returns_utc_offset_times` is false and the time
+    instance had fractional seconds the new UTC time instance was out by
+    a factor of 1,000,000 as the `Time.utc` constructor takes a usec
+    value and not a fractional second value.
 
     *Andrew White*
 
-*   Ensure duration parsing is consistent across DST changes.
-
-    Previously `ActiveSupport::Duration.parse` used `Time.current` and
-    `Time#advance` to calculate the number of seconds in the duration
-    from an arbitrary collection of parts. However as `advance` tries to
-    be consistent across DST boundaries this meant that either the
-    duration was shorter or longer depending on the time of year.
+*   Add `expires_at` argument to `ActiveSupport::Cache` `write` and `fetch` to set a cache entry TTL as an absolute time.
 
-    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.
+    ```ruby
+    Rails.cache.write(key, value, expires_at: Time.now.at_end_of_hour)
+    ```
 
-    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.
+    *Jean Boussier*
 
-    Fixes #26941.
+*   Deprecate `ActiveSupport::TimeWithZone.name` so that from Rails 7.1 it will use the default implementation.
 
     *Andrew White*
 
-*   Use `Hash#compact` and `Hash#compact!` from Ruby 2.4. Old Ruby versions
-    will continue to get these methods from Active Support as before.
-
-    *Prathamesh Sonpatki*
-
-*   Fix `ActiveSupport::TimeZone#strptime`.
-    Support for timestamps in format of seconds (%s) and milliseconds (%Q).
-
-    Fixes #26840.
+*   Deprecates Rails custom `Enumerable#sum` and `Array#sum` in favor of Ruby's native implementation which
+    is considerably faster.
 
-    *Lev Denisov*
+    Ruby requires an initializer for non-numeric type as per examples below:
 
-*   Fix `DateAndTime::Calculations#copy_time_to`. Copy `nsec` instead of `usec`.
+    ```ruby
+    %w[foo bar].sum('')
+    # instead of %w[foo bar].sum
 
-    Jumping forward or backward between weeks now preserves nanosecond digits.
+    [[1, 2], [3, 4, 5]].sum([])
+    # instead of [[1, 2], [3, 4, 5]].sum
+    ```
 
-    *Josua Schmid*
+    *Alberto Mota*
 
-*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
+*   Tests parallelization is now disabled when running individual files to prevent the setup overhead.
 
-    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:
+    It can still be enforced if the environment variable `PARALLEL_WORKERS` is present and set to a value greater than 1.
 
-        Time.zone = "US/Eastern"
+    *Ricardo Díaz*
 
-        t = Time.zone.local(2016,11,6,1)
-        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
+*   Fix proxying keyword arguments in `ActiveSupport::CurrentAttributes`.
 
-        t.in(1.hour)
-        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
+    *Marcin Kołodziej*
 
-    Fixes #26580.
+*   Add `Enumerable#maximum` and `Enumerable#minimum` to easily calculate the maximum or minimum from extracted
+    elements of an enumerable.
 
-    *Thomas Balthazar*
+    ```ruby
+    payments = [Payment.new(5), Payment.new(15), Payment.new(10)]
 
-*   Remove unused parameter `options = nil` for `#clear` of
-    `ActiveSupport::Cache::Strategy::LocalCache::LocalStore` and
-    `ActiveSupport::Cache::Strategy::LocalCache`.
+    payments.minimum(:price) # => 5
+    payments.maximum(:price) # => 15
+    ```
 
-    *Yosuke Kabuto*
+    This also allows passing enumerables to `fresh_when` and `stale?` in Action Controller.
+    See PR [#41404](https://github.com/rails/rails/pull/41404) for an example.
 
-*   Fix `thread_mattr_accessor` subclass no longer overwrites parent.
+    *Ayrton De Craene*
 
-    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.
+*   `ActiveSupport::Cache::MemCacheStore` now accepts an explicit `nil` for its `addresses` argument.
 
-    Given:
+    ```ruby
+    config.cache_store = :mem_cache_store, nil
 
-        class Account
-          thread_mattr_accessor :user
-        end
+    # is now equivalent to
 
-        class Customer < Account
-        end
+    config.cache_store = :mem_cache_store
 
-        Account.user = "DHH"
-        Customer.user = "Rafael"
+    # and is also equivalent to
 
-    Before:
+    config.cache_store = :mem_cache_store, ENV["MEMCACHE_SERVERS"] || "localhost:11211"
 
-        Account.user  # => "Rafael"
+    # which is the fallback behavior of Dalli
+    ```
 
-    After:
+    This helps those migrating from `:dalli_store`, where an explicit `nil` was permitted.
 
-        Account.user  # => "DHH"
+    *Michael Overmeyer*
 
-    *Shinichi Maeshima*
+*   Add `Enumerable#in_order_of` to put an Enumerable in a certain order by a key.
 
-*   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.
+    *DHH*
 
-    Fixes #26039.
+*   `ActiveSupport::Inflector.camelize` behaves expected when provided a symbol `:upper` or `:lower` argument. Matches
+    `String#camelize` behavior.
 
-    *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*
+    *Alex Ghiculescu*
 
-*   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*
-
-*   Introduce `assert_changes` and `assert_no_changes`.
-
-    `assert_changes` is a more general `assert_difference` that works with any
-    value.
-
-        assert_changes 'Error.current', from: nil, to: 'ERR' do
-          expected_bad_operation
-        end
-
-    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
-
-    The `from` and `to` arguments are compared with the case operator (`===`).
-
-        assert_changes 'Error.current', from: nil, to: Error do
-          expected_bad_operation
-        end
-
-    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.
-
-        user = User.start_registration
-        assert_changes 'user.token', to: /\w{32}/ do
-          user.finish_registration
-        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.
-
-    Fixes #25701.
-
-    *John Gesimondo*
-
-*   `travel/travel_to` travel time helpers, now raise on nested calls,
-    as this can lead to confusing time stubbing.
-
-    Instead of:
-
-        travel_to 2.days.from_now do
-          # 2 days from today
-          travel_to 3.days.from_now do
-            # 5 days from today
-          end
-        end
-
-    preferred way to achieve above is:
-
-        travel 2.days do
-          # 2 days from today
-        end
-
-        travel 5.days do
-          # 5 days from today
-        end
+*   Raises an `ArgumentError` when the first argument of `ActiveSupport::Notification.subscribe` is
+    invalid.
 
     *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*
-
-*   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.
-
-    *Kevin McPhillips*
-
-*   Remove deprecated arguments in `assert_nothing_raised`.
-
-    *Rafel Mendonça França*
-
-*   `Date.to_s` doesn't produce too many spaces. For example, `to_s(:short)`
-    will now produce `01 Feb` instead of ` 1 Feb`.
-
-    Fixes #25251.
-
-    *Sean Griffin*
-
-*   Introduce `Module#delegate_missing_to`.
-
-    When building a decorator, a common pattern emerges:
-
-        class Partition
-          def initialize(first_event)
-            @events = [ first_event ]
-          end
-
-          def people
-            if @events.first.detail.people.any?
-              @events.collect { |e| Array(e.detail.people) }.flatten.uniq
-            else
-              @events.collect(&:creator).uniq
-            end
-          end
-
-          private
-            def respond_to_missing?(name, include_private = false)
-              @events.respond_to?(name, include_private)
-            end
-
-            def method_missing(method, *args, &block)
-              @events.send(method, *args, &block)
-            end
-        end
-
-    With `Module#delegate_missing_to`, the above is condensed to:
+*   `HashWithIndifferentAccess#deep_transform_keys` now returns a `HashWithIndifferentAccess` instead of a `Hash`.
 
-        class Partition
-          delegate_missing_to :@events
+    *Nathaniel Woodthorpe*
 
-          def initialize(first_event)
-            @events = [ first_event ]
-          end
+*   Consume dalli’s `cache_nils` configuration as `ActiveSupport::Cache`'s `skip_nil` when using `MemCacheStore`.
 
-          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
+    *Ritikesh G*
 
-    *Genadi Samokovarov*, *DHH*
+*   Add `RedisCacheStore#stats` method similar to `MemCacheStore#stats`. Calls `redis#info` internally.
 
-*   Rescuable: If a handler doesn't match the exception, check for handlers
-    matching the exception's cause.
+    *Ritikesh G*
 
-    *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-1-stable](https://github.com/rails/rails/blob/6-1-stable/activesupport/CHANGELOG.md) for previous changes.