activesupport 5.0.0 → 6.1.0

data/CHANGELOG.md

@@ -1,798 +1,551 @@
-## Rails 5.0.0 (June 30, 2016) ##
+## Rails 6.1.0 (December 09, 2020) ##
 
-*   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.
+*   Ensure `MemoryStore` disables compression by default. Reverts behavior of
+    `MemoryStore` to its prior rails `5.1` behavior.
 
-    *Grzegorz Witek*
+    *Max Gurewitz*
 
-*   `Date.to_s` doesn't produce too many spaces. For example, `to_s(:short)`
-    will now produce `01 Feb` instead of ` 1 Feb`.
+*   Calling `iso8601` on negative durations retains the negative sign on individual
+    digits instead of prepending it.
 
-    Fixes #25251.
+    This change is required so we can interoperate with PostgreSQL, which prefers
+    negative signs for each component.
 
-    *Sean Griffin*
+    Compatibility with other iso8601 parsers which support leading negatives as well
+    as negatives per component is still retained.
 
-*   Rescuable: If a handler doesn't match the exception, check for handlers
-    matching the exception's cause.
-
-    *Jeremy Daer*
-
-*   `ActiveSupport::Duration` supports weeks and hours.
-
-        [1.hour.inspect, 1.hour.value, 1.hour.parts]
-        # => ["3600 seconds", 3600, [[:seconds, 3600]]]   # Before
-        # => ["1 hour", 3600, [[:hours, 1]]]              # After
+    Before:
 
-        [1.week.inspect, 1.week.value, 1.week.parts]
-        # => ["7 days", 604800, [[:days, 7]]]             # Before
-        # => ["1 week", 604800, [[:weeks, 1]]]            # After
+        (-1.year - 1.day).iso8601
+        # => "-P1Y1D"
 
-    This brings us into closer conformance with ISO8601 and relieves some
-    astonishment about getting `1.hour.inspect # => 3600 seconds`.
+    After:
 
-    Compatibility: The duration's `value` remains the same, so apps using
-    durations are oblivious to the new time periods. Apps, libraries, and
-    plugins that work with the internal `parts` hash will need to broaden
-    their time period handling to cover hours & weeks.
+        (-1.year - 1.day).iso8601
+        # => "P-1Y-1D"
 
-    *Andrey Novikov*
+    *Vipul A M*
 
-*   Time zones: Ensure that the UTC offset reflects DST changes that occurred
-    since the app started. Removes UTC offset caching, reducing performance,
-    but this is still relatively quick and isn't in any hot paths.
+*   Remove deprecated `ActiveSupport::Notifications::Instrumenter#end=`.
 
-    *Alexey Shein*
+    *Rafael Mendonça França*
 
-*   Make `getlocal` and `getutc` always return instances of `Time` for
-    `ActiveSupport::TimeWithZone` and `DateTime`. This eliminates a possible
-    stack level too deep error in `to_time` where `ActiveSupport::TimeWithZone`
-    was wrapping a `DateTime` instance. As a consequence of this the internal
-    time value in `ActiveSupport::TimeWithZone` is now always an instance of
-    `Time` in the UTC timezone, whether that's as the UTC time directly or
-    a representation of the local time in the timezone. There should be no
-    consequences of this internal change and if there are it's a bug due to
-    leaky abstractions.
+*   Deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `DateTime#subsec` to return the fraction of a second as a `Rational`.
+*   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 additional aliases for `DateTime#utc` to mirror the ones on
-    `ActiveSupport::TimeWithZone` and `Time`.
+*   Remove deprecated `ActiveSupport::Multibyte::Chars#consumes?` and `ActiveSupport::Multibyte::Chars#normalize`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `DateTime#localtime` to return an instance of `Time` in the system's
-    local timezone. Also aliased to `getlocal`.
+*   Remove deprecated file `active_support/core_ext/range/include_range`.
 
-    *Andrew White*, *Yuichiro Kaneko*
+    *Rafael Mendonça França*
 
-*   Add `Time#sec_fraction` to return the fraction of a second as a `Rational`.
+*   Remove deprecated file `active_support/core_ext/hash/transform_values`.
 
-    *Andrew White*
+    *Rafael Mendonça França*
 
-*   Add `ActiveSupport.to_time_preserves_timezone` config option to control
-    how `to_time` handles timezones. In Ruby 2.4+ the behavior will change
-    from converting to the local system timezone, to preserving the timezone
-    of the receiver. This config option defaults to false so that apps made
-    with earlier versions of Rails are not affected when upgrading, e.g:
+*   Remove deprecated file `active_support/core_ext/hash/compact`.
 
-        >> ENV['TZ'] = 'US/Eastern'
+    *Rafael Mendonça França*
 
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T06:23:12.000-04:00"
+*   Remove deprecated file `active_support/core_ext/array/prepend_and_append`.
 
-        >> ActiveSupport.to_time_preserves_timezone = true
+    *Rafael Mendonça França*
 
