activesupport 6.0.3 → 7.0.0

data/CHANGELOG.md

@@ -1,660 +1,383 @@
-## Rails 6.0.3 (May 06, 2020) ##
+## Rails 7.0.0 (December 15, 2021) ##
 
-*   `Array#to_sentence` no longer returns a frozen string.
+*   Fix `ActiveSupport::Duration.build` to support negative values.
 
-    Before:
+    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`).
 
-        ['one', 'two'].to_sentence.frozen?
-        # => true
+    *Caleb Buxton*, *Braden Staudacher*
 
-    After:
 
-        ['one', 'two'].to_sentence.frozen?
-        # => false
-
-    *Nicolas Dular*
-
-*   Update `ActiveSupport::Messages::Metadata#fresh?` to work for cookies with expiry set when
-    `ActiveSupport.parse_json_times = true`.
-
-    *Christian Gregg*
-
-
-## Rails 6.0.2.2 (March 19, 2020) ##
+## Rails 7.0.0.rc3 (December 14, 2021) ##
 
 *   No changes.
 
 
-## Rails 6.0.2.1 (December 18, 2019) ##
+## Rails 7.0.0.rc2 (December 14, 2021) ##
 
 *   No changes.
 
+## Rails 7.0.0.rc1 (December 06, 2021) ##
 
-## Rails 6.0.2 (December 13, 2019) ##
-
-*   Eager load translations during initialization.
-
-    *Diego Plentz*
-
-*   Use per-thread CPU time clock on `ActiveSupport::Notifications`.
-
-    *George Claghorn*
-
+*   Deprecate passing a format to `#to_s` in favor of `#to_formatted_s` in `Array`, `Range`, `Date`, `DateTime`, `Time`,
+    `BigDecimal`, `Float` and, `Integer`.
 
-## Rails 6.0.1 (November 5, 2019) ##
-
-*   `ActiveSupport::SafeBuffer` supports `Enumerator` methods.
-
-    *Shugo Maeda*
-
-*   The Redis cache store fails gracefully when the server returns a "max number
-    of clients reached" error.
-
-    *Brandon Medenwald*
+    *Rafael Mendonça França*
 
-*   Fixed that mutating a value returned by a memory cache store would
-    unexpectedly change the cached value.
+*   Document `ActiveSupport::Testing::Deprecation`.
 
-    *Jonathan Hyman*
+    *Sam Bostock & Sam Jordan*
 
-*   The default inflectors in `zeitwerk` mode support overrides:
+*   Add `Pathname#existence`.
 
     ```ruby
-    # config/initializers/zeitwerk.rb
-    Rails.autoloaders.each do |autoloader|
-      autoloader.inflector.inflect(
-        "html_parser" => "HTMLParser",
-        "ssl_error"   => "SSLError"
-      )
-    end
+    Pathname.new("file").existence&.read
     ```
 
