activerecord 7.0.8.7 → 7.1.0.beta1

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 (227) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +1339 -1572
  3. data/MIT-LICENSE +1 -1
  4. data/README.rdoc +15 -16
  5. data/lib/active_record/aggregations.rb +16 -13
  6. data/lib/active_record/association_relation.rb +1 -1
  7. data/lib/active_record/associations/association.rb +18 -3
  8. data/lib/active_record/associations/association_scope.rb +16 -9
  9. data/lib/active_record/associations/belongs_to_association.rb +14 -6
  10. data/lib/active_record/associations/builder/association.rb +3 -3
  11. data/lib/active_record/associations/builder/belongs_to.rb +21 -8
  12. data/lib/active_record/associations/builder/has_and_belongs_to_many.rb +1 -5
  13. data/lib/active_record/associations/builder/singular_association.rb +4 -0
  14. data/lib/active_record/associations/collection_association.rb +17 -9
  15. data/lib/active_record/associations/collection_proxy.rb +16 -11
  16. data/lib/active_record/associations/foreign_association.rb +10 -3
  17. data/lib/active_record/associations/has_many_association.rb +20 -13
  18. data/lib/active_record/associations/has_many_through_association.rb +10 -6
  19. data/lib/active_record/associations/has_one_association.rb +10 -3
  20. data/lib/active_record/associations/join_dependency.rb +10 -8
  21. data/lib/active_record/associations/preloader/association.rb +27 -6
  22. data/lib/active_record/associations/preloader.rb +12 -9
  23. data/lib/active_record/associations/singular_association.rb +1 -1
  24. data/lib/active_record/associations/through_association.rb +22 -11
  25. data/lib/active_record/associations.rb +193 -97
  26. data/lib/active_record/attribute_assignment.rb +0 -2
  27. data/lib/active_record/attribute_methods/before_type_cast.rb +17 -0
  28. data/lib/active_record/attribute_methods/dirty.rb +40 -26
  29. data/lib/active_record/attribute_methods/primary_key.rb +76 -24
  30. data/lib/active_record/attribute_methods/query.rb +28 -16
  31. data/lib/active_record/attribute_methods/read.rb +18 -5
  32. data/lib/active_record/attribute_methods/serialization.rb +150 -31
  33. data/lib/active_record/attribute_methods/write.rb +3 -3
  34. data/lib/active_record/attribute_methods.rb +105 -21
  35. data/lib/active_record/attributes.rb +3 -3
  36. data/lib/active_record/autosave_association.rb +55 -9
  37. data/lib/active_record/base.rb +7 -2
  38. data/lib/active_record/callbacks.rb +10 -24
  39. data/lib/active_record/coders/column_serializer.rb +61 -0
  40. data/lib/active_record/coders/json.rb +1 -1
  41. data/lib/active_record/coders/yaml_column.rb +70 -42
  42. data/lib/active_record/connection_adapters/abstract/connection_handler.rb +163 -88
  43. data/lib/active_record/connection_adapters/abstract/connection_pool/queue.rb +2 -0
  44. data/lib/active_record/connection_adapters/abstract/connection_pool/reaper.rb +3 -1
  45. data/lib/active_record/connection_adapters/abstract/connection_pool.rb +63 -43
  46. data/lib/active_record/connection_adapters/abstract/database_limits.rb +5 -0
  47. data/lib/active_record/connection_adapters/abstract/database_statements.rb +109 -32
  48. data/lib/active_record/connection_adapters/abstract/query_cache.rb +60 -22
  49. data/lib/active_record/connection_adapters/abstract/quoting.rb +41 -6
  50. data/lib/active_record/connection_adapters/abstract/savepoints.rb +4 -3
  51. data/lib/active_record/connection_adapters/abstract/schema_creation.rb +18 -4
  52. data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +137 -11
  53. data/lib/active_record/connection_adapters/abstract/schema_statements.rb +289 -122
  54. data/lib/active_record/connection_adapters/abstract/transaction.rb +280 -58
  55. data/lib/active_record/connection_adapters/abstract_adapter.rb +502 -91
  56. data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +200 -108
  57. data/lib/active_record/connection_adapters/column.rb +9 -0
  58. data/lib/active_record/connection_adapters/mysql/column.rb +1 -0
  59. data/lib/active_record/connection_adapters/mysql/database_statements.rb +22 -143
  60. data/lib/active_record/connection_adapters/mysql/quoting.rb +16 -12
  61. data/lib/active_record/connection_adapters/mysql/schema_creation.rb +9 -0
  62. data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +6 -0
  63. data/lib/active_record/connection_adapters/mysql/schema_dumper.rb +1 -1
  64. data/lib/active_record/connection_adapters/mysql/schema_statements.rb +17 -12
  65. data/lib/active_record/connection_adapters/mysql2/database_statements.rb +148 -0
  66. data/lib/active_record/connection_adapters/mysql2_adapter.rb +98 -53
  67. data/lib/active_record/connection_adapters/pool_config.rb +14 -5
  68. data/lib/active_record/connection_adapters/pool_manager.rb +19 -9
  69. data/lib/active_record/connection_adapters/postgresql/column.rb +1 -2
  70. data/lib/active_record/connection_adapters/postgresql/database_statements.rb +76 -29
  71. data/lib/active_record/connection_adapters/postgresql/oid/range.rb +11 -2
  72. data/lib/active_record/connection_adapters/postgresql/quoting.rb +9 -6
  73. data/lib/active_record/connection_adapters/postgresql/referential_integrity.rb +3 -9
  74. data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +76 -6
  75. data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +131 -2
  76. data/lib/active_record/connection_adapters/postgresql/schema_dumper.rb +42 -0
  77. data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +351 -54
  78. data/lib/active_record/connection_adapters/postgresql_adapter.rb +336 -168
  79. data/lib/active_record/connection_adapters/schema_cache.rb +287 -59
  80. data/lib/active_record/connection_adapters/sqlite3/column.rb +49 -0
  81. data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +42 -36
  82. data/lib/active_record/connection_adapters/sqlite3/quoting.rb +4 -3
  83. data/lib/active_record/connection_adapters/sqlite3/schema_definitions.rb +1 -0
  84. data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +26 -7
  85. data/lib/active_record/connection_adapters/sqlite3_adapter.rb +162 -77
  86. data/lib/active_record/connection_adapters/statement_pool.rb +7 -0
  87. data/lib/active_record/connection_adapters/trilogy/database_statements.rb +98 -0
  88. data/lib/active_record/connection_adapters/trilogy_adapter.rb +254 -0
  89. data/lib/active_record/connection_adapters.rb +3 -1
  90. data/lib/active_record/connection_handling.rb +71 -94
  91. data/lib/active_record/core.rb +128 -138
  92. data/lib/active_record/counter_cache.rb +46 -25
  93. data/lib/active_record/database_configurations/database_config.rb +9 -3
  94. data/lib/active_record/database_configurations/hash_config.rb +22 -12
  95. data/lib/active_record/database_configurations/url_config.rb +17 -11
  96. data/lib/active_record/database_configurations.rb +86 -33
  97. data/lib/active_record/delegated_type.rb +8 -3
  98. data/lib/active_record/deprecator.rb +7 -0
  99. data/lib/active_record/destroy_association_async_job.rb +2 -0
  100. data/lib/active_record/encryption/auto_filtered_parameters.rb +66 -0
  101. data/lib/active_record/encryption/cipher/aes256_gcm.rb +4 -1
  102. data/lib/active_record/encryption/config.rb +25 -1
  103. data/lib/active_record/encryption/configurable.rb +12 -19
  104. data/lib/active_record/encryption/context.rb +10 -3
  105. data/lib/active_record/encryption/contexts.rb +5 -1
  106. data/lib/active_record/encryption/derived_secret_key_provider.rb +8 -2
  107. data/lib/active_record/encryption/encryptable_record.rb +36 -18
  108. data/lib/active_record/encryption/encrypted_attribute_type.rb +17 -6
  109. data/lib/active_record/encryption/extended_deterministic_queries.rb +66 -54
  110. data/lib/active_record/encryption/extended_deterministic_uniqueness_validator.rb +2 -2
  111. data/lib/active_record/encryption/key_generator.rb +12 -1
  112. data/lib/active_record/encryption/message_serializer.rb +2 -0
  113. data/lib/active_record/encryption/properties.rb +3 -3
  114. data/lib/active_record/encryption/scheme.rb +19 -22
  115. data/lib/active_record/encryption.rb +1 -0
  116. data/lib/active_record/enum.rb +113 -26
  117. data/lib/active_record/errors.rb +89 -15
  118. data/lib/active_record/explain.rb +23 -3
  119. data/lib/active_record/fixture_set/model_metadata.rb +14 -4
  120. data/lib/active_record/fixture_set/render_context.rb +2 -0
  121. data/lib/active_record/fixture_set/table_row.rb +29 -8
  122. data/lib/active_record/fixtures.rb +119 -71
  123. data/lib/active_record/future_result.rb +30 -5
  124. data/lib/active_record/gem_version.rb +4 -4
  125. data/lib/active_record/inheritance.rb +30 -16
  126. data/lib/active_record/insert_all.rb +55 -8
  127. data/lib/active_record/integration.rb +8 -8
  128. data/lib/active_record/internal_metadata.rb +118 -30
  129. data/lib/active_record/locking/pessimistic.rb +5 -2
  130. data/lib/active_record/log_subscriber.rb +29 -12
  131. data/lib/active_record/marshalling.rb +56 -0
  132. data/lib/active_record/message_pack.rb +124 -0
  133. data/lib/active_record/middleware/database_selector/resolver.rb +4 -0
  134. data/lib/active_record/middleware/database_selector.rb +5 -7
  135. data/lib/active_record/middleware/shard_selector.rb +3 -1
  136. data/lib/active_record/migration/command_recorder.rb +100 -4
  137. data/lib/active_record/migration/compatibility.rb +131 -5
  138. data/lib/active_record/migration/default_strategy.rb +23 -0
  139. data/lib/active_record/migration/execution_strategy.rb +19 -0
  140. data/lib/active_record/migration.rb +213 -109
  141. data/lib/active_record/model_schema.rb +47 -27
  142. data/lib/active_record/nested_attributes.rb +28 -3
  143. data/lib/active_record/normalization.rb +158 -0
  144. data/lib/active_record/persistence.rb +183 -33
  145. data/lib/active_record/promise.rb +84 -0
  146. data/lib/active_record/query_cache.rb +3 -21
  147. data/lib/active_record/query_logs.rb +77 -52
  148. data/lib/active_record/query_logs_formatter.rb +41 -0
  149. data/lib/active_record/querying.rb +15 -2
  150. data/lib/active_record/railtie.rb +107 -45
  151. data/lib/active_record/railties/controller_runtime.rb +10 -5
  152. data/lib/active_record/railties/databases.rake +139 -145
  153. data/lib/active_record/railties/job_runtime.rb +23 -0
  154. data/lib/active_record/readonly_attributes.rb +32 -5
  155. data/lib/active_record/reflection.rb +169 -45
  156. data/lib/active_record/relation/batches/batch_enumerator.rb +5 -3
  157. data/lib/active_record/relation/batches.rb +190 -61
  158. data/lib/active_record/relation/calculations.rb +152 -63
  159. data/lib/active_record/relation/delegation.rb +22 -8
  160. data/lib/active_record/relation/finder_methods.rb +85 -15
  161. data/lib/active_record/relation/merger.rb +2 -0
  162. data/lib/active_record/relation/predicate_builder/association_query_value.rb +11 -2
  163. data/lib/active_record/relation/predicate_builder/relation_handler.rb +5 -1
  164. data/lib/active_record/relation/predicate_builder.rb +26 -14
  165. data/lib/active_record/relation/query_attribute.rb +2 -1
  166. data/lib/active_record/relation/query_methods.rb +351 -62
  167. data/lib/active_record/relation/spawn_methods.rb +18 -1
  168. data/lib/active_record/relation.rb +76 -35
  169. data/lib/active_record/result.rb +19 -5
  170. data/lib/active_record/runtime_registry.rb +10 -1
  171. data/lib/active_record/sanitization.rb +51 -11
  172. data/lib/active_record/schema.rb +2 -3
  173. data/lib/active_record/schema_dumper.rb +41 -7
  174. data/lib/active_record/schema_migration.rb +68 -33
  175. data/lib/active_record/scoping/default.rb +15 -5
  176. data/lib/active_record/scoping/named.rb +2 -2
  177. data/lib/active_record/scoping.rb +2 -1
  178. data/lib/active_record/secure_password.rb +60 -0
  179. data/lib/active_record/secure_token.rb +21 -3
  180. data/lib/active_record/signed_id.rb +7 -5
  181. data/lib/active_record/store.rb +8 -8
  182. data/lib/active_record/suppressor.rb +3 -1
  183. data/lib/active_record/table_metadata.rb +10 -1
  184. data/lib/active_record/tasks/database_tasks.rb +127 -105
  185. data/lib/active_record/tasks/mysql_database_tasks.rb +15 -6
  186. data/lib/active_record/tasks/postgresql_database_tasks.rb +16 -13
  187. data/lib/active_record/tasks/sqlite_database_tasks.rb +14 -7
  188. data/lib/active_record/test_fixtures.rb +113 -96
  189. data/lib/active_record/timestamp.rb +26 -14
  190. data/lib/active_record/token_for.rb +113 -0
  191. data/lib/active_record/touch_later.rb +11 -6
  192. data/lib/active_record/transactions.rb +36 -10
  193. data/lib/active_record/type/adapter_specific_registry.rb +1 -8
  194. data/lib/active_record/type/internal/timezone.rb +7 -2
  195. data/lib/active_record/type/time.rb +4 -0
  196. data/lib/active_record/validations/absence.rb +1 -1
  197. data/lib/active_record/validations/numericality.rb +5 -4
  198. data/lib/active_record/validations/presence.rb +5 -28
  199. data/lib/active_record/validations/uniqueness.rb +47 -2
  200. data/lib/active_record/validations.rb +8 -4
  201. data/lib/active_record/version.rb +1 -1
  202. data/lib/active_record.rb +121 -16
  203. data/lib/arel/errors.rb +10 -0
  204. data/lib/arel/factory_methods.rb +4 -0
  205. data/lib/arel/nodes/binary.rb +6 -1
  206. data/lib/arel/nodes/bound_sql_literal.rb +61 -0
  207. data/lib/arel/nodes/cte.rb +36 -0
  208. data/lib/arel/nodes/fragments.rb +35 -0
  209. data/lib/arel/nodes/homogeneous_in.rb +0 -8
  210. data/lib/arel/nodes/leading_join.rb +8 -0
  211. data/lib/arel/nodes/node.rb +111 -2
  212. data/lib/arel/nodes/sql_literal.rb +6 -0
  213. data/lib/arel/nodes/table_alias.rb +4 -0
  214. data/lib/arel/nodes.rb +4 -0
  215. data/lib/arel/predications.rb +2 -0
  216. data/lib/arel/table.rb +9 -5
  217. data/lib/arel/visitors/mysql.rb +8 -1
  218. data/lib/arel/visitors/to_sql.rb +81 -17
  219. data/lib/arel/visitors/visitor.rb +2 -2
  220. data/lib/arel.rb +16 -2
  221. data/lib/rails/generators/active_record/application_record/USAGE +8 -0
  222. data/lib/rails/generators/active_record/migration.rb +3 -1
  223. data/lib/rails/generators/active_record/model/USAGE +113 -0
  224. data/lib/rails/generators/active_record/model/model_generator.rb +15 -6
  225. metadata +52 -17
  226. data/lib/active_record/connection_adapters/legacy_pool_manager.rb +0 -35
  227. data/lib/active_record/null_relation.rb +0 -63