-        >> "2016-04-23T10:23:12.000Z".to_time
-        => "2016-04-23T10:23:12.000Z"
+*   Remove deprecated file `active_support/core_ext/numeric/inquiry`.
 
-    Fixes #24617.
+    *Rafael Mendonça França*
 
-    *Andrew White*
+*   Remove deprecated file `active_support/core_ext/module/reachable`.
 
-*   `ActiveSupport::TimeZone.country_zones(country_code)` looks up the
-    country's time zones by its two-letter ISO3166 country code, e.g.
+    *Rafael Mendonça França*
 
-        >> ActiveSupport::TimeZone.country_zones(:jp).map(&:to_s)
-        => ["(GMT+09:00) Osaka"]
+*   Remove deprecated `Module#parent_name`, `Module#parent` and `Module#parents`.
 
-        >> ActiveSupport::TimeZone.country_zones(:uy).map(&:to_s)
-        => ["(GMT-03:00) Montevideo"]
+    *Rafael Mendonça França*
 
-    *Andrey Novikov*
+*   Remove deprecated `ActiveSupport::LoggerThreadSafeLevel#after_initialize`.
 
-*   `Array#sum` compat with Ruby 2.4's native method.
+    *Rafael Mendonça França*
 
-    Ruby 2.4 introduces `Array#sum`, but it only supports numeric elements,
-    breaking our `Enumerable#sum` which supports arbitrary `Object#+`.
-    To fix, override `Array#sum` with our compatible implementation.
+*   Remove deprecated `LoggerSilence` constant.
 
-    Native Ruby 2.4:
+    *Rafael Mendonça França*
 
-        %w[ a b ].sum
-        # => TypeError: String can't be coerced into Fixnum
+*   Remove deprecated fallback to `I18n.default_local` when `config.i18n.fallbacks` is empty.
 
-    With `Enumerable#sum` shim:
+    *Rafael Mendonça França*
 
-        %w[ a b ].sum
-        # => 'ab'
+*   Remove entries from local cache on `RedisCacheStore#delete_matched`
 
-    We tried shimming the fast path and falling back to the compatible path
-    if it fails, but that ends up slower even in simple cases due to the cost
-    of exception handling. Our only choice is to override the native `Array#sum`
-    with our `Enumerable#sum`.
+    Fixes #38627
 
-    *Jeremy Daer*
+    *ojab*
 
-*   `ActiveSupport::Duration` supports ISO8601 formatting and parsing.
+*   Speed up `ActiveSupport::SecurityUtils.fixed_length_secure_compare` by using
+    `OpenSSL.fixed_length_secure_compare`, if available.
 
-        ActiveSupport::Duration.parse('P3Y6M4DT12H30M5S')
-        # => 3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds
+    *Nate Matykiewicz*
 
-        (3.years + 3.days).iso8601
-        # => "P3Y3D"
+*   `ActiveSupport::Cache::MemCacheStore` now checks `ENV["MEMCACHE_SERVERS"]` before falling back to `"localhost:11211"` if configured without any addresses.
 
-    Inspired by Arnau Siches' [ISO8601 gem](https://github.com/arnau/ISO8601/)
-    and rewritten by Andrey Novikov with suggestions from Andrew White. Test
-    data from the ISO8601 gem redistributed under MIT license.
+    ```ruby
+    config.cache_store = :mem_cache_store
 
-    (Will be used to support the PostgreSQL interval data type.)
+    # is now equivalent to
 
-    *Andrey Novikov*, *Arnau Siches*, *Andrew White*
+    config.cache_store = :mem_cache_store, ENV["MEMCACHE_SERVERS"] || "localhost:11211"
 
-*   `Cache#fetch(key, force: true)` forces a cache miss, so it must be called
-    with a block to provide a new value to cache. Fetching with `force: true`
-    but without a block now raises ArgumentError.
+    # instead of
 
-        cache.fetch('key', force: true) # => ArgumentError
+    config.cache_store = :mem_cache_store, "localhost:11211" # ignores ENV["MEMCACHE_SERVERS"]
+    ```
 
-    *Santosh Wadghule*
+    *Sam Bostock*
 
-*   Fix behavior of JSON encoding for `Exception`.
+*   `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).
 
-    *namusyaka*
+    ```ruby
+    class ActionControllerSubscriber < ActiveSupport::Subscriber
+      attach_to :action_controller
 
-*   Make `number_to_phone` format number with regexp pattern.
+      def start_processing(event)
+        info "Processing by #{event.payload[:controller]}##{event.payload[:action]} as #{format}"
+      end
 
-        number_to_phone(18812345678, pattern: /(\d{3})(\d{4})(\d{4})/)
-        # => 188-1234-5678
+      def redirect_to(event)
+        info { "Redirected to #{event.payload[:location]}" }
+      end
+    end
 
-    *Pan Gaoyong*
+    # 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)
 
-*   Match `String#to_time`'s behaviour to that of ruby's implementation for edge cases.
+    class CustomActionControllerSubscriber < ActionControllerSubscriber
+      attach_to :action_controller, inherit_all: true
 
