factory_bot 4.11.1 → 6.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/CONTRIBUTING.md +58 -13
  3. data/GETTING_STARTED.md +785 -153
  4. data/LICENSE +1 -1
  5. data/NEWS.md +379 -0
  6. data/README.md +20 -30
  7. data/lib/factory_bot/aliases.rb +2 -2
  8. data/lib/factory_bot/attribute/association.rb +2 -2
  9. data/lib/factory_bot/attribute/dynamic.rb +3 -2
  10. data/lib/factory_bot/attribute.rb +4 -39
  11. data/lib/factory_bot/attribute_assigner.rb +24 -10
  12. data/lib/factory_bot/attribute_list.rb +3 -2
  13. data/lib/factory_bot/callback.rb +4 -11
  14. data/lib/factory_bot/configuration.rb +15 -19
  15. data/lib/factory_bot/declaration/association.rb +33 -3
  16. data/lib/factory_bot/declaration/dynamic.rb +3 -1
  17. data/lib/factory_bot/declaration/implicit.rb +7 -2
  18. data/lib/factory_bot/declaration.rb +5 -5
  19. data/lib/factory_bot/declaration_list.rb +3 -3
  20. data/lib/factory_bot/decorator/attribute_hash.rb +1 -1
  21. data/lib/factory_bot/decorator/invocation_tracker.rb +2 -1
  22. data/lib/factory_bot/decorator.rb +20 -4
  23. data/lib/factory_bot/definition.rb +69 -21
  24. data/lib/factory_bot/definition_hierarchy.rb +1 -11
  25. data/lib/factory_bot/definition_proxy.rb +119 -64
  26. data/lib/factory_bot/enum.rb +27 -0
  27. data/lib/factory_bot/errors.rb +7 -4
  28. data/lib/factory_bot/evaluation.rb +1 -1
  29. data/lib/factory_bot/evaluator.rb +10 -11
  30. data/lib/factory_bot/evaluator_class_definer.rb +1 -1
  31. data/lib/factory_bot/factory.rb +12 -12
  32. data/lib/factory_bot/factory_runner.rb +4 -4
  33. data/lib/factory_bot/find_definitions.rb +2 -2
  34. data/lib/factory_bot/internal.rb +91 -0
  35. data/lib/factory_bot/linter.rb +41 -28
  36. data/lib/factory_bot/null_factory.rb +13 -4
  37. data/lib/factory_bot/null_object.rb +2 -6
  38. data/lib/factory_bot/registry.rb +17 -8
  39. data/lib/factory_bot/reload.rb +2 -3
  40. data/lib/factory_bot/sequence.rb +5 -6
  41. data/lib/factory_bot/strategy/stub.rb +37 -32
  42. data/lib/factory_bot/strategy_calculator.rb +1 -1
  43. data/lib/factory_bot/strategy_syntax_method_registrar.rb +13 -2
  44. data/lib/factory_bot/syntax/default.rb +13 -25
  45. data/lib/factory_bot/syntax/methods.rb +32 -9
  46. data/lib/factory_bot/syntax.rb +2 -2
  47. data/lib/factory_bot/trait.rb +7 -4
  48. data/lib/factory_bot/version.rb +1 -1
  49. data/lib/factory_bot.rb +71 -140
  50. metadata +46 -34
  51. data/NEWS +0 -306
  52. data/lib/factory_bot/attribute/static.rb +0 -16
  53. data/lib/factory_bot/declaration/static.rb +0 -26
  54. data/lib/factory_bot/decorator/class_key_hash.rb +0 -28
data/LICENSE CHANGED
@@ -1,4 +1,4 @@
1
- Copyright (c) 2008-2017 Joe Ferris and thoughtbot, inc.
1
+ Copyright (c) 2008-2019 Joe Ferris and thoughtbot, inc.
2
2
 
3
3
  Permission is hereby granted, free of charge, to any person obtaining a copy
4
4
  of this software and associated documentation files (the "Software"), to deal