@@ -6,20 +6,23 @@ require "zlib"
6
6
  require "set"
7
7
  require "active_support/dependencies"
8
8
  require "active_support/core_ext/digest/uuid"
9
- require "active_record/fixture_set/file"
10
- require "active_record/fixture_set/render_context"
11
- require "active_record/fixture_set/table_rows"
12
9
  require "active_record/test_fixtures"
13
10
 
14
11
  module ActiveRecord
15
12
  class FixtureClassNotFound < ActiveRecord::ActiveRecordError # :nodoc:
16
13
  end
17
14
 
15
+ # = Active Record \Fixtures
16
+ #
18
17
  # \Fixtures are a way of organizing data that you want to test against; in short, sample data.
19
18
  #
20
- # They are stored in YAML files, one file per model, which are placed in the directory
21
- # appointed by <tt>ActiveSupport::TestCase.fixture_path=(path)</tt> (this is automatically
22
- # configured for Rails, so you can just put your files in <tt><your-rails-app>/test/fixtures/</tt>).
19
+ # They are stored in YAML files, one file per model, which are by default placed in either
20
+ # <tt><your-rails-app>/test/fixtures/</tt> or in the <tt>test/fixtures</tt>
21
+ # folder under any of your application's engines.
22
+ #
23
+ # The location can also be changed with ActiveSupport::TestCase.fixture_paths=,
24
+ # once you have <tt>require "rails/test_help"</tt> in your +test_helper.rb+.
25
+ #
23
26
  # The fixture file ends with the +.yml+ file extension, for example:
