activesupport 8.0.3 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +310 -159
  3. data/lib/active_support/backtrace_cleaner.rb +71 -0
  4. data/lib/active_support/cache/mem_cache_store.rb +13 -13
  5. data/lib/active_support/cache/redis_cache_store.rb +36 -30
  6. data/lib/active_support/cache/strategy/local_cache.rb +16 -7
  7. data/lib/active_support/cache/strategy/local_cache_middleware.rb +7 -7
  8. data/lib/active_support/cache.rb +69 -6
  9. data/lib/active_support/callbacks.rb +20 -8
  10. data/lib/active_support/concurrency/load_interlock_aware_monitor.rb +8 -62
  11. data/lib/active_support/concurrency/thread_monitor.rb +55 -0
  12. data/lib/active_support/configurable.rb +34 -0
  13. data/lib/active_support/continuous_integration.rb +145 -0
  14. data/lib/active_support/core_ext/array.rb +7 -7
  15. data/lib/active_support/core_ext/benchmark.rb +4 -12
  16. data/lib/active_support/core_ext/big_decimal.rb +1 -1
  17. data/lib/active_support/core_ext/class/attribute.rb +8 -6
  18. data/lib/active_support/core_ext/class.rb +2 -2
  19. data/lib/active_support/core_ext/date.rb +5 -5
  20. data/lib/active_support/core_ext/date_and_time/compatibility.rb +0 -35
  21. data/lib/active_support/core_ext/date_time/compatibility.rb +3 -5
  22. data/lib/active_support/core_ext/date_time.rb +5 -5
  23. data/lib/active_support/core_ext/digest.rb +1 -1
  24. data/lib/active_support/core_ext/enumerable.rb +2 -2
  25. data/lib/active_support/core_ext/erb/util.rb +3 -3
  26. data/lib/active_support/core_ext/file.rb +1 -1
  27. data/lib/active_support/core_ext/hash.rb +8 -8
  28. data/lib/active_support/core_ext/integer.rb +3 -3
  29. data/lib/active_support/core_ext/kernel.rb +3 -3
  30. data/lib/active_support/core_ext/module.rb +11 -11
  31. data/lib/active_support/core_ext/numeric.rb +3 -3
  32. data/lib/active_support/core_ext/object/json.rb +8 -1
  33. data/lib/active_support/core_ext/object/to_query.rb +5 -0
  34. data/lib/active_support/core_ext/object.rb +13 -13
  35. data/lib/active_support/core_ext/pathname.rb +2 -2
  36. data/lib/active_support/core_ext/range.rb +4 -5
  37. data/lib/active_support/core_ext/string/multibyte.rb +10 -1
  38. data/lib/active_support/core_ext/string/output_safety.rb +19 -12
  39. data/lib/active_support/core_ext/string.rb +13 -13
  40. data/lib/active_support/core_ext/symbol.rb +1 -1
  41. data/lib/active_support/core_ext/time/calculations.rb +0 -7
  42. data/lib/active_support/core_ext/time/compatibility.rb +2 -27
  43. data/lib/active_support/core_ext/time.rb +5 -5
  44. data/lib/active_support/core_ext.rb +1 -1
  45. data/lib/active_support/current_attributes/test_helper.rb +2 -2
  46. data/lib/active_support/current_attributes.rb +13 -10
  47. data/lib/active_support/dependencies/interlock.rb +11 -5
  48. data/lib/active_support/dependencies.rb +6 -1
  49. data/lib/active_support/deprecation/reporting.rb +4 -2
  50. data/lib/active_support/deprecation.rb +1 -1
  51. data/lib/active_support/editor.rb +70 -0
  52. data/lib/active_support/error_reporter.rb +50 -6
  53. data/lib/active_support/event_reporter/test_helper.rb +32 -0
  54. data/lib/active_support/event_reporter.rb +592 -0
  55. data/lib/active_support/evented_file_update_checker.rb +5 -1
  56. data/lib/active_support/execution_context.rb +64 -7
  57. data/lib/active_support/file_update_checker.rb +7 -5
  58. data/lib/active_support/gem_version.rb +2 -2
  59. data/lib/active_support/gzip.rb +1 -0
  60. data/lib/active_support/hash_with_indifferent_access.rb +27 -7
  61. data/lib/active_support/i18n_railtie.rb +1 -2
  62. data/lib/active_support/inflector/inflections.rb +31 -15
  63. data/lib/active_support/inflector/transliterate.rb +6 -8
  64. data/lib/active_support/isolated_execution_state.rb +12 -15
  65. data/lib/active_support/json/decoding.rb +2 -2
  66. data/lib/active_support/json/encoding.rb +135 -17
  67. data/lib/active_support/log_subscriber.rb +2 -6
  68. data/lib/active_support/message_encryptors.rb +52 -0
  69. data/lib/active_support/message_pack/extensions.rb +5 -0
  70. data/lib/active_support/message_verifiers.rb +52 -0
  71. data/lib/active_support/messages/rotation_coordinator.rb +9 -0
  72. data/lib/active_support/messages/rotator.rb +5 -0
  73. data/lib/active_support/multibyte/chars.rb +8 -1
  74. data/lib/active_support/multibyte.rb +4 -0
  75. data/lib/active_support/notifications/fanout.rb +64 -42
  76. data/lib/active_support/notifications/instrumenter.rb +1 -1
  77. data/lib/active_support/railtie.rb +32 -15
  78. data/lib/active_support/structured_event_subscriber.rb +99 -0
  79. data/lib/active_support/subscriber.rb +0 -5
  80. data/lib/active_support/syntax_error_proxy.rb +3 -0
  81. data/lib/active_support/test_case.rb +61 -6
  82. data/lib/active_support/testing/assertions.rb +34 -6
  83. data/lib/active_support/testing/error_reporter_assertions.rb +18 -1
  84. data/lib/active_support/testing/event_reporter_assertions.rb +227 -0
  85. data/lib/active_support/testing/notification_assertions.rb +92 -0
  86. data/lib/active_support/testing/parallelization/server.rb +15 -2
  87. data/lib/active_support/testing/parallelization/worker.rb +4 -2
  88. data/lib/active_support/testing/parallelization.rb +25 -1
  89. data/lib/active_support/testing/tests_without_assertions.rb +1 -1
  90. data/lib/active_support/testing/time_helpers.rb +7 -3
  91. data/lib/active_support/time_with_zone.rb +22 -22
  92. data/lib/active_support/values/time_zone.rb +8 -1
  93. data/lib/active_support/xml_mini.rb +3 -2
  94. data/lib/active_support.rb +20 -15
  95. metadata +24 -17
  96. data/lib/active_support/core_ext/range/each.rb +0 -24
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b2cdf9736ba5b94841913f95e5e83f01cc82becad9006ed2d75e18f1cc117c43
4
- data.tar.gz: 7f8f545780e7ecfece1bdd6af006e504d91e89ad019a1020cd43014a296e7def
3
+ metadata.gz: 8e2e34de82e59790b784a08b2471fa7427da0b1642763bba5904ad1aa6ad45a8
4
+ data.tar.gz: fadad2b6a958becb7cc187251643463d43127d28af9098631050c4b368079dcc
5
5
  SHA512:
6
- metadata.gz: b23ff4bae6aae8f2e154b478c8f36825d0179152a0591591c240ea2b8d6104dcad0b70598a9b42888ab41448a06bc6b69c4ca537c1e5edb386fa81408f25acde
7
- data.tar.gz: 84fa236c5c86feff0ae2283888ca7266c5f5d9090474b099c2b9142c082e107062bea571d8197f0138a022d7db7fe08e02f3544ade6cd611de68c35b26b90e75
6
+ metadata.gz: 1d545e02442de9422d3b62f261fdba69bbf9aaa95e2f8138a62493dd090397a163841044b5fb538a1e1be2ab70a464e51a7eb3ee56f12f778ecb7cc681ea6dab
7
+ data.tar.gz: d6de04f518b4802721210693b496f28ac80d16f3d7aa78bedeb007c4c850d0084d532a8b696b079f41412e274e5e29ff3644b95adfbf861f6852cfc0675ac516
data/CHANGELOG.md CHANGED
@@ -1,309 +1,460 @@
1
- ## Rails 8.0.3 (September 22, 2025) ##
1
+ ## Rails 8.1.0 (October 22, 2025) ##
2
2
 
3
- * `ActiveSupport::FileUpdateChecker` does not depend on `Time.now` to prevent unnecessary reloads with time travel test helpers
3
+ * Remove deprecated passing a Time object to `Time#since`.
4
4
 
5
- *Jan Grodowski*
5
+ *Rafael Mendonça França*
6
6
 
7
- * Fix `ActiveSupport::BroadcastLogger` from executing a block argument for each logger (tagged, info, etc.).
7
+ * Remove deprecated `Benchmark.ms` method. It is now defined in the `benchmark` gem.
8
8
 
9
- *Jared Armstrong*
9
+ *Rafael Mendonça França*
10
10
 
11
- * Make `ActiveSupport::Logger` `#freeze`-friendly.
11
+ * Remove deprecated addition for `Time` instances with `ActiveSupport::TimeWithZone`.
12
12
 
13
- *Joshua Young*
13
+ *Rafael Mendonça França*
14
14
 