-    `nil` is now returned instead of the current date if the string provided does
-    contain time information, but none that is used to build the `Time` object.
+      def start_processing(event)
+        info "A custom response to start_processing events"
+      end
 
-    Fixes #22958.
+      # => 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
+    ```
 
-    *Siim Liiser*
+    *Adrianna Chang*
 
-*   Rely on the native DateTime#<=> implementation to handle non-datetime like
-    objects instead of returning `nil` ourselves. This restores the ability
-    of `DateTime` instances to be compared with a `Numeric` that represents an
-    astronomical julian day number.
+*   Allow the digest class used to generate non-sensitive digests to be configured with `config.active_support.hash_digest_class`.
 
-    Fixes #24228.
+    `config.active_support.use_sha1_digests` is deprecated in favour of `config.active_support.hash_digest_class = ::Digest::SHA1`.
 
-    *Andrew White*
+    *Dirkjan Bussink*
 
-*   Add `String#upcase_first` method.
+*   Fix bug to make memcached write_entry expire correctly with unless_exist
 
-    *Glauco Custódio*, *bogdanvlviv*
+    *Jye Lee*
 
-*   Prevent `Marshal.load` from looping infinitely when trying to autoload a constant
-    which resolves to a different name.
+*   Add `ActiveSupport::Duration` conversion methods
 
-    *Olek Janiszewski*
+    `in_seconds`, `in_minutes`, `in_hours`, `in_days`, `in_weeks`, `in_months`, and `in_years` return the respective duration covered.
 
-*   Deprecate `Module.local_constants`. Please use `Module.constants(false)` instead.
+    *Jason York*
 
-    *Yuichiro Kaneko*
+*   Fixed issue in `ActiveSupport::Cache::RedisCacheStore` not passing options
+    to `read_multi` causing `fetch_multi` to not work properly
 
-*   Publish `ActiveSupport::Executor` and `ActiveSupport::Reloader` APIs to allow
-    components and libraries to manage, and participate in, the execution of
-    application code, and the application reloading process.
+    *Rajesh Sharma*
 
-    *Matthew Draper*
+*   Fixed issue in `ActiveSupport::Cache::MemCacheStore` which caused duplicate compression,
+    and caused the provided `compression_threshold` to not be respected.
 
-*   Deprecate arguments on `assert_nothing_raised`.
+    *Max Gurewitz*
 
-    `assert_nothing_raised` does not assert the arguments that have been passed
-    in (usually a specific exception class) since the method only yields the
-    block. So as not to confuse the users that the arguments have meaning, they
-    are being deprecated.
+*   Prevent `RedisCacheStore` and `MemCacheStore` from performing compression
+    when reading entries written with `raw: true`.
 
-    *Tara Scherner de la Fuente*
+    *Max Gurewitz*
 
-*   Make `benchmark('something', silence: true)` actually work.
+*   `URI.parser` is deprecated and will be removed in Rails 6.2. Use
+    `URI::DEFAULT_PARSER` instead.
 
-    *DHH*
+    *Jean Boussier*
 
-*   Add `#on_weekday?` method to `Date`, `Time`, and `DateTime`.
+*   `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.
 
-    `#on_weekday?` returns `true` if the receiving date/time does not fall on a Saturday
-    or Sunday.
+    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.
 
-    *Vipul A M*
+    *Xavier Noria*
 
-*   Add `Array#second_to_last` and `Array#third_to_last` methods.
+*   Add 3rd person aliases of `Symbol#start_with?` and `Symbol#end_with?`.
 
-    *Brian Christian*
+    ```ruby
+    :foo.starts_with?("f") # => true
+    :foo.ends_with?("o")   # => true
+    ```
 
-*   Fix regression in `Hash#dig` for HashWithIndifferentAccess.
+    *Ryuta Kamizono*
 
-    *Jon Moss*
+*   Add override of unary plus for `ActiveSupport::Duration`.
 
-*   Change `number_to_currency` behavior for checking negativity.
+    `+ 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.
 
-    Used `to_f.negative` instead of using `to_f.phase` for checking negativity
-    of a number in number_to_currency helper.
-    This change works same for all cases except when number is "-0.0".
+    Before:
+    ```ruby
+    +1.second.class
+    # => ActiveSupport::Duration
+    (+ 1.second).class
+    # => Integer
+    ```
 
-        -0.0.to_f.negative? => false
-        -0.0.to_f.phase? => 3.14
+    After:
+    ```ruby
+    +1.second.class
+    # => ActiveSupport::Duration
+    (+ 1.second).class
+    # => ActiveSupport::Duration
+    ```
 
-    This change reverts changes from https://github.com/rails/rails/pull/6512.
-    But it should be acceptable as we could not find any currency which
-    supports negative zeros.
+    Fixes #39079.
 
-    *Prathamesh Sonpatki*, *Rafael Mendonça França*
+    *Roman Kushnir*
 
-*   Match `HashWithIndifferentAccess#default`'s behaviour with `Hash#default`.
+*   Add subsec to `ActiveSupport::TimeWithZone#inspect`.
 