24
27
  # <tt><your-rails-app>/test/fixtures/web_sites.yml</tt>).
25
28
  #
@@ -39,10 +42,17 @@ module ActiveRecord
39
42
  # is followed by an indented list of key/value pairs in the "key: value" format. Records are
40
43
  # separated by a blank line for your viewing pleasure.
41
44
  #
42
- # Note: Fixtures are unordered. If you want ordered fixtures, use the omap YAML type.
43
- # See https://yaml.org/type/omap.html
44
- # for the specification. You will need ordered fixtures when you have foreign key constraints
45
- # on keys in the same table. This is commonly needed for tree structures. Example:
45
+ # == Ordering
46
+ #
47
+ # Fixtures by default are unordered. This is because the maps in YAML are unordered.
48
+ #
49
+ # If you want ordered fixtures, use the omap YAML type.
50
+ # See https://yaml.org/type/omap.html for the specification.
51
+ #
52
+ # You will need ordered fixtures when you have foreign key constraints
53
+ # on keys in the same table. This is commonly needed for tree structures.
54
+ #
55
+ # For example:
46
56
  #
47
57
  # --- !omap
48
58
  # - parent:
@@ -54,7 +64,7 @@ module ActiveRecord
54
64
  # parent_id: 1
55
65
  # title: Child
