activesupport 4.0.13 → 4.2.11.3

data/CHANGELOG.md

@@ -1,700 +1,688 @@
-## Rails 4.0.13 (January 6, 2015) ##
+## Rails 4.2.11.3 (May 15, 2020) ##
 
-*No changes*
+*   No changes.
 
 
-## Rails 4.0.12 (November 16, 2014) ##
+## Rails 4.2.11.2 (May 15, 2020) ##
 
-*No changes*
+*   No changes.
 
 
-## Rails 4.0.11.1 (November 19, 2014) ##
+## Rails 4.2.11.1 (March 11, 2019) ##
 
-*No changes*
+*   No changes.
 
 
-## Rails 4.0.11 (September 11, 2014) ##
+## Rails 4.2.11 (November 27, 2018) ##
 
-*No changes*
+*   No changes.
 
 
-## Rails 4.0.10 (September 11, 2014) ##
+## Rails 4.2.10 (September 27, 2017) ##
 
-*   Fix DateTime comparison with DateTime::Infinity object.
+*   No changes.
 
-    *Rafael Mendonça França*
-
-*   Make Dependencies pass a name to NameError error.
 
-    *arthurnn*, *Yuki Nishijima*
+## Rails 4.2.9 (June 26, 2017) ##
 
+*   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`.
 
-## Rails 4.0.9 (August 18, 2014) ##
+    *Kevin McPhillips* & *Andrew White*
 
-*No changes*
+*   Restore the return type of `DateTime#utc`
 
+    In Rails 5.0 the return type of `DateTime#utc` was changed to `Time` to be
+    consistent with the new `DateTime#localtime` method. When these changes were
+    backported in #27553 this inadvertently changed the return type in a patcn
+    release. Since `DateTime#localtime` was new in Rails 4.2.8 it's okay to
+    restore the return type of `DateTime#utc` but keep `DateTime#localtime` as
+    returning `Time` without breaking backwards compatibility.
 
-## Rails 4.0.8 (July 2, 2014) ##
-
-*No changes*
-
+    *Andrew White*
 
-## Rails 4.0.7 (July 2, 2014) ##
+*   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(sourse, proc)` just to be able to pass a proc.
 
-*No changes*
+    *Jeff Latz*
 
+*   Cache `ActiveSupport::TimeWithZone#to_datetime` before freezing.
 
-## Rails 4.0.6 (June 26, 2014) ##
+    *Adam Rice*
 
-*   `Hash#deep_transform_keys` and `Hash#deep_transform_keys!` now transform hashes
-    in nested arrays.  This change also applies to `Hash#deep_stringify_keys`,
-    `Hash#deep_stringify_keys!`, `Hash#deep_symbolize_keys` and
-    `Hash#deep_symbolize_keys!`.
+*   `AS::Testing::TimeHelpers#travel_to` now changes `DateTime.now` as well as
+    `Time.now` and `Date.today`.
 
-    *OZAWA Sakuro*
+    *Yuki Nishijima*
 
-*   `HashWithIndifferentAccess` better respects `#to_hash` on objects it's
-    given. In particular `#update`, `#merge`, `#replace` all accept objects
-    which respond to `#to_hash`, even if those objects are not Hashes directly.
 
-    Currently, if `HashWithIndifferentAccess.new` is given a non-Hash (even if
-    it responds to `#to_hash`) that object is treated as the default value,
-    rather than the initial keys and value. Changing that could break existing
-    code, so it will be updated in 4.2.
+## Rails 4.2.8 (February 21, 2017) ##
 
-    *Peter Jaros*
+*   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.
 
+    *Andrew White*
 
-## Rails 4.0.5 (May 6, 2014) ##
-
-*No changes*
-
+*   Add `DateTime#subsec` to return the fraction of a second as a `Rational`.
 
-## Rails 4.0.4 (March 14, 2014) ##
+    *Andrew White*
 
-*   Fix parsing bugs in `XmlMini`
+*   Add additional aliases for `DateTime#utc` to mirror the ones on
+    `ActiveSupport::TimeWithZone` and `Time`.
 
-    Symbols or boolean parsing would raise an error for non string values (e.g.
-    integers). Decimal parsing would fail due to a missing requirement.
+    *Andrew White*
 
-    *Birkir A. Barkarson*
+*   Add `DateTime#localtime` to return an instance of `Time` in the system's
+    local timezone. Also aliased to `getlocal`.
 
-*   Re-enable support for iterating over `DateTime` ranges
+    *Andrew White*, *Yuichiro Kaneko*
 
-    Fixes #13667.
+*   Add `Time#sec_fraction` to return the fraction of a second as a `Rational`.
 
-    *Prathamesh Sonpatki*
+    *Andrew White*
 
-*   Use `remove_possible_method` instead of `remove_method` to avoid
-    a `NameError` to be thrown on FreeBSD with the `Date` object.
+*   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:
 
-    *Rafael Mendonça França*, *Robin Dupret*
+        >> ENV['TZ'] = 'US/Eastern'
 
-*   Default the new `I18n.enforce_available_locales` config to `true`, meaning
-    `I18n` will make sure that all locales passed to it must be declared in the
-    `available_locales` list.
+        >> "2016-04-23T10:23:12.000Z".to_time
+        => "2016-04-23T06:23:12.000-04:00"
 
-    To disable it add the following configuration to your application:
+        >> ActiveSupport.to_time_preserves_timezone = true
 