-    *David Cornu*
+    Before:
 
-*   Adds `:exception_object` key to `ActiveSupport::Notifications::Instrumenter`
-    payload when an exception is raised.
+        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"
 
-    Adds new key/value pair to payload when an exception is raised:
-    e.g. `:exception_object => #<RuntimeError: FAIL>`.
+    After:
 
-    *Ryan T. Hosford*
+        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"
 
-*   Support extended grapheme clusters and UAX 29.
+    *akinomaeni*
 
-    *Adam Roben*
+*   Calling `ActiveSupport::TaggedLogging#tagged` without a block now returns a tagged logger.
 
-*   Add petabyte and exabyte numeric conversion.
+    ```ruby
+    logger.tagged("BCX").info("Funky time!") # => [BCX] Funky time!
+    ```
 
-    *Akshay Vishnoi*
+    *Eugene Kenny*
 
-*   Add thread_m/cattr_accessor/reader/writer suite of methods for declaring class and module variables that live per-thread.
-    This makes it easy to declare per-thread globals that are encapsulated. Note: This is a sharp edge. A wild proliferation
-    of globals is A Bad Thing. But like other sharp tools, when it's right, it's right.
+*   Align `Range#cover?` extension behavior with Ruby behavior for backwards ranges.
 
-    Here's an example of a simple event tracking system where the object being tracked needs not pass a creator that it
-    doesn't need itself along:
+    `(1..10).cover?(5..3)` now returns `false`, as it does in plain Ruby.
 
-        module Current
-          thread_mattr_accessor :account
-          thread_mattr_accessor :user
+    Also update `#include?` and `#===` behavior to match.
 
-          def self.reset() self.account = self.user = nil end
-        end
+    *Michael Groeneman*
 
-        class ApplicationController < ActionController::Base
-          before_action :set_current
-          after_action { Current.reset }
+*   Update to TZInfo v2.0.0.
 
-          private
-            def set_current
-              Current.account = Account.find(params[:account_id])
-              Current.user    = Current.account.users.find(params[:user_id])
-            end
-        end
+    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.
 
-        class MessagesController < ApplicationController
-          def create
-            @message = Message.create!(message_params)
-          end
-        end
+    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
 
-        class Message < ApplicationRecord
-          has_many :events
-          after_create :track_created
+    See the `utc_to_local_returns_utc_offset_times` documentation for details.
 
-          private
-            def track_created
-              events.create! origin: self, action: :create
-            end
-        end
+    *Phil Ross*, *Jared Beck*
 
-        class Event < ApplicationRecord
-          belongs_to :creator, class_name: 'User'
-          before_validation { self.creator ||= Current.user }
-        end
+*   Add Date and Time `#yesterday?` and `#tomorrow?` alongside `#today?`.
 
-    *DHH*
+    Aliased to `#prev_day?` and `#next_day?` to match the existing `#prev/next_day` methods.
 
+    *Jatin Dhankhar*
 
-*   Deprecated `Module#qualified_const_` in favour of the builtin Module#const_
-    methods.
+*   Add `Enumerable#pick` to complement `ActiveRecord::Relation#pick`.
 
-    *Genadi Samokovarov*
+    *Eugene Kenny*
 
-*   Deprecate passing string to define callback.
+*   [Breaking change] `ActiveSupport::Callbacks#halted_callback_hook` now receive a 2nd argument:
 
-    *Yuichiro Kaneko*
+    `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.
 
-*   `ActiveSupport::Cache::Store#namespaced_key`,
-    `ActiveSupport::Cache::MemCachedStore#escape_key`, and
-    `ActiveSupport::Cache::FileStore#key_file_path`
-    are deprecated and replaced with `normalize_key` that now calls `super`.
+    ```ruby
+      class Book < ApplicationRecord
+        before_save { throw(:abort) }
+        before_create { throw(:abort) }
 
-    `ActiveSupport::Cache::LocaleCache#set_cache_value` is deprecated and replaced with `write_cache_value`.
+        def halted_callback_hook(filter, callback_name)
+          Rails.logger.info("Book couldn't be #{callback_name}d")
+        end
 
-    *Michael Grosser*
+        Book.create # => "Book couldn't be created"
+        book.save # => "Book couldn't be saved"
+      end
+    ```
 
-*   Implements an evented file watcher to asynchronously detect changes in the
-    application source code, routes, locales, etc.
+    *Edouard Chin*
 
-    This watcher is disabled by default, applications my enable it in the configuration:
+*   Support `prepend` with `ActiveSupport::Concern`.
 
-        # config/environments/development.rb
-        config.file_watcher = ActiveSupport::EventedFileUpdateChecker
+    Allows a module with `extend ActiveSupport::Concern` to be prepended.
 
-    This feature depends on the [listen](https://github.com/guard/listen) gem:
+        module Imposter
+          extend ActiveSupport::Concern
 
-        group :development do
-          gem 'listen', '~> 3.0.5'
+          # Same as `included`, except only run when prepended.
+          prepended do
+          end
         end
 
-    *Puneet Agarwal* and *Xavier Noria*
+        class Person
+          prepend Imposter
+        end
 
-*   Added `Time.days_in_year` to return the number of days in the given year, or the
-    current year if no argument is provided.
+    Class methods are prepended to the base class, concerning is also
+    updated: `concerning :Imposter, prepend: true do`.
 
-    *Jon Pascoe*
+    *Jason Karns*, *Elia Schito*
 
-*   Updated `parameterize` to preserve the case of a string, optionally.
+*   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.
 
-    Example:
+    *Vishal Telangre*
 
-        parameterize("Donald E. Knuth", separator: '_') # => "donald_e_knuth"
-        parameterize("Donald E. Knuth", preserve_case: true) # => "Donald-E-Knuth"
+*   Support added for a `round_mode` parameter, in all number helpers. (See: `BigDecimal::mode`.)
 
-    *Swaathi Kakarla*
+    ```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"
 