56
66
  #
57
- # = Using Fixtures in Test Cases
67
+ # == Using Fixtures in Test Cases
58
68
  #
59
69
  # Since fixtures are a testing construct, we use them in our unit and functional tests. There
60
70
  # are two ways to use the fixtures, but first let's take a look at a sample unit test:
@@ -124,7 +134,7 @@ module ActiveRecord
124
134
  # traversed in the database to create the fixture hash and/or instance variables. This is expensive for
125
135
  # large sets of fixtured data.
126
136
  #
127
- # = Dynamic fixtures with ERB
137
+ # == Dynamic fixtures with \ERB
128
138
  #
129
139
  # Sometimes you don't care about the content of the fixtures as much as you care about the volume.
130
140
  # In these cases, you can mix ERB in with your YAML fixtures to create a bunch of fixtures for load
@@ -162,7 +172,7 @@ module ActiveRecord
162
172
  # name: kitten.png
163
173
  # sha: <%= file_sha 'files/kitten.png' %>
164
174
  #
165
- # = Transactional Tests
175
+ # == Transactional Tests
166
176
  #
167
177
  # Test cases can use begin+rollback to isolate their changes to the database instead of having to
168
178
  # delete+insert for every test case.
@@ -198,7 +208,7 @@ module ActiveRecord
198
208
  # 2. Your database does not support transactions. Every Active Record database supports transactions except MySQL MyISAM.
199
209
  # Use InnoDB, MaxDB, or NDB instead.
200
210
  #
201
- # = Advanced Fixtures
211
+ # == Advanced Fixtures
202
212
  #
203
213
  # Fixtures that don't specify an ID get some extra features:
204
214
  #
@@ -212,7 +222,7 @@ module ActiveRecord
212
222
  # * Fixture label interpolation
213
223
  # * Support for YAML defaults
214
224
  #
215
- # == Stable, Autogenerated IDs
225
+ # === Stable, Autogenerated IDs
216
226
  #
217
227
  # Here, have a monkey fixture:
218
228
  #
@@ -241,13 +251,13 @@ module ActiveRecord
241
251
  # The generated ID for a given label is constant, so we can discover
242
252
  # any fixture's ID without loading anything, as long as we know the label.
243
253
  #
244
- # == Label references for associations (+belongs_to+, +has_one+, +has_many+)
254
+ # === Label references for associations (+belongs_to+, +has_one+, +has_many+)
245
255
  #
246
256
  # Specifying foreign keys in fixtures can be very fragile, not to
247
257
  # mention difficult to read. Since Active Record can figure out the ID of
248
258
  # any fixture from its label, you can specify FK's by label instead of ID.
249
259
  #
250
- # === +belongs_to+
260
+ # ==== +belongs_to+
251
261
  #
252
262
  # Let's break out some more monkeys and pirates.
253
263
  #
@@ -311,9 +321,9 @@ module ActiveRecord
311
321
  #
312
322
  # Just provide the polymorphic target type and Active Record will take care of the rest.
313
323
  #
314
- # === +has_and_belongs_to_many+ or <tt>has_many :through</tt>
324
+ # ==== +has_and_belongs_to_many+ or <tt>has_many :through</tt>
315
325
  #
316
- # Time to give our monkey some fruit.
326
+ # \Time to give our monkey some fruit.
317
327
  #
318
328
  # ### in monkeys.yml
319
329
  #
@@ -375,7 +385,7 @@ module ActiveRecord
375
385
  # the fixture's model class and discovers the +has_and_belongs_to_many+
376
386
  # associations.
377
387
  #
378
- # == Autofilled Timestamp Columns
388
+ # === Autofilled \Timestamp Columns
379
389
  #
380
390
  # If your table/model specifies any of Active Record's
381
391
  # standard timestamp columns (+created_at+, +created_on+, +updated_at+, +updated_on+),
@@ -383,7 +393,7 @@ module ActiveRecord
383
393
  #
384
394
  # If you've set specific values, they'll be left alone.
385
395
  #
386
- # == Fixture label interpolation
396
+ # === Fixture label interpolation
387
397
  #
388
398
  # The label of the current fixture is always available as a column value:
389
399
  #
@@ -400,7 +410,11 @@ module ActiveRecord
400
410
  # monkey_id: <%= ActiveRecord::FixtureSet.identify(:reginald) %>
401
411
  # pirate_id: <%= ActiveRecord::FixtureSet.identify(:george) %>
402
412
  #
403
- # == Support for YAML defaults
413
+ # If the model uses UUID values for identifiers, add the +:uuid+ argument:
414
+ #
415
+ # ActiveRecord::FixtureSet.identify(:boaty_mcboatface, :uuid)
416
+ #
417
+ # === Support for YAML defaults
404
418
  #