data/NEWS.md ADDED
@@ -0,0 +1,379 @@
1
+ # News
2
+
3
+ ## 6.2.0 (May 7, 2021)
4
+ * Added: support for Ruby 3.0
5
+ * Changed: Include factory or trait name in error messages for missing traits. d05a9a3c
6
+ * Changed: Switched from Travis CI to GitHub Actions
7
+ * Fixed: More Ruby 2.7 kwarg deprecation warnings
8
+
9
+ ## 6.1.0 (July 8, 2020)
10
+ * Added: public reader for the evaluation instance, helpful for building interrelated associations
11
+ * Changed: raise a more helpful error when passing an invalid argument to an association
12
+ * Fixed: Ruby 2.7 kwarg deprecation warnings
13
+
14
+ ## 6.0.2 (June 19, 2020)
15
+ * Fixed: bug causing traits to consume more memory each time they were used
16
+
17
+ ## 6.0.1 (June 19, 2020)
18
+ * Fixed: bug with constant resolution causing unexpected uninitialized constant errors
19
+
20
+ ## 6.0.0 (June 18, 2020)
21
+ * Added: automatic definition of traits for Active Record enum attributes, enabled by default
22
+ (Note that this required changing where factory_bot constantizes the build
23
+ class, which may affect applications that were using abstract factories for
24
+ inheritance. See issue #1409.)
25
+ * Added: `traits_for_enum` method to define traits for non-Active Record enums
26
+ * Added: `build_stubbed_starting_id=` option to define the starting id for `build_stubbed`
27
+ * Removed: deprecated methods on the top-level `FactoryBot` module meant only for internal use
28
+ * Removed: support for EOL versions of Ruby (2.3, 2.4) and Rails (4.2)
29
+ * Removed: support for "abstract" factories with no associated class; use traits instead.
30
+
31
+ ## 5.2.0 (April 24, 2020)
32
+ * Added: Pass index to block for `*_list` methods
33
+ * Deprecated: methods on the top-level `FactoryBot` module meant only for internal use: `callbacks`, `configuration`, `constructor`, `initialize_with`, `register_sequence`, `resent_configuration`, `skip_create`, `to_create`
34
+
35
+ ## 5.1.2 (March 25, 2020)
36
+ * Fixed: Ruby 2.7 keyword deprecation warning in FactoryBot.lint
37
+
38
+ ## 5.1.1 (October 2, 2019)
39
+ * Improved: performance of traits
40
+ * Fixed: registering strategies on JRuby
41
+
42
+ ## 5.1.0 (September 21, 2019)
43
+ * Added: "Did you mean?" style error message to help with typos in association declarations
44
+ * Changed: `NoMethodError` for static attributes now offers a "Did you mean?" style message
45
+ * Fixed: avoid undefining inherited evaluator methods
46
+ * Fixed: avoid stubbing id for records without a primary key
47
+ * Fixed: raise a helpful error for self-referencing traits to avoid a `SystemStackError`
48
+ * Deprecated: methods on the top-level `FactoryBot` module meant only for internal use: `allow_class_lookup`, `allow_class_lookup`=, `register_trait`, `trait_by_name`, `traits`, `sequence_by_name`, `sequences`, `factory_by_name`, `register_factory`, `callback_names`, `register_callback`, `register_default_callbacks`, `register_default_strategies`, `strategies`
49
+
50
+ ## 5.0.2 (February 22, 2019)
51
+ * Bugfix: raise "Trait not registered" error when passing invalid trait arguments
52
+
53
+ ## 5.0.1 (February 15, 2019)
54
+ * Bugfix: Do not raise error when two sequences have the same name
55
+ in two traits that have the same name
56
+
57
+ ## 5.0.0 (February 1, 2019)
58
+ * Added: Verbose option to include full backtraces in the linting output
59
+ * Changed: use_parent_strategy now defaults to true, so by default the
60
+ build strategy will build, rather than create associations
61
+ * Changed: Passing a block when defining associations now raises an error
62
+ * Bugfix: use_parent_strategy is no longer reset by FactoryBot.reload
63
+ * Bugfix: rewind_sequences will now rewind local sequences along with the global ones
64
+ * Bugfix: the build_stubbed strategy now sets timestamps without changing the
65
+ the original behavior of the timestamp methods
66
+ * Bugfix: avoid a stack error when referring to an "attributes" attribute in initialize_with
67
+ * Removed: support for EOL versions of Ruby and Rails
68
+ * Removed: static attributes (use dynamic attributes with a block instead)
69
+ * Removed: looking up factories by class
70
+ * Removed: ignore method (use transient instead)
71
+ * Removed: duplicate_attribute_assignment_from_initialize_with configuration option
72
+ * Deprecated: allow_class_lookup configuration option
73
+
74
+ ## 4.11.1 (September 7, 2018)
75
+ * Documentation: Include .yardopts in the gem to fix broken RubyDoc links
76
+
77
+ ## 4.11.0 (August, 15, 2018)
78
+ * Bugfix: Do not raise error for valid build_stubbed methods: decrement, increment, and toggle
79
+ * Bugfix: Do not add timestamps with build_stubbed for objects that shouldn't have timestamps
80
+ * Deprecate static attributes
81
+
82
+ ## 4.10.0 (May 25, 2018)
83
+ * Allow sequences to be rewound
84
+
85
+ ## 4.9.0 (skipped - FactoryGirl only release)
86
+
87
+ ## 4.8.2 (October 20, 2017)
88
+ * Rename factory_girl to factory_bot
89
+
90
+ ## 4.8.1 (September 28, 2017)
91
+ * Explicitly define `#destroyed?` within the `Stub` strategy to return `nil` instead of raising
92
+ * Update various dependencies
93
+ * Update internal test suite to use RSpec's mocking/stubbing instead of mocha
94
+
95
+ ## 4.8.0 (December 16, 2016)
96
+ * Improve documentation
97
+ * Add `FactoryGirl.generate_list` to be consistent with `build_list`/`create_list` and friends
98
+ * Add `FactoryGirl.use_parent_strategy` configuration to allow associations to leverage parent build strategy
99
+
100
+ ## 4.7.0 (April 1, 2016)
101
+ * Improve documentation
102
+ * Improve instrumentation payload to include traits, overrides, and the factory itself
103
+ * Allow linting of traits
104
+ * Deprecate factory lookup by class name in preparation for 5.0
105
+ * Improve internal performance by using flat_map instead of map and compact
106
+ * Improve handling of dirty attributes after building a stubbed object
107
+ * Reduce warnings from redefining methods
108
+
109
+ ## 4.6.0 (skipped)
110
+
111
+ ## 4.5.0 (October 17, 2014)
112
+ * Improve FactoryGirl.lint by including exception and message in output
113
+ * Allow selective linting
114
+ * Use more explicit #public_send when doing attribute assignment
115
+ * Improve documentation around FactoryGirl.lint and initialize_with
116
+ * Deprecate #ignore in favor of #transient
117
+
118
+ ## 4.4.0 (February 10, 2014)
119
+ * Add FactoryGirl.lint
120
+ * Fix memory leak in duplicate traits
121
+ * Update documentation
122
+
123
+ ## 4.3.0 (November 3, 2013)
124
+ * Start testing against Rails 4.0 and Ruby 2.0.0
125
+ * Stop testing against Rails 3.0 and Ruby 1.9.2
126
+ * Add `*_pair` methods to only build two objects
127
+ * Raise if a method is defined with a FactoryGirl block (factory or trait)
128
+ * Allow use of Symbol#to_proc in callbacks
129
+ * Add global callbacks
130
+ * Improve GETTING_STARTED and README
131
+
132
+ ## 4.2.0 (January 18, 2013)
133
+ * Improve documentation
134
+ * Allow `*_list` syntax methods to accept a block
135
+ * Update gem dependencies
136
+ * Allow setting id for objects created with `build_stubbed`
137
+ * Fix Stub strategy to mimic ActiveRecord regarding `created_at`
138
+ * Evaluate sequences within the context of an Evaluator
139
+ * Fix Mocha deprecation warning
140
+ * Fix some warnings when running RUBYOPT=-w rake
141
+ * Convert test suite to RSpec's "expect" syntax
142
+
143
+ ## 4.1.0 (September 11, 2012)
144
+ * Allow multiple callbacks to bind to the same block
145
+ * Fix documentation surrounding the stub strategy
146
+
147
+ ## 4.0.0 (August 3, 2012)
148
+ * Remove deprecated cucumber_steps
149
+ * Remove deprecated alternate syntaxes
150
+ * Deprecate duplicate_attribute_assignment_from_initialize_with, which is now unused
151
+ as attributes assigned within initialize_with are not subsequently assigned
152
+
153
+ ## 3.6.1 (August 2, 2012)
154
+ Update README to include info about running with JRuby
155
+ * Update dependencies on RSpec and tiny versions of Rails in Appraisal
156
+ * Improve flexibility of using traits with associations and add documentation
157
+ * Stub update_column to raise to mirror ActiveRecord's change from update_attribute
158
+
159
+ ## 3.6.0 (July 27, 2012)
160
+ * Code/spec cleanup
161
+ * Allow factories with traits to be used in associations
162
+ * Refactor Factory to use DefinitionHierarchy to handle managing callbacks,
163
+ custom constructor, and custom to_create
164
+ * Add memoization to speed up factories providing attribute overrides
165
+ * Add initial support of JRuby when running in 1.9 mode
166
+ * Improve docs on what happens when including FactoryGirl::Syntax::Methods
167
+
168
+ ## 3.5.0 (June 22, 2012)
169
+ * Allow created_at to be set when using build_stubbed
170
+ * Deprecate FactoryGirl step definitions
171
+
172
+ ## 3.4.2 (June 19, 2012)
173
+ * Fix bug in traits with callbacks called implicitly in factories whose
174
+ callbacks trigger multiple times
175
+
176
+ ## 3.4.1 (June 18, 2012)
177
+ * Fix traits so they can be nested and referred to from other traits
178
+
179
+ ## 3.4.0 (June 11, 2012)
180
+ * Sequences support Enumerators
181
+ * Optionally disable duplicate assignment of attributes in initialize_with
182
+ * Make hash of public attributes available in initialize_with
183
+ * Support referring to a factory based on class name
184
+
185
+ ## 3.3.0 (May 13, 2012)
186
+ * Allow to_create, skip_create, and initialize_with to be defined globally
187
+ * Allow to_create, skip_create, and initialize_with to be defined within traits
188
+ * Fix deprecation messages for alternate syntaxes (make, generate, etc.)
189
+ * Improve library documentation
190
+ * Deprecate after_build, after_create, before_create, after_stub in favor of new callbacks
191
+ * Introduce new callback syntax: after(:build) {}, after(:custom) {}, or callback(:different) {}
192
+ This allows for declaring any callback, usable with custom strategies
193
+ * Add attributes_for_list and build_stubbed_list with the StrategySyntaxMethodRegistrar
194
+ * Allow use of syntax methods (build, create, generate, etc) implicitly in callbacks
195
+ * Internal refactoring of a handful of components
196
+
197
+ ## 3.2.0 (April 24, 2012)
198
+ * Use AS::Notifications for pub/sub to track running factories
199
+ * Call new within initialize_with implicitly on the build class
200
+ * Skip to_create with skip_create
201
+ * Allow registration of custom strategies
202
+ * Deprecate alternate syntaxes
203
+ * Implicitly call factory_bot's syntax methods from dynamic attributes
204
+
205
+ ## 3.1.0 (April 6, 2012)
206
+ * Sequences support aliases, which reference the same block
207
+ * Update documentation
208
+ * Add before_create callback
209
+ * Support use of #attribute_names method to determine available attributes for steps
210
+ * Use ActiveSupport::Deprecation for all deprecations
211
+
212
+ ## 3.0.0 (March 23, 2012)
213
+ * Deprecate the vintage syntax
214
+ * Remove Rails 2.x support
215
+ * Remove Ruby 1.8 support
216
+ * Remove deprecated features, including default_strategy, factory_name,
217
+ :method for defining default strategy, ignore on individual attributes, and
218
+ interacting with Factory the way you would FactoryGirl
219
+
220
+ ## 2.6.4 (March 16, 2012)
221
+ * Do not ignore names of transient attributes
222
+ * Ensure attributes set on instance are calculated uniquely
223
+
224
+ ## 2.6.3 (March 9, 2012)
225
+ * Fix issue with traits not being present the first time a factory is accessed
226
+ * Update available Cucumber step definitions to not require a trailing colon
227
+ when building a table of attributes to instantiate records with
228
+
229
+ ## 2.6.2 (March 9, 2012)
230
+ * Allow factories to use all their ancestors' traits
231
+ * Ignore bin dir generated by bundler
232
+ * Namespace ::Factory as top-level to fix vintage syntax issue with
233
+ Ruby 1.9.2-p3p18
234
+
235
+ ## 2.6.1 (March 2, 2012)
236
+ * Use FactoryGirl.reload in specs
237
+ * Clean up running named factories with a particular strategy with
238
+ FactoryGirl::FactoryRunner
239
+
240
+ ## 2.6.0 (February 17, 2012)
241
+ * Improve documentation of has_many associations in the GETTING_STARTED
242
+ document
243
+ * Deprecate :method in favor of :strategy when overriding an association's
244
+ build strategy
245
+
246
+ ## 2.5.2 (February 10, 2012)
247
+ * Fix step definitions to use associations defined in parent factories
248
+ * Add inline trait support to (build|create)_list
249
+ * Update ActiveSupport dependency to >= 2.3.9, which introduced
250
+ class_attribute
251
+
252
+ ## 2.5.1 (February 3, 2012)
253
+ * Fix attribute evaluation when the attribute isn't defined in the factory but
254
+ is a private method on Object
255
+ * Update rubygems on Travis before running tests
256
+ * Fix spec name
257
+ * Update GETTING_STARTED with correct usage of build_stubbed
258
+ * Update README with more info on initialize_with
259
+ * Honor :parent on factory over block nesting
260
+
261
+ ## 2.5.0 (January 20, 2012)
262
+ * Revert 'Deprecate build_stubbed and attributes_for'
263
+ * Implement initialize_with to allow overriding object instantiation
264
+ * Ensure FG runs against Rails 3.2.0
265
+
266
+ ## 2.4.2 (January 18, 2012)
267
+ * Fix inline traits' interaction with defaults on the factory
268
+
269
+ ## 2.4.1 (January 17, 2012)
270
+ * Deprecate build_stubbed and attributes_for
271
+ * Fix inline traits
272
+
273
+ ## 2.4.0 (January 13, 2012)
274
+ * Refactor internals of FactoryGirl to use anonymous class on which attributes
275
+ get defined
276
+ * Explicitly require Ruby 1.8.7 or higher in gemspec
277
+ * Fix documentation
278
+ * Add Gemnasium status to documentation
279
+ * Supplying a Class to a factory that overrides to_s no longer results in
280
+ getting the wrong Class constructed
281
+ * Be more agnostic about ORMs when using columns in FactoryGirl step
282
+ definitions
283
+ * Test against Active Record 3.2.0.rc2
284
+ * Update GETTING_STARTED to use Ruby syntax highlighting
285
+
286
+ ## 2.3.2 (November 26, 2011)
287
+ * Move logic of where instance.save! is set to Definition
288
+ * Fix method name from aliases_for? to alias_for?
289
+ * Refactor internal attribute handling to use an anonymous class instead of
290
+ faking Ruby's variable resolution. This allows for more sane usage of
291
+ attributes without having to manage sorting priority because attributes
292
+ can turn themselves into procs, which are used with define_method on a
293
+ class so attributes work correctly all the time.
294
+
295
+ ## 2.3.1 (November 23, 2011)
296
+ * Remove internally-used associate method from all the FactoryGirl::Proxy subclasses
297
+ * Move around requiring of files
298
+ * Consolidate errors into factory_bot.rb
299
+ * Refactor AttributeList to deal with priority only when iterating over
300
+ attributes
301
+ * Refactor internals of some of the Proxy subclasses
302
+ * Ensure callbacks on traits are executed in the correct order
303
+
304
+ ## 2.3.0 (November 18, 2011)
305
+ * Registries are named, resulting in better messages when factories, traits,
306
+ or sequences cannot be found
307
+ * Fix incorrect tests
308
+ * Internals refactoring introducing FactoryGirl::NullFactory,
309
+ FactoryGirl::Definition, and FactoryGirl::DeclarationList
310
+ * Use ActiveSupport for Hash#except and its delegation capabilities
311
+ * Fix usage of callbacks when added via implicit traits
312
+ * Use Bundler tasks and clean up dependencies
313
+ * Fix failing spec for big letters in factory name passed as symbol
314
+ * Add ability for traits to be added dynamically when creating an instance via
315
+ build, create, build_stubbed, or attributes_for
316
+
317
+ ## 2.2.0 (October 14, 2011)
318
+ * Clean up RSpec suite to not use 'should'
319
+ * Use create_list in step definitions
320
+ * Syntax methods that deal with ORM interaction (attributes_for, build, build_stubbed,
321
+ and create) now accept a block that yields the result. This results in a
322
+ more convenient way to interact with the result than using Object.tap.
323
+ * Standardize deprecation warnings
324
+ * Update transient attribute syntax to use blocks instead of calling ignore on
325
+ each attribute declaration
326
+ * Parents can be defined after children because factories are evaluated when
327
+ they're used; this means breaking up factories across multiple files will
328
+ behave as expected
329
+ * Large internal refactoring, including changing access modifiers for a
330
+ handful of methods for a more clearly defined API
331
+
332
+ ## 2.1.2 (September 23, 2011)
333
+ * Bugfix: Vintage syntax fixed after bug introduced in 2.1.1
334
+ * Introduce dependency on activesupport to remove code from Factory class
335
+
336
+ ## 2.1.1 (September 23, 2011) (yanked)
337
+ * Bugfix: Parent object callbacks are run before child object callbacks
338
+ * Declarations: allow overriding/modification of individual traits in child factories
339
+ * Callbacks refactored to not be attributes
340
+ * Updating documentation for formatting and clarity (incl. new specificity for cucumber)
341
+
342
+ ## 2.1.0 (September 02, 2011)
343
+ * Bugfix: created_at now defined for stubbed models
344
+ * Gemspec updated for use with Rails 3.1
345
+ * Factories can now be modified post-definition (useful for overriding defaults from gems/plugins)
346
+ * All factories can now be reloaded with Factory.reload
347
+ * Add :method => build to factory associations to prevent saving of associated objects
348
+ * Factories defined in {Rails.root}/factories are now loaded by default
349
+ * Various documentation updates
350
+
351
+ ## 1.1.4 (November 28, 2008)
352
+ * Factory.build now uses Factory.create for associations of the built object
353
+ * Factory definitions are now detected in subdirectories, such as
354
+ factories/person_factory.rb (thanks to Josh Nichols)
355
+ * Factory definitions are now loaded after the environment in a Rails project
356
+ (fixes some issues with dependencies being loaded too early) (thanks to
357
+ Josh Nichols)
358
+ * Factory names ending in 's' no longer cause problems (thanks to Alex Sharp
359
+ and Josh Owens)
360
+
361
+ ## 1.1.3 (September 12, 2008)
362
+ * Automatically pull in definitions from factories.rb, test/factories.rb, or
363
+ spec/factories.rb
364
+ ## 1.1.2 (July 30, 2008)
365
+ * Improved error handling for invalid and undefined factories/attributes
366
+ * Improved handling of strings vs symbols vs classes
367
+ * Added a prettier syntax for handling associations
368
+ * Updated documentation and fixed compatibility with Rails 2.1
369
+
370
+ ## 1.1.1 (June 23, 2008)
371
+ * The attribute "name" no longer requires using #add_attribute
372
+
373
+ ## 1.1.0 (June 03, 2008)
374
+ * Added support for dependent attributes
375
+ * Fixed the attributes_for build strategy to not build associations
376
+ * Added support for sequences
377
+
378
+ ## 1.0.0 (May 31, 2008)
379
+ * First version
data/README.md CHANGED
@@ -1,11 +1,11 @@
1
- # factory_bot [![Build Status][ci-image]][ci] [![Code Climate][grade-image]][grade] [![Gem Version][version-image]][version] [![Reviewed by Hound][hound-badge-image]][hound]
1
+ # factory_bot [![Build Status][ci-image]][ci] [![Code Climate][grade-image]][grade] [![Gem Version][version-image]][version]
2
2
 
3
3
  factory_bot is a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance.
4
4
 
5
5
  If you want to use factory_bot with Rails, see
6
6
  [factory_bot_rails](https://github.com/thoughtbot/factory_bot_rails).
7
7
 
8
- _[Interested in the history of the project name?](NAME.md)_
8
+ _[Interested in the history of the project name?][NAME]_
9
9
 
10
10
 
11
11
  ### Transitioning from factory\_girl?
@@ -21,7 +21,7 @@ You should find the documentation for your version of factory_bot on [Rubygems](
21
21
  See [GETTING_STARTED] for information on defining and using factories. We also
22
22
  have [a detailed introductory video][], available for free on Upcase.
23
23
 
24
- [a detailed introductory video]: https://upcase.com/videos/factory-girl?utm_source=github&utm_medium=open-source&utm_campaign=factory-girl
24
+ [a detailed introductory video]: https://upcase.com/videos/factory-bot?utm_source=github&utm_medium=open-source&utm_campaign=factory-girl
25
25
 
26
26
  Install
27
27
  --------
@@ -40,27 +40,10 @@ To install the gem manually from your shell, run:
40
40
  gem install factory_bot
41
41
  ```
42
42
 
43
- **Caveat:** As of ActiveSupport 5.0 and above, Ruby 2.2.2+ is required. Because
44
- of Rubygems' dependency resolution when installing gems, you may see an error
45
- similar to:
46
-
47
- ```
48
- $ gem install factory_bot
49
- ERROR: Error installing factory_bot:
50
- activesupport requires Ruby version >= 2.2.2.
51
- ```
52
-
53
- To bypass this, install a pre-5.0 version of ActiveSupport before installing
54
- manually.
55
-
56
43
  Supported Ruby versions
57
44
  -----------------------
58
45
 
59
- The factory_bot 3.x+ series supports MRI Ruby 1.9. Additionally, factory_bot
60
- 3.6+ supports JRuby 1.6.7.2+ while running in 1.9 mode. See [GETTING_STARTED]
61
- for more information on configuring the JRuby environment.
62
-
63
- For versions of Ruby prior to 1.9, please use factory_bot 2.x.
46
+ Supported Ruby versions are listed in [`.github/workflows/build.yml`](https://github.com/thoughtbot/factory_bot/blob/master/.github/workflows/build.yml)
64
47
 
65
48
  More Information
66
49
  ----------------
@@ -70,30 +53,37 @@ More Information
70
53
  * [Issues](https://github.com/thoughtbot/factory_bot/issues)
71
54
  * [GIANT ROBOTS SMASHING INTO OTHER GIANT ROBOTS](https://robots.thoughtbot.com/)
72
55
 
73
- You may also find useful information under the [factory_girl tag on Stack Overflow](https://stackoverflow.com/questions/tagged/factory-girl).
56
+ [GETTING_STARTED]: https://github.com/thoughtbot/factory_bot/blob/master/GETTING_STARTED.md
57
+ [NAME]: https://github.com/thoughtbot/factory_bot/blob/master/NAME.md
58
+
59
+ Useful Tools
60
+ ------------
74
61
 
75
- [GETTING_STARTED]: https://www.rubydoc.info/gems/factory_bot/file/GETTING_STARTED.md
62
+ * [FactoryTrace](https://github.com/djezzzl/factory_trace) - helps to find unused factories and traits.
76
63
 
77
64
  Contributing
78
65
  ------------
79
66
 
80
67
  Please see [CONTRIBUTING.md](https://github.com/thoughtbot/factory_bot/blob/master/CONTRIBUTING.md).
81
68
 
82
- factory_bot was originally written by Joe Ferris and is now maintained by Josh
83
- Clayton. Many improvements and bugfixes were contributed by the [open source
69
+ factory_bot was originally written by Joe Ferris and is maintained by thoughtbot.
70
+ Many improvements and bugfixes were contributed by the [open source
84
71
  community](https://github.com/thoughtbot/factory_bot/graphs/contributors).
85
72
 
86
73
  License
87
74
  -------
88
75
 
89
- factory_bot is Copyright © 2008-2016 Joe Ferris and thoughtbot. It is free
76
+ factory_bot is Copyright © 2008-2020 Joe Ferris and thoughtbot. It is free
90
77
  software, and may be redistributed under the terms specified in the
91
- [LICENSE](/LICENSE) file.
78
+ [LICENSE] file.
79
+
80
+ [LICENSE]: https://github.com/thoughtbot/factory_bot/blob/master/LICENSE
81
+
92
82
 
93
83
  About thoughtbot
94
84
  ----------------
95
85
 
96
- ![thoughtbot](https://presskit.thoughtbot.com/images/thoughtbot-logo-for-readmes.svg)
86
+ ![thoughtbot](https://thoughtbot.com/brand_assets/93:44.svg)
97
87
 
98
88
  factory_bot is maintained and funded by thoughtbot, inc.
99
89
  The names and logos for thoughtbot are trademarks of thoughtbot, inc.
@@ -104,8 +94,8 @@ See [our other projects][community] or
104
94
 
105
95
  [community]: https://thoughtbot.com/community?utm_source=github
106
96
  [hire]: https://thoughtbot.com/hire-us?utm_source=github
107
- [ci-image]: https://travis-ci.org/thoughtbot/factory_bot.svg
108
- [ci]: https://travis-ci.org/thoughtbot/factory_bot?branch=master
97
+ [ci-image]: https://github.com/thoughtbot/factory_bot/actions/workflows/build.yml/badge.svg
98
+ [ci]: https://github.com/thoughtbot/factory_bot/actions?query=workflow%3A.github%2Fworkflows%2Fbuild.yml+branch%3Amaster++
109
99
  [grade-image]: https://codeclimate.com/github/thoughtbot/factory_bot/badges/gpa.svg
110
100
  [grade]: https://codeclimate.com/github/thoughtbot/factory_bot
111
101
  [version-image]: https://badge.fury.io/rb/factory_bot.svg
@@ -9,10 +9,10 @@ module FactoryBot
9
9
  ]
10
10
 
11
11
  def self.aliases_for(attribute)
12
- aliases.map do |(pattern, replace)|
12
+ aliases.map { |(pattern, replace)|
13
13
  if pattern.match(attribute.to_s)
14
14
  attribute.to_s.sub(pattern, replace).to_sym
15
15
  end
16
- end.compact << attribute
16
+ }.compact << attribute
17
17
  end
18
18
  end
@@ -6,12 +6,12 @@ module FactoryBot
6
6
 
7
7
  def initialize(name, factory, overrides)
8
8
  super(name, false)
9
- @factory = factory
9
+ @factory = factory
10
10
  @overrides = overrides
11
11
  end
12
12
 
13
13
  def to_proc
14
- factory = @factory
14
+ factory = @factory
15
15
  overrides = @overrides
16
16
  traits_and_overrides = [factory, overrides].flatten
17
17
  factory_name = traits_and_overrides.shift
@@ -12,10 +12,11 @@ module FactoryBot
12
12
 
13
13
  -> {
14
14
  value = case block.arity
15
- when 1, -1 then instance_exec(self, &block)
15
+ when 1, -1, -2 then instance_exec(self, &block)
16
16
  else instance_exec(&block)
17
- end
17
+ end
18
18
  raise SequenceAbuseError if FactoryBot::Sequence === value
19
+
19
20
  value
20
21
  }
21
22
  end
@@ -1,7 +1,6 @@
1
- require 'factory_bot/attribute/static'
2
- require 'factory_bot/attribute/dynamic'
3
- require 'factory_bot/attribute/association'
4
- require 'factory_bot/attribute/sequence'
1
+ require "factory_bot/attribute/dynamic"
2
+ require "factory_bot/attribute/association"
3
+ require "factory_bot/attribute/sequence"
5
4
 
6
5
  module FactoryBot
7
6
  # @api private
@@ -11,11 +10,10 @@ module FactoryBot
11
10
  def initialize(name, ignored)
12
11
  @name = name.to_sym
13
12
  @ignored = ignored
14
- ensure_non_attribute_writer!
15
13
  end
16
14
 
17
15
  def to_proc
18
- -> { }
16
+ -> {}
19
17
  end
20
18
 
21
19
  def association?
@@ -25,38 +23,5 @@ module FactoryBot
25
23
  def alias_for?(attr)
26
24
  FactoryBot.aliases_for(attr).include?(name)
27
25
  end
28
-
29
- private
30
-
31
- def ensure_non_attribute_writer!
32
- NonAttributeWriterValidator.new(@name).validate!
33
- end
34
-
35
- class NonAttributeWriterValidator
36
- def initialize(method_name)
37
- @method_name = method_name.to_s
38
- @method_name_setter_match = @method_name.match(/(.*)=$/)
39
- end
40
-
41
- def validate!
42
- if method_is_writer?
43
- raise AttributeDefinitionError, error_message
44
- end
45
- end
46
-
47
- private
48
-
49
- def method_is_writer?
50
- !!@method_name_setter_match
51
- end
52
-
53
- def attribute_name
54
- @method_name_setter_match[1]
55
- end
56
-
57
- def error_message
58
- "factory_bot uses '#{attribute_name} value' syntax rather than '#{attribute_name} = value'"
59
- end
60
- end
61
26
  end
62
27
  end
@@ -3,9 +3,9 @@ module FactoryBot
3
3
  class AttributeAssigner
4
4
  def initialize(evaluator, build_class, &instance_builder)
5
5
  @build_class = build_class
6
- @instance_builder = instance_builder
7
- @evaluator = evaluator
8
- @attribute_list = evaluator.class.attribute_list
6
+ @instance_builder = instance_builder
7
+ @evaluator = evaluator
8
+ @attribute_list = evaluator.class.attribute_list
9
9
  @attribute_names_assigned = []
10
10
  end
11
11
 
@@ -22,16 +22,18 @@ module FactoryBot
22
22
  def hash
23
23
  @evaluator.instance = build_hash
24
24
 
25
- attributes_to_set_on_hash.inject({}) do |result, attribute|
25
+ attributes_to_set_on_hash.each_with_object({}) do |attribute, result|
26
26
  result[attribute] = get(attribute)
27
- result
28
27
  end
29
28
  end
30
29
 
31
30
  private
32
31
 
33
32
  def method_tracking_evaluator
34
- @method_tracking_evaluator ||= Decorator::AttributeHash.new(decorated_evaluator, attribute_names_to_assign)
33
+ @method_tracking_evaluator ||= Decorator::AttributeHash.new(
34
+ decorated_evaluator,
35
+ attribute_names_to_assign
36
+ )
35
37
  end
36
38
 
37
39
  def decorated_evaluator
@@ -65,7 +67,11 @@ module FactoryBot
65
67
  end
66
68
 
67
69
  def attribute_names_to_assign
68
- @attribute_names_to_assign ||= non_ignored_attribute_names + override_names - ignored_attribute_names - alias_names_to_ignore
70
+ @attribute_names_to_assign ||=
71
+ non_ignored_attribute_names +
72
+ override_names -
73
+ ignored_attribute_names -
74
+ alias_names_to_ignore
69
75
  end
70
76
 
71
77
  def non_ignored_attribute_names
@@ -89,9 +95,17 @@ module FactoryBot
89
95
  end
90
96
 
91
97
  def alias_names_to_ignore
92
- @attribute_list.non_ignored.flat_map do |attribute|
93
- override_names.map { |override| attribute.name if attribute.alias_for?(override) && attribute.name != override && !ignored_attribute_names.include?(override) }
94
- end.compact
98
+ @attribute_list.non_ignored.flat_map { |attribute|
99
+ override_names.map do |override|
100
+ attribute.name if ignorable_alias?(attribute, override)
101
+ end
102
+ }.compact
103
+ end
104
+
105
+ def ignorable_alias?(attribute, override)
106
+ attribute.alias_for?(override) &&
107
+ attribute.name != override &&
108
+ !ignored_attribute_names.include?(override)
95
109
  end
96
110
  end
97
111
  end