activesupport 7.0.8 → 7.1.3.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (179) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +940 -286
  3. data/MIT-LICENSE +1 -1
  4. data/README.rdoc +4 -4
  5. data/lib/active_support/actionable_error.rb +3 -1
  6. data/lib/active_support/array_inquirer.rb +2 -0
  7. data/lib/active_support/backtrace_cleaner.rb +25 -5
  8. data/lib/active_support/benchmarkable.rb +1 -0
  9. data/lib/active_support/broadcast_logger.rb +250 -0
  10. data/lib/active_support/builder.rb +1 -1
  11. data/lib/active_support/cache/coder.rb +153 -0
  12. data/lib/active_support/cache/entry.rb +134 -0
  13. data/lib/active_support/cache/file_store.rb +37 -10
  14. data/lib/active_support/cache/mem_cache_store.rb +100 -76
  15. data/lib/active_support/cache/memory_store.rb +78 -24
  16. data/lib/active_support/cache/null_store.rb +6 -0
  17. data/lib/active_support/cache/redis_cache_store.rb +151 -141
  18. data/lib/active_support/cache/serializer_with_fallback.rb +175 -0
  19. data/lib/active_support/cache/strategy/local_cache.rb +29 -14
  20. data/lib/active_support/cache.rb +331 -252
  21. data/lib/active_support/callbacks.rb +44 -21
  22. data/lib/active_support/concern.rb +4 -2
  23. data/lib/active_support/concurrency/load_interlock_aware_monitor.rb +42 -3
  24. data/lib/active_support/concurrency/null_lock.rb +13 -0
  25. data/lib/active_support/configurable.rb +10 -0
  26. data/lib/active_support/core_ext/array/conversions.rb +2 -1
  27. data/lib/active_support/core_ext/array.rb +0 -1
  28. data/lib/active_support/core_ext/class/subclasses.rb +13 -10
  29. data/lib/active_support/core_ext/date/conversions.rb +2 -1
  30. data/lib/active_support/core_ext/date.rb +0 -1
  31. data/lib/active_support/core_ext/date_and_time/calculations.rb +10 -0
  32. data/lib/active_support/core_ext/date_time/conversions.rb +6 -2
  33. data/lib/active_support/core_ext/date_time.rb +0 -1
  34. data/lib/active_support/core_ext/digest/uuid.rb +1 -10
  35. data/lib/active_support/core_ext/enumerable.rb +3 -75
  36. data/lib/active_support/core_ext/erb/util.rb +196 -0
  37. data/lib/active_support/core_ext/hash/conversions.rb +1 -1
  38. data/lib/active_support/core_ext/hash/deep_merge.rb +22 -14
  39. data/lib/active_support/core_ext/module/attribute_accessors.rb +6 -0
  40. data/lib/active_support/core_ext/module/attribute_accessors_per_thread.rb +34 -16
  41. data/lib/active_support/core_ext/module/concerning.rb +6 -6
  42. data/lib/active_support/core_ext/module/delegation.rb +40 -11
  43. data/lib/active_support/core_ext/module/deprecation.rb +15 -12
  44. data/lib/active_support/core_ext/module/introspection.rb +0 -1
  45. data/lib/active_support/core_ext/numeric/bytes.rb +9 -0
  46. data/lib/active_support/core_ext/numeric/conversions.rb +2 -0
  47. data/lib/active_support/core_ext/numeric.rb +0 -1
  48. data/lib/active_support/core_ext/object/deep_dup.rb +16 -0
  49. data/lib/active_support/core_ext/object/inclusion.rb +13 -5
  50. data/lib/active_support/core_ext/object/instance_variables.rb +22 -12
  51. data/lib/active_support/core_ext/object/json.rb +11 -3
  52. data/lib/active_support/core_ext/object/with.rb +44 -0
  53. data/lib/active_support/core_ext/object/with_options.rb +4 -4
  54. data/lib/active_support/core_ext/object.rb +1 -0
  55. data/lib/active_support/core_ext/pathname/blank.rb +16 -0
  56. data/lib/active_support/core_ext/pathname/existence.rb +2 -0
  57. data/lib/active_support/core_ext/pathname.rb +1 -0
  58. data/lib/active_support/core_ext/range/conversions.rb +28 -7
  59. data/lib/active_support/core_ext/range/overlap.rb +40 -0
  60. data/lib/active_support/core_ext/range.rb +1 -2
  61. data/lib/active_support/core_ext/securerandom.rb +24 -12
  62. data/lib/active_support/core_ext/string/filters.rb +20 -14
  63. data/lib/active_support/core_ext/string/indent.rb +1 -1
  64. data/lib/active_support/core_ext/string/inflections.rb +16 -5
  65. data/lib/active_support/core_ext/string/output_safety.rb +38 -174
  66. data/lib/active_support/core_ext/thread/backtrace/location.rb +12 -0
  67. data/lib/active_support/core_ext/time/calculations.rb +18 -2
  68. data/lib/active_support/core_ext/time/conversions.rb +2 -2
  69. data/lib/active_support/core_ext/time/zones.rb +4 -4
  70. data/lib/active_support/core_ext/time.rb +0 -1
  71. data/lib/active_support/current_attributes.rb +15 -6
  72. data/lib/active_support/deep_mergeable.rb +53 -0
  73. data/lib/active_support/dependencies/autoload.rb +17 -12
  74. data/lib/active_support/deprecation/behaviors.rb +65 -42
  75. data/lib/active_support/deprecation/constant_accessor.rb +5 -4
  76. data/lib/active_support/deprecation/deprecators.rb +104 -0
  77. data/lib/active_support/deprecation/disallowed.rb +3 -5
  78. data/lib/active_support/deprecation/instance_delegator.rb +31 -4
  79. data/lib/active_support/deprecation/method_wrappers.rb +6 -23
  80. data/lib/active_support/deprecation/proxy_wrappers.rb +37 -22
  81. data/lib/active_support/deprecation/reporting.rb +42 -25
  82. data/lib/active_support/deprecation.rb +32 -5
  83. data/lib/active_support/deprecator.rb +7 -0
  84. data/lib/active_support/descendants_tracker.rb +104 -132
  85. data/lib/active_support/duration/iso8601_serializer.rb +0 -2
  86. data/lib/active_support/duration.rb +2 -1
  87. data/lib/active_support/encrypted_configuration.rb +30 -9
  88. data/lib/active_support/encrypted_file.rb +8 -3
  89. data/lib/active_support/environment_inquirer.rb +22 -2
  90. data/lib/active_support/error_reporter/test_helper.rb +15 -0
  91. data/lib/active_support/error_reporter.rb +121 -35
  92. data/lib/active_support/execution_wrapper.rb +4 -4
  93. data/lib/active_support/file_update_checker.rb +4 -2
  94. data/lib/active_support/fork_tracker.rb +10 -2
  95. data/lib/active_support/gem_version.rb +4 -4
  96. data/lib/active_support/gzip.rb +2 -0
  97. data/lib/active_support/hash_with_indifferent_access.rb +35 -17
  98. data/lib/active_support/html_safe_translation.rb +12 -2
  99. data/lib/active_support/i18n.rb +1 -1
  100. data/lib/active_support/i18n_railtie.rb +20 -13
  101. data/lib/active_support/inflector/inflections.rb +2 -0
  102. data/lib/active_support/inflector/methods.rb +23 -11
  103. data/lib/active_support/inflector/transliterate.rb +3 -1
  104. data/lib/active_support/isolated_execution_state.rb +26 -22
  105. data/lib/active_support/json/decoding.rb +2 -1
  106. data/lib/active_support/json/encoding.rb +25 -43
  107. data/lib/active_support/key_generator.rb +9 -1
  108. data/lib/active_support/lazy_load_hooks.rb +6 -4
  109. data/lib/active_support/locale/en.yml +2 -0
  110. data/lib/active_support/log_subscriber.rb +84 -33
  111. data/lib/active_support/logger.rb +9 -60
  112. data/lib/active_support/logger_thread_safe_level.rb +10 -24
  113. data/lib/active_support/message_encryptor.rb +197 -53
  114. data/lib/active_support/message_encryptors.rb +141 -0
  115. data/lib/active_support/message_pack/cache_serializer.rb +23 -0
  116. data/lib/active_support/message_pack/extensions.rb +292 -0
  117. data/lib/active_support/message_pack/serializer.rb +63 -0
  118. data/lib/active_support/message_pack.rb +50 -0
  119. data/lib/active_support/message_verifier.rb +212 -93
  120. data/lib/active_support/message_verifiers.rb +135 -0
  121. data/lib/active_support/messages/codec.rb +65 -0
  122. data/lib/active_support/messages/metadata.rb +111 -45
  123. data/lib/active_support/messages/rotation_coordinator.rb +93 -0
  124. data/lib/active_support/messages/rotator.rb +34 -32
  125. data/lib/active_support/messages/serializer_with_fallback.rb +158 -0
  126. data/lib/active_support/multibyte/chars.rb +2 -0
  127. data/lib/active_support/multibyte/unicode.rb +9 -37
  128. data/lib/active_support/notifications/fanout.rb +245 -81
  129. data/lib/active_support/notifications/instrumenter.rb +77 -20
  130. data/lib/active_support/notifications.rb +1 -1
  131. data/lib/active_support/number_helper/number_converter.rb +14 -5
  132. data/lib/active_support/number_helper/number_to_currency_converter.rb +6 -6
  133. data/lib/active_support/number_helper/number_to_human_size_converter.rb +3 -3
  134. data/lib/active_support/number_helper/number_to_phone_converter.rb +1 -0
  135. data/lib/active_support/number_helper.rb +379 -318
  136. data/lib/active_support/ordered_hash.rb +3 -3
  137. data/lib/active_support/ordered_options.rb +14 -0
  138. data/lib/active_support/parameter_filter.rb +84 -69
  139. data/lib/active_support/proxy_object.rb +2 -0
  140. data/lib/active_support/railtie.rb +33 -21
  141. data/lib/active_support/reloader.rb +12 -4
  142. data/lib/active_support/rescuable.rb +2 -0
  143. data/lib/active_support/secure_compare_rotator.rb +16 -9
  144. data/lib/active_support/string_inquirer.rb +3 -1
  145. data/lib/active_support/subscriber.rb +9 -27
  146. data/lib/active_support/syntax_error_proxy.rb +70 -0
  147. data/lib/active_support/tagged_logging.rb +60 -24
  148. data/lib/active_support/test_case.rb +153 -6
  149. data/lib/active_support/testing/assertions.rb +26 -10
  150. data/lib/active_support/testing/autorun.rb +0 -2
  151. data/lib/active_support/testing/constant_stubbing.rb +32 -0
  152. data/lib/active_support/testing/deprecation.rb +25 -25
  153. data/lib/active_support/testing/error_reporter_assertions.rb +107 -0
  154. data/lib/active_support/testing/isolation.rb +1 -1
  155. data/lib/active_support/testing/method_call_assertions.rb +21 -8
  156. data/lib/active_support/testing/parallelize_executor.rb +8 -3
  157. data/lib/active_support/testing/stream.rb +1 -1
  158. data/lib/active_support/testing/strict_warnings.rb +39 -0
  159. data/lib/active_support/testing/time_helpers.rb +37 -15
  160. data/lib/active_support/time_with_zone.rb +4 -14
  161. data/lib/active_support/values/time_zone.rb +9 -7
  162. data/lib/active_support/version.rb +1 -1
  163. data/lib/active_support/xml_mini/jdom.rb +3 -10
  164. data/lib/active_support/xml_mini/nokogiri.rb +1 -1
  165. data/lib/active_support/xml_mini/nokogirisax.rb +1 -1
  166. data/lib/active_support/xml_mini/rexml.rb +1 -1
  167. data/lib/active_support/xml_mini.rb +2 -2
  168. data/lib/active_support.rb +14 -3
  169. metadata +103 -16
  170. data/lib/active_support/core_ext/array/deprecated_conversions.rb +0 -25
  171. data/lib/active_support/core_ext/date/deprecated_conversions.rb +0 -40
  172. data/lib/active_support/core_ext/date_time/deprecated_conversions.rb +0 -36
  173. data/lib/active_support/core_ext/numeric/deprecated_conversions.rb +0 -60
  174. data/lib/active_support/core_ext/range/deprecated_conversions.rb +0 -36
  175. data/lib/active_support/core_ext/range/include_time_with_zone.rb +0 -5
  176. data/lib/active_support/core_ext/range/overlaps.rb +0 -10
  177. data/lib/active_support/core_ext/time/deprecated_conversions.rb +0 -73
  178. data/lib/active_support/core_ext/uri.rb +0 -5
  179. data/lib/active_support/per_thread_registry.rb +0 -65