15
- * Fix `ActiveSupport::HashWithIndifferentAccess#transform_keys!` removing defaults.
15
+ * Remove deprecated support for `to_time` to preserve the system local time. It will now always preserve the receiver
16
+ timezone.
16
17
 
17
- *Hartley McGuire*
18
+ *Rafael Mendonça França*
18
19
 
19
- * Fix `ActiveSupport::HashWithIndifferentAccess#tranform_keys!` to handle collisions.
20
+ * Deprecate `config.active_support.to_time_preserves_timezone`.
20
21
 
21
- If the transformation would result in a key equal to another not yet transformed one,
22
- it would result in keys being lost.
22
+ *Rafael Mendonça França*
23
23
 
24
- Before:
24
+ * Standardize event name formatting in `assert_event_reported` error messages.
25
25
 
26
- ```ruby
27
- >> {a: 1, b: 2}.with_indifferent_access.transform_keys!(&:succ)
28
- => {"c" => 1}
29
- ```
26
+ The event name in failure messages now uses `.inspect` (e.g., `name: "user.created"`)
27
+ to match `assert_events_reported` and provide type clarity between strings and symbols.
28
+ This only affects tests that assert on the failure message format itself.
30
29
 
31
- After:
30
+ *George Ma*
32
31
 
33
- ```ruby
34
- >> {a: 1, b: 2}.with_indifferent_access.transform_keys!(&:succ)
35
- => {"c" => 1, "d" => 2}
36
- ```
32
+ * Fix `Enumerable#sole` to return the full tuple instead of just the first element of the tuple.
37
33
 
38
- *Jason T Johnson*, *Jean Boussier*
34
+ *Olivier Bellone*
39
35
 
40
- * Fix `ActiveSupport::Cache::MemCacheStore#read_multi` to handle network errors.
36
+ * Fix parallel tests hanging when worker processes die abruptly.
41
37
 
42
- This method specifically wasn't handling network errors like other codepaths.
38
+ Previously, if a worker process was killed (e.g., OOM killed, `kill -9`) during parallel
39
+ test execution, the test suite would hang forever waiting for the dead worker.
43
40
 
44
- *Alessandro Dal Grande*
41
+ *Joshua Young*
45
42
 
46
- * Fix configuring `RedisCacheStore` with `raw: true`.
43
+ * Add `config.active_support.escape_js_separators_in_json`.
47
44
 
48
- *fatkodima*
45
+ Introduce a new framework default to skip escaping LINE SEPARATOR (U+2028) and PARAGRAPH SEPARATOR (U+2029) in JSON.
49
46
 
50
- * Fix `Enumerable#sole` for infinite collections.
47
+ Historically these characters were not valid inside JavaScript literal strings but that changed in ECMAScript 2019.
48
+ As such it's no longer a concern in modern browsers: https://caniuse.com/mdn-javascript_builtins_json_json_superset.
51
49
 
52
- *fatkodima*
50
+ *Étienne Barrié*, *Jean Boussier*
53
51
 
52
+ * Fix `NameError` when `class_attribute` is defined on instance singleton classes.
54
53
 
55
- ## Rails 8.0.2.1 (August 13, 2025) ##
54
+ Previously, calling `class_attribute` on an instance's singleton class would raise
55
+ a `NameError` when accessing the attribute through the instance.
56
56
 
57
- * No changes.
57
+ ```ruby
58
+ object = MyClass.new
59
+ object.singleton_class.class_attribute :foo, default: "bar"
60
+ object.foo # previously raised NameError, now returns "bar"
61
+ ```
58
62
 
63
+ *Joshua Young*
59
64
 
60
- ## Rails 8.0.2 (March 12, 2025) ##
65
+ * Introduce `ActiveSupport::Testing::EventReporterAssertions#with_debug_event_reporting`
66
+ to enable event reporter debug mode in tests.
61
67
 
62
- * Fix setting `to_time_preserves_timezone` from `new_framework_defaults_8_0.rb`.
68
+ The previous way to enable debug mode is by using `#with_debug` on the
69
+ event reporter itself, which is too verbose. This new helper will help
70
+ clear up any confusion on how to test debug events.
63
71
 
64
- *fatkodima*
72
+ *Gannon McGibbon*
65
73
 
66
- * Fix Active Support Cache `fetch_multi` when local store is active.
74
+ * Add `ActiveSupport::StructuredEventSubscriber` for consuming notifications and
75
+ emitting structured event logs. Events may be emitted with the `#emit_event`
76
+ or `#emit_debug_event` methods.
67
77
 