-*   `HashWithIndifferentAccess.new` respects the default value or proc on objects
-    that respond to `#to_hash`. `.new_from_hash_copying_default` simply invokes `.new`.
-    All calls to `.new_from_hash_copying_default` are replaced with `.new`.
+    485000.to_s(:human, precision: 2, round_mode: :half_even) # => "480 Thousand"
+    ```
 
-    *Gordon Chan*
+    *Tom Lord*
 
-*   Change Integer#year to return a Fixnum instead of a Float to improve
-    consistency.
-
-    Integer#years returned a Float while the rest of the accompanying methods
-    (days, weeks, months, etc.) return a Fixnum.
+*   `Array#to_sentence` no longer returns a frozen string.
 
     Before:
 
-    1.year # => 31557600.0
+        ['one', 'two'].to_sentence.frozen?
+        # => true
 
     After:
 
-    1.year # => 31557600
-
-    *Konstantinos Rousis*
+        ['one', 'two'].to_sentence.frozen?
+        # => false
 
-*   Handle invalid UTF-8 strings when HTML escaping.
+    *Nicolas Dular*
 
-    Use `ActiveSupport::Multibyte::Unicode.tidy_bytes` to handle invalid UTF-8
-    strings in `ERB::Util.unwrapped_html_escape` and `ERB::Util.html_escape_once`.
-    Prevents user-entered input passed from a querystring into a form field from
-    causing invalid byte sequence errors.
+*   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.
 
-    *Grey Baker*
+    ```ruby
+    duration = ActiveSupport::Duration.build(1000000)
+    # 1 week, 4 days, 13 hours, 46 minutes, and 40.0 seconds
 
-*   Update `ActiveSupport::Multibyte::Chars#slice!` to return `nil` if the
-    arguments are out of bounds, to mirror the behavior of `String#slice!`
+    duration_iso = duration.iso8601
+    # P11DT13H46M40S
 
-    *Gourav Tiwari*
+    ActiveSupport::Duration.parse(duration_iso)
+    # 11 days, 13 hours, 46 minutes, and 40 seconds
 
-*   Fix `number_to_human` so that 999999999 rounds to "1 Billion" instead of
-    "1000 Million".
+    duration = ActiveSupport::Duration.build(604800)
+    # 1 week
 
-    *Max Jacobson*
+    duration_iso = duration.iso8601
+    # P1W
 
-*   Fix `ActiveSupport::Deprecation#deprecate_methods` to report using the
-    current deprecator instance, where applicable.
+    ActiveSupport::Duration.parse(duration_iso)
+    # 1 week
+    ```
 
-    *Brandon Dunne*
+    *Abhishek Sarkar*
 
-*   `Cache#fetch` instrumentation marks whether it was a `:hit`.
+*   Add block support to `ActiveSupport::Testing::TimeHelpers#travel_back`.
 
-    *Robin Clowers*
+    *Tim Masliuchenko*
 
-*   `assert_difference` and `assert_no_difference` now returns the result of the
-    yielded block.
+*   Update `ActiveSupport::Messages::Metadata#fresh?` to work for cookies with expiry set when
+    `ActiveSupport.parse_json_times = true`.
 
-    Example:
-
-      post = assert_difference -> { Post.count }, 1 do
-        Post.create
-      end
+    *Christian Gregg*
 
-    *Lucas Mazza*
+*   Support symbolic links for `content_path` in `ActiveSupport::EncryptedFile`.
 
-*   Short-circuit `blank?` on date and time values since they are never blank.
+    *Takumi Shotoku*
 
-    Fixes #21657.
+*   Improve `Range#===`, `Range#include?`, and `Range#cover?` to work with beginless (startless)
+    and endless range targets.
 
-    *Andrew White*
+    *Allen Hsu*, *Andrew Hodgkinson*
 
-*   Replaced deprecated `ThreadSafe::Cache` with its successor `Concurrent::Map` now that
-    the thread_safe gem has been merged into concurrent-ruby.
+*   Don't use `Process#clock_gettime(CLOCK_THREAD_CPUTIME_ID)` on Solaris.
 
-    *Jerry D'Antonio*
+    *Iain Beeston*
 