405
419
  # You can set and reuse defaults in your fixtures YAML file.
406
420
  # This is the same technique used in the +database.yml+ file to specify
@@ -442,6 +456,41 @@ module ActiveRecord
442
456
  # In the above example, 'base' will be ignored when creating fixtures.
443
457
  # This can be used for common attributes inheriting.
444
458
  #
459
+ # == Composite Primary Key Fixtures
460
+ #
461
+ # Fixtures for composite primary key tables are fairly similar to normal tables.
462
+ # When using an id column, the column may be omitted as usual:
463
+ #
464
+ # # app/models/book.rb
465
+ # class Book < ApplicationRecord
466
+ # self.primary_key = [:author_id, :id]
467
+ # belongs_to :author
468
+ # end
469
+ #
470
+ # # books.yml
471
+ # alices_adventure_in_wonderland:
472
+ # author_id: <%= ActiveRecord::FixtureSet.identify(:lewis_carroll) %>
473
+ # title: "Alice's Adventures in Wonderland"
474
+ #
475
+ # However, in order to support composite primary key relationships,
476
+ # you must use the `composite_identify` method:
477
+ #
478
+ # # app/models/book_orders.rb
479
+ # class BookOrder < ApplicationRecord
480
+ # self.primary_key = [:shop_id, :id]
481
+ # belongs_to :order, query_constraints: [:shop_id, :order_id]
482
+ # belongs_to :book, query_constraints: [:author_id, :book_id]
483
+ # end
484
+ #
485
+ # # book_orders.yml
486
+ # alices_adventure_in_wonderland_in_books:
487
+ # author: lewis_carroll
488
+ # book_id: <%= ActiveRecord::FixtureSet.composite_identify(
489
+ # :alices_adventure_in_wonderland, Book.primary_key)[:id] %>
490
+ # shop: book_store
491
+ # order_id: <%= ActiveRecord::FixtureSet.composite_identify(
492
+ # :books, Order.primary_key)[:id] %>
493
+ #
445
494
  # == Configure the fixture model class
446
495
  #
447
496
  # It's possible to set the fixture's model class directly in the YAML file.
@@ -456,6 +505,10 @@ module ActiveRecord
456
505
  #
457
506
  # Any fixtures labeled "_fixture" are safely ignored.
458
507
  class FixtureSet
508
+ require "active_record/fixture_set/file"
509
+ require "active_record/fixture_set/render_context"
510
+ require "active_record/fixture_set/table_rows"
511
+
459
512
  #--
460
513
  # An instance of FixtureSet is normally stored in a single YAML file and
461
514
  # possibly in a folder with the same name.
@@ -467,39 +520,6 @@ module ActiveRecord
467
520
 
468
521
  cattr_accessor :all_loaded_fixtures, default: {}
469
522
 
470
- class ClassCache
471
- def initialize(class_names, config)
472
- @class_names = class_names.stringify_keys
473
- @config = config
474
-
475
- # Remove string values that aren't constants or subclasses of AR
476
- @class_names.delete_if do |klass_name, klass|
477
- !insert_class(@class_names, klass_name, klass)
478
- end
479
- end
480
-
481
- def [](fs_name)
482
- @class_names.fetch(fs_name) do
483
- klass = default_fixture_model(fs_name, @config).safe_constantize
484
- insert_class(@class_names, fs_name, klass)
485
- end
486
- end
487
-
488
- private
489
- def insert_class(class_names, name, klass)
490
- # We only want to deal with AR objects.
491
- if klass && klass < ActiveRecord::Base
492
- class_names[name] = klass
493
- else
494
- class_names[name] = nil
495
- end
496
- end
497
-
498
- def default_fixture_model(fs_name, config)
499
- ActiveRecord::FixtureSet.default_fixture_model_name(fs_name, config)
500
- end
501
- end
502
-
503
523
  class << self
504
524
  def default_fixture_model_name(fixture_set_name, config = ActiveRecord::Base) # :nodoc:
505
525
  config.pluralize_table_names ?
@@ -552,9 +572,9 @@ module ActiveRecord
552
572
  end
553
573
  end
554
574
 
555
- def create_fixtures(fixtures_directory, fixture_set_names, class_names = {}, config = ActiveRecord::Base, &block)
575
+ def create_fixtures(fixtures_directories, fixture_set_names, class_names = {}, config = ActiveRecord::Base, &block)
556
576
  fixture_set_names = Array(fixture_set_names).map(&:to_s)
557
- class_names = ClassCache.new class_names, config
577
+ class_names.stringify_keys!
558
578
 
559
579
  # FIXME: Apparently JK uses this.
560
580
  connection = block_given? ? block : lambda { ActiveRecord::Base.connection }
@@ -565,7 +585,7 @@ module ActiveRecord
565
585
 
566
586
  if fixture_files_to_read.any?