68
- `fetch_multi` now properly yield to the provided block for missing entries
69
- that have been recorded as such in the local store.
78
+ ```ruby
79
+ class MyStructuredEventSubscriber < ActiveSupport::StructuredEventSubscriber
80
+ def notification(event)
81
+ emit_event("my.notification", data: 1)
82
+ end
83
+ end
84
+ ```
70
85
 
71
- *Jean Boussier*
86
+ *Adrianna Chang*
72
87
 
73
- * Fix execution wrapping to report all exceptions, including `Exception`.
88
+ * `ActiveSupport::FileUpdateChecker` does not depend on `Time.now` to prevent unecessary reloads with time travel test helpers
74
89
 
75
- If a more serious error like `SystemStackError` or `NoMemoryError` happens,
76
- the error reporter should be able to report these kinds of exceptions.
90
+ *Jan Grodowski*
77
91
 
78
- *Gannon McGibbon*
92
+ * Add `ActiveSupport::Cache::Store#namespace=` and `#namespace`.
93
+
94
+ Can be used as an alternative to `Store#clear` in some situations such as parallel
95
+ testing.
79
96
 
80
- * Fix `RedisCacheStore` and `MemCacheStore` to also handle connection pool related errors.
97
+ *Nick Schwaderer*
81
98
 
82
- These errors are rescued and reported to `Rails.error`.
99
+ * Create `parallel_worker_id` helper for running parallel tests. This allows users to
100
+ know which worker they are currently running in.
83
101
 
84
- *Jean Boussier*
102
+ *Nick Schwaderer*
103
+
104
+ * Make the cache of `ActiveSupport::Cache::Strategy::LocalCache::Middleware` updatable.
85
105
 
86
- * Fix `ActiveSupport::Cache#read_multi` to respect version expiry when using local cache.
106
+ If the cache client at `Rails.cache` of a booted application changes, the corresponding
107
+ mounted middleware needs to update in order for request-local caches to be setup properly.
108
+ Otherwise, redundant cache operations will erroneously hit the datastore.
87
109
 
88
- *zzak*
110
+ *Gannon McGibbon*
111
+
112
+ * Add `assert_events_reported` test helper for `ActiveSupport::EventReporter`.
89
113
 
90
- * Fix `ActiveSupport::MessageVerifier` and `ActiveSupport::MessageEncryptor` configuration of `on_rotation` callback.
114
+ This new assertion allows testing multiple events in a single block, regardless of order:
91
115
 
92
116
  ```ruby
93
- verifier.rotate(old_secret).on_rotation { ... }
117
+ assert_events_reported([
118
+ { name: "user.created", payload: { id: 123 } },
119
+ { name: "email.sent", payload: { to: "user@example.com" } }
120
+ ]) do
121
+ create_user_and_send_welcome_email
122
+ end
94
123
  ```
95
124
 
96
- Now both work as documented.
125
+ *George Ma*
97
126
 
98
- *Jean Boussier*
127
+ * Add `ActiveSupport::TimeZone#standard_name` method.
128
+
129
+ ``` ruby
130
+ zone = ActiveSupport::TimeZone['Hawaii']
131
+ # Old way
132
+ ActiveSupport::TimeZone::MAPPING[zone.name]
133
+ # New way
134
+ zone.standard_name # => 'Pacific/Honolulu'
135
+ ```
136
+
137
+ *Bogdan Gusiev*
138
+
139
+ * Add Structured Event Reporter, accessible via `Rails.event`.
140
+
141
+ The Event Reporter provides a unified interface for producing structured events in Rails
142
+ applications:
143
+
144
+ ```ruby
145
+ Rails.event.notify("user.signup", user_id: 123, email: "user@example.com")
146
+ ```
99
147
 
100
- * Fix `ActiveSupport::MessageVerifier` to always be able to verify both URL-safe and URL-unsafe payloads.
148
+ It supports adding tags to events:
101
149
 
102
- This is to allow transitioning seemlessly from either configuration without immediately invalidating
103
- all previously generated signed messages.
150
+ ```ruby
151
+ Rails.event.tagged("graphql") do
152
+ # Event includes tags: { graphql: true }
153
+ Rails.event.notify("user.signup", user_id: 123, email: "user@example.com")
154
+ end
155
+ ```
104
156
 
105
- *Jean Boussier*, *Florent Beaurain*, *Ali Sepehri*
157
+ As well as context:
158
+ ```ruby
159
+ # All events will contain context: {request_id: "abc123", shop_id: 456}
160
+ Rails.event.set_context(request_id: "abc123", shop_id: 456)
161
+ ```
106
162
 
107
- * Fix `cache.fetch` to honor the provided expiry when `:race_condition_ttl` is used.
163
+ Events are emitted to subscribers. Applications register subscribers to
164
+ control how events are serialized and emitted. Subscribers must implement
165
+ an `#emit` method, which receives the event hash:
108
166
 