-        config.i18n.enforce_available_locales = false
+        >> "2016-04-23T10:23:12.000Z".to_time
+        => "2016-04-23T10:23:12.000Z"
 
-    This also ensures I18n configuration is properly initialized taking the new
-    option into account, to avoid their deprecations while booting up the app.
+    Fixes #24617.
 
-    *Carlos Antonio da Silva*, *Yves Senn*
+    *Andrew White*
 
-*   Fix file descriptor being leaked on each call to `Kernel.silence_stream`.
+*   Add `init_with` to `ActiveSupport::TimeWithZone` and `ActiveSupport::TimeZone`
 
-    *Mario Visic*
+    It is helpful to be able to run apps concurrently written in successive
+    versions of Rails to aid migration, e.g. run Rails 4.2 and 5.0 variants
+    of your application at the same time to carry out A/B testing.
 
-*   Fix `slice!` deleting the default value of the hash.
+    To do this serialization formats need to be cross compatible and the
+    change in 3aa26cf didn't meet this criteria because the Psych loader
+    checks for the existence of `init_with` before setting the instance
+    variables and the wrapping behavior of `ActiveSupport::TimeWithZone`
+    tries to see if the `Time` instance responds to `init_with` before the
+    `@time` variable is set.
 
-    *Antonio Santos*
+    To fix this we backported just the `init_with` behavior from the change
+    in 3aa26cf. If the revived instance is then written out to YAML again
+    it will revert to the default Rails 4.2 behavior of converting it to
+    a UTC timestamp string.
 
+    Fixes #26296.
 
-## Rails 4.0.3 (February 18, 2014) ##
+    *Andrew White*
 
-*No changes*
+*   Fix `ActiveSupport::TimeWithZone#in` across DST boundaries.
 
+    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#since` which handles
+    transitions across DST boundaries, e.g:
 
-## Rails 4.0.2 (December 02, 2013) ##
+        Time.zone = "US/Eastern"
 
-*No changes*
+        t = Time.zone.local(2016,11,6,1)
+        # => Sun, 06 Nov 2016 01:00:00 EDT -05:00
 
+        t.in(1.hour)
+        # => Sun, 06 Nov 2016 01:00:00 EST -05:00
 
-## Rails 4.0.1 (November 01, 2013) ##
+    Fixes #26580.
 
-*   Disable the ability to iterate over Range of AS::TimeWithZone
-    due to significant performance issues.
+    *Thomas Balthazar*
 
-    *Bogdan Gusiev*
 
-*   Fix `ActiveSupport::Cache::FileStore#cleanup` to no longer rely on missing `each_key` method.
+## Rails 4.2.7 (July 12, 2016) ##
 
-    *Murray Steele*
+*   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.
 
-*   Ensure that autoloaded constants in all-caps nestings are marked as
-    autoloaded.
+    *Kevin McPhillips*
 
-    *Simon Coffey*
+*   Backported `ActiveSupport::LoggerThreadSafeLevel`. Assigning the
+    `Rails.logger.level` is now thread safe.
 
-*   Adds a new deprecation behaviour that raises an exception. Throwing this
-    line into `config/environments/development.rb`:
+    *Kevin McPhillips*
 
-        ActiveSupport::Deprecation.behavior = :raise
+*   Fixed a problem with ActiveSupport::SafeBuffer.titleize calling capitalize
+    on nil.
 
-    will cause the application to raise an `ActiveSupport::DeprecationException`
-    on deprecations.
+    *Brian McManus*
 
-    Use this for aggressive deprecation cleanups.
+*   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.
 
-    *Xavier Noria*
+    *Alexey Shein*
 
-*   Improve `ActiveSupport::Cache::MemoryStore` cache size calculation.
-    The memory used by a key/entry pair is calculated via `#cached_size`:
+*   Prevent `Marshal.load` from looping infinitely when trying to autoload a constant
+    which resolves to a different name.
 
-        def cached_size(key, entry)
-          key.to_s.bytesize + entry.size + PER_ENTRY_OVERHEAD
-        end
+    *Olek Janiszewski*
 