data/CHANGELOG.md CHANGED
@@ -1,565 +1,1219 @@
1
- ## Rails 7.0.8 (September 09, 2023) ##
1
+ ## Rails 7.1.3.4 (June 04, 2024) ##
2
2
 
3
- * Fix `TimeWithZone` still using deprecated `#to_s` when `ENV` or `config` to
4
- disable it are set.
3
+ * No changes.
5
4
 
6
- *Hartley McGuire*
7
5
 
8
- * Fix CacheStore#write_multi when using a distributed Redis cache with a connection pool.
6
+ ## Rails 7.1.3.3 (May 16, 2024) ##
7
+
8
+ * No changes.
9
+
9
10
 
10
- Fixes [#48938](https://github.com/rails/rails/issues/48938).
11
+ ## Rails 7.1.3.2 (February 21, 2024) ##
11
12
 
12
- *Jonathan del Strother*
13
+ * No changes.
13
14
 
14
15
 
15
- ## Rails 7.0.7.2 (August 22, 2023) ##
16
+ ## Rails 7.1.3.1 (February 21, 2024) ##
16
17
 
17
18
  * No changes.
18
19
 
19
20
 
20
- ## Rails 7.0.7.1 (August 22, 2023) ##
21
+ ## Rails 7.1.3 (January 16, 2024) ##
22
+
23
+ * Handle nil `backtrace_locations` in `ActiveSupport::SyntaxErrorProxy`.
24
+
25
+ *Eugene Kenny*
26
+
27
+ * Fix `ActiveSupport::JSON.encode` to prevent duplicate keys.
28
+
29
+ If the same key exist in both String and Symbol form it could
30
+ lead to the same key being emitted twice.
31
+
32
+ *Manish Sharma*
21
33
 
22
- * Use a temporary file for storing unencrypted files while editing
34
+ * Fix `ActiveSupport::Cache::Store#read_multi` when using a cache namespace
35
+ and local cache strategy.
23
36
 
24
- [CVE-2023-38037]
37
+ *Mark Oleson*
25
38
 
39
+ * Fix `Time.now/DateTime.now/Date.today` to return results in a system timezone after `#travel_to`.
26
40
 
27
- ## Rails 7.0.7 (August 09, 2023) ##
41
+ There is a bug in the current implementation of #travel_to:
42
+ it remembers a timezone of its argument, and all stubbed methods start
43
+ returning results in that remembered timezone. However, the expected
44
+ behaviour is to return results in a system timezone.
28
45
 
29
- * Fix `Cache::NullStore` with local caching for repeated reads.
46
+ *Aleksei Chernenkov*
47
+
48
+ * Fix `:unless_exist` option for `MemoryStore#write` (et al) when using a
49
+ cache namespace.
50
+
51
+ *S. Brent Faulkner*
52
+
53
+ * Fix ActiveSupport::Deprecation to handle blaming generated code.
54
+
55
+ *Jean Boussier*, *fatkodima*
56
+
57
+
58
+ ## Rails 7.1.2 (November 10, 2023) ##
59
+
60
+ * Fix `:expires_in` option for `RedisCacheStore#write_multi`.
30
61
 
31
62
  *fatkodima*
32
63
 
33
- * Fix `to_s` with no arguments not respecting custom `:default` formats
64
+ * Fix deserialization of non-string "purpose" field in Message serializer
34
65
 
35
- *Hartley McGuire*
66
+ *Jacopo Beschi*
36
67
 
37
- * Fix `ActiveSupport::Inflector.humanize(nil)` raising ``NoMethodError: undefined method `end_with?' for nil:NilClass``.
68
+ * Prevent global cache options being overwritten when setting dynamic options
69
+ inside a `ActiveSupport::Cache::Store#fetch` block.
38
70
 
39
- *James Robinson*
71
+ *Yasha Krasnou*
40
72
 
41
- * Fix `Enumerable#sum` for `Enumerator#lazy`.
73
+ * Fix missing `require` resulting in `NoMethodError` when running
74
+ `bin/rails secrets:show` or `bin/rails secrets:edit`.
42
75
 
43
- *fatkodima*, *Matthew Draper*, *Jonathan Hefner*
76
+ *Stephen Ierodiaconou*
44
77
 
45
- * Improve error message when EventedFileUpdateChecker is used without a
46
- compatible version of the Listen gem
78
+ * Ensure `{down,up}case_first` returns non-frozen string.
47
79
 
48
- *Hartley McGuire*
80
+ *Jonathan Hefner*
49
81
 
82
+ * Fix `#to_fs(:human_size)` to correctly work with negative numbers.
50
83
 
51
- ## Rails 7.0.6 (June 29, 2023) ##
84
+ *Earlopain*
52
85
 
53
- * Fix `EncryptedConfiguration` returning incorrect values for some `Hash`
54
- methods
86
+ * Fix `BroadcastLogger#dup` so that it duplicates the logger's `broadcasts`.
55
87
 
56
- *Hartley McGuire*
88
+ *Andrew Novoselac*
57
89
 
58
- * Fix arguments being destructed `Enumerable#many?` with block.
90
+ * Fix issue where `bootstrap.rb` overwrites the `level` of a `BroadcastLogger`'s `broadcasts`.
59
91
 
60
92
  *Andrew Novoselac*
61
93
 
62
- * Fix humanize for strings ending with id.
94
+ * Fix `ActiveSupport::Cache` to handle outdated Marshal payload from Rails 6.1 format.
95
+
96
+ Active Support's Cache is supposed to treat a Marshal payload that can no longer be
97
+ deserialized as a cache miss. It fail to do so for compressed payload in the Rails 6.1
98
+ legacy format.
99
+
100
+ *Jean Boussier*
101
+
102
+ * Fix `OrderedOptions#dig` for array indexes.
103
+
104
+ *fatkodima*
105
+
106
+ * Fix time travel helpers to work when nested using with separate classes.
63
107
 
64
108
  *fatkodima*
65
109
 
110
+ * Fix `delete_matched` for file cache store to work with keys longer than the
111
+ max filename size.
66
112
 
67
- ## Rails 7.0.5.1 (June 26, 2023) ##
113
+ *fatkodima* and *Jonathan Hefner*
68
114
 
69
- * No changes.
115
+ * Fix compatibility with the `semantic_logger` gem.
70
116
 
117
+ The `semantic_logger` gem doesn't behave exactly like stdlib logger in that
118
+ `SemanticLogger#level` returns a Symbol while stdlib `Logger#level` returns an Integer.
71
119
 
72
- ## Rails 7.0.5 (May 24, 2023) ##
120
+ This caused the various `LogSubscriber` classes in Rails to break when assigned a
121
+ `SemanticLogger` instance.
73
122
 
74
- * Fixes TimeWithZone ArgumentError.
123
+ *Jean Boussier*, *ojab*
75
124
 
76
- *Niklas Häusele*
125
+ ## Rails 7.1.1 (October 11, 2023) ##
77
126
 
127
+ * Add support for keyword arguments when delegating calls to custom loggers from `ActiveSupport::BroadcastLogger`.
78
128
 
79
- ## Rails 7.0.4.3 (March 13, 2023) ##
129
+ *Edouard Chin*
130
+
131
+ * `NumberHelper`: handle objects responding `to_d`.
132
+
133
+ *fatkodima*
80
134
 
81
- * Implement SafeBuffer#bytesplice
135
+ * Fix RedisCacheStore to properly set the TTL when incrementing or decrementing.
82
136
 
83
- [CVE-2023-28120]
137
+ This bug was only impacting Redis server older than 7.0.
84
138
 
139
+ *Thomas Countz*
85
140
 
86
- ## Rails 7.0.4.2 (January 24, 2023) ##
141
+ * Fix MemoryStore to prevent race conditions when incrementing or decrementing.
142
+
143
+ *Pierre Jambet*
144
+
145
+
146
+ ## Rails 7.1.0 (October 05, 2023) ##
87
147
 
88
148
  * No changes.
89
149
 
90
150
 
91
- ## Rails 7.0.4.1 (January 17, 2023) ##
151
+ ## Rails 7.1.0.rc2 (October 01, 2023) ##
92
152
 
93
- * Avoid regex backtracking in Inflector.underscore
153
+ * Fix `AS::MessagePack` with `ENV["RAILS_MAX_THREADS"]`.
94
154
 
95
- [CVE-2023-22796]
155
+ *Jonathan Hefner*
96
156
 
97
157
 
98
- ## Rails 7.0.4 (September 09, 2022) ##
158
+ ## Rails 7.1.0.rc1 (September 27, 2023) ##
99
159
 
100
- * Ensure `ActiveSupport::Testing::Isolation::Forking` closes pipes
160
+ * Add a new public API for broadcasting logs
101
161
 
102
- Previously, `Forking.run_in_isolation` opened two ends of a pipe. The fork
103
- process closed the read end, wrote to it, and then terminated (which
104
- presumably closed the file descriptors on its end). The parent process
105
- closed the write end, read from it, and returned, never closing the read
106
- end.
162
+ This feature existed for a while but was until now a private API.
163
+ Broadcasting log allows to send log message to difference sinks (STDOUT, a file ...) and
164
+ is used by default in the development environment to write logs both on STDOUT and in the
165
+ "development.log" file.
107
166
 
108
- This resulted in an accumulation of open file descriptors, which could
109
- cause errors if the limit is reached.
167
+ Basic usage:
110
168
 
111
- *Sam Bostock*
169
+ ```ruby
170
+ stdout_logger = Logger.new(STDOUT)
171
+ file_logger = Logger.new("development.log")
172
+ broadcast = ActiveSupport::BroadcastLogger.new(stdout_logger, file_logger)
112
173
 
113
- * Redis cache store is now compatible with redis-rb 5.0.
174
+ broadcast.info("Hello!") # The "Hello!" message is written on STDOUT and in the log file.
175
+ ```
114
176
 
115
- *Jean Boussier*
177
+ Adding other sink(s) to the broadcast:
116
178
 
117
- * Fix `NoMethodError` on custom `ActiveSupport::Deprecation` behavior.
179
+ ```ruby
180
+ broadcast = ActiveSupport::BroadcastLogger.new
181
+ broadcast.broadcast_to(Logger.new(STDERR))
182
+ ```
118
183
 
119
- `ActiveSupport::Deprecation.behavior=` was supposed to accept any object
120
- that responds to `call`, but in fact its internal implementation assumed that
121
- this object could respond to `arity`, so it was restricted to only `Proc` objects.
184
+ Remove a sink from the broadcast:
122
185
 
123
- This change removes this `arity` restriction of custom behaviors.
186
+ ```ruby
187
+ stdout_logger = Logger.new(STDOUT)
188
+ broadcast = ActiveSupport::BroadcastLogger.new(stdout_logger)
124
189
 
125
- *Ryo Nakamura*
190
+ broadcast.stop_broadcasting_to(stdout_logger)
191
+ ```
126
192
 
193
+ *Edouard Chin*
127
194
 
128
- ## Rails 7.0.3.1 (July 12, 2022) ##
195
+ * Fix Range#overlap? not taking empty ranges into account on Ruby < 3.3
129
196
 
130
- * No changes.
197
+ *Nobuyoshi Nakada*, *Shouichi Kamiya*, *Hartley McGuire*
131
198
 
199
+ * Use Ruby 3.3 Range#overlap? if available
132
200
 
133
- ## Rails 7.0.3 (May 09, 2022) ##
201
+ *Yasuo Honda*
134
202
 
135
- * No changes.
136
203
 
204
+ ## Rails 7.1.0.beta1 (September 13, 2023) ##
137
205
 
138
- ## Rails 7.0.2.4 (April 26, 2022) ##
206
+ * Add `bigdecimal` as Active Support dependency that is a bundled gem candidate for Ruby 3.4.
139
207
 
140
- * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
208
+ `bigdecimal` 3.1.4 or higher version will be installed.
209
+ Ruby 2.7 and 3.0 users who want `bigdecimal` version 2.0.0 or 3.0.0 behavior as a default gem,
210
+ pin the `bigdecimal` version in your application Gemfile.
141
211
 
142
- Add the method `ERB::Util.xml_name_escape` to escape dangerous characters
143
- in names of tags and names of attributes, following the specification of XML.
212
+ *Koichi ITO*
144
213
 
145
- *Álvaro Martín Fraguas*
214
+ * Add `drb`, `mutex_m` and `base64` that are bundled gem candidates for Ruby 3.4
146
215
 
147
- ## Rails 7.0.2.3 (March 08, 2022) ##
216
+ *Yasuo Honda*
148
217
 
149
- * No changes.
218
+ * When using cache format version >= 7.1 or a custom serializer, expired and
219
+ version-mismatched cache entries can now be detected without deserializing
220
+ their values.
150
221
 
222
+ *Jonathan Hefner*
151
223
 
152
- ## Rails 7.0.2.2 (February 11, 2022) ##
224
+ * Make all cache stores return a boolean for `#delete`
153
225
 
154
- * Fix Reloader method signature to work with the new Executor signature
226
+ Previously the `RedisCacheStore#delete` would return `1` if the entry
227
+ exists and `0` otherwise. Now it returns true if the entry exists and false
228
+ otherwise, just like the other stores.
155
229
 
230
+ The `FileStore` would return `nil` if the entry doesn't exists and returns
231
+ `false` now as well.
156
232
 
157
- ## Rails 7.0.2.1 (February 11, 2022) ##
233
+ *Petrik de Heus*
158
234
 
159
- * No changes.
235
+ * Active Support cache stores now support replacing the default compressor via
236
+ a `:compressor` option. The specified compressor must respond to `deflate`
237
+ and `inflate`. For example:
160
238
 
239
+ ```ruby
240
+ module MyCompressor
241
+ def self.deflate(string)
242
+ # compression logic...
243
+ end
161
244
 
162
- ## Rails 7.0.2 (February 08, 2022) ##
245
+ def self.inflate(compressed)
246
+ # decompression logic...
247
+ end
248
+ end
163
249
 
164
- * Fix `ActiveSupport::EncryptedConfiguration` to be compatible with Psych 4
250
+ config.cache_store = :redis_cache_store, { compressor: MyCompressor }
251
+ ```
165
252
 
166
- *Stephen Sugden*
253
+ *Jonathan Hefner*
167
254
 
168
- * Improve `File.atomic_write` error handling.
255
+ * Active Support cache stores now support a `:serializer` option. Similar to
256
+ the `:coder` option, serializers must respond to `dump` and `load`. However,
257
+ serializers are only responsible for serializing a cached value, whereas
258
+ coders are responsible for serializing the entire `ActiveSupport::Cache::Entry`
259
+ instance. Additionally, the output from serializers can be automatically
260
+ compressed, whereas coders are responsible for their own compression.
169
261
 
170
- *Daniel Pepper*
262
+ Specifying a serializer instead of a coder also enables performance
263
+ optimizations, including the bare string optimization introduced by cache
264
+ format version 7.1.
171
265
 
266
+ The `:serializer` and `:coder` options are mutually exclusive. Specifying
267
+ both will raise an `ArgumentError`.
172
268
 
173
- ## Rails 7.0.1 (January 06, 2022) ##
269
+ *Jonathan Hefner*
174
270
 
175
- * Fix `Class#descendants` and `DescendantsTracker#descendants` compatibility with Ruby 3.1.
271
+ * Fix `ActiveSupport::Inflector.humanize(nil)` raising ``NoMethodError: undefined method `end_with?' for nil:NilClass``.
176
272
 
177
- [The native `Class#descendants` was reverted prior to Ruby 3.1 release](https://bugs.ruby-lang.org/issues/14394#note-33),
178
- but `Class#subclasses` was kept, breaking the feature detection.
273
+ *James Robinson*
179
274
 
180
- *Jean Boussier*
275
+ * Don't show secrets for `ActiveSupport::KeyGenerator#inspect`.
276
+
277
+ Before:
278
+
279
+ ```ruby
280
+ ActiveSupport::KeyGenerator.new(secret).inspect
281
+ "#<ActiveSupport::KeyGenerator:0x0000000104888038 ... @secret=\"\\xAF\\bFh]LV}q\\nl\\xB2U\\xB3 ... >"
282
+ ```
283
+
284
+ After:
181
285
 
286
+ ```ruby
287
+ ActiveSupport::KeyGenerator::Aes256Gcm(secret).inspect
288
+ "#<ActiveSupport::KeyGenerator:0x0000000104888038>"
289
+ ```
182
290
 
183
- ## Rails 7.0.0 (December 15, 2021) ##
291
+ *Petrik de Heus*
184
292
 
185
- * Fix `ActiveSupport::Duration.build` to support negative values.
293
+ * Improve error message when EventedFileUpdateChecker is used without a
294
+ compatible version of the Listen gem
186
295
 
187
- The algorithm to collect the `parts` of the `ActiveSupport::Duration`
188
- ignored the sign of the `value` and accumulated incorrect part values. This
189
- impacted `ActiveSupport::Duration#sum` (which is dependent on `parts`) but
190
- not `ActiveSupport::Duration#eql?` (which is dependent on `value`).
296
+ *Hartley McGuire*
191
297
 
192
- *Caleb Buxton*, *Braden Staudacher*
298
+ * Add `:report` behavior for Deprecation
193
299
 
300
+ Setting `config.active_support.deprecation = :report` uses the error
301
+ reporter to report deprecation warnings to `ActiveSupport::ErrorReporter`.
194
302
 
195
- ## Rails 7.0.0.rc3 (December 14, 2021) ##
303
+ Deprecations are reported as handled errors, with a severity of `:warning`.
196
304
 
197
- * No changes.
305
+ Useful to report deprecations happening in production to your bug tracker.
198
306
 
307
+ *Étienne Barrié*
199
308
 
200
- ## Rails 7.0.0.rc2 (December 14, 2021) ##
309
+ * Rename `Range#overlaps?` to `#overlap?` and add alias for backwards compatibility
201
310
 
202
- * No changes.
311
+ *Christian Schmidt*
203
312
 
204
- ## Rails 7.0.0.rc1 (December 06, 2021) ##
313
+ * Fix `EncryptedConfiguration` returning incorrect values for some `Hash`
314
+ methods
205
315
 
206
- * Deprecate passing a format to `#to_s` in favor of `#to_formatted_s` in `Array`, `Range`, `Date`, `DateTime`, `Time`,
207
- `BigDecimal`, `Float` and, `Integer`.
316
+ *Hartley McGuire*
208
317
 
209
- *Rafael Mendonça França*
318
+ * Don't show secrets for `MessageEncryptor#inspect`.
210
319
 
211
- * Document `ActiveSupport::Testing::Deprecation`.
320
+ Before:
212
321
 
213
- *Sam Bostock & Sam Jordan*
322
+ ```ruby
323
+ ActiveSupport::MessageEncryptor.new(secret, cipher: "aes-256-gcm").inspect
324
+ "#<ActiveSupport::MessageEncryptor:0x0000000104888038 ... @secret=\"\\xAF\\bFh]LV}q\\nl\\xB2U\\xB3 ... >"
325
+ ```
214
326
 
215
- * Add `Pathname#existence`.
327
+ After:
216
328
 
217
329
  ```ruby
218
- Pathname.new("file").existence&.read
330
+ ActiveSupport::MessageEncryptor.new(secret, cipher: "aes-256-gcm").inspect
331
+ "#<ActiveSupport::MessageEncryptor:0x0000000104888038>"
219
332
  ```
220
333
 
221
- *Timo Schilling*
334
+ *Petrik de Heus*
222
335
 
223
- * Remove deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
336
+ * Don't show contents for `EncryptedConfiguration#inspect`.
224
337
 
225
- *Rafael Mendonça França*
338
+ Before:
339
+ ```ruby
340
+ Rails.application.credentials.inspect
341
+ "#<ActiveSupport::EncryptedConfiguration:0x000000010d2b38e8 ... @config={:secret=>\"something secret\"} ... @key_file_contents=\"915e4ea054e011022398dc242\" ...>"
342
+ ```
226
343
 
227
- * Remove deprecated support to use `Range#include?` to check the inclusion of a value in
228
- a date time range is deprecated.
344
+ After:
345
+ ```ruby
346
+ Rails.application.credentials.inspect
347
+ "#<ActiveSupport::EncryptedConfiguration:0x000000010d2b38e8>"
348
+ ```
229
349
 
230
- *Rafael Mendonça França*
350
+ *Petrik de Heus*
231
351
 
232
- * Remove deprecated `URI.parser`.
352
+ * `ERB::Util.html_escape_once` always returns an `html_safe` string.
233
353
 
234
- *Rafael Mendonça França*
354
+ This method previously maintained the `html_safe?` property of a string on the return
355
+ value. Because this string has been escaped, however, not marking it as `html_safe` causes
356
+ entities to be double-escaped.
235
357
 
236
- * Remove deprecated `config.active_support.use_sha1_digests`.
358
+ As an example, take this view snippet:
237
359
 
238
- *Rafael Mendonça França*
360
+ ```html
361
+ <p><%= html_escape_once("this & that &amp; the other") %></p>
362
+ ```
363
+
364
+ Before this change, that would be double-escaped and render as:
365
+
366
+ ```html
367
+ <p>this &amp;amp; that &amp;amp; the other</p>
368
+ ```
369
+
370
+ After this change, it renders correctly as:
371
+
372
+ ```html
373
+ <p>this &amp; that &amp; the other</p>
374
+ ```
375
+
376
+ Fixes #48256
377
+
378
+ *Mike Dalessio*
379
+
380
+ * Deprecate `SafeBuffer#clone_empty`.
381
+
382
+ This method has not been used internally since Rails 4.2.0.
383
+
384
+ *Mike Dalessio*
385
+
386
+ * `MessageEncryptor`, `MessageVerifier`, and `config.active_support.message_serializer`
387
+ now accept `:message_pack` and `:message_pack_allow_marshal` as serializers.
388
+ These serializers require the [`msgpack` gem](https://rubygems.org/gems/msgpack)
389
+ (>= 1.7.0).
390
+
391
+ The Message Pack format can provide improved performance and smaller payload
392
+ sizes. It also supports round-tripping some Ruby types that are not supported
393
+ by JSON. For example:
394
+
395
+ ```ruby
396
+ verifier = ActiveSupport::MessageVerifier.new("secret")
397
+ data = [{ a: 1 }, { b: 2 }.with_indifferent_access, 1.to_d, Time.at(0, 123)]
398
+ message = verifier.generate(data)
399
+
400
+ # BEFORE with config.active_support.message_serializer = :json
401
+ verifier.verified(message)
402
+ # => [{"a"=>1}, {"b"=>2}, "1.0", "1969-12-31T18:00:00.000-06:00"]
403
+ verifier.verified(message).map(&:class)
404
+ # => [Hash, Hash, String, String]
405
+
406
+ # AFTER with config.active_support.message_serializer = :message_pack
407
+ verifier.verified(message)
408
+ # => [{:a=>1}, {"b"=>2}, 0.1e1, 1969-12-31 18:00:00.000123 -0600]
409
+ verifier.verified(message).map(&:class)
410
+ # => [Hash, ActiveSupport::HashWithIndifferentAccess, BigDecimal, Time]
411
+ ```
412
+
413
+ The `:message_pack` serializer can fall back to deserializing with
414
+ `ActiveSupport::JSON` when necessary, and the `:message_pack_allow_marshal`
415
+ serializer can fall back to deserializing with `Marshal` as well as
416
+ `ActiveSupport::JSON`. Additionally, the `:marshal`, `:json`, and
417
+ `:json_allow_marshal` serializers can now fall back to deserializing with
418
+ `ActiveSupport::MessagePack` when necessary. These behaviors ensure old
419
+ messages can still be read so that migration is easier.
420
+
421
+ *Jonathan Hefner*
422
+
423
+ * A new `7.1` cache format is available which includes an optimization for
424
+ bare string values such as view fragments.
425
+
426
+ The `7.1` cache format is used by default for new apps, and existing apps
427
+ can enable the format by setting `config.load_defaults 7.1` or by setting
428
+ `config.active_support.cache_format_version = 7.1` in `config/application.rb`
429
+ or a `config/environments/*.rb` file.
430
+
431
+ Cache entries written using the `6.1` or `7.0` cache formats can be read
432
+ when using the `7.1` format. To perform a rolling deploy of a Rails 7.1
433
+ upgrade, wherein servers that have not yet been upgraded must be able to
434
+ read caches from upgraded servers, leave the cache format unchanged on the
435
+ first deploy, then enable the `7.1` cache format on a subsequent deploy.
436
+
437
+ *Jonathan Hefner*
239
438
 
240
- * Invoking `Object#with_options` without a `&block` argument returns the
241
- `ActiveSupport::OptionMerger` instance.
439
+ * Active Support cache stores can now use a preconfigured serializer based on
440
+ `ActiveSupport::MessagePack` via the `:serializer` option:
242
441
 
243
- *Sean Doyle*
442
+ ```ruby
443
+ config.cache_store = :redis_cache_store, { serializer: :message_pack }
444
+ ```
244
445
 
245
- * `Rails.application.executor` hooks can now be called around every test
446
+ The `:message_pack` serializer can reduce cache entry sizes and improve
447
+ performance, but requires the [`msgpack` gem](https://rubygems.org/gems/msgpack)
448
+ (>= 1.7.0).
246
449
 
247
- This helps to better simulate request or job local state being reset around tests and prevents state
248
- leaking from one test to another.
450
+ The `:message_pack` serializer can read cache entries written by the default
451
+ serializer, and the default serializer can now read entries written by the
452
+ `:message_pack` serializer. These behaviors make it easy to migrate between
453
+ serializer without invalidating the entire cache.
249
454
 
250
- However it requires the executor hooks executed in the test environment to be re-entrant.
455
+ *Jonathan Hefner*
251
456
 
252
- To enable this, set `config.active_support.executor_around_test_case = true` (this is the default in Rails 7).
457
+ * `Object#deep_dup` no longer duplicate named classes and modules.
458
+
459
+ Before:
460
+
461
+ ```ruby
462
+ hash = { class: Object, module: Kernel }
463
+ hash.deep_dup # => {:class=>#<Class:0x00000001063ffc80>, :module=>#<Module:0x00000001063ffa00>}
464
+ ```
465
+
466
+ After:
467
+
468
+ ```ruby
469
+ hash = { class: Object, module: Kernel }
470
+ hash.deep_dup # => {:class=>Object, :module=>Kernel}
471
+ ```
253
472
 
254
473
  *Jean Boussier*
255
474
 
256
- * `ActiveSupport::DescendantsTracker` now mostly delegate to `Class#descendants` on Ruby 3.1
475
+ * Consistently raise an `ArgumentError` if the `ActiveSupport::Cache` key is blank.
476
+
477
+ *Joshua Young*
478
+
479
+ * Deprecate usage of the singleton `ActiveSupport::Deprecation`.
480
+
481
+ All usage of `ActiveSupport::Deprecation` as a singleton is deprecated, the most common one being
482
+ `ActiveSupport::Deprecation.warn`. Gem authors should now create their own deprecator (`ActiveSupport::Deprecation`
483
+ object), and use it to emit deprecation warnings.
257
484
 
258
- Ruby now provides a fast `Class#descendants` making `ActiveSupport::DescendantsTracker` mostly useless.
485
+ Calling any of the following without specifying a deprecator argument is also deprecated:
486
+ * Module.deprecate
487
+ * deprecate_constant
488
+ * DeprecatedObjectProxy
489
+ * DeprecatedInstanceVariableProxy
490
+ * DeprecatedConstantProxy
491
+ * deprecation-related test assertions
259
492
 
260
- As a result the following methods are deprecated:
493
+ Use of `ActiveSupport::Deprecation.silence` and configuration methods like `behavior=`, `disallowed_behavior=`,
494
+ `disallowed_warnings=` should now be aimed at the [application's deprecators](https://api.rubyonrails.org/classes/Rails/Application.html#method-i-deprecators).
261
495
 
262
- - `ActiveSupport::DescendantsTracker.direct_descendants`
263
- - `ActiveSupport::DescendantsTracker#direct_descendants`
496
+ ```ruby
497
+ Rails.application.deprecators.silence do
498
+ # code that emits deprecation warnings
499
+ end
500
+ ```
501
+
502
+ If your gem has a Railtie or Engine, it's encouraged to add your deprecator to the application's deprecators, that
503
+ way the deprecation related configuration options will apply to it as well, e.g.
504
+ `config.active_support.report_deprecations` set to `false` in the production environment will also disable your
505
+ deprecator.
506
+
507
+ ```ruby
508
+ initializer "my_gem.deprecator" do |app|
509
+ app.deprecators[:my_gem] = MyGem.deprecator
510
+ end
511
+ ```
512
+
513
+ *Étienne Barrié*
514
+
515
+ * Add `Object#with` to set and restore public attributes around a block
516
+
517
+ ```ruby
518
+ client.timeout # => 5
519
+ client.with(timeout: 1) do
520
+ client.timeout # => 1
521
+ end
522
+ client.timeout # => 5
523
+ ```
264
524
 
265
525
  *Jean Boussier*
266
526
 
267
- * Fix the `Digest::UUID.uuid_from_hash` behavior for namespace IDs that are different from the ones defined on `Digest::UUID`.
527
+ * Remove deprecated support to generate incorrect RFC 4122 UUIDs when providing a namespace ID that is not one of the
528
+ constants defined on `Digest::UUID`.
268
529
 
269
- The new behavior will be enabled by setting the
270
- `config.active_support.use_rfc4122_namespaced_uuids` option to `true`
271
- and is the default for new apps.
530
+ *Rafael Mendonça França*
272
531
 
273
- The old behavior is the default for upgraded apps and will output a
274
- deprecation warning every time a value that is different than one of
275
- the constants defined on the `Digest::UUID` extension is used as the
276
- namespace ID.
532
+ * Deprecate `config.active_support.use_rfc4122_namespaced_uuids`.
277
533
 
278
- *Alex Robbin*, *Erich Soares Machado*, *Eugene Kenny*
534
+ *Rafael Mendonça França*
279
535
 
280
- * `ActiveSupport::Inflector::Inflections#clear(:acronyms)` is now supported,
281
- and `inflector.clear` / `inflector.clear(:all)` also clears acronyms.
536
+ * Remove implicit conversion of objects into `String` by `ActiveSupport::SafeBuffer`.
282
537
 
283
- *Alex Ghiculescu*, *Oliver Peate*
538
+ *Rafael Mendonça França*
284
539
 
540
+ * Remove deprecated `active_support/core_ext/range/include_time_with_zone` file.
285
541
 
286
- ## Rails 7.0.0.alpha2 (September 15, 2021) ##
542
+ *Rafael Mendonça França*
287
543
 
288
- * No changes.
544
+ * Deprecate `config.active_support.remove_deprecated_time_with_zone_name`.
289
545
 
546
+ *Rafael Mendonça França*
290
547
 
291
- ## Rails 7.0.0.alpha1 (September 15, 2021) ##
548
+ * Remove deprecated override of `ActiveSupport::TimeWithZone.name`.
292
549
 
293
- * `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.
550
+ *Rafael Mendonça França*
294
551
 
295
- *Xavier Noria*
552
+ * Deprecate `config.active_support.disable_to_s_conversion`.
296
553
 
297
- * Private internal classes of `ActiveSupport::Dependencies` have been deleted, like `ActiveSupport::Dependencies::Reference`, `ActiveSupport::Dependencies::Blamable`, and others.
554
+ *Rafael Mendonça França*
298
555
 
299
- *Xavier Noria*
556
+ * Remove deprecated option to passing a format to `#to_s` in `Array`, `Range`, `Date`, `DateTime`, `Time`,
557
+ `BigDecimal`, `Float` and, `Integer`.
300
558
 
301
- * The private API of `ActiveSupport::Dependencies` has been deleted. That includes methods like `hook!`, `unhook!`, `depend_on`, `require_or_load`, `mechanism`, and many others.
559
+ *Rafael Mendonça França*
302
560
 
303
- *Xavier Noria*
561
+ * Remove deprecated `ActiveSupport::PerThreadRegistry`.
304
562
 
305
- * Improves the performance of `ActiveSupport::NumberHelper` formatters by avoiding the use of exceptions as flow control.
563
+ *Rafael Mendonça França*
306
564
 
307
- *Mike Dalessio*
565
+ * Remove deprecated override of `Enumerable#sum`.
566
+
567
+ *Rafael Mendonça França*
568
+
569
+ * Deprecated initializing a `ActiveSupport::Cache::MemCacheStore` with an instance of `Dalli::Client`.
570
+
571
+ Deprecate the undocumented option of providing an already-initialized instance of `Dalli::Client` to `ActiveSupport::Cache::MemCacheStore`. Such clients could be configured with unrecognized options, which could lead to unexpected behavior. Instead, provide addresses as documented.
572
+
573
+ *aledustet*
574
+
575
+ * Stub `Time.new()` in `TimeHelpers#travel_to`
308
576
 
309
- * Removed rescue block from `ActiveSupport::Cache::RedisCacheStore#handle_exception`
577
+ ```ruby
578
+ travel_to Time.new(2004, 11, 24) do
579
+ # Inside the `travel_to` block `Time.new` is stubbed
580
+ assert_equal 2004, Time.new.year
581
+ end
582
+ ```
310
583
 
311
- Previously, if you provided a `error_handler` to `redis_cache_store`, any errors thrown by
312
- the error handler would be rescued and logged only. Removed the `rescue` clause from `handle_exception`
313
- to allow these to be thrown.
584
+ *fatkodima*
585
+
586
+ * Raise `ActiveSupport::MessageEncryptor::InvalidMessage` from
587
+ `ActiveSupport::MessageEncryptor#decrypt_and_verify` regardless of cipher.
588
+ Previously, when a `MessageEncryptor` was using a non-AEAD cipher such as
589
+ AES-256-CBC, a corrupt or tampered message would raise
590
+ `ActiveSupport::MessageVerifier::InvalidSignature`. Now, all ciphers raise
591
+ the same error:
592
+
593
+ ```ruby
594
+ encryptor = ActiveSupport::MessageEncryptor.new("x" * 32, cipher: "aes-256-gcm")
595
+ message = encryptor.encrypt_and_sign("message")
596
+ encryptor.decrypt_and_verify(message.next)
597
+ # => raises ActiveSupport::MessageEncryptor::InvalidMessage
598
+
599
+ encryptor = ActiveSupport::MessageEncryptor.new("x" * 32, cipher: "aes-256-cbc")
600
+ message = encryptor.encrypt_and_sign("message")
601
+ encryptor.decrypt_and_verify(message.next)
602
+ # BEFORE:
603
+ # => raises ActiveSupport::MessageVerifier::InvalidSignature
604
+ # AFTER:
605
+ # => raises ActiveSupport::MessageEncryptor::InvalidMessage
606
+ ```
607
+
608
+ *Jonathan Hefner*
609
+
610
+ * Support `nil` original values when using `ActiveSupport::MessageVerifier#verify`.
611
+ Previously, `MessageVerifier#verify` did not work with `nil` original
612
+ values, though both `MessageVerifier#verified` and
613
+ `MessageEncryptor#decrypt_and_verify` do:
314
614
 
315
- *Nicholas A. Stuart*
615
+ ```ruby
616
+ encryptor = ActiveSupport::MessageEncryptor.new(secret)
617
+ message = encryptor.encrypt_and_sign(nil)
316
618
 
317
- * Allow entirely opting out of deprecation warnings.
619
+ encryptor.decrypt_and_verify(message)
620
+ # => nil
318
621
 
319
- Previously if you did `app.config.active_support.deprecation = :silence`, some work would
320
- still be done on each call to `ActiveSupport::Deprecation.warn`. In very hot paths, this could
321
- cause performance issues.
622
+ verifier = ActiveSupport::MessageVerifier.new(secret)
623
+ message = verifier.generate(nil)
322
624
 
323
- Now, you can make `ActiveSupport::Deprecation.warn` a no-op:
625
+ verifier.verified(message)
626
+ # => nil
627
+
628
+ verifier.verify(message)
629
+ # BEFORE:
630
+ # => raises ActiveSupport::MessageVerifier::InvalidSignature
631
+ # AFTER:
632
+ # => nil
633
+ ```
634
+
635
+ *Jonathan Hefner*
636
+
637
+ * Maintain `html_safe?` on html_safe strings when sliced with `slice`, `slice!`, or `chr` method.
638
+
639
+ Previously, `html_safe?` was only maintained when the html_safe strings were sliced
640
+ with `[]` method. Now, `slice`, `slice!`, and `chr` methods will maintain `html_safe?` like `[]` method.
324
641
 
325
642
  ```ruby
326
- config.active_support.report_deprecations = false
643
+ string = "<div>test</div>".html_safe
644
+ string.slice(0, 1).html_safe? # => true
645
+ string.slice!(0, 1).html_safe? # => true
646
+ # maintain html_safe? after the slice!
647
+ string.html_safe? # => true
648
+ string.chr.html_safe? # => true
327
649
  ```
328
650
 
329
- This is the default in production for new apps. It is the equivalent to:
651
+ *Michael Go*
652
+
653
+ * Add `Object#in?` support for open ranges.
330
654
 
331
655
  ```ruby
332
- config.active_support.deprecation = :silence
333
- config.active_support.disallowed_deprecation = :silence
656
+ assert Date.today.in?(..Date.tomorrow)
657
+ assert_not Date.today.in?(Date.tomorrow..)
334
658
  ```
335
659
 
336
- but will take a more optimised code path.
660
+ *Ignacio Galindo*
661
+
662
+ * `config.i18n.raise_on_missing_translations = true` now raises on any missing translation.
663
+
664
+ Previously it would only raise when called in a view or controller. Now it will raise
665
+ anytime `I18n.t` is provided an unrecognised key.
666
+
667
+ If you do not want this behaviour, you can customise the i18n exception handler. See the
668
+ upgrading guide or i18n guide for more information.
337
669
 
338
670
  *Alex Ghiculescu*
339
671
 
340
- * Faster tests by parallelizing only when overhead is justified by the number
341
- of them.
672
+ * `ActiveSupport::CurrentAttributes` now raises if a restricted attribute name is used.
673
+
674
+ Attributes such as `set` and `reset` cannot be used as they clash with the
675
+ `CurrentAttributes` public API.
676
+
677
+ *Alex Ghiculescu*
342
678
 
343
- Running tests in parallel adds overhead in terms of database
344
- setup and fixture loading. Now, Rails will only parallelize test executions when
345
- there are enough tests to make it worth it.
679
+ * `HashWithIndifferentAccess#transform_keys` now takes a Hash argument, just
680
+ as Ruby's `Hash#transform_keys` does.
346
681
 
347
- This threshold is 50 by default, and is configurable via config setting in
348
- your test.rb:
682
+ *Akira Matsuda*
683
+
684
+ * `delegate` now defines method with proper arity when delegating to a Class.
685
+ With this change, it defines faster method (3.5x faster with no argument).
686
+ However, in order to gain this benefit, the delegation target method has to
687
+ be defined before declaring the delegation.
349
688
 
350
689
  ```ruby
351
- config.active_support.test_parallelization_threshold = 100
690
+ # This defines 3.5 times faster method than before
691
+ class C
692
+ def self.x() end
693
+ delegate :x, to: :class
694
+ end
695
+
696
+ class C
697
+ # This works but silently falls back to old behavior because
698
+ # `delegate` cannot find the definition of `x`
699
+ delegate :x, to: :class
700
+ def self.x() end
701
+ end
702
+ ```
703
+
704
+ *Akira Matsuda*
705
+
706
+ * `assert_difference` message now includes what changed.
707
+
708
+ This makes it easier to debug non-obvious failures.
709
+
710
+ Before:
711
+
712
+ ```
713
+ "User.count" didn't change by 32.
714
+ Expected: 1611
715
+ Actual: 1579
352
716
  ```
353
717
 
354
- It's also configurable at the test case level:
718
+ After:
719
+
720
+ ```
721
+ "User.count" didn't change by 32, but by 0.
722
+ Expected: 1611
723
+ Actual: 1579
724
+ ```
725
+
726
+ *Alex Ghiculescu*
727
+
728
+ * Add ability to match exception messages to `assert_raises` assertion
355
729
 
730
+ Instead of this
356
731
  ```ruby
357
- class ActiveSupport::TestCase
358
- parallelize threshold: 100
732
+ error = assert_raises(ArgumentError) do
733
+ perform_service(param: 'exception')
359
734
  end
735
+ assert_match(/incorrect param/i, error.message)
360
736
  ```
361
737
 
362
- *Jorge Manrubia*
738
+ you can now write this
739
+ ```ruby
740
+ assert_raises(ArgumentError, match: /incorrect param/i) do
741
+ perform_service(param: 'exception')
742
+ end
743
+ ```
363
744
 
364
- * OpenSSL constants are now used for Digest computations.
745
+ *fatkodima*
365
746
 
366
- *Dirkjan Bussink*
747
+ * Add `Rails.env.local?` shorthand for `Rails.env.development? || Rails.env.test?`.
367
748
 
368
- * `TimeZone.iso8601` now accepts valid ordinal values similar to Ruby's `Date._iso8601` method.
369
- A valid ordinal value will be converted to an instance of `TimeWithZone` using the `:year`
370
- and `:yday` fragments returned from `Date._iso8601`.
749
+ *DHH*
750
+
751
+ * `ActiveSupport::Testing::TimeHelpers` now accepts named `with_usec` argument
752
+ to `freeze_time`, `travel`, and `travel_to` methods. Passing true prevents
753
+ truncating the destination time with `change(usec: 0)`.
754
+
755
+ *KevSlashNull*, and *serprex*
756
+
757
+ * `ActiveSupport::CurrentAttributes.resets` now accepts a method name
758
+
759
+ The block API is still the recommended approach, but now both APIs are supported:
371
760
 
372
761
  ```ruby
373
- twz = ActiveSupport::TimeZone["Eastern Time (US & Canada)"].iso8601("21087")
374
- twz.to_a[0, 6] == [0, 0, 0, 28, 03, 2021]
762
+ class Current < ActiveSupport::CurrentAttributes
763
+ resets { Time.zone = nil }
764
+ resets :clear_time_zone
765
+ end
375
766
  ```
376
767
 
377
- *Steve Laing*
768
+ *Alex Ghiculescu*
378
769
 
379
- * `Time#change` and methods that call it (e.g. `Time#advance`) will now
380
- return a `Time` with the timezone argument provided, if the caller was
381
- initialized with a timezone argument.
770
+ * Ensure `ActiveSupport::Testing::Isolation::Forking` closes pipes
382
771
 
383
- Fixes [#42467](https://github.com/rails/rails/issues/42467).
772
+ Previously, `Forking.run_in_isolation` opened two ends of a pipe. The fork
773
+ process closed the read end, wrote to it, and then terminated (which
774
+ presumably closed the file descriptors on its end). The parent process
775
+ closed the write end, read from it, and returned, never closing the read
776
+ end.
384
777
 
385
- *Alex Ghiculescu*
778
+ This resulted in an accumulation of open file descriptors, which could
779
+ cause errors if the limit is reached.
780
+
781
+ *Sam Bostock*
386
782
 
387
- * Allow serializing any module or class to JSON by name.
783
+ * Fix `Time#change` and `Time#advance` for times around the end of Daylight
784
+ Saving Time.
388
785
 
389
- *Tyler Rick*, *Zachary Scott*
786
+ Previously, when `Time#change` or `Time#advance` constructed a time inside
787
+ the final stretch of Daylight Saving Time (DST), the non-DST offset would
788
+ always be chosen for local times:
390
789
 
391
- * Raise `ActiveSupport::EncryptedFile::MissingKeyError` when the
392
- `RAILS_MASTER_KEY` environment variable is blank (e.g. `""`).
790
+ ```ruby
791
+ # DST ended just before 2021-11-07 2:00:00 AM in US/Eastern.
792
+ ENV["TZ"] = "US/Eastern"
793
+
794
+ time = Time.local(2021, 11, 07, 00, 59, 59) + 1
795
+ # => 2021-11-07 01:00:00 -0400
796
+ time.change(day: 07)
797
+ # => 2021-11-07 01:00:00 -0500
798
+ time.advance(seconds: 0)
799
+ # => 2021-11-07 01:00:00 -0500
800
+
801
+ time = Time.local(2021, 11, 06, 01, 00, 00)
802
+ # => 2021-11-06 01:00:00 -0400
803
+ time.change(day: 07)
804
+ # => 2021-11-07 01:00:00 -0500
805
+ time.advance(days: 1)
806
+ # => 2021-11-07 01:00:00 -0500
807
+ ```
393
808
 
394
- *Sunny Ripert*
809
+ And the DST offset would always be chosen for times with a `TimeZone`
810
+ object:
395
811
 
396
- * The `from:` option is added to `ActiveSupport::TestCase#assert_no_changes`.
812
+ ```ruby
813
+ Time.zone = "US/Eastern"
814
+
815
+ time = Time.new(2021, 11, 07, 02, 00, 00, Time.zone) - 3600
816
+ # => 2021-11-07 01:00:00 -0500
817
+ time.change(day: 07)
818
+ # => 2021-11-07 01:00:00 -0400
819
+ time.advance(seconds: 0)
820
+ # => 2021-11-07 01:00:00 -0400
821
+
822
+ time = Time.new(2021, 11, 8, 01, 00, 00, Time.zone)
823
+ # => 2021-11-08 01:00:00 -0500
824
+ time.change(day: 07)
825
+ # => 2021-11-07 01:00:00 -0400
826
+ time.advance(days: -1)
827
+ # => 2021-11-07 01:00:00 -0400
828
+ ```
397
829
 
398
- It permits asserting on the initial value that is expected not to change.
830
+ Now, `Time#change` and `Time#advance` will choose the offset that matches
831
+ the original time's offset when possible:
399
832
 
400
833
  ```ruby
401
- assert_no_changes -> { Status.all_good? }, from: true do
402
- post :create, params: { status: { ok: true } }
834
+ ENV["TZ"] = "US/Eastern"
835
+
836
+ time = Time.local(2021, 11, 07, 00, 59, 59) + 1
837
+ # => 2021-11-07 01:00:00 -0400
838
+ time.change(day: 07)
839
+ # => 2021-11-07 01:00:00 -0400
840
+ time.advance(seconds: 0)
841
+ # => 2021-11-07 01:00:00 -0400
842
+
843
+ time = Time.local(2021, 11, 06, 01, 00, 00)
844
+ # => 2021-11-06 01:00:00 -0400
845
+ time.change(day: 07)
846
+ # => 2021-11-07 01:00:00 -0400
847
+ time.advance(days: 1)
848
+ # => 2021-11-07 01:00:00 -0400
849
+
850
+ Time.zone = "US/Eastern"
851
+
852
+ time = Time.new(2021, 11, 07, 02, 00, 00, Time.zone) - 3600
853
+ # => 2021-11-07 01:00:00 -0500
854
+ time.change(day: 07)
855
+ # => 2021-11-07 01:00:00 -0500
856
+ time.advance(seconds: 0)
857
+ # => 2021-11-07 01:00:00 -0500
858
+
859
+ time = Time.new(2021, 11, 8, 01, 00, 00, Time.zone)
860
+ # => 2021-11-08 01:00:00 -0500
861
+ time.change(day: 07)
862
+ # => 2021-11-07 01:00:00 -0500
863
+ time.advance(days: -1)
864
+ # => 2021-11-07 01:00:00 -0500
865
+ ```
866
+
867
+ *Kevin Hall*, *Takayoshi Nishida*, and *Jonathan Hefner*
868
+
869
+ * Fix MemoryStore to preserve entries TTL when incrementing or decrementing
870
+
871
+ This is to be more consistent with how MemCachedStore and RedisCacheStore behaves.
872
+
873
+ *Jean Boussier*
874
+
875
+ * `Rails.error.handle` and `Rails.error.record` filter now by multiple error classes.
876
+
877
+ ```ruby
878
+ Rails.error.handle(IOError, ArgumentError) do
879
+ 1 + '1' # raises TypeError
403
880
  end
881
+ 1 + 1 # TypeErrors are not IOErrors or ArgumentError, so this will *not* be handled
404
882
  ```
405
883
 
406
- *George Claghorn*
884
+ *Martin Spickermann*
407
885
 
408
- * Deprecate `ActiveSupport::SafeBuffer`'s incorrect implicit conversion of objects into string.
886
+ * `Class#subclasses` and `Class#descendants` now automatically filter reloaded classes.
409
887
 
410
- Except for a few methods like `String#%`, objects must implement `#to_str`
411
- to be implicitly converted to a String in string operations. In some
412
- circumstances `ActiveSupport::SafeBuffer` was incorrectly calling the
413
- explicit conversion method (`#to_s`) on them. This behavior is now
414
- deprecated.
888
+ Previously they could return old implementations of reloadable classes that have been
889
+ dereferenced but not yet garbage collected.
890
+
891
+ They now automatically filter such classes like `DescendantTracker#subclasses` and
892
+ `DescendantTracker#descendants`.
415
893
 
416
894
  *Jean Boussier*
417
895
 
418
- * Allow nested access to keys on `Rails.application.credentials`.
896
+ * `Rails.error.report` now marks errors as reported to avoid reporting them twice.
897
+
898
+ In some cases, users might want to report errors explicitly with some extra context
899
+ before letting it bubble up.
419
900
 
420
- Previously only top level keys in `credentials.yml.enc` could be accessed with method calls. Now any key can.
901
+ This also allows to safely catch and report errors outside of the execution context.
421
902
 
422
- For example, given these secrets:
903
+ *Jean Boussier*
423
904
 
424
- ```yml
425
- aws:
426
- access_key_id: 123
427
- secret_access_key: 345
905
+ * Add `assert_error_reported` and `assert_no_error_reported`
906
+
907
+ Allows to easily asserts an error happened but was handled
908
+
909
+ ```ruby
910
+ report = assert_error_reported(IOError) do
911
+ # ...
912
+ end
913
+ assert_equal "Oops", report.error.message
914
+ assert_equal "admin", report.context[:section]
915
+ assert_equal :warning, report.severity
916
+ assert_predicate report, :handled?
428
917
  ```
429
918
 
430
- `Rails.application.credentials.aws.access_key_id` will now return the same thing as
431
- `Rails.application.credentials.aws[:access_key_id]`.
919
+ *Jean Boussier*
432
920
 
433
- *Alex Ghiculescu*
921
+ * `ActiveSupport::Deprecation` behavior callbacks can now receive the
922
+ deprecator instance as an argument. This makes it easier for such callbacks
923
+ to change their behavior based on the deprecator's state. For example,
924
+ based on the deprecator's `debug` flag.
434
925
 
435
- * Added a faster and more compact `ActiveSupport::Cache` serialization format.
926
+ 3-arity and splat-args callbacks such as the following will now be passed
927
+ the deprecator instance as their third argument:
436
928
 
437
- It can be enabled with `config.active_support.cache_format_version = 7.0` or
438
- `config.load_defaults 7.0`. Regardless of the configuration Active Support
439
- 7.0 can read cache entries serialized by Active Support 6.1 which allows to
440
- upgrade without invalidating the cache. However Rails 6.1 can't read the
441
- new format, so all readers must be upgraded before the new format is enabled.
929
+ * `->(message, callstack, deprecator) { ... }`
930
+ * `->(*args) { ... }`
931
+ * `->(message, *other_args) { ... }`
442
932
 
443
- *Jean Boussier*
933
+ 2-arity and 4-arity callbacks such as the following will continue to behave
934
+ the same as before:
444
935
 
445
- * Add `Enumerable#sole`, per `ActiveRecord::FinderMethods#sole`. Returns the
446
- sole item of the enumerable, raising if no items are found, or if more than
447
- one is.
936
+ * `->(message, callstack) { ... }`
937
+ * `->(message, callstack, deprecation_horizon, gem_name) { ... }`
938
+ * `->(message, callstack, *deprecation_details) { ... }`
448
939
 
449
- *Asherah Connor*
940
+ *Jonathan Hefner*
450
941
 
451
- * Freeze `ActiveSupport::Duration#parts` and remove writer methods.
942
+ * `ActiveSupport::Deprecation#disallowed_warnings` now affects the instance on
943
+ which it is configured.
452
944
 
453
- Durations are meant to be value objects and should not be mutated.
945
+ This means that individual `ActiveSupport::Deprecation` instances can be
946
+ configured with their own disallowed warnings, and the global
947
+ `ActiveSupport::Deprecation.disallowed_warnings` now only affects the global
948
+ `ActiveSupport::Deprecation.warn`.
454
949
 
455
- *Andrew White*
950
+ **Before**
951
+
952
+ ```ruby
953
+ ActiveSupport::Deprecation.disallowed_warnings = ["foo"]
954
+ deprecator = ActiveSupport::Deprecation.new("2.0", "MyCoolGem")
955
+ deprecator.disallowed_warnings = ["bar"]
956
+
957
+ ActiveSupport::Deprecation.warn("foo") # => raise ActiveSupport::DeprecationException
958
+ ActiveSupport::Deprecation.warn("bar") # => print "DEPRECATION WARNING: bar"
959
+ deprecator.warn("foo") # => raise ActiveSupport::DeprecationException
960
+ deprecator.warn("bar") # => print "DEPRECATION WARNING: bar"
961
+ ```
456
962
 
457
- * Fix `ActiveSupport::TimeZone#utc_to_local` with fractional seconds.
963
+ **After**
458
964
 
459
- When `utc_to_local_returns_utc_offset_times` is false and the time
460
- instance had fractional seconds the new UTC time instance was out by
461
- a factor of 1,000,000 as the `Time.utc` constructor takes a usec
462
- value and not a fractional second value.
965
+ ```ruby
966
+ ActiveSupport::Deprecation.disallowed_warnings = ["foo"]
967
+ deprecator = ActiveSupport::Deprecation.new("2.0", "MyCoolGem")
968
+ deprecator.disallowed_warnings = ["bar"]
969
+
970
+ ActiveSupport::Deprecation.warn("foo") # => raise ActiveSupport::DeprecationException
971
+ ActiveSupport::Deprecation.warn("bar") # => print "DEPRECATION WARNING: bar"
972
+ deprecator.warn("foo") # => print "DEPRECATION WARNING: foo"
973
+ deprecator.warn("bar") # => raise ActiveSupport::DeprecationException
974
+ ```
463
975
 
464
- *Andrew White*
976
+ Note that global `ActiveSupport::Deprecation` methods such as `ActiveSupport::Deprecation.warn`
977
+ and `ActiveSupport::Deprecation.disallowed_warnings` have been deprecated.
978
+
979
+ *Jonathan Hefner*
465
980
 
466
- * Add `expires_at` argument to `ActiveSupport::Cache` `write` and `fetch` to set a cache entry TTL as an absolute time.
981
+ * Add italic and underline support to `ActiveSupport::LogSubscriber#color`
982
+
983
+ Previously, only bold text was supported via a positional argument.
984
+ This allows for bold, italic, and underline options to be specified
985
+ for colored logs.
467
986
 
468
987
  ```ruby
469
- Rails.cache.write(key, value, expires_at: Time.now.at_end_of_hour)
988
+ info color("Hello world!", :red, bold: true, underline: true)
470
989
  ```
471
990
 
991
+ *Gannon McGibbon*
992
+
993
+ * Add `String#downcase_first` method.
994
+
995
+ This method is the corollary of `String#upcase_first`.
996
+
997
+ *Mark Schneider*
998
+
999
+ * `thread_mattr_accessor` will call `.dup.freeze` on non-frozen default values.
1000
+
1001
+ This provides a basic level of protection against different threads trying
1002
+ to mutate a shared default object.
1003
+
1004
+ *Jonathan Hefner*
1005
+
1006
+ * Add `raise_on_invalid_cache_expiration_time` config to `ActiveSupport::Cache::Store`
1007
+
1008
+ Specifies if an `ArgumentError` should be raised if `Rails.cache` `fetch` or
1009
+ `write` are given an invalid `expires_at` or `expires_in` time.
1010
+
1011
+ Options are `true`, and `false`. If `false`, the exception will be reported
1012
+ as `handled` and logged instead. Defaults to `true` if `config.load_defaults >= 7.1`.
1013
+
1014
+ *Trevor Turk*
1015
+
1016
+ * `ActiveSupport::Cache::Store#fetch` now passes an options accessor to the block.
1017
+
1018
+ It makes possible to override cache options:
1019
+
1020
+ Rails.cache.fetch("3rd-party-token") do |name, options|
1021
+ token = fetch_token_from_remote
1022
+ # set cache's TTL to match token's TTL
1023
+ options.expires_in = token.expires_in
1024
+ token
1025
+ end
1026
+
1027
+ *Andrii Gladkyi*, *Jean Boussier*
1028
+
1029
+ * `default` option of `thread_mattr_accessor` now applies through inheritance and
1030
+ also across new threads.
1031
+
1032
+ Previously, the `default` value provided was set only at the moment of defining
1033
+ the attribute writer, which would cause the attribute to be uninitialized in
1034
+ descendants and in other threads.
1035
+
1036
+ Fixes #43312.
1037
+
1038
+ *Thierry Deo*
1039
+
1040
+ * Redis cache store is now compatible with redis-rb 5.0.
1041
+
472
1042
  *Jean Boussier*
473
1043
 
474
- * Deprecate `ActiveSupport::TimeWithZone.name` so that from Rails 7.1 it will use the default implementation.
1044
+ * Add `skip_nil:` support to `ActiveSupport::Cache::Store#fetch_multi`.
475
1045
 
476
- *Andrew White*
1046
+ *Daniel Alfaro*
477
1047
 
478
- * Deprecates Rails custom `Enumerable#sum` and `Array#sum` in favor of Ruby's native implementation which
479
- is considerably faster.
1048
+ * Add `quarter` method to date/time
480
1049
 
481
- Ruby requires an initializer for non-numeric type as per examples below:
1050
+ *Matt Swanson*
482
1051
 
483
- ```ruby
484
- %w[foo bar].sum('')
485
- # instead of %w[foo bar].sum
1052
+ * Fix `NoMethodError` on custom `ActiveSupport::Deprecation` behavior.
486
1053
 
487
- [[1, 2], [3, 4, 5]].sum([])
488
- # instead of [[1, 2], [3, 4, 5]].sum
489
- ```
1054
+ `ActiveSupport::Deprecation.behavior=` was supposed to accept any object
1055
+ that responds to `call`, but in fact its internal implementation assumed that
1056
+ this object could respond to `arity`, so it was restricted to only `Proc` objects.
490
1057
 
491
- *Alberto Mota*
1058
+ This change removes this `arity` restriction of custom behaviors.
492
1059
 
493
- * Tests parallelization is now disabled when running individual files to prevent the setup overhead.
1060
+ *Ryo Nakamura*
494
1061
 
495
- It can still be enforced if the environment variable `PARALLEL_WORKERS` is present and set to a value greater than 1.
1062
+ * Support `:url_safe` option for `MessageEncryptor`.
496
1063
 
497
- *Ricardo Díaz*
1064
+ The `MessageEncryptor` constructor now accepts a `:url_safe` option, similar
1065
+ to the `MessageVerifier` constructor. When enabled, this option ensures
1066
+ that messages use a URL-safe encoding.
498
1067
 
499
- * Fix proxying keyword arguments in `ActiveSupport::CurrentAttributes`.
1068
+ *Jonathan Hefner*
500
1069
 
501
- *Marcin Kołodziej*
1070
+ * Add `url_safe` option to `ActiveSupport::MessageVerifier` initializer
502
1071
 
503
- * Add `Enumerable#maximum` and `Enumerable#minimum` to easily calculate the maximum or minimum from extracted
504
- elements of an enumerable.
1072
+ `ActiveSupport::MessageVerifier.new` now takes optional `url_safe` argument.
1073
+ It can generate URL-safe strings by passing `url_safe: true`.
505
1074
 
506
1075
  ```ruby
507
- payments = [Payment.new(5), Payment.new(15), Payment.new(10)]
508
-
509
- payments.minimum(:price) # => 5
510
- payments.maximum(:price) # => 15
1076
+ verifier = ActiveSupport::MessageVerifier.new(url_safe: true)
1077
+ message = verifier.generate(data) # => URL-safe string
511
1078
  ```
512
1079
 
513
- This also allows passing enumerables to `fresh_when` and `stale?` in Action Controller.
514
- See PR [#41404](https://github.com/rails/rails/pull/41404) for an example.
1080
+ This option is `false` by default to be backwards compatible.
1081
+
1082
+ *Shouichi Kamiya*
515
1083
 
516
- *Ayrton De Craene*
1084
+ * Enable connection pooling by default for `MemCacheStore` and `RedisCacheStore`.
517
1085
 
518
- * `ActiveSupport::Cache::MemCacheStore` now accepts an explicit `nil` for its `addresses` argument.
1086
+ If you want to disable connection pooling, set `:pool` option to `false` when configuring the cache store:
519
1087
 
520
1088
  ```ruby
521
- config.cache_store = :mem_cache_store, nil
1089
+ config.cache_store = :mem_cache_store, "cache.example.com", pool: false
1090
+ ```
1091
+
1092
+ *fatkodima*
522
1093
 
523
- # is now equivalent to
1094
+ * Add `force:` support to `ActiveSupport::Cache::Store#fetch_multi`.
524
1095
 
525
- config.cache_store = :mem_cache_store
1096
+ *fatkodima*
526
1097
 
527
- # and is also equivalent to
1098
+ * Deprecated `:pool_size` and `:pool_timeout` options for configuring connection pooling in cache stores.
528
1099
 
529
- config.cache_store = :mem_cache_store, ENV["MEMCACHE_SERVERS"] || "localhost:11211"
1100
+ Use `pool: true` to enable pooling with default settings:
530
1101
 
531
- # which is the fallback behavior of Dalli
1102
+ ```ruby
1103
+ config.cache_store = :redis_cache_store, pool: true
532
1104
  ```
533
1105
 
534
- This helps those migrating from `:dalli_store`, where an explicit `nil` was permitted.
1106
+ Or pass individual options via `:pool` option:
535
1107
 
536
- *Michael Overmeyer*
1108
+ ```ruby
1109
+ config.cache_store = :redis_cache_store, pool: { size: 10, timeout: 2 }
1110
+ ```
537
1111
 
538
- * Add `Enumerable#in_order_of` to put an Enumerable in a certain order by a key.
1112
+ *fatkodima*
539
1113
 
540
- *DHH*
1114
+ * Allow #increment and #decrement methods of `ActiveSupport::Cache::Store`
1115
+ subclasses to set new values.
541
1116
 
542
- * `ActiveSupport::Inflector.camelize` behaves expected when provided a symbol `:upper` or `:lower` argument. Matches
543
- `String#camelize` behavior.
1117
+ Previously incrementing or decrementing an unset key would fail and return
1118
+ nil. A default will now be assumed and the key will be created.
544
1119
 
545
- *Alex Ghiculescu*
1120
+ *Andrej Blagojević*, *Eugene Kenny*
546
1121
 
547
- * Raises an `ArgumentError` when the first argument of `ActiveSupport::Notification.subscribe` is
548
- invalid.
1122
+ * Add `skip_nil:` support to `RedisCacheStore`
549
1123
 
550
- *Vipul A M*
1124
+ *Joey Paris*
551
1125
 
552
- * `HashWithIndifferentAccess#deep_transform_keys` now returns a `HashWithIndifferentAccess` instead of a `Hash`.
1126
+ * `ActiveSupport::Cache::MemoryStore#write(name, val, unless_exist:true)` now
1127
+ correctly writes expired keys.
553
1128
 
554
- *Nathaniel Woodthorpe*
1129
+ *Alan Savage*
555
1130
 
556
- * Consume dalli’s `cache_nils` configuration as `ActiveSupport::Cache`'s `skip_nil` when using `MemCacheStore`.
1131
+ * `ActiveSupport::ErrorReporter` now accepts and forward a `source:` parameter.
557
1132
 
558
- *Ritikesh G*
1133
+ This allow libraries to signal the origin of the errors, and reporters
1134
+ to easily ignore some sources.
559
1135
 
560
- * Add `RedisCacheStore#stats` method similar to `MemCacheStore#stats`. Calls `redis#info` internally.
1136
+ *Jean Boussier*
561
1137
 
562
- *Ritikesh G*
1138
+ * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
1139
+
1140
+ Add the method `ERB::Util.xml_name_escape` to escape dangerous characters
1141
+ in names of tags and names of attributes, following the specification of XML.
1142
+
1143
+ *Álvaro Martín Fraguas*
1144
+
1145
+ * Respect `ActiveSupport::Logger.new`'s `:formatter` keyword argument
1146
+
1147
+ The stdlib `Logger::new` allows passing a `:formatter` keyword argument to
1148
+ set the logger's formatter. Previously `ActiveSupport::Logger.new` ignored
1149
+ that argument by always setting the formatter to an instance of
1150
+ `ActiveSupport::Logger::SimpleFormatter`.
1151
+
1152
+ *Steven Harman*
1153
+
1154
+ * Deprecate preserving the pre-Ruby 2.4 behavior of `to_time`
1155
+
1156
+ With Ruby 2.4+ the default for +to_time+ changed from converting to the
1157
+ local system time to preserving the offset of the receiver. At the time Rails
1158
+ supported older versions of Ruby so a compatibility layer was added to assist
1159
+ in the migration process. From Rails 5.0 new applications have defaulted to
1160
+ the Ruby 2.4+ behavior and since Rails 7.0 now only supports Ruby 2.7+
1161
+ this compatibility layer can be safely removed.
1162
+
1163
+ To minimize any noise generated the deprecation warning only appears when the
1164
+ setting is configured to `false` as that is the only scenario where the
1165
+ removal of the compatibility layer has any effect.
1166
+
1167
+ *Andrew White*
1168
+
1169
+ * `Pathname.blank?` only returns true for `Pathname.new("")`
1170
+
1171
+ Previously it would end up calling `Pathname#empty?` which returned true
1172
+ if the path existed and was an empty directory or file.
1173
+
1174
+ That behavior was unlikely to be expected.
1175
+
1176
+ *Jean Boussier*
1177
+
1178
+ * Deprecate `Notification::Event`'s `#children` and `#parent_of?`
1179
+
1180
+ *John Hawthorn*
1181
+
1182
+ * Change the default serializer of `ActiveSupport::MessageVerifier` from
1183
+ `Marshal` to `ActiveSupport::JSON` when using `config.load_defaults 7.1`.
563
1184
 
1185
+ Messages serialized with `Marshal` can still be read, but new messages will
1186
+ be serialized with `ActiveSupport::JSON`. For more information, see
1187
+ https://guides.rubyonrails.org/v7.1/configuring.html#config-active-support-message-serializer.
1188
+
1189
+ *Saba Kiaei*, *David Buckley*, and *Jonathan Hefner*
1190
+
1191
+ * Change the default serializer of `ActiveSupport::MessageEncryptor` from
1192
+ `Marshal` to `ActiveSupport::JSON` when using `config.load_defaults 7.1`.
1193
+
1194
+ Messages serialized with `Marshal` can still be read, but new messages will
1195
+ be serialized with `ActiveSupport::JSON`. For more information, see
1196
+ https://guides.rubyonrails.org/v7.1/configuring.html#config-active-support-message-serializer.
1197
+
1198
+ *Zack Deveau*, *Martin Gingras*, and *Jonathan Hefner*
1199
+
1200
+ * Add `ActiveSupport::TestCase#stub_const` to stub a constant for the duration of a yield.
1201
+
1202
+ *DHH*
1203
+
1204
+ * Fix `ActiveSupport::EncryptedConfiguration` to be compatible with Psych 4
1205
+
1206
+ *Stephen Sugden*
1207
+
1208
+ * Improve `File.atomic_write` error handling
1209
+
1210
+ *Daniel Pepper*
1211
+
1212
+ * Fix `Class#descendants` and `DescendantsTracker#descendants` compatibility with Ruby 3.1.
1213
+
1214
+ [The native `Class#descendants` was reverted prior to Ruby 3.1 release](https://bugs.ruby-lang.org/issues/14394#note-33),
1215
+ but `Class#subclasses` was kept, breaking the feature detection.
1216
+
1217
+ *Jean Boussier*
564
1218
 
565
- Please check [6-1-stable](https://github.com/rails/rails/blob/6-1-stable/activesupport/CHANGELOG.md) for previous changes.
1219
+ Please check [7-0-stable](https://github.com/rails/rails/blob/7-0-stable/activesupport/CHANGELOG.md) for previous changes.