109
167
  ```ruby
110
- cache.fetch("key", expires_in: 1.hour, race_condition_ttl: 5.second) do
111
- "something"
168
+ class LogSubscriber
169
+ def emit(event)
170
+ payload = event[:payload].map { |key, value| "#{key}=#{value}" }.join(" ")
171
+ source_location = event[:source_location]
172
+ log = "[#{event[:name]}] #{payload} at #{source_location[:filepath]}:#{source_location[:lineno]}"
173
+ Rails.logger.info(log)
174
+ end
112
175
  end
113
176
  ```
114
177
 
115
- In the above example, the final cache entry would have a 10 seconds TTL instead
116
- of the requested 1 hour.
178
+ *Adrianna Chang*
117
179
 
118
- *Dhia*
180
+ * Make `ActiveSupport::Logger` `#freeze`-friendly.
119
181
 
120
- * Better handle procs with splat arguments in `set_callback`.
182
+ *Joshua Young*
121
183
 
122
- *Radamés Roriz*
184
+ * Make `ActiveSupport::Gzip.compress` deterministic based on input.
123
185
 
124
- * Fix `String#mb_chars` to not mutate the receiver.
186
+ `ActiveSupport::Gzip.compress` used to include a timestamp in the output,
187
+ causing consecutive calls with the same input data to have different output
188
+ if called during different seconds. It now always sets the timestamp to `0`
189
+ so that the output is identical for any given input.
125
190
 
126
- Previously it would call `force_encoding` on the receiver,
127
- now it dups the receiver first.
191
+ *Rob Brackett*
128
192
 
129
- *Jean Boussier*
193
+ * Given an array of `Thread::Backtrace::Location` objects, the new method
194
+ `ActiveSupport::BacktraceCleaner#clean_locations` returns an array with the
195
+ clean ones:
130
196
 
131
- * Improve `ErrorSubscriber` to also mark error causes as reported.
197
+ ```ruby
198
+ clean_locations = backtrace_cleaner.clean_locations(caller_locations)
199
+ ```
132
200
 
133
- This avoid some cases of errors being reported twice, notably in views because of how
134
- errors are wrapped in `ActionView::Template::Error`.
201
+ Filters and silencers receive strings as usual. However, the `path`
202
+ attributes of the locations in the returned array are the original,
203
+ unfiltered ones, since locations are immutable.
135
204
 
136
- *Jean Boussier*
205
+ *Xavier Noria*
137
206
 
138
- * Fix `Module#module_parent_name` to return the correct name after the module has been named.
207
+ * Improve `CurrentAttributes` and `ExecutionContext` state managment in test cases.
139
208
 
140
- When called on an anonymous module, the return value wouldn't change after the module was given a name
141
- later by being assigned to a constant.
209
+ Previously these two global state would be entirely cleared out whenever calling
210
+ into code that is wrapped by the Rails executor, typically Action Controller or
211
+ Active Job helpers:
142
212
 
143
213
  ```ruby
144
- mod = Module.new
145
- mod.module_parent_name # => "Object"
146
- MyModule::Something = mod
147
- mod.module_parent_name # => "MyModule"
214
+ test "#index works" do
215
+ CurrentUser.id = 42
216
+ get :index
217
+ CurrentUser.id == nil
218
+ end
148
219
  ```
149
220
 
221
+ Now re-entering the executor properly save and restore that state.
222
+
150
223
  *Jean Boussier*
151
224
 
225
+ * The new method `ActiveSupport::BacktraceCleaner#first_clean_location`
226
+ returns the first clean location of the caller's call stack, or `nil`.
227
+ Locations are `Thread::Backtrace::Location` objects. Useful when you want to
228
+ report the application-level location where something happened as an object.
152
229
 
153
- ## Rails 8.0.1 (December 13, 2024) ##
230
+ *Xavier Noria*
154
231
 
155
- * Fix a bug in `ERB::Util.tokenize` that causes incorrect tokenization when ERB tags are preceeded by multibyte characters.
232
+ * FileUpdateChecker and EventedFileUpdateChecker ignore changes in Gem.path now.
156
233
 
157
- *Martin Emde*
234
+ *Ermolaev Andrey*, *zzak*
158
235
 
159
- * Restore the ability to decorate methods generated by `class_attribute`.
236
+ * The new method `ActiveSupport::BacktraceCleaner#first_clean_frame` returns
237
+ the first clean frame of the caller's backtrace, or `nil`. Useful when you
238
+ want to report the application-level frame where something happened as a
239
+ string.
160
240
 
161
- It always has been complicated to use Module#prepend or an alias method chain
162
- to decorate methods defined by `class_attribute`, but became even harder in 8.0.
241
+ *Xavier Noria*
163
242
 