-*   Updated Unicode version to 8.0.0
+*   Prevent `ActiveSupport::Duration.build(value)` from creating instances of
+    `ActiveSupport::Duration` unless `value` is of type `Numeric`.
 
-    *Anshul Sharma*
+    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`.
 
-*   `number_to_currency` and `number_with_delimiter` now accept custom `delimiter_pattern` option
-     to handle placement of delimiter, to support currency formats like INR
+    Before:
 
-     Example:
+        small_duration_from_string = ActiveSupport::Duration.build('9')
+        large_duration_from_string = ActiveSupport::Duration.build('100000000000000')
+        small_duration_from_int = ActiveSupport::Duration.build(9)
 
-        number_to_currency(1230000, delimiter_pattern: /(\d+?)(?=(\d\d)+(\d)(?!\d))/, unit: '₹', format: "%u %n")
-        # => '₹ 12,30,000.00'
+        large_duration_from_string > small_duration_from_string
+        # => false
 
-    *Vipul A M*
+        small_duration_from_string == small_duration_from_int
+        # => false
 
-*   Deprecate `:prefix` option of `number_to_human_size` with no replacement.
+        small_duration_from_int < large_duration_from_string
+        # => ArgumentError (comparison of ActiveSupport::Duration::Scalar with ActiveSupport::Duration failed)
 
-    *Jean Boussier*
+        large_duration_from_string > small_duration_from_int
+        # => ArgumentError (comparison of String with ActiveSupport::Duration failed)
 
-*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
-        twz = DateTime.now.in_time_zone
-        twz.eql?(twz.dup) => true
+    After:
 
-    Fixes #14178.
+        small_duration_from_string = ActiveSupport::Duration.build('9')
+        # => TypeError (can't build an ActiveSupport::Duration from a String)
 
-    *Roque Pinel*
+    *Alexei Emam*
 
-*   ActiveSupport::HashWithIndifferentAccess `select` and `reject` will now return
-    enumerator if called without block.
+*   Add `ActiveSupport::Cache::Store#delete_multi` method to delete multiple keys from the cache store.
 
-    Fixes #20095.
+    *Peter Zhu*
 
-    *Bernard Potocki*
+*   Support multiple arguments in `HashWithIndifferentAccess` for `merge` and `update` methods, to
+    follow Ruby 2.6 addition.
 
-*   Removed `ActiveSupport::Concurrency::Latch`, superseded by `Concurrent::CountDownLatch`
-    from the concurrent-ruby gem.
+    *Wojciech Wnętrzak*
 
-    *Jerry D'Antonio*
+*   Allow initializing `thread_mattr_*` attributes via `:default` option.
 
-*   Fix not calling `#default` on `HashWithIndifferentAccess#to_hash` when only
-    `default_proc` is set, which could raise.
+        class Scraper
+          thread_mattr_reader :client, default: Api::Client.new
+        end
 
-    *Simon Eskildsen*
+    *Guilherme Mansur*
 
-*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`.
+*   Add `compact_blank` for those times when you want to remove #blank? values from
+    an Enumerable (also `compact_blank!` on Hash, Array, ActionController::Parameters).
 
-    *Simon Eskildsen*
+    *Dana Sherson*
 
-*   Fix a range of values for parameters of the Time#change.
+*   Make ActiveSupport::Logger Fiber-safe.
 
-    *Nikolay Kondratyev*
+    Use `Fiber.current.__id__` in `ActiveSupport::Logger#local_level=` in order
+    to make log level local to Ruby Fibers in addition to Threads.
 
-*   Add `Enumerable#pluck` to get the same values from arrays as from ActiveRecord
-    associations.
+    Example:
 
-    Fixes #20339.
+        logger = ActiveSupport::Logger.new(STDOUT)
+        logger.level = 1
+        puts "Main is debug? #{logger.debug?}"
 
-    *Kevin Deisz*
+        Fiber.new {
+          logger.local_level = 0
+          puts "Thread is debug? #{logger.debug?}"
+        }.resume
 
-*   Add a bang version to `ActiveSupport::OrderedOptions` get methods which will raise
-    an `KeyError` if the value is `.blank?`.
+        puts "Main is debug? #{logger.debug?}"
 
     Before:
 
-        if (slack_url = Rails.application.secrets.slack_url).present?
-          # Do something worthwhile
-        else
-          # Raise as important secret password is not specified
-        end
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? true
 
     After:
 
