activesupport 7.0.7.2 → 7.1.5.1

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