164
- This capability is now supported for both reader and writer methods.
243
+ * Always clear `CurrentAttributes` instances.
165
244
 
166
- *Jean Boussier*
245
+ Previously `CurrentAttributes` instance would be reset at the end of requests.
246
+ Meaning its attributes would be re-initialized.
167
247
 
248
+ This is problematic because it assume these objects don't hold any state
249
+ other than their declared attribute, which isn't always the case, and
250
+ can lead to state leak across request.
168
251
 
169
- ## Rails 8.0.0.1 (December 10, 2024) ##
252
+ Now `CurrentAttributes` instances are abandoned at the end of a request,
253
+ and a new instance is created at the start of the next request.
170
254
 
171
- * No changes.
255
+ *Jean Boussier*, *Janko Marohnić*
172
256
 
257
+ * Add public API for `before_fork_hook` in parallel testing.
173
258
 
174
- ## Rails 8.0.0 (November 07, 2024) ##
259
+ Introduces a public API for calling the before fork hooks implemented by parallel testing.
175
260
 
176
- * No changes.
261
+ ```ruby
262
+ parallelize_before_fork do
263
+ # perform an action before test processes are forked
264
+ end
265
+ ```
177
266
 
267
+ *Eileen M. Uchitelle*
178
268
 
179
- ## Rails 8.0.0.rc2 (October 30, 2024) ##
269
+ * Implement ability to skip creating parallel testing databases.
180
270
 
181
- * No changes.
271
+ With parallel testing, Rails will create a database per process. If this isn't
272
+ desirable or you would like to implement databases handling on your own, you can
273
+ now turn off this default behavior.
182
274
 
275
+ To skip creating a database per process, you can change it via the
276
+ `parallelize` method:
183
277
 
184
- ## Rails 8.0.0.rc1 (October 19, 2024) ##
278
+ ```ruby
279
+ parallelize(workers: 10, parallelize_databases: false)
280
+ ```
185
281
 
186
- * Remove deprecated support to passing an array of strings to `ActiveSupport::Deprecation#warn`.
282
+ or via the application configuration:
187
283
 
188
- *Rafael Mendonça França*
284
+ ```ruby
285
+ config.active_support.parallelize_databases = false
286
+ ```
189
287
 
190
- * Remove deprecated support to setting `attr_internal_naming_format` with a `@` prefix.
288
+ *Eileen M. Uchitelle*
191
289
 
192
- *Rafael Mendonça França*
290
+ * Allow to configure maximum cache key sizes
193
291
 
194
- * Remove deprecated `ActiveSupport::ProxyObject`.
292
+ When the key exceeds the configured limit (250 bytes by default), it will be truncated and
293
+ the digest of the rest of the key appended to it.
195
294
 
196
- *Rafael Mendonça França*
295
+ Note that previously `ActiveSupport::Cache::RedisCacheStore` allowed up to 1kb cache keys before
296
+ truncation, which is now reduced to 250 bytes.
297
+
298
+ ```ruby
299
+ config.cache_store = :redis_cache_store, { max_key_size: 64 }
300
+ ```
197
301
 
198
- * Don't execute i18n watcher on boot. It shouldn't catch any file changes initially,
199
- and unnecessarily slows down boot of applications with lots of translations.
302
+ *fatkodima*
200
303
 
201
- *Gannon McGibbon*, *David Stosik*
304
+ * Use `UNLINK` command instead of `DEL` in `ActiveSupport::Cache::RedisCacheStore` for non-blocking deletion.
202
305
 
203
- * Fix `ActiveSupport::HashWithIndifferentAccess#stringify_keys` to stringify all keys not just symbols.
306
+ *Aron Roh*
204
307
 
205
- Previously:
308
+ * Add `Cache#read_counter` and `Cache#write_counter`
206
309
 
207
310
  ```ruby
208
- { 1 => 2 }.with_indifferent_access.stringify_keys[1] # => 2
311
+ Rails.cache.write_counter("foo", 1)
312
+ Rails.cache.read_counter("foo") # => 1
313
+ Rails.cache.increment("foo")
314
+ Rails.cache.read_counter("foo") # => 2
209
315
  ```
210
316
 
211
- After this change:
317
+ *Alex Ghiculescu*
318
+
319
+ * Introduce ActiveSupport::Testing::ErrorReporterAssertions#capture_error_reports
320
+
321
+ Captures all reported errors from within the block that match the given
322
+ error class.
212
323
 