-    That way, you can tweak how individual basenames are inflected without touching Active Support inflection rules, which are global. These inflectors fallback to `String#camelize`, so existing inflection rules are still taken into account for non-overridden basenames.
-
-    Please, check the [autoloading guide for `zeitwerk` mode](https://guides.rubyonrails.org/v6.0/autoloading_and_reloading_constants.html#customizing-inflections) if you prefer not to depend on `String#camelize` at all.
-
-    *Xavier Noria*
-
-*   Improve `Range#===`, `Range#include?`, and `Range#cover?` to work with beginless (startless)
-    and endless range targets.
-
-    *Allen Hsu*, *Andrew Hodgkinson*
-
-*   Don't use `Process#clock_gettime(CLOCK_THREAD_CPUTIME_ID)` on Solaris.
-
-    *Iain Beeston*
-
-
-## Rails 6.0.0 (August 16, 2019) ##
-
-*   Let `require_dependency` in `zeitwerk` mode look the autoload paths up for
-    better backwards compatibility.
-
-    *Xavier Noria*
-
-*   Let `require_dependency` in `zeitwerk` mode support arguments that respond
-    to `to_path` for better backwards compatibility.
-
-    *Xavier Noria*
-
-*   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:
+    *Timo Schilling*
 
-        Main is debug? false
-        Thread is debug? true
-        Main is debug? false
+*   Remove deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
 
-    *Alexander Varnin*
-
-*   Do not delegate missing `marshal_dump` and `_dump` methods via the
-    `delegate_missing_to` extension. This avoids unintentionally adding instance
-    variables when calling `Marshal.dump(object)`, should the delegation target of
-    `object` be a method which would otherwise add them. Fixes #36522.
+    *Rafael Mendonça França*
 
-    *Aaron Lipman*
+*   Remove deprecated support to use `Range#include?` to check the inclusion of a value in
+    a date time range is deprecated.
 
+    *Rafael Mendonça França*
 
-## Rails 6.0.0.rc2 (July 22, 2019) ##
+*   Remove deprecated `URI.parser`.
 
-*   `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`.
+    *Rafael Mendonça França*
 
-    Before:
+*   Remove deprecated `config.active_support.use_sha1_digests`.
 
-        'foobar'.truncate(5).frozen?
-        # => true
-        'foobar'.truncate(6).frozen?
-        # => false
+    *Rafael Mendonça França*
 
-    After:
+*   Invoking `Object#with_options` without a `&block` argument returns the
+    `ActiveSupport::OptionMerger` instance.
 
-        'foobar'.truncate(5).frozen?
-        # => false
-        'foobar'.truncate(6).frozen?
-        # => false
+    *Sean Doyle*
 
-    *Jordan Thomas*
+*   `Rails.application.executor` hooks can now be called around every test
 
+    This helps to better simulate request or job local state being reset around tests and prevents state
+    leaking from one test to another.
 
-## Rails 6.0.0.rc1 (April 24, 2019) ##
+    However it requires the executor hooks executed in the test environment to be re-entrant.
 
-*   Introduce `ActiveSupport::ActionableError`.
+    To enable this, set `config.active_support.executor_around_test_case = true` (this is the default in Rails 7).
 
-    Actionable errors let's you dispatch actions from Rails' error pages. This
-    can help you save time if you have a clear action for the resolution of
-    common development errors.
+    *Jean Boussier*
 
-    The de-facto example are pending migrations. Every time pending migrations
-    are found, a middleware raises an error. With actionable errors, you can
-    run the migrations right from the error page. Other examples include Rails
-    plugins that need to run a rake task to setup themselves. They can now
-    raise actionable errors to run the setup straight from the error pages.
+*   `ActiveSupport::DescendantsTracker` now mostly delegate to `Class#descendants` on Ruby 3.1
 
-    Here is how to define an actionable error:
+    Ruby now provides a fast `Class#descendants` making `ActiveSupport::DescendantsTracker` mostly useless.
 
-    ```ruby
-    class PendingMigrationError < MigrationError #:nodoc:
-      include ActiveSupport::ActionableError
+    As a result the following methods are deprecated:
 
-      action "Run pending migrations" do
-        ActiveRecord::Tasks::DatabaseTasks.migrate
-      end
-    end
-    ```
+      - `ActiveSupport::DescendantsTracker.direct_descendants`
+      - `ActiveSupport::DescendantsTracker#direct_descendants`
 
-    To make an error actionable, include the `ActiveSupport::ActionableError`
-    module and invoke the `action` class macro to define the action. An action
-    needs a name and a procedure to execute. The name is shown as the name of a
-    button on the error pages. Once clicked, it will invoke the given
-    procedure.
+    *Jean Boussier*
 
-    *Vipul A M*, *Yao Jie*, *Genadi Samokovarov*
+*   Fix the `Digest::UUID.uuid_from_hash` behavior for namespace IDs that are different from the ones defined on `Digest::UUID`.
 
-*   Preserve `html_safe?` status on `ActiveSupport::SafeBuffer#*`.
+    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.
 
-    Before:
+    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.
 
-        ("<br />".html_safe * 2).html_safe? #=> nil
+    *Alex Robbin*, *Erich Soares Machado*, *Eugene Kenny*
 
-    After:
+*   `ActiveSupport::Inflector::Inflections#clear(:acronyms)` is now supported,
+    and `inflector.clear` / `inflector.clear(:all)` also clears acronyms.
 
-        ("<br />".html_safe * 2).html_safe? #=> true
+    *Alex Ghiculescu*, *Oliver Peate*
 
-    *Ryo Nakamura*
 
-*   Calling test methods with `with_info_handler` method to allow minitest-hooks
-    plugin to work.
+## Rails 7.0.0.alpha2 (September 15, 2021) ##
 
-    *Mauri Mustonen*
+*   No changes.
 
-*   The Zeitwerk compatibility interface for `ActiveSupport::Dependencies` no
-    longer implements `autoloaded_constants` or `autoloaded?` (undocumented,
-    anyway). Experience shows introspection does not have many use cases, and
-    troubleshooting is done by logging. With this design trade-off we are able
-    to use even less memory in all environments.
 
-    *Xavier Noria*
+## Rails 7.0.0.alpha1 (September 15, 2021) ##
 
-*   Depends on Zeitwerk 2, which stores less metadata if reloading is disabled
-    and hence uses less memory when `config.cache_classes` is `true`, a standard
-    setup in production.
+*   `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.
 
     *Xavier Noria*
 
-*   In `:zeitwerk` mode, eager load directories in engines and applications only
-    if present in their respective `config.eager_load_paths`.
-
-    A common use case for this is adding `lib` to `config.autoload_paths`, but
-    not to `config.eager_load_paths`. In that configuration, for example, files
-    in the `lib` directory should not be eager loaded.
+*   Private internal classes of `ActiveSupport::Dependencies` have been deleted, like `ActiveSupport::Dependencies::Reference`, `ActiveSupport::Dependencies::Blamable`, and others.
 
     *Xavier Noria*
 
-*   Fix bug in Range comparisons when comparing to an excluded-end Range
-
-    Before:
-
-        (1..10).cover?(1...11) # => false
-
-    After:
-
-        (1..10).cover?(1...11) # => true
-
-    With the same change for `Range#include?` and `Range#===`.
-
-    *Owen Stephens*
-
-*   Use weak references in descendants tracker to allow anonymous subclasses to
-    be garbage collected.
-
-    *Edgars Beigarts*
-
-*   Update `ActiveSupport::Notifications::Instrumenter#instrument` to make
-    passing a block optional. This will let users use
-    `ActiveSupport::Notifications` messaging features outside of
-    instrumentation.
-
-    *Ali Ibrahim*
-
-*   Fix `Time#advance` to work with dates before 1001-03-07
-
-    Before:
-
-        Time.utc(1001, 3, 6).advance(years: -1) # => 1000-03-05 00:00:00 UTC
-
-    After
-
-        Time.utc(1001, 3, 6).advance(years: -1) # => 1000-03-06 00:00:00 UTC
-
-    Note that this doesn't affect `DateTime#advance` as that doesn't use a proleptic calendar.
-
-    *Andrew White*
-
-*   In Zeitwerk mode, engines are now managed by the `main` autoloader. Engines may reference application constants, if the application is reloaded and we do not reload engines, they won't use the reloaded application code.
+*   The private API of `ActiveSupport::Dependencies` has been deleted. That includes methods like `hook!`, `unhook!`, `depend_on`, `require_or_load`, `mechanism`, and many others.
 
     *Xavier Noria*
 
-*   Add support for supplying `locale` to `transliterate` and `parameterize`.
+*   Improves the performance of `ActiveSupport::NumberHelper` formatters by avoiding the use of exceptions as flow control.
 
-        I18n.backend.store_translations(:de, i18n: { transliterate: { rule: { "ü" => "ue" } } })
+    *Mike Dalessio*
 
-        ActiveSupport::Inflector.transliterate("ü", locale: :de) # => "ue"
-        "Fünf autos".parameterize(locale: :de) # => "fuenf-autos"
-        ActiveSupport::Inflector.parameterize("Fünf autos", locale: :de) # => "fuenf-autos"
+*   Removed rescue block from `ActiveSupport::Cache::RedisCacheStore#handle_exception`
 
-    *Kaan Ozkan*, *Sharang Dashputre*
+    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.
 
-*   Allow `Array#excluding` and `Enumerable#excluding` to deal with a passed array gracefully.
+    *Nicholas A. Stuart*
 
-        [ 1, 2, 3, 4, 5 ].excluding([4, 5]) # => [ 1, 2, 3 ]
+*   Allow entirely opting out of deprecation warnings.
 
-    *DHH*
-
-*   Renamed `Array#without` and `Enumerable#without` to `Array#excluding` and `Enumerable#excluding`, to create parity with
-    `Array#including` and `Enumerable#including`. Retained the old names as aliases.
-
-    *DHH*
-
-*   Added `Array#including` and `Enumerable#including` to conveniently enlarge a collection with more members using a method rather than an operator:
+    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.
 
-        [ 1, 2, 3 ].including(4, 5) # => [ 1, 2, 3, 4, 5 ]
-        post.authors.including(Current.person) # => All the authors plus the current person!
+    Now, you can make `ActiveSupport::Deprecation.warn` a no-op:
 
-    *DHH*
-
-
-## Rails 6.0.0.beta3 (March 11, 2019) ##
-
-*   No changes.
-
-
-## Rails 6.0.0.beta2 (February 25, 2019) ##
-
-*   New autoloading based on [Zeitwerk](https://github.com/fxn/zeitwerk).
-
-    *Xavier Noria*
-
-*   Revise `ActiveSupport::Notifications.unsubscribe` to correctly handle Regex or other multiple-pattern subscribers.
-
-    *Zach Kemp*
-
-*   Add `before_reset` callback to `CurrentAttributes` and define `after_reset` as an alias of `resets` for symmetry.
-
-    *Rosa Gutierrez*
-
-*   Remove the `` Kernel#` `` override that suppresses ENOENT and accidentally returns nil on Unix systems.
-
-    *Akinori Musha*
-
-*   Add `ActiveSupport::HashWithIndifferentAccess#assoc`.
-
-    `assoc` can now be called with either a string or a symbol.
-
-    *Stefan Schüßler*
-
-*   Add `Hash#deep_transform_values`, and `Hash#deep_transform_values!`.
-
-    *Guillermo Iguaran*
-
-
-## Rails 6.0.0.beta1 (January 18, 2019) ##
-
-*   Remove deprecated `Module#reachable?` method.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated `#acronym_regex` method from `Inflections`.
-
-    *Rafael Mendonça França*
-
-*   Fix `String#safe_constantize` throwing a `LoadError` for incorrectly cased constant references.
-
-    *Keenan Brock*
-
-*   Preserve key order passed to `ActiveSupport::CacheStore#fetch_multi`.
-
-    `fetch_multi(*names)` now returns its results in the same order as the `*names` requested, rather than returning cache hits followed by cache misses.
-
-    *Gannon McGibbon*
-
-*   If the same block is `included` multiple times for a Concern, an exception is no longer raised.
-
-    *Mark J. Titorenko*, *Vlad Bokov*
-
-*   Fix bug where `#to_options` for `ActiveSupport::HashWithIndifferentAccess`
-    would not act as alias for `#symbolize_keys`.
-
-    *Nick Weiland*
-
-*   Improve the logic that detects non-autoloaded constants.
-
-    *Jan Habermann*, *Xavier Noria*
-
-*   Deprecate `ActiveSupport::Multibyte::Unicode#pack_graphemes(array)` and `ActiveSupport::Multibyte::Unicode#unpack_graphemes(string)`
-    in favor of `array.flatten.pack("U*")` and `string.scan(/\X/).map(&:codepoints)`, respectively.
-
-    *Francesco Rodríguez*
-
-*   Deprecate `ActiveSupport::Multibyte::Chars.consumes?` in favor of `String#is_utf8?`.
-
-    *Francesco Rodríguez*
-
-*   Fix duration being rounded to a full second.
-    ```
-      time = DateTime.parse("2018-1-1")
-      time += 0.51.seconds
+    ```ruby
+    config.active_support.report_deprecations = false
     ```
-    Will now correctly add 0.51 second and not 1 full second.
-
-    *Edouard Chin*
-
-*   Deprecate `ActiveSupport::Multibyte::Unicode#normalize` and `ActiveSupport::Multibyte::Chars#normalize`
-    in favor of `String#unicode_normalize`
-
-    *Francesco Rodríguez*
-
-*   Deprecate `ActiveSupport::Multibyte::Unicode#downcase/upcase/swapcase` in favor of
-    `String#downcase/upcase/swapcase`.
-
-    *Francesco Rodríguez*
-
-*   Add `ActiveSupport::ParameterFilter`.
-
-    *Yoshiyuki Kinjo*
-
-*   Rename `Module#parent`, `Module#parents`, and `Module#parent_name` to
-    `module_parent`, `module_parents`, and `module_parent_name`.
 
-    *Gannon McGibbon*
+    This is the default in production for new apps. It is the equivalent to:
 
-*   Deprecate the use of `LoggerSilence` in favor of `ActiveSupport::LoggerSilence`
-
-    *Edouard Chin*
-
-*   Deprecate using negative limits in `String#first` and `String#last`.
-
-    *Gannon McGibbon*, *Eric Turner*
+    ```ruby
+    config.active_support.deprecation = :silence
+    config.active_support.disallowed_deprecation = :silence
+    ```
 
-*   Fix bug where `#without` for `ActiveSupport::HashWithIndifferentAccess` would fail
-    with symbol arguments
+    but will take a more optimised code path.
 
-    *Abraham Chan*
+    *Alex Ghiculescu*
 
-*   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.
+*   Faster tests by parallelizing only when overhead is justified by the number
+    of them.
 
-    *Janosch Müller*
+    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.
 
-*   Changed `ActiveSupport::TaggedLogging.new` to return a new logger instance instead
-    of mutating the one received as parameter.
+    This threshold is 50 by default, and is configurable via config setting in
+    your test.rb:
 
-    *Thierry Joyal*
+    ```ruby
+    config.active_support.test_parallelization_threshold = 100
+    ```
 
-*   Define `unfreeze_time` as an alias of `travel_back` in `ActiveSupport::Testing::TimeHelpers`.
+    It's also configurable at the test case level:
 
-    The alias is provided for symmetry with `freeze_time`.
+    ```ruby
+    class ActiveSupport::TestCase
+      parallelize threshold: 100
+    end
+    ```
 
-    *Ryan Davidson*
+    *Jorge Manrubia*
 
-*   Add support for tracing constant autoloads. Just throw
+*   OpenSSL constants are now used for Digest computations.
 
-        ActiveSupport::Dependencies.logger = Rails.logger
-        ActiveSupport::Dependencies.verbose = true
+    *Dirkjan Bussink*
 
-    in an initializer.
+*   `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`.
 
-    *Xavier Noria*
+    ```ruby
+    twz = ActiveSupport::TimeZone["Eastern Time (US & Canada)"].iso8601("21087")
+    twz.to_a[0, 6] == [0, 0, 0, 28, 03, 2021]
+    ```
 
-*   Maintain `html_safe?` on html_safe strings when sliced.
+    *Steve Laing*
 
-        string = "<div>test</div>".html_safe
-        string[-1..1].html_safe? # => true
+*   `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.
 
-    *Elom Gomez*, *Yumin Wong*
+    Fixes [#42467](https://github.com/rails/rails/issues/42467).
 
-*   Add `Array#extract!`.
+    *Alex Ghiculescu*
 
-    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.
+*   Allow serializing any module or class to JSON by name.
 
-        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]
+    *Tyler Rick*, *Zachary Scott*
 
-    *bogdanvlviv*
+*   Raise `ActiveSupport::EncryptedFile::MissingKeyError` when the
+    `RAILS_MASTER_KEY` environment variable is blank (e.g. `""`).
 
-*   Support not to cache `nil` for `ActiveSupport::Cache#fetch`.
+    *Sunny Ripert*
 
-        cache.fetch('bar', skip_nil: true) { nil }
-        cache.exist?('bar') # => false
+*   The `from:` option is added to `ActiveSupport::TestCase#assert_no_changes`.
 
-    *Martin Hong*
+    It permits asserting on the initial value that is expected not to change.
 
-*   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:
+    ```ruby
+    assert_no_changes -> { Status.all_good? }, from: true do
+      post :create, params: { status: { ok: true } }
+    end
+    ```
 
-        ActiveSupport::Notifications.subscribe('wait') do |*args|
-          @event = ActiveSupport::Notifications::Event.new(*args)
-        end
+    *George Claghorn*
 
-        ActiveSupport::Notifications.instrument('wait') do
-          sleep 1
-        end
+*   Deprecate `ActiveSupport::SafeBuffer`'s incorrect implicit conversion of objects into string.
 
-        @event.duration # => 1000.138
+    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.
 
-    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:
+    *Jean Boussier*
 
-        ActiveSupport::Notifications.subscribe('wait') do |event|
-          @event = event
-        end
+*   Allow nested access to keys on `Rails.application.credentials`.
 
-        ActiveSupport::Notifications.instrument('wait') do
-          sleep 1
-        end
+    Previously only top level keys in `credentials.yml.enc` could be accessed with method calls. Now any key can.
 
-        p @event.allocations # => 7
-        p @event.cpu_time    # => 0.256
-        p @event.idle_time   # => 1003.2399
+    For example, given these secrets:
 
-    Now you can enjoy event objects without making them yourself.  Neat!
+    ```yml
+    aws:
+      access_key_id: 123
+      secret_access_key: 345
+    ```
 
-    *Aaron "t.lo" Patterson*
+    `Rails.application.credentials.aws.access_key_id` will now return the same thing as
+    `Rails.application.credentials.aws[:access_key_id]`.
 
-*   Add cpu_time, idle_time, and allocations to Event.
+    *Alex Ghiculescu*
 
-    *Eileen M. Uchitelle*, *Aaron Patterson*
+*   Added a faster and more compact `ActiveSupport::Cache` serialization format.
 
-*   RedisCacheStore: support key expiry in increment/decrement.
+    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.
 
-    Pass `:expires_in` to `#increment` and `#decrement` to set a Redis EXPIRE on the key.
+    *Jean Boussier*
 
-    If the key is already set to expire, RedisCacheStore won't extend its expiry.
+*   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.
 
-        Rails.cache.increment("some_key", 1, expires_in: 2.minutes)
+    *Asherah Connor*
 
-    *Jason Lee*
+*   Freeze `ActiveSupport::Duration#parts` and remove writer methods.
 
-*   Allow `Range#===` and `Range#cover?` on Range.
+    Durations are meant to be value objects and should not be mutated.
 
-    `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.
+    *Andrew White*
 
-    *Requiring active_support/core_ext/range/include_range is now deprecated.*
-    *Use `require "active_support/core_ext/range/compare_range"` instead.*
+*   Fix `ActiveSupport::TimeZone#utc_to_local` with fractional seconds.
 
-    *utilum*
+    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.
 
-*   Add `index_with` to Enumerable.
+    *Andrew White*
 
-    Allows creating a hash from an enumerable with the value from a passed block
-    or a default argument.
+*   Add `expires_at` argument to `ActiveSupport::Cache` `write` and `fetch` to set a cache entry TTL as an absolute time.
 
-        %i( title body ).index_with { |attr| post.public_send(attr) }
-        # => { title: "hey", body: "what's up?" }
+    ```ruby
+    Rails.cache.write(key, value, expires_at: Time.now.at_end_of_hour)
+    ```
 
-        %i( title body ).index_with(nil)
-        # => { title: nil, body: nil }
+    *Jean Boussier*
 
-    Closely linked with `index_by`, which creates a hash where the keys are extracted from a block.
+*   Deprecate `ActiveSupport::TimeWithZone.name` so that from Rails 7.1 it will use the default implementation.
 
-    *Kasper Timm Hansen*
+    *Andrew White*
 
-*   Fix bug where `ActiveSupport::TimeZone.all` would fail when tzinfo data for
-    any timezone defined in `ActiveSupport::TimeZone::MAPPING` is missing.
+*   Deprecates Rails custom `Enumerable#sum` and `Array#sum` in favor of Ruby's native implementation which
+    is considerably faster.
 
-    *Dominik Sander*
+    Ruby requires an initializer for non-numeric type as per examples below:
 
-*   Redis cache store: `delete_matched` no longer blocks the Redis server.
-    (Switches from evaled Lua to a batched SCAN + DEL loop.)
+    ```ruby
+    %w[foo bar].sum('')
+    # instead of %w[foo bar].sum
 
-    *Gleb Mazovetskiy*
+    [[1, 2], [3, 4, 5]].sum([])
+    # instead of [[1, 2], [3, 4, 5]].sum
+    ```
 
-*   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.
+    *Alberto Mota*
 
-    *Godfrey Chan*
+*   Tests parallelization is now disabled when running individual files to prevent the setup overhead.
 
-*   Fix bug where `URI.unescape` would fail with mixed Unicode/escaped character input:
+    It can still be enforced if the environment variable `PARALLEL_WORKERS` is present and set to a value greater than 1.
 
-        URI.unescape("\xe3\x83\x90")  # => "バ"
-        URI.unescape("%E3%83%90")  # => "バ"
-        URI.unescape("\xe3\x83\x90%E3%83%90")  # => Encoding::CompatibilityError
+    *Ricardo Díaz*
 
-    *Ashe Connor*, *Aaron Patterson*
+*   Fix proxying keyword arguments in `ActiveSupport::CurrentAttributes`.
 
-*   Add `before?` and `after?` methods to `Date`, `DateTime`,
-    `Time`, and `TimeWithZone`.
+    *Marcin Kołodziej*
 
-    *Nick Holden*
+*   Add `Enumerable#maximum` and `Enumerable#minimum` to easily calculate the maximum or minimum from extracted
+    elements of an enumerable.
 
-*   `ActiveSupport::Inflector#ordinal` and `ActiveSupport::Inflector#ordinalize` now support
-    translations through I18n.
+    ```ruby
+    payments = [Payment.new(5), Payment.new(15), Payment.new(10)]
 
-        # locale/fr.rb
+    payments.minimum(:price) # => 5
+    payments.maximum(:price) # => 15
+    ```
 
-        {
-          fr: {
-            number: {
-              nth: {
-                ordinals: lambda do |_key, number:, **_options|
-                  if number.to_i.abs == 1
-                    'er'
-                  else
-                    'e'
-                  end
-                end,
+    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.
 
-                ordinalized: lambda do |_key, number:, **_options|
-                  "#{number}#{ActiveSupport::Inflector.ordinal(number)}"
-                end
-              }
-            }
-          }
-        }
+    *Ayrton De Craene*
 
+*   `ActiveSupport::Cache::MemCacheStore` now accepts an explicit `nil` for its `addresses` argument.
 
-    *Christian Blais*
+    ```ruby
+    config.cache_store = :mem_cache_store, nil
 
-*   Add `:private` option to ActiveSupport's `Module#delegate`
-    in order to delegate methods as private:
+    # is now equivalent to
 
-        class User < ActiveRecord::Base
-          has_one :profile
-          delegate :date_of_birth, to: :profile, private: true
+    config.cache_store = :mem_cache_store
 
-          def age
-            Date.today.year - date_of_birth.year
-          end
-        end
+    # and is also equivalent to
 
-        # User.new.age  # => 29
-        # User.new.date_of_birth
-        # => NoMethodError: private method `date_of_birth' called for #<User:0x00000008221340>
+    config.cache_store = :mem_cache_store, ENV["MEMCACHE_SERVERS"] || "localhost:11211"
 
-    *Tomas Valent*
+    # which is the fallback behavior of Dalli
+    ```
 
-*   `String#truncate_bytes` to truncate a string to a maximum bytesize without
-    breaking multibyte characters or grapheme clusters like 👩‍👩‍👦‍👦.
+    This helps those migrating from `:dalli_store`, where an explicit `nil` was permitted.
 
-    *Jeremy Daer*
+    *Michael Overmeyer*
 
-*   `String#strip_heredoc` preserves frozenness.
+*   Add `Enumerable#in_order_of` to put an Enumerable in a certain order by a key.
 
-        "foo".freeze.strip_heredoc.frozen?  # => true
+    *DHH*
 
-    Fixes that frozen string literals would inadvertently become unfrozen:
+*   `ActiveSupport::Inflector.camelize` behaves expected when provided a symbol `:upper` or `:lower` argument. Matches
+    `String#camelize` behavior.
 
-        # frozen_string_literal: true
+    *Alex Ghiculescu*
 
-        foo = <<-MSG.strip_heredoc
-          la la la
-        MSG
+*   Raises an `ArgumentError` when the first argument of `ActiveSupport::Notification.subscribe` is
+    invalid.
 
-        foo.frozen?  # => false !??
+    *Vipul A M*
 
-    *Jeremy Daer*
+*   `HashWithIndifferentAccess#deep_transform_keys` now returns a `HashWithIndifferentAccess` instead of a `Hash`.
 
-*   Rails 6 requires Ruby 2.5.0 or newer.
+    *Nathaniel Woodthorpe*
 
-    *Jeremy Daer*, *Kasper Timm Hansen*
+*   Consume dalli’s `cache_nils` configuration as `ActiveSupport::Cache`'s `skip_nil` when using `MemCacheStore`.
 
-*   Adds parallel testing to Rails.
+    *Ritikesh G*
 
-    Parallelize your test suite with forked processes or threads.
+*   Add `RedisCacheStore#stats` method similar to `MemCacheStore#stats`. Calls `redis#info` internally.
 
-    *Eileen M. Uchitelle*, *Aaron Patterson*
+    *Ritikesh G*
 
 
-Please check [5-2-stable](https://github.com/rails/rails/blob/5-2-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.