-    The value of `PER_ENTRY_OVERHEAD` is 240 bytes based on an [empirical
-    estimation](https://gist.github.com/ssimeonov/6047200) for 64-bit MRI on
-    1.9.3 and 2.0.
 
-    Fixes #11512.
+## Rails 4.2.6 (March 07, 2016) ##
 
-    *Simeon Simeonov*
+*   No changes.
 
-*   Only raise `Module::DelegationError` if it's the source of the exception.
 
-    Fixes #10559.
+## Rails 4.2.5.2 (February 26, 2016) ##
 
-*   Add `DateTime#usec` and `DateTime#nsec` so that `ActiveSupport::TimeWithZone` keeps
-    sub-second resolution when wrapping a `DateTime` value.
+*   No changes.
 
-    Fixes #10855.
 
-    *Andrew White*
+## Rails 4.2.5.1 (January 25, 2015) ##
 
-*   Make `Time.at_with_coercion` retain the second fraction and return local time.
+*   No changes.
 
-    Fixes #11350.
 
-    *Neer Friedman*, *Andrew White*
+## Rails 4.2.5 (November 12, 2015) ##
 
-*   Fix return value from `BacktraceCleaner#noise` when the cleaner is configured
-    with multiple silencers.
+*   Fix `TimeWithZone#eql?` to properly handle `TimeWithZone` created from `DateTime`:
+        twz = DateTime.now.in_time_zone
+        twz.eql?(twz.dup) => true
 
-    Fixes #11030.
+    Fixes #14178.
 
-    *Mark J. Titorenko*
+    *Roque Pinel*
 
-*   Fix `ActiveSupport::Dependencies::Loadable#load_dependency` calling
-    `#blame_file!` on Exceptions that do not have the Blamable mixin
+*   Handle invalid UTF-8 characters in `MessageVerifier.verify`.
 
-    *Andrew Kreiling*
+    *Roque Pinel*, *Grey Baker*
 
 
-## Rails 4.0.0 (June 25, 2013) ##
+## Rails 4.2.4 (August 24, 2015) ##
 
-*   Override `Time.at` to support the passing of Time-like values when called with a single argument.
+*   Fix a `SystemStackError` when encoding an `Enumerable` with `json` gem and
+    with the Active Support JSON encoder loaded.
 
-    *Andrew White*
+    Fixes #20775.
 
-*   Allow Date to be compared with Time (like it was possible to compare Time with Date).
+    *Sammy Larbi*, *Prathamesh Sonpatki*
 
-    *DHH*
+*   Fix not calling `#default` on `HashWithIndifferentAcess#to_hash` when only
+    `default_proc` is set, which could raise.
 
-*   Deprecate multiple parameters support of `Object#in?`.
+    *Simon Eskildsen*
 
-    *Brian Morearty + Carlos Antonio da Silva*
+*   Fix setting `default_proc` on `HashWithIndifferentAccess#dup`
 
-*   An `ActiveSupport::Subscriber` class has been extracted from
-    `ActiveSupport::LogSubscriber`, allowing you to use the event attachment
-    API for other kinds of subscribers.
+    *Simon Eskildsen*
 
-    *Daniel Schierbeck*
 
-*   `Class#class_attribute` accepts an `instance_predicate` option which
-    defaults to `true`. If set to `false` the predicate method will not
-    be defined.
+## Rails 4.2.3 (June 25, 2015) ##
 
-    *Agis Anastasopoulos*
+*   Fix a range of values for parameters of the Time#change
 
-*   `fast_xs` support has been removed.  Use `String#encode(xml: :attr)`.
+    *Nikolay Kondratyev*
 
-*   `ActiveSupport::Notifications::Instrumenter#instrument` should
-    yield its payload.
+*   Add some missing `require 'active_support/deprecation'`
 
-    *stopdropandrew*
-
-*   `ActiveSupport::TimeWithZone` raises `NoMethodError` in proper context.
-    Fixes #9772.
-
-    *Yves Senn*
-
-*   Fix deletion of empty directories in `ActiveSupport::Cache::FileStore`.
+    *Akira Matsuda*
 
-    *Charles Jones*
 
-*   Improve singularizing a singular for multiple cases.
-    Fixes #2608 #1825 #2395.
+## Rails 4.2.2 (June 16, 2015) ##
 
-    Example:
+*   Fix XSS vulnerability in `ActiveSupport::JSON.encode` method.
 
-        # Before
-        'address'.singularize # => 'addres'
+    CVE-2015-3226.
 
-        # After
-        'address'.singularize # => 'address'
+    *Rafael Mendonça França*
 
-    *Mark McSpadden*
+*   Fix denial of service vulnerability in the XML processing.
 
-*   Prevent `DateTime#change` from truncating the second fraction, when seconds
-    do not need to be changed.
+    CVE-2015-3227.
 
-    *Chris Baynes*
+    *Aaron Patterson*
 
-*   Added `ActiveSupport::TimeWithZone#to_r` for `Time#at` compatibility.
 
-    Before this change:
+## Rails 4.2.1 (March 19, 2015) ##
 
-        Time.zone = 'Tokyo'
-        time = Time.zone.now
-        time == Time.at(time) # => false
+*   Fixed a problem where String#truncate_words would get stuck with a complex
+    string.
 
-    After the change:
+    *Henrik Nygren*
 
-        Time.zone = 'Tokyo'
-        time = Time.zone.now
-        time == Time.at(time) # => true
+*   Fixed a roundtrip problem with AS::SafeBuffer where primitive-like strings
+    will be dumped as primitives:
 
-    *stopdropandrew*
+    Before:
 
-*   `ActiveSupport::NumberHelper#number_to_human` returns the number unaltered when
-    the given units hash does not contain the needed key, e.g. when the number provided
-    is less than the largest key provided.
-    Fixes #9269.
+        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
 
-    Examples:
+     After:
 
-        number_to_human(123, units: {}) # => 123
-        number_to_human(123, units: { thousand: 'k' }) # => 123
+        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"
 
-    *Michael Hoffman*
+    *Godfrey Chan*
 
-*   Added `beginning_of_minute` support to core ext calculations for `Time` and `DateTime`.
+*   Replace fixed `:en` with `I18n.default_locale` in `Duration#inspect`.
 
-    *Gagan Awhad*
+    *Dominik Masur*
 
-*   Add `:nsec` date format.
+*   Add missing time zone definitions for Russian Federation and sync them
+    with `zone.tab` file from tzdata version 2014j (latest).
 
-    *Jamie Gaskins*
+    *Andrey Novikov*
 
-*   `ActiveSupport::Gzip.compress` allows two optional arguments for compression
-    level and strategy.
 
-    *Beyond*
+## Rails 4.2.0 (December 20, 2014) ##
 
-*   Modify `TimeWithZone#as_json` to include 3 decimal places of sub-second accuracy
-    by default, which is optional as per the ISO8601 spec, but extremely useful. Also
-    the default behaviour of `Date#toJSON()` in recent versions of Chrome, Safari and
-    Firefox.
+*   The decorated `load` and `require` methods are now kept private.
 
-    *James Harton*
+    Fixes #17553.
 
-*   Improve `String#squish` to handle Unicode whitespace. *Antoine Lyset*
+    *Xavier Noria*
 
-*   Standardise on `to_time` returning an instance of `Time` in the local system timezone
-    across `String`, `Time`, `Date`, `DateTime` and `ActiveSupport::TimeWithZone`.
+*   `String#remove` and `String#remove!` accept multiple arguments.
 
-    *Andrew White*
+    *Pavel Pravosud*
 
-*   Extract `ActiveSupport::Testing::Performance` into https://github.com/rails/rails-perftest
-    You can add the gem to your `Gemfile` to keep using performance tests.
+*   `TimeWithZone#strftime` now delegates every directive to `Time#strftime` except for '%Z',
+    it also now correctly handles escaped '%' characters placed just before time zone related directives.
 
-        gem 'rails-perftest'
+    *Pablo Herrero*
 
-    *Yves Senn*
+*   Corrected `Inflector#underscore` handling of multiple successive acroynms.
 
-*   `Hash.from_xml` raises when it encounters `type="symbol"` or `type="yaml"`.
-    Use `Hash.from_trusted_xml` to parse this XML.
+    *James Le Cuirot*
 
-    CVE-2013-0156
+*   Delegation now works with ruby reserved words passed to `:to` option.
 
-    *Jeremy Kemper*
+    Fixes #16956.
 
-*   Deprecate `assert_present` and `assert_blank` in favor of
-    `assert object.blank?` and `assert object.present?`
+    *Agis Anastasopoulos*
 
-    *Yves Senn*
+*   Added method `#eql?` to `ActiveSupport::Duration`, in addition to `#==`.
 
-*   Change `String#to_date` to use `Date.parse`. This gives more consistent error
-    messages and allows the use of partial dates.
+    Currently, the following returns `false`, contrary to expectation:
 
-        "gibberish".to_date => Argument Error: invalid date
-        "3rd Feb".to_date => Sun, 03 Feb 2013
+        1.minute.eql?(1.minute)
 
-    *Kelly Stannard*
+    Adding method `#eql?` will make this behave like expected. Method `#eql?` is
+    just a bit stricter than `#==`, as it checks whether the argument is also a duration. Their
+    parts may be different though.
 
-*   Remove meaningless `ActiveSupport::FrozenObjectError`, which was just an alias of `RuntimeError`.
+        1.minute.eql?(60.seconds)  # => true
+        1.minute.eql?(60)          # => false
 
-    *Akira Matsuda*
+    *Joost Lubach*
 
-*   Introduce `assert_not` to replace warty `assert !foo`.  *Jeremy Kemper*
+*   `Time#change` can now change nanoseconds (`:nsec`) as a higher-precision
+    alternative to microseconds (`:usec`).
 
-*   Prevent `Callbacks#set_callback` from setting the same callback twice.
+    *Agis Anastasooulos*
 
-        before_save :foo, :bar, :foo
+*   `MessageVerifier.new` raises an appropriate exception if the secret is `nil`.
+    This prevents `MessageVerifier#generate` from raising a cryptic error later on.
 
-    will at first call `bar`, then `foo`. `foo` will no more be called
-    twice.
+    *Kostiantyn Kahanskyi*
 
-    *Dmitriy Kiriyenko*
+*   Introduced new configuration option `active_support.test_order` for
+    specifying the order in which test cases are executed. This option currently defaults
+    to `:sorted` but will be changed to `:random` in Rails 5.0.
 
-*   Add `ActiveSupport::Logger#silence` that works the same as the old `Logger#silence` extension.
+    *Akira Matsuda*, *Godfrey Chan*
 
-    *DHH*
+*   Fixed a bug in `Inflector#underscore` where acroynms in nested constant names
+    are incorrectly parsed as camelCase.
 
-*   Remove surrogate unicode character encoding from `ActiveSupport::JSON.encode`
-    The encoding scheme was broken for unicode characters outside the basic multilingual plane;
-    since json is assumed to be UTF-8, and we already force the encoding to UTF-8,
-    simply pass through the un-encoded characters.
+    Fixes #8015.
 
-    *Brett Carter*
+    *Fred Wu*, *Matthew Draper*
 
-*   Deprecate `Time.time_with_date_fallback`, `Time.utc_time` and `Time.local_time`.
-    These methods were added to handle the limited range of Ruby's native `Time`
-    implementation. Those limitations no longer apply so we are deprecating them in 4.0
-    and they will be removed in 4.1.
+*   Make `Time#change` throw an exception if the `:usec` option is out of range and
+    the time has an offset other than UTC or local.
 
-    *Andrew White*
+    *Agis Anastasopoulos*
 
-*   Deprecate `Date#to_time_in_current_zone` and add `Date#in_time_zone`. *Andrew White*
+*   `Method` objects now report themselves as not `duplicable?`. This allows
+    hashes and arrays containing `Method` objects to be `deep_dup`ed.
 
-*   Add `String#in_time_zone` method to convert a string to an `ActiveSupport::TimeWithZone`. *Andrew White*
+    *Peter Jaros*
 
-*   Deprecate `ActiveSupport::BasicObject` in favor of `ActiveSupport::ProxyObject`.
-    This class is used for proxy classes. It avoids confusion with Ruby's `BasicObject`
-    class.
+*   `determine_constant_from_test_name` does no longer shadow `NameError`s
+    which happens during constant autoloading.
 
-    *Francesco Rodriguez*
+    Fixes #9933.
 
-*   Patched `Marshal#load` to work with constant autoloading. Fixes autoloading
-    with cache stores that rely on `Marshal` (`MemCacheStore` and `FileStore`).
-    Fixes #8167.
+    *Guo Xiang Tan*
 
-    *Uriel Katz*
+*   Added instance_eval version to Object#try and Object#try!, so you can do this:
 
-*   Make `Time.zone.parse` to work with JavaScript format date strings. *Andrew White*
+        person.try { name.first }
 
-*   Add `DateTime#seconds_until_end_of_day` and `Time#seconds_until_end_of_day`
-    as a complement for `seconds_from_midnight`; useful when setting expiration
-    times for caches, e.g.:
+    instead of:
 
-        <% cache('dashboard', expires_in: Date.current.seconds_until_end_of_day) do %>
-          ...
+        person.try { |person| person.name.first }
 
-    *Olek Janiszewski*
+    *DHH*, *Ari Pollak*
 
-*   No longer proxy `ActiveSupport::Multibyte#class`. *Steve Klabnik*
+*   Fix the `ActiveSupport::Duration#instance_of?` method to return the right
+    value with the class itself since it was previously delegated to the
+    internal value.
 
-*   Deprecate `ActiveSupport::TestCase#pending` method, use `skip` from minitest instead. *Carlos Antonio da Silva*
+    *Robin Dupret*
 
-*   `XmlMini.with_backend` now may be safely used with threads:
+*   Fix rounding errors with `#travel_to` by resetting the usec on any passed time to zero, so we only travel
+    with per-second precision, not anything deeper than that.
 
-        Thread.new do
-          XmlMini.with_backend("REXML") { rexml_power }
-        end
-        Thread.new do
-          XmlMini.with_backend("LibXML") { libxml_power }
-        end
+    *DHH*
 
-    Each thread will use it's own backend.
+*   Fix DateTime comparison with `DateTime::Infinity` object.
 
-    *Nikita Afanasenko*
+    *Rafael Mendonça França*
 
-*   Dependencies no longer trigger `Kernel#autoload` in `remove_constant`. Fixes #8213. *Xavier Noria*
+*   Added Object#itself which returns the object itself. Useful when dealing with a chaining scenario, like Active Record scopes:
 
-*   Simplify `mocha` integration and remove monkey-patches, bumping `mocha` to 0.13.0. *James Mead*
+        Event.public_send(state.presence_in([ :trashed, :drafted ]) || :itself).order(:created_at)
 
-*   `#as_json` isolates options when encoding a hash. Fixes #8182.
+    *DHH*
 
-    *Yves Senn*
+*   `Object#with_options` executes block in merging option context when
+    explicit receiver in not passed.
 
-*   Deprecate `Hash#diff` in favor of minitest's #diff. *Steve Klabnik*
+    *Pavel Pravosud*
 
-*   `Kernel#capture` can catch output from subprocesses. *Dmitry Vorotilin*
+*   Fixed a compatibility issue with the `Oj` gem when cherry-picking the file
+    `active_support/core_ext/object/json` without requiring `active_support/json`.
 
-*   `to_xml` conversions now use builder's `tag!` method instead of explicit invocation of `method_missing`.
+    Fixes #16131.
 
-    *Nikita Afanasenko*
+    *Godfrey Chan*
 
-*   Fixed timezone mapping of the Solomon Islands. *Steve Klabnik*
+*   Make `Hash#with_indifferent_access` copy the default proc too.
 
-*   Make callstack attribute optional in `ActiveSupport::Deprecation::Reporting`
-    methods `warn` and `deprecation_warning`.
+    *arthurnn*, *Xanders*
 
-    *Alexey Gaziev*
+*   Add `String#truncate_words` to truncate a string by a number of words.
 
-*   Implement `HashWithIndifferentAccess#replace` so `key?` works correctly. *David Graham*
+    *Mohamed Osama*
 
-*   Handle the possible permission denied errors `atomic.rb` might trigger due to its `chown`
-    and `chmod` calls.
+*   Deprecate `capture` and `quietly`.
 
-    *Daniele Sluijters*
+    These methods are not thread safe and may cause issues when used in threaded environments.
+    To avoid problems we are deprecating them.
 
-*   `Hash#extract!` returns only those keys that present in the receiver.
+    *Tom Meier*
 
-        {a: 1, b: 2}.extract!(:a, :x) # => {:a => 1}
+*   `DateTime#to_f` now preserves the fractional seconds instead of always
+    rounding to `.0`.
 
-    *Mikhail Dieterle*
+    Fixes #15994.
 
-*   `Hash#extract!` returns the same subclass, that the receiver is. I.e.
-    `HashWithIndifferentAccess#extract!` returns a `HashWithIndifferentAccess` instance.
+    *John Paul Ashenfelter*
 
-    *Mikhail Dieterle*
+*   Add `Hash#transform_values` to simplify a common pattern where the values of a
+    hash must change, but the keys are left the same.
 
-*   Optimize `ActiveSupport::Cache::Entry` to reduce memory and processing overhead. *Brian Durand*
+    *Sean Griffin*
 
-*   Tests tag the Rails log with the current test class and test case:
+*   Always instrument `ActiveSupport::Cache`.
 
-        [SessionsControllerTest] [test_0002_sign in] Processing by SessionsController#create as HTML
-        [SessionsControllerTest] [test_0002_sign in] ...
+    Since `ActiveSupport::Notifications` only instruments items when there
+    are attached subscribers, we don't need to disable instrumentation.
 
-    *Jeremy Kemper*
+    *Peter Wagenet*
 
-*   Add `logger.push_tags` and `.pop_tags` to complement `logger.tagged`:
+*   Make the `apply_inflections` method case-insensitive when checking
+    whether a word is uncountable or not.
 
-        class Job
-          def before
-            Rails.logger.push_tags :jobs, self.class.name
-          end
+    *Robin Dupret*
 
-          def after
-            Rails.logger.pop_tags 2
-          end
-        end
-
-    *Jeremy Kemper*
+*   Make Dependencies pass a name to NameError error.
 
-*   Allow delegation to the class using the `:class` keyword, replacing
-    `self.class` usage:
+    *arthurnn*
 
-        class User
-          def self.hello
-           "world"
-          end
+*   Fixed `ActiveSupport::Cache::FileStore` exploding with long paths.
 
-          delegate :hello, to: :class
-        end
+    *Adam Panzer*, *Michael Grosser*
 
-    *Marc-Andre Lafortune*
+*   Fixed `ActiveSupport::TimeWithZone#-` so precision is not unnecessarily lost
+    when working with objects with a nanosecond component.
 
-*   `Date.beginning_of_week` thread local and `beginning_of_week` application
-    config option added (default is Monday).
+    `ActiveSupport::TimeWithZone#-` should return the same result as if we were
+    using `Time#-`:
 
-    *Innokenty Mikhailov*
+        Time.now.end_of_day - Time.now.beginning_of_day # => 86399.999999999
 
-*   An optional block can be passed to `config_accessor` to set its default value
+    Before:
 
-        class User
-          include ActiveSupport::Configurable
+        Time.zone.now.end_of_day.nsec # => 999999999
+        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day # => 86400.0
 
-          config_accessor :hair_colors do
-            [:brown, :black, :blonde, :red]
-          end
-        end
+    After:
 
-        User.hair_colors # => [:brown, :black, :blonde, :red]
+        Time.zone.now.end_of_day - Time.zone.now.beginning_of_day
+        # => 86399.999999999
 
-    *Larry Lv*
+    *Gordon Chan*
 
-*   `ActiveSupport::Benchmarkable#silence` has been deprecated due to its lack of
-    thread safety. It will be removed without replacement in Rails 4.1.
+*   Fixed precision error in NumberHelper when using Rationals.
 
-    *Steve Klabnik*
+    Before:
 
-*   An optional block can be passed to `Hash#deep_merge`. The block will be invoked
-    for each duplicated key and used to resolve the conflict.
+        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
+        # => "330.00"
 
-    *Pranas Kiziela*
+    After:
 
-*   `ActiveSupport::Deprecation` is now a class. It is possible to create an instance
-    of deprecator. Backwards compatibility has been preserved.
+        ActiveSupport::NumberHelper.number_to_rounded Rational(1000, 3), precision: 2
+        # => "333.33"
 
-    You can choose which instance of the deprecator will be used.
+    See #15379.
 
-        deprecate :method_name, deprecator: deprecator_instance
+    *Juanjo Bazán*
 
-    You can use `ActiveSupport::Deprecation` in your gem.
+*   Removed deprecated `Numeric#ago` and friends
 
-        require 'active_support/deprecation'
-        require 'active_support/core_ext/module/deprecation'
+    Replacements:
 
-        class MyGem
-          def self.deprecator
-            ActiveSupport::Deprecation.new('2.0', 'MyGem')
-          end
+        5.ago   => 5.seconds.ago
+        5.until => 5.seconds.until
+        5.since => 5.seconds.since
+        5.from_now => 5.seconds.from_now
 
-          def old_method
-          end
+    See #12389 for the history and rationale behind this.
 
-          def new_method
-          end
+    *Godfrey Chan*
 
-          deprecate old_method: :new_method, deprecator: deprecator
-        end
+*   DateTime `advance` now supports partial days.
 
-        MyGem.new.old_method
-        # => DEPRECATION WARNING: old_method is deprecated and will be removed from MyGem 2.0 (use new_method instead). (called from <main> at file.rb:18)
+    Before:
 
-    *Piotr Niełacny & Robert Pankowecki*
+        DateTime.now.advance(days: 1, hours: 12)
 
-*   `ERB::Util.html_escape` encodes single quote as `#39`. Decimal form has better support in old browsers. *Kalys Osmonov*
+    After:
 
-*   `ActiveSupport::Callbacks`: deprecate monkey patch of object callbacks.
-    Using the `filter` method like this:
+        DateTime.now.advance(days: 1.5)
 
-        before_filter MyFilter.new
+    Fixes #12005.
 
-        class MyFilter
-          def filter(controller)
-          end
-        end
+    *Shay Davidson*
 
-    Is now deprecated with recommendation to use the corresponding filter type
-    (`#before`, `#after` or `#around`):
+*   `Hash#deep_transform_keys` and `Hash#deep_transform_keys!` now transform hashes
+    in nested arrays.  This change also applies to `Hash#deep_stringify_keys`,
+    `Hash#deep_stringify_keys!`, `Hash#deep_symbolize_keys` and
+    `Hash#deep_symbolize_keys!`.
 
-        before_filter MyFilter.new
+    *OZAWA Sakuro*
 
-        class MyFilter
-          def before(controller)
-          end
-        end
+*   Fixed confusing `DelegationError` in `Module#delegate`.
 
-    *Bogdan Gusiev*
+    See #15186.
 
-*   An optional block can be passed to `HashWithIndifferentAccess#update` and `#merge`.
-    The block will be invoked for each duplicated key, and used to resolve the conflict,
-    thus replicating the behaviour of the corresponding methods on the `Hash` class.
+    *Vladimir Yarotsky*
 
-    *Leo Cassarani*
+*   Fixed `ActiveSupport::Subscriber` so that no duplicate subscriber is created
+    when a subscriber method is redefined.
 
-*   Remove `j` alias for `ERB::Util#json_escape`.
-    The `j` alias is already used for `ActionView::Helpers::JavaScriptHelper#escape_javascript`
-    and both modules are included in the view context that would confuse the developers.
+    *Dennis Schön*
 
-    *Akira Matsuda*
+*   Remove deprecated string based terminators for `ActiveSupport::Callbacks`.
 
-*   Replace deprecated `memcache-client` gem with `dalli` in `ActiveSupport::Cache::MemCacheStore`.
+    *Eileen M. Uchitelle*
 
-    *Guillermo Iguaran*
+*   Fixed an issue when using
+    `ActiveSupport::NumberHelper::NumberToDelimitedConverter` to
+    convert a value that is an `ActiveSupport::SafeBuffer` introduced
+    in 2da9d67.
 
-*   Add default values to all `ActiveSupport::NumberHelper` methods, to avoid
-    errors with empty locales or missing values.
+    See #15064.
 
-    *Carlos Antonio da Silva*
+    *Mark J. Titorenko*
 
-*   `ActiveSupport::JSON::Variable` is deprecated. Define your own `#as_json` and
-    `#encode_json` methods for custom JSON string literals.
+*   `TimeZone#parse` defaults the day of the month to '1' if any other date
+    components are specified. This is more consistent with the behavior of
+    `Time#parse`.
 
-    *Erich Menge*
+    *Ulysse Carion*
 
-*   Add `String#indent`. *fxn & Ace Suares*
+*   `humanize` strips leading underscores, if any.
 
-*   Inflections can now be defined per locale. `singularize` and `pluralize`
-    accept locale as an extra argument.
+    Before:
 
-    *David Celis*
+        '_id'.humanize # => ""
 
-*   `Object#try` will now return `nil` instead of raise a `NoMethodError` if the
-    receiving object does not implement the method, but you can still get the
-    old behavior by using the new `Object#try!`.
+    After:
 
-    *DHH*
+        '_id'.humanize # => "Id"
 
-*   `ERB::Util.html_escape` now escapes single quotes. *Santiago Pastorino*
+    *Xavier Noria*
 
-*   `Time#change` now works with time values with offsets other than UTC or the local time zone. *Andrew White*
+*   Fixed backward compatibility issues introduced in 326e652.
 
-*   `ActiveSupport::Callbacks`: deprecate usage of filter object with `#before` and `#after` methods as `around` callback. *Bogdan Gusiev*
+    Empty Hash or Array should not be present in serialization result.
 
-*   Add `Time#prev_quarter` and `Time#next_quarter` short-hands for `months_ago(3)` and `months_since(3)`. *SungHee Kang*
+        {a: []}.to_query # => ""
+        {a: {}}.to_query # => ""
 
-*   Remove obsolete and unused `require_association` method from dependencies. *fxn*
+    For more info see #14948.
 
-*   Add `:instance_accessor` option for `config_accessor`.
+    *Bogdan Gusiev*
 
-        class User
-          include ActiveSupport::Configurable
-          config_accessor :allowed_access, instance_accessor: false
-        end
+*   Add `Digest::UUID::uuid_v3` and `Digest::UUID::uuid_v5` to support stable
+    UUID fixtures on PostgreSQL.
 
-        User.new.allowed_access = true # => NoMethodError
-        User.new.allowed_access        # => NoMethodError
+    *Roderick van Domburg*
 
-    *Francesco Rodriguez*
+*   Fixed `ActiveSupport::Duration#eql?` so that `1.second.eql?(1.second)` is
+    true.
 
-*   `ActionView::Helpers::NumberHelper` methods have been moved to `ActiveSupport::NumberHelper` and are now available via
-    `Numeric#to_s`.  `Numeric#to_s` now accepts the formatting options `:phone`, `:currency`, `:percentage`, `:delimited`,
-    `:rounded`, `:human`, and `:human_size`.
+    This fixes the current situation of:
 
-    *Andrew Mutz*
+        1.second.eql?(1.second) # => false
 
-*   Add `Hash#transform_keys`, `Hash#transform_keys!`, `Hash#deep_transform_keys`, and `Hash#deep_transform_keys!`. *Mark McSpadden*
+    `eql?` also requires that the other object is an `ActiveSupport::Duration`.
+    This requirement makes `ActiveSupport::Duration`'s behavior consistent with
+    the behavior of Ruby's numeric types:
 
-*   Changed XML type `datetime` to `dateTime` (with upper case letter `T`). *Angelo Capilleri*
+        1.eql?(1.0) # => false
+        1.0.eql?(1) # => false
 
-*   Add `:instance_accessor` option for `class_attribute`. *Alexey Vakhov*
+        1.second.eql?(1) # => false (was true)
+        1.eql?(1.second) # => false
 
-*   `constantize` now looks in the ancestor chain. *Marc-Andre Lafortune & Andrew White*
+        { 1 => "foo", 1.0 => "bar" }
+        # => { 1 => "foo", 1.0 => "bar" }
 
-*   Adds `Hash#deep_stringify_keys` and `Hash#deep_stringify_keys!` to convert all keys from a `Hash` instance into strings. *Lucas Húngaro*
+        { 1 => "foo", 1.second => "bar" }
+        # now => { 1 => "foo", 1.second => "bar" }
+        # was => { 1 => "bar" }
 
-*   Adds `Hash#deep_symbolize_keys` and `Hash#deep_symbolize_keys!` to convert all keys from a `Hash` instance into symbols. *Lucas Húngaro*
+    And though the behavior of these hasn't changed, for reference:
 
-*   `Object#try` can't call private methods. *Vasiliy Ermolovich*
+        1 == 1.0 # => true
+        1.0 == 1 # => true
 
-*   `AS::Callbacks#run_callbacks` remove `key` argument. *Francesco Rodriguez*
+        1 == 1.second # => true
+        1.second == 1 # => true
 
-*   `deep_dup` works more expectedly now and duplicates also values in `Hash` instances and elements in `Array` instances. *Alexey Gaziev*
+    *Emily Dobervich*
 
-*   Inflector no longer applies ice -> ouse to words like "slice", "police", etc. *Wes Morgan*
+*   `ActiveSupport::SafeBuffer#prepend` acts like `String#prepend` and modifies
+    instance in-place, returning self. `ActiveSupport::SafeBuffer#prepend!` is
+    deprecated.
 
-*   Add `ActiveSupport::Deprecations.behavior = :silence` to completely ignore Rails runtime deprecations. *twinturbo*
+    *Pavel Pravosud*
 
-*   Make `Module#delegate` stop using `send` - can no longer delegate to private methods. *dasch*
+*   `HashWithIndifferentAccess` better respects `#to_hash` on objects it
+    receives. In particular, `.new`, `#update`, `#merge`, and `#replace` accept
+    objects which respond to `#to_hash`, even if those objects are not hashes
+    directly.
 
-*   `ActiveSupport::Callbacks`: deprecate `:rescuable` option. *Bogdan Gusiev*
+    *Peter Jaros*
 
-*   Adds `Integer#ordinal` to get the ordinal suffix string of an integer. *Tim Gildea*
+*   Deprecate `Class#superclass_delegating_accessor`, use `Class#class_attribute` instead.
 
-*   `ActiveSupport::Callbacks`: `:per_key` option is no longer supported. *Bogdan Gusiev*
+    *Akshay Vishnoi*
 
-*   `ActiveSupport::Callbacks#define_callbacks`: add `:skip_after_callbacks_if_terminated` option. *Bogdan Gusiev*
+*   Ensure classes which `include Enumerable` get `#to_json` in addition to
+    `#as_json`.
 
-*   Add `html_escape_once` to `ERB::Util`, and delegate the `escape_once` tag helper to it. *Carlos Antonio da Silva*
+    *Sammy Larbi*
 
-*   Deprecates the compatibility method `Module#local_constant_names`,
-    use `Module#local_constants` instead (which returns symbols). *Xavier Noria*
+*   Change the signature of `fetch_multi` to return a hash rather than an
+    array. This makes it consistent with the output of `read_multi`.
 
-*   Deletes the compatibility method `Module#method_names`,
-    use `Module#methods` from now on (which returns symbols). *Xavier Noria*
+    *Parker Selbert*
 
-*   Deletes the compatibility method `Module#instance_method_names`,
-    use `Module#instance_methods` from now on (which returns symbols). *Xavier Noria*
+*   Introduce `Concern#class_methods` as a sleek alternative to clunky
+    `module ClassMethods`. Add `Kernel#concern` to define at the toplevel
+    without chunky `module Foo; extend ActiveSupport::Concern` boilerplate.
 
-*   `BufferedLogger` is deprecated. Use `ActiveSupport::Logger`, or the logger
-    from the Ruby standard library.
+        # app/models/concerns/authentication.rb
+        concern :Authentication do
+          included do
+            after_create :generate_private_key
+          end
 
-    *Aaron Patterson*
+          class_methods do
+            def authenticate(credentials)
+              # ...
+            end
+          end
 
-*   Unicode database updated to 6.1.0. *Norman Clarke*
+          def generate_private_key
+            # ...
+          end
+        end
 
-*   Adds `encode_big_decimal_as_string` option to force JSON serialization of `BigDecimal` as numeric instead
-    of wrapping them in strings for safety.
+        # app/models/user.rb
+        class User < ActiveRecord::Base
+          include Authentication
+        end
 
-*   Optimize log subscribers to check log level before doing any processing. *Brian Durand*
+    *Jeremy Kemper*
 
-Please check [3-2-stable](https://github.com/rails/rails/blob/3-2-stable/activesupport/CHANGELOG.md) for previous changes.
+Please check [4-1-stable](https://github.com/rails/rails/blob/4-1-stable/activesupport/CHANGELOG.md) for previous changes.