213
324
  ```ruby
214
- { 1 => 2 }.with_indifferent_access.stringify_keys["1"] # => 2
325
+ reports = capture_error_reports(IOError) do
326
+ Rails.error.report(IOError.new("Oops"))
327
+ Rails.error.report(IOError.new("Oh no"))
328
+ Rails.error.report(StandardError.new)
329
+ end
330
+
331
+ assert_equal 2, reports.size
332
+ assert_equal "Oops", reports.first.error.message
333
+ assert_equal "Oh no", reports.last.error.message
215
334
  ```
216
335
 
217
- This change can be seen as a bug fix, but since it behaved like this for a very long time, we're deciding
218
- to not backport the fix and to make the change in a major release.
336
+ *Andrew Novoselac*
219
337
 
220
- *Jean Boussier*
338
+ * Introduce ActiveSupport::ErrorReporter#add_middleware
221
339
 
222
- ## Rails 8.0.0.beta1 (September 26, 2024) ##
340
+ When reporting an error, the error context middleware will be called with the reported error
341
+ and base execution context. The stack may mutate the context hash. The mutated context will
342
+ then be passed to error subscribers. Middleware receives the same parameters as `ErrorReporter#report`.
223
343
 
224
- * Include options when instrumenting `ActiveSupport::Cache::Store#delete` and `ActiveSupport::Cache::Store#delete_multi`.
344
+ *Andrew Novoselac*, *Sam Schmidt*
225
345
 
226
- *Adam Renberg Tamm*
346
+ * Change execution wrapping to report all exceptions, including `Exception`.
227
347
 
228
- * Print test names when running `rails test -v` for parallel tests.
348
+ If a more serious error like `SystemStackError` or `NoMemoryError` happens,
349
+ the error reporter should be able to report these kinds of exceptions.
229
350
 
230
- *John Hawthorn*, *Abeid Ahmed*
351
+ *Gannon McGibbon*
231
352
 
232
- * Deprecate `Benchmark.ms` core extension.
353
+ * `ActiveSupport::Testing::Parallelization.before_fork_hook` allows declaration of callbacks that
354
+ are invoked immediately before forking test workers.
233
355
 
234
- The `benchmark` gem will become bundled in Ruby 3.5
356
+ *Mike Dalessio*
235
357
 
236
- *Earlopain*
358
+ * Allow the `#freeze_time` testing helper to accept a date or time argument.
237
359
 
238
- * `ActiveSupport::TimeWithZone#inspect` now uses ISO 8601 style time like `Time#inspect`
360
+ ```ruby
361
+ Time.current # => Sun, 09 Jul 2024 15:34:49 EST -05:00
362
+ freeze_time Time.current + 1.day
363
+ sleep 1
364
+ Time.current # => Mon, 10 Jul 2024 15:34:49 EST -05:00
365
+ ```
239
366
 
240
- *John Hawthorn*
367
+ *Joshua Young*
241
368
 
242
- * `ActiveSupport::ErrorReporter#report` now assigns a backtrace to unraised exceptions.
369
+ * `ActiveSupport::JSON` now accepts options
243
370
 
244
- Previously reporting an un-raised exception would result in an error report without
245
- a backtrace. Now it automatically generates one.
371
+ It is now possible to pass options to `ActiveSupport::JSON`:
372
+ ```ruby
373
+ ActiveSupport::JSON.decode('{"key": "value"}', symbolize_names: true) # => { key: "value" }
374
+ ```
246
375
 
247
- *Jean Boussier*
376
+ *matthaigh27*
248
377
 
249
- * Add `escape_html_entities` option to `ActiveSupport::JSON.encode`.
378
+ * `ActiveSupport::Testing::NotificationAssertions`'s `assert_notification` now matches against payload subsets by default.
250
379
 
251
- This allows for overriding the global configuration found at
252
- `ActiveSupport.escape_html_entities_in_json` for specific calls to `to_json`.
380
+ Previously the following assertion would fail due to excess key vals in the notification payload. Now with payload subset matching, it will pass.
253
381
 
254
- This should be usable from controllers in the following manner:
255
382
  ```ruby
256
- class MyController < ApplicationController
257
- def index
258
- render json: { hello: "world" }, escape_html_entities: false
259
- end
383
+ assert_notification("post.submitted", title: "Cool Post") do
384
+ ActiveSupport::Notifications.instrument("post.submitted", title: "Cool Post", body: "Cool Body")
260
385
  end
261
386
  ```
262
387
 
263
- *Nigel Baillie*
388
+ Additionally, you can now persist a matched notification for more customized assertions.
264
389
 
265
- * Raise when using key which can't respond to `#to_sym` in `EncryptedConfiguration`.
390
+ ```ruby
391
+ notification = assert_notification("post.submitted", title: "Cool Post") do
392
+ ActiveSupport::Notifications.instrument("post.submitted", title: "Cool Post", body: Body.new("Cool Body"))
393
+ end
266
394
 
267
- As is the case when trying to use an Integer or Float as a key, which is unsupported.
395
+ assert_instance_of(Body, notification.payload[:body])
396
+ ```
268
397
 