567
587
  fixtures_map = read_and_insert(
568
- fixtures_directory,
588
+ Array(fixtures_directories),
569
589
  fixture_files_to_read,
570
590
  class_names,
571
591
  connection,
@@ -576,7 +596,8 @@ module ActiveRecord
576
596
  end
577
597
 
578
598
  # Returns a consistent, platform-independent identifier for +label+.
579
- # Integer identifiers are values less than 2^30. UUIDs are RFC 4122 version 5 SHA-1 hashes.
599
+ #
600
+ # \Integer identifiers are values less than 2^30. UUIDs are RFC 4122 version 5 SHA-1 hashes.
580
601
  def identify(label, column_type = :integer)
581
602
  if column_type == :uuid
582
603
  Digest::UUID.uuid_v5(Digest::UUID::OID_NAMESPACE, label.to_s)
@@ -585,21 +606,35 @@ module ActiveRecord
585
606
  end
586
607
  end
587
608
 
588
- # Superclass for the evaluation contexts used by ERB fixtures.
609
+ # Returns a consistent, platform-independent hash representing a mapping
610
+ # between the label and the subcomponents of the provided composite key.
611
+ #
612
+ # Example:
613
+ #
614
+ # composite_identify("label", [:a, :b, :c]) # => { a: hash_1, b: hash_2, c: hash_3 }
615
+ def composite_identify(label, key)
616
+ key
617
+ .index_with
618
+ .with_index { |sub_key, index| (identify(label) << index) % MAX_ID }
619
+ .with_indifferent_access
620
+ end
621
+
622
+ # Superclass for the evaluation contexts used by \ERB fixtures.
589
623
  def context_class
590
624
  @context_class ||= Class.new
591
625
  end
592
626
 
593
627
  private
594
- def read_and_insert(fixtures_directory, fixture_files, class_names, connection) # :nodoc:
628
+ def read_and_insert(fixtures_directories, fixture_files, class_names, connection) # :nodoc:
595
629
  fixtures_map = {}
630
+ directory_glob = "{#{fixtures_directories.join(",")}}"
596
631
  fixture_sets = fixture_files.map do |fixture_set_name|
597
632
  klass = class_names[fixture_set_name]
598
633
  fixtures_map[fixture_set_name] = new( # ActiveRecord::FixtureSet.new
599
634
  nil,
600
635
  fixture_set_name,
601
636
  klass,
602
- ::File.join(fixtures_directory, fixture_set_name)
637
+ ::File.join(directory_glob, fixture_set_name)
603
638
  )
604
639
  end
605
640
  update_all_loaded_fixtures(fixtures_map)
@@ -629,9 +664,7 @@ module ActiveRecord
629
664
 
630
665
  conn.insert_fixtures_set(table_rows_for_connection, table_rows_for_connection.keys)
631
666
 
632
- if ActiveRecord.verify_foreign_keys_for_fixtures && !conn.all_foreign_keys_valid?
633
- raise "Foreign key violations found in your fixture data. Ensure you aren't referring to labels that don't exist on associations."
634
- end
667
+ check_all_foreign_keys_valid!(conn)
635
668
 
636
669
  # Cap primary key sequences to max(pk).
637
670
  if conn.respond_to?(:reset_pk_sequence!)
@@ -640,6 +673,16 @@ module ActiveRecord
640
673
  end
641
674
  end
642
675
 
676
+ def check_all_foreign_keys_valid!(conn)
677
+ return unless ActiveRecord.verify_foreign_keys_for_fixtures
678
+
679
+ begin
680
+ conn.check_all_foreign_keys_valid!
681
+ rescue ActiveRecord::StatementInvalid => e
682
+ raise "Foreign key violations found in your fixture data. Ensure you aren't referring to labels that don't exist on associations. Error from database:\n\n#{e.message}"
683
+ end
684
+ end
685
+
643
686
  def update_all_loaded_fixtures(fixtures_map) # :nodoc:
644
687
  all_loaded_fixtures.update(fixtures_map)
645
688
  end
@@ -653,7 +696,6 @@ module ActiveRecord
653
696
  @config = config
654
697
 
655
698
  self.model_class = class_name
656
-
657
699
  @fixtures = read_fixture_files(path)
658
700
 
659
701
  @table_name = model_class&.table_name || self.class.default_fixture_table_name(name, config)
@@ -715,14 +757,18 @@ module ActiveRecord
715
757
  # Loads the fixtures from the YAML file at +path+.
716
758
  # If the file sets the +model_class+ and current instance value is not set,
717
759
  # it uses the file value.
760
+
718
761
  def read_fixture_files(path)
719
- yaml_files = Dir["#{path}/{**,*}/*.yml"].select { |f|
762
+ yaml_files = Dir["#{path}{.yml,/{**,*}/*.yml}"].select { |f|
720
763
  ::File.file?(f)
721
- } + [yaml_file_path(path)]
764
+ }
765
+
766
+ raise ArgumentError, "No fixture files found for #{@name}" if yaml_files.empty?
722
767
 
723
768
  yaml_files.each_with_object({}) do |file, fixtures|
724
769
  FixtureSet::File.open(file) do |fh|
725
770
  self.model_class ||= fh.model_class if fh.model_class
771
+ self.model_class ||= default_fixture_model_class
726
772
  self.ignored_fixtures ||= fh.ignored_fixtures
727
773
  fh.each do |fixture_name, row|
728
774
  fixtures[fixture_name] = ActiveRecord::Fixture.new(row, model_class)
@@ -731,8 +777,9 @@ module ActiveRecord
731
777
  end
732
778
  end
733
779
 
734
- def yaml_file_path(path)
735
- "#{path}.yml"
780
+ def default_fixture_model_class
781
+ klass = ActiveRecord::FixtureSet.default_fixture_model_name(@name, @config).safe_constantize
782
+ klass if klass && klass < ActiveRecord::Base
736
783
  end
737
784
  end
738
785
 
@@ -769,7 +816,8 @@ module ActiveRecord
769
816
  def find
770
817
  raise FixtureClassNotFound, "No class attached to find." unless model_class
771
818
  object = model_class.unscoped do
772
- model_class.find(fixture[model_class.primary_key])
819
+ pk_clauses = fixture.slice(*Array(model_class.primary_key))
820
+ model_class.find_by!(pk_clauses)
773
821
  end
774
822
  # Fixtures can't be eagerly loaded
775
823
  object.instance_variable_set(:@strict_loading, false)
@@ -2,6 +2,27 @@
2
2
 
3
3
  module ActiveRecord
4
4
  class FutureResult # :nodoc:
5
+ class Complete
6
+ attr_reader :result
7
+ delegate :empty?, :to_a, to: :result
8
+
9
+ def initialize(result)
10
+ @result = result
11
+ end
12
+
13
+ def pending?
14
+ false
15
+ end
16
+
17
+ def canceled?
18
+ false
19
+ end
20
+
21
+ def then(&block)
22
+ Promise::Complete.new(@result.then(&block))
23
+ end
24
+ end
25
+
5
26
  class EventBuffer
6
27
  def initialize(future_result, instrumenter)
7
28
  @future_result = future_result
@@ -45,6 +66,10 @@ module ActiveRecord
45
66
  @event_buffer = nil
46
67
  end
47
68
 
69
+ def then(&block)
70
+ Promise.new(self, block)
71
+ end
72
+
48
73
  def schedule!(session)
49
74
  @session = session
50
75
  @pool.schedule_query(self)
@@ -95,11 +120,11 @@ module ActiveRecord
95
120
  @pending && (!@session || @session.active?)
96
121
  end
97
122
 
98
- private
99
- def canceled?
100
- @session && !@session.active?
101
- end
123
+ def canceled?
124
+ @session && !@session.active?
125
+ end
102
126
 
127
+ private
103
128
  def execute_or_wait
104
129
  if pending?
105
130
  start = Process.clock_gettime(Process::CLOCK_MONOTONIC, :float_millisecond)
@@ -124,7 +149,7 @@ module ActiveRecord
124
149
  end
125
150
 
126
151
  def exec_query(connection, *args, **kwargs)
127
- connection.exec_query(*args, **kwargs)
152
+ connection.internal_exec_query(*args, **kwargs)
128
153
  end
129
154
 
130
155
  class SelectAll < FutureResult # :nodoc:
@@ -1,16 +1,16 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module ActiveRecord
4
- # Returns the currently loaded version of Active Record as a <tt>Gem::Version</tt>.
4
+ # Returns the currently loaded version of Active Record as a +Gem::Version+.
5
5
  def self.gem_version
6
6
  Gem::Version.new VERSION::STRING
7
7
  end
8
8
 
9
9
  module VERSION
10
10
  MAJOR = 7
11
- MINOR = 0
12
- TINY = 8
13
- PRE = "7"
11
+ MINOR = 1
12
+ TINY = 0
13
+ PRE = "beta1"
14
14
 
15
15
  STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")
16
16
  end
@@ -4,7 +4,7 @@ require "active_support/inflector"
4
4
  require "active_support/core_ext/hash/indifferent_access"
5
5
 
6
6
  module ActiveRecord
7
- # == Single table inheritance
7
+ # = Single table inheritance
8
8
  #
9
9
  # Active Record allows inheritance by storing the name of the class in a column that by
10
10
  # default is named "type" (can be changed by overwriting <tt>Base.inheritance_column</tt>).
@@ -32,8 +32,9 @@ module ActiveRecord
32
32
  # be triggered. In that case, it'll work just like normal subclasses with no special magic
33
33
  # for differentiating between them or reloading the right type with find.
34
34
  #
35
- # Note, all the attributes for all the cases are kept in the same table. Read more:
36
- # https://www.martinfowler.com/eaaCatalog/singleTableInheritance.html
35
+ # Note, all the attributes for all the cases are kept in the same table.
36
+ # Read more:
37
+ # * https://www.martinfowler.com/eaaCatalog/singleTableInheritance.html
37
38
  #
38
39
  module Inheritance
39
40
  extend ActiveSupport::Concern
@@ -93,14 +94,24 @@ module ActiveRecord
93
94
  :true == (@finder_needs_type_condition ||= descends_from_active_record? ? :false : :true)
94
95
  end
95
96
 
96
- # Returns the class descending directly from ActiveRecord::Base, or
97
- # an abstract class, if any, in the inheritance hierarchy.
97
+ # Returns the first class in the inheritance hierarchy that descends from either an
98
+ # abstract class or from <tt>ActiveRecord::Base</tt>.
98
99
  #
99
- # If A extends ActiveRecord::Base, A.base_class will return A. If B descends from A
100
- # through some arbitrarily deep hierarchy, B.base_class will return A.
100
+ # Consider the following behaviour:
101
101
  #
102
- # If B < A and C < B and if A is an abstract_class then both B.base_class
103
- # and C.base_class would return B as the answer since A is an abstract_class.
102
+ # class ApplicationRecord < ActiveRecord::Base
103
+ # self.abstract_class = true
104
+ # end
105
+ # class Shape < ApplicationRecord
106
+ # self.abstract_class = true
107
+ # end
108
+ # Polygon = Class.new(Shape)
109
+ # Square = Class.new(Polygon)
110
+ #
111
+ # ApplicationRecord.base_class # => ApplicationRecord
112
+ # Shape.base_class # => Shape
113
+ # Polygon.base_class # => Polygon
114
+ # Square.base_class # => Polygon
104
115
  attr_reader :base_class
105
116
 
106
117
  # Returns whether the class is a base class.
@@ -116,7 +127,7 @@ module ActiveRecord
116
127
  # true.
117
128
  # +ApplicationRecord+, for example, is generated as an abstract class.
118
129
  #
119
- # Consider the following default behaviour:
130
+ # Consider the following default behavior:
120
131
  #
121
132
  # Shape = Class.new(ActiveRecord::Base)
122
133
  # Polygon = Class.new(Shape)
@@ -210,12 +221,6 @@ module ActiveRecord
210
221
  end
211
222
  end
212
223
 
213
- def inherited(subclass)
214
- subclass.set_base_class
215
- subclass.instance_variable_set(:@_type_candidates_cache, Concurrent::Map.new)
216
- super
217
- end
218
-
219
224
  def dup # :nodoc:
220
225
  # `initialize_dup` / `initialize_copy` don't work when defined
221
226
  # in the `singleton_class`.
@@ -277,6 +282,15 @@ module ActiveRecord
277
282
  end
278
283
 
279
284
  private
285
+ def inherited(subclass)
286
+ super
287
+ subclass.set_base_class
288
+ subclass.instance_variable_set(:@_type_candidates_cache, Concurrent::Map.new)
289
+ subclass.class_eval do
290
+ @finder_needs_type_condition = nil
291
+ end
292
+ end
293
+
280
294
  # Called by +instantiate+ to decide which class to use for a new
281
295
  # record instance. For single-table inheritance, we check the record
282
296
  # for a +type+ column and return the corresponding class.
@@ -8,15 +8,21 @@ module ActiveRecord
8
8
  attr_reader :on_duplicate, :update_only, :returning, :unique_by, :update_sql
9
9
 
10
10
  def initialize(model, inserts, on_duplicate:, update_only: nil, returning: nil, unique_by: nil, record_timestamps: nil)
11
- raise ArgumentError, "Empty list of attributes passed" if inserts.blank?
12
-
13
- @model, @connection, @inserts, @keys = model, model.connection, inserts, inserts.first.keys.map(&:to_s)
11
+ @model, @connection, @inserts = model, model.connection, inserts.map(&:stringify_keys)
14
12
  @on_duplicate, @update_only, @returning, @unique_by = on_duplicate, update_only, returning, unique_by
15
13
  @record_timestamps = record_timestamps.nil? ? model.record_timestamps : record_timestamps
16
14
 
17
15
  disallow_raw_sql!(on_duplicate)
18
16
  disallow_raw_sql!(returning)
19
17
 
18
+ if @inserts.empty?
19
+ @keys = []
20
+ else
21
+ resolve_sti
22
+ resolve_attribute_aliases
23
+ @keys = @inserts.first.keys
24
+ end
25
+
20
26
  configure_on_duplicate_update_logic
21
27
 
22
28
  if model.scope_attributes?
@@ -28,13 +34,15 @@ module ActiveRecord
28
34
  @returning = (connection.supports_insert_returning? ? primary_keys : false) if @returning.nil?
29
35
  @returning = false if @returning == []
30
36
 
31
- @unique_by = find_unique_index_for(unique_by)
37
+ @unique_by = find_unique_index_for(@unique_by)
32
38
  @on_duplicate = :skip if @on_duplicate == :update && updatable_columns.empty?
33
39
 
34
40
  ensure_valid_options_for_connection!
35
41
  end
36
42
 
37
43
  def execute
44
+ return ActiveRecord::Result.empty if inserts.empty?
45
+
38
46
  message = +"#{model} "
39
47
  message << "Bulk " if inserts.many?
40
48
  message << (on_duplicate == :update ? "Upsert" : "Insert")
@@ -76,7 +84,7 @@ module ActiveRecord
76
84
  @record_timestamps
77
85
  end
78
86
 
79
- # TODO: Consider remaining this method, as it only conditionally extends keys, not always
87
+ # TODO: Consider renaming this method, as it only conditionally extends keys, not always
80
88
  def keys_including_timestamps
81
89
  @keys_including_timestamps ||= if record_timestamps?
82
90
  keys + model.all_timestamp_attributes_in_model
@@ -88,6 +96,34 @@ module ActiveRecord
88
96
  private
89
97
  attr_reader :scope_attributes
90
98
 
99
+ def has_attribute_aliases?(attributes)
100
+ attributes.keys.any? { |attribute| model.attribute_alias?(attribute) }
101
+ end
102
+
103
+ def resolve_sti
104
+ return if model.descends_from_active_record?
105
+
106
+ sti_type = model.sti_name
107
+ @inserts = @inserts.map do |insert|
108
+ insert.reverse_merge(model.inheritance_column.to_s => sti_type)
109
+ end
110
+ end
111
+
112
+ def resolve_attribute_aliases
113
+ return unless has_attribute_aliases?(@inserts.first)
114
+
115
+ @inserts = @inserts.map do |insert|
116
+ insert.transform_keys { |attribute| resolve_attribute_alias(attribute) }
117
+ end
118
+
119
+ @update_only = Array(@update_only).map { |attribute| resolve_attribute_alias(attribute) } if @update_only
120
+ @unique_by = Array(@unique_by).map { |attribute| resolve_attribute_alias(attribute) } if @unique_by
121
+ end
122
+
123
+ def resolve_attribute_alias(attribute)
124
+ model.attribute_alias(attribute) || attribute
125
+ end
126
+
91
127
  def configure_on_duplicate_update_logic
92
128
  if custom_update_sql_provided? && update_only.present?
93
129
  raise ArgumentError, "You can't set :update_only and provide custom update SQL via :on_duplicate at the same time"
@@ -115,8 +151,9 @@ module ActiveRecord
115
151
 
116
152
  name_or_columns = unique_by || model.primary_key
117
153
  match = Array(name_or_columns).map(&:to_s)
154
+ sorted_match = match.sort
118
155
 
119
- if index = unique_indexes.find { |i| match.include?(i.name) || i.columns == match }
156
+ if index = unique_indexes.find { |i| match.include?(i.name) || Array(i.columns).sort == sorted_match }
120
157
  index
121
158
  elsif match == primary_keys
122
159
  unique_by.nil? ? nil : ActiveRecord::ConnectionAdapters::IndexDefinition.new(model.table_name, "#{model.table_name}_primary_key", true, match)
@@ -212,7 +249,13 @@ module ActiveRecord
212
249
  if insert_all.returning.is_a?(String)
213
250
  insert_all.returning
214
251
  else
215
- format_columns(insert_all.returning)
252
+ Array(insert_all.returning).map do |attribute|
253
+ if model.attribute_alias?(attribute)
254
+ "#{quote_column(model.attribute_alias(attribute))} AS #{quote_column(attribute)}"
255
+ else
256
+ quote_column(attribute)
257
+ end
258
+ end.join(",")
216
259
  end
217
260
  end
218
261
 
@@ -271,7 +314,11 @@ module ActiveRecord
271
314
  end
272
315
 
273
316
  def quote_columns(columns)
274
- columns.map(&connection.method(:quote_column_name))
317
+ columns.map { |column| quote_column(column) }
318
+ end
319
+
320
+ def quote_column(column)
321
+ connection.quote_column_name(column)
275
322
  end
276
323
  end
277
324
  end