-        slack_url = Rails.application.secrets.slack_url!
-
-    *Aditya Sanghi*, *Gaurish Sharma*
-
-*   Remove deprecated `Class#superclass_delegating_accessor`.
-    Use `Class#class_attribute` instead.
-
-    *Akshay Vishnoi*
-
-*   Patch `Delegator` to work with `#try`.
-
-    Fixes #5790.
-
-    *Nate Smith*
-
-*   Add `Integer#positive?` and `Integer#negative?` query methods
-    in the vein of `Fixnum#zero?`.
-
-    This makes it nicer to do things like `bunch_of_numbers.select(&:positive?)`.
-
-    *DHH*
-
-*   Encoding `ActiveSupport::TimeWithZone` to YAML now preserves the timezone information.
-
-    Fixes #9183.
-
-    *Andrew White*
-
-*   Added `ActiveSupport::TimeZone#strptime` to allow parsing times as if
-    from a given timezone.
-
-    *Paul A Jungwirth*
-
-*   `ActiveSupport::Callbacks#skip_callback` now raises an `ArgumentError` if
-    an unrecognized callback is removed.
-
-    *Iain Beeston*
-
-*   Added `ActiveSupport::ArrayInquirer` and `Array#inquiry`.
-
-    Wrapping an array in an `ArrayInquirer` gives a friendlier way to check its
-    contents:
-
-        variants = ActiveSupport::ArrayInquirer.new([:phone, :tablet])
-
-        variants.phone?    # => true
-        variants.tablet?   # => true
-        variants.desktop?  # => false
-
-        variants.any?(:phone, :tablet)   # => true
-        variants.any?(:phone, :desktop)  # => true
-        variants.any?(:desktop, :watch)  # => false
-
-    `Array#inquiry` is a shortcut for wrapping the receiving array in an
-    `ArrayInquirer`.
-
-    *George Claghorn*
-
-*   Deprecate `alias_method_chain` in favour of `Module#prepend` introduced in
-    Ruby 2.0.
-
-    *Kir Shatrov*
+        Main is debug? false
+        Thread is debug? true
+        Main is debug? false
 
-*   Added `#without` on `Enumerable` and `Array` to return a copy of an
-    enumerable without the specified elements.
+    Fixes #36752.
 
-    *Todd Bealmear*
+    *Alexander Varnin*
 
-*   Fixed a problem where `String#truncate_words` would get stuck with a complex
-    string.
-
-    *Henrik Nygren*
-
-*   Fixed a roundtrip problem with `AS::SafeBuffer` where primitive-like strings
-    will be dumped as primitives:
+*   Allow the `on_rotation` proc used when decrypting/verifying a message to be
+    passed at the constructor level.
 
     Before:
 
-        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
-        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => true
-        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => false
-        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => 1
-        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => 1.1
+        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 { ... })
 
     After:
 
-        YAML.load ActiveSupport::SafeBuffer.new("Hello").to_yaml  # => "Hello"
-        YAML.load ActiveSupport::SafeBuffer.new("true").to_yaml   # => "true"
-        YAML.load ActiveSupport::SafeBuffer.new("false").to_yaml  # => "false"
-        YAML.load ActiveSupport::SafeBuffer.new("1").to_yaml      # => "1"
-        YAML.load ActiveSupport::SafeBuffer.new("1.1").to_yaml    # => "1.1"
-
-    *Godfrey Chan*
-
-*   Enable `number_to_percentage` to keep the number's precision by allowing
-    `:precision` to be `nil`.
-
-    *Jack Xu*
-
-*   `config_accessor` became a private method, as with Ruby's `attr_accessor`.
-
-    *Akira Matsuda*
-
-*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
-    `Time.now` and `Date.today`.
-
-    *Yuki Nishijima*
-
-*   Add `file_fixture` to `ActiveSupport::TestCase`.
-    It provides a simple mechanism to access sample files in your test cases.
-
-    By default file fixtures are stored in `test/fixtures/files`. This can be
-    configured per test-case using the `file_fixture_path` class attribute.
-
-    *Yves Senn*
-
-*   Return value of yielded block in `File.atomic_write`.
-
-    *Ian Ker-Seymer*
-
-*   Duplicate frozen array when assigning it to a `HashWithIndifferentAccess` so
-    that it doesn't raise a `RuntimeError` when calling `map!` on it in `convert_value`.
-
-    Fixes #18550.
-
-    *Aditya Kapoor*
-
-*   Add missing time zone definitions for Russian Federation and sync them
-    with `zone.tab` file from tzdata version 2014j (latest).
-
-    *Andrey Novikov*
-
-*   Add `SecureRandom.base58` for generation of random base58 strings.
+        crypt = ActiveSupport::MessageEncryptor.new('long_secret', on_rotation: proc { ... })
+        crypt.decrypt_and_verify(encrypted_message)
+        crypt.decrypt_and_verify(another_encrypted_message)
 
-    *Matthew Draper*, *Guillermo Iguaran*
+    *Edouard Chin*
 