269
- *zzak*
398
+ *Nicholas La Roux*
270
399
 
271
- * Deprecate addition and since between two `Time` and `ActiveSupport::TimeWithZone`.
400
+ * Deprecate `String#mb_chars` and `ActiveSupport::Multibyte::Chars`.
272
401
 
273
- Previously adding time instances together such as `10.days.ago + 10.days.ago` or `10.days.ago.since(10.days.ago)` produced a nonsensical future date. This behavior is deprecated and will be removed in Rails 8.1.
402
+ These APIs are a relic of the Ruby 1.8 days when Ruby strings weren't encoding
403
+ aware. There is no legitimate reasons to need these APIs today.
274
404
 
275
- *Nick Schwaderer*
405
+ *Jean Boussier*
276
406
 
277
- * Support rfc2822 format for Time#to_fs & Date#to_fs.
407
+ * Deprecate `ActiveSupport::Configurable`
278
408
 
279
- *Akshay Birajdar*
409
+ *Sean Doyle*
280
410
 
281
- * Optimize load time for `Railtie#initialize_i18n`. Filter `I18n.load_path`s passed to the file watcher to only those
282
- under `Rails.root`. Previously the watcher would grab all available locales, including those in gems
283
- which do not require a watcher because they won't change.
411
+ * `nil.to_query("key")` now returns `key`.
284
412
 
285
- *Nick Schwaderer*
413
+ Previously it would return `key=`, preventing round tripping with `Rack::Utils.parse_nested_query`.
414
+
415
+ *Erol Fornoles*
286
416
 
287
- * Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
288
- by these values.
417
+ * Avoid wrapping redis in a `ConnectionPool` when using `ActiveSupport::Cache::RedisCacheStore` if the `:redis`
418
+ option is already a `ConnectionPool`.
289
419
 
290
- *Igor Depolli*
420
+ *Joshua Young*
291
421
 
292
- * Improve error message when using `assert_difference` or `assert_changes` with a
293
- proc by printing the proc's source code (MRI only).
422
+ * Alter `ERB::Util.tokenize` to return :PLAIN token with full input string when string doesn't contain ERB tags.
294
423
 
295
- *Richard Böhme*, *Jean Boussier*
424
+ *Martin Emde*
425
+
426
+ * Fix a bug in `ERB::Util.tokenize` that causes incorrect tokenization when ERB tags are preceded by multibyte characters.
427
+
428
+ *Martin Emde*
296
429
 
297
- * Add a new configuration value `:zone` for `ActiveSupport.to_time_preserves_timezone` and rename the previous `true` value to `:offset`. The new default value is `:zone`.
430
+ * Add `ActiveSupport::Testing::NotificationAssertions` module to help with testing `ActiveSupport::Notifications`.
298
431
 
299
- *Jason Kim*, *John Hawthorn*
432
+ *Nicholas La Roux*, *Yishu See*, *Sean Doyle*
300
433
 
301
- * Align instrumentation `payload[:key]` in ActiveSupport::Cache to follow the same pattern, with namespaced and normalized keys.
434
+ * `ActiveSupport::CurrentAttributes#attributes` now will return a new hash object on each call.
435
+
436
+ Previously, the same hash object was returned each time that method was called.
437
+
438
+ *fatkodima*
439
+
440
+ * `ActiveSupport::JSON.encode` supports CIDR notation.
441
+
442
+ Previously:
443
+
444
+ ```ruby
445
+ ActiveSupport::JSON.encode(IPAddr.new("172.16.0.0/24")) # => "\"172.16.0.0\""
446
+ ```
447
+
448
+ After this change:
449
+
450
+ ```ruby
451
+ ActiveSupport::JSON.encode(IPAddr.new("172.16.0.0/24")) # => "\"172.16.0.0/24\""
452
+ ```
302
453
 
303
- *Frederik Erbs Spang Thomsen*
454
+ *Taketo Takashima*
304
455
 
305
- * Fix `travel_to` to set usec 0 when `with_usec` is `false` and the given argument String or DateTime.
456
+ * Make `ActiveSupport::FileUpdateChecker` faster when checking many file-extensions.
306
457
 
307
- *mopp*
458
+ *Jonathan del Strother*
308
459
 
309
- Please check [7-2-stable](https://github.com/rails/rails/blob/7-2-stable/activesupport/CHANGELOG.md) for previous changes.
460
+ Please check [8-0-stable](https://github.com/rails/rails/blob/8-0-stable/activesupport/CHANGELOG.md) for previous changes.