-*   Add `#prev_day` and `#next_day` counterparts to `#yesterday` and
-    `#tomorrow` for `Date`, `Time`, and `DateTime`.
+*   `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.
 
-    *George Claghorn*
+    *Matthew Tanous*
 
-*   Add `same_time` option to `#next_week` and `#prev_week` for `Date`, `Time`,
-    and `DateTime`.
-
-    *George Claghorn*
-
-*   Add `#on_weekend?`, `#next_weekday`, `#prev_weekday` methods to `Date`,
-    `Time`, and `DateTime`.
-
-    `#on_weekend?` returns `true` if the receiving date/time falls on a Saturday
-    or Sunday.
-
-    `#next_weekday` returns a new date/time representing the next day that does
-    not fall on a Saturday or Sunday.
-
-    `#prev_weekday` returns a new date/time representing the previous day that
-    does not fall on a Saturday or Sunday.
-
-    *George Claghorn*
-
-*   Added ability to `TaggedLogging` to allow loggers to be instantiated multiple times
-    so that they don't share tags with each other.
-
-        Rails.logger = Logger.new(STDOUT)
-
-        # Before
-        custom_logger = ActiveSupport::TaggedLogging.new(Rails.logger)
-        custom_logger.push_tags "custom_tag"
-        custom_logger.info "test"  # => "[custom_tag] [custom_tag] test"
-        Rails.logger.info "test"   # => "[custom_tag] [custom_tag] test"
-
-        # After
-        custom_logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT))
-        custom_logger.push_tags "custom_tag"
-        custom_logger.info "test"  # => "[custom_tag] test"
-        Rails.logger.info "test"   # => "test"
-
-    *Alexander Staubo*
-
-*   Change the default test order from `:sorted` to `:random`.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated `ActiveSupport::JSON::Encoding::CircularReferenceError`.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated methods `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string=`
-    and `ActiveSupport::JSON::Encoding.encode_big_decimal_as_string`.
-
-    *Rafael Mendonça França*
+*   `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`.
 
-*   Remove deprecated `ActiveSupport::SafeBuffer#prepend`.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated methods at `Kernel`.
-
-    `silence_stderr`, `silence_stream`, `capture` and `quietly`.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated `active_support/core_ext/big_decimal/yaml_conversions`
-    file.
-
-    *Rafael Mendonça França*
-
-*   Remove deprecated methods `ActiveSupport::Cache::Store.instrument` and
-    `ActiveSupport::Cache::Store.instrument=`.
-
-    *Rafael Mendonça França*
-
-*   Change the way in which callback chains can be halted.
-
-    The preferred method to halt a callback chain from now on is to explicitly
-    `throw(:abort)`.
-    In the past, callbacks could only be halted by explicitly providing a
-    terminator and by having a callback match the conditions of the terminator.
-
-*   Add `ActiveSupport.halt_callback_chains_on_return_false`
-
-    Setting `ActiveSupport.halt_callback_chains_on_return_false`
-    to `true` will let an app support the deprecated way of halting Active Record,
-    and Active Model callback chains by returning `false`.
-
-    Setting the value to `false` will tell the app to ignore any `false` value
-    returned by those callbacks, and only halt the chain upon `throw(:abort)`.
-
-    When the configuration option is missing, its value is `true`, so older apps
-    ported to Rails 5.0 will not break (but display a deprecation warning).
-    For new Rails 5.0 apps, its value is set to `false` in an initializer, so
-    these apps will support the new behavior by default.
-
-    *claudiob*, *Roque Pinel*
-
-*   Changes arguments and default value of CallbackChain's `:terminator` option
-
-    Chains of callbacks defined without an explicit `:terminator` option will
-    now be halted as soon as a `before_` callback throws `:abort`.
-
-    Chains of callbacks defined with a `:terminator` option will maintain their
-    existing behavior of halting as soon as a `before_` callback matches the
-    terminator's expectation.
-
-    *claudiob*
-
-*   Deprecate `MissingSourceFile` in favor of `LoadError`.
-
-    `MissingSourceFile` was just an alias to `LoadError` and was not being
-    raised inside the framework.
-
-    *Rafael Mendonça França*
-
-*   Remove `Object#itself` as it is implemented in Ruby 2.2.
-
-    *Cristian Bica*
-
-*   Add support for error dispatcher classes in `ActiveSupport::Rescuable`.
-    Now it acts closer to Ruby's rescue.
-
-    Example:
-
-        class BaseController < ApplicationController
-          module ErrorDispatcher
-            def self.===(other)
-              Exception === other && other.respond_to?(:status)
-            end
-          end
-
-          rescue_from ErrorDispatcher do |error|
-            render status: error.status, json: { error: error.to_s }
-          end
-        end
+    Before:
 
-    *Genadi Samokovarov*
+        'foobar'.truncate(5).frozen?
+        # => true
+        'foobar'.truncate(6).frozen?
+        # => false
 
-*   Add `#verified` and `#valid_message?` methods to `ActiveSupport::MessageVerifier`
+    After:
 
-    Previously, the only way to decode a message with `ActiveSupport::MessageVerifier`
-    was to use `#verify`, which would raise an exception on invalid messages. Now
-    `#verified` can also be used, which returns `nil` on messages that cannot be
-    decoded.
+        'foobar'.truncate(5).frozen?
+        # => false
+        'foobar'.truncate(6).frozen?
+        # => false
 
-    Previously, there was no way to check if a message's format was valid without
-    attempting to decode it. `#valid_message?` is a boolean convenience method that
-    checks whether the message is valid without actually decoding it.
+    *Jordan Thomas*
 
-    *Logan Leger*
 
-Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-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.