factory_bot-blueprint-rspec 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 383c2e021a8f95d413975221ad71a812573085d87c344d9092489cd4701c7bcc
-  data.tar.gz: 855d528ff18cfa4e02645fd6eb7a24b65e170918ba759454ccd06bc5c7e14574
+  metadata.gz: 6d69a5a7bc30ab7ef24bf30d52470782905063ca277b6a43200dea4889913360
+  data.tar.gz: c5260558476aeda1899f059587f5ef1f8367433f550535b09db3f440344ea6a0
 SHA512:
-  metadata.gz: 791b93263904413b1bbdc11df06f18c5181fe44882a10c1d9b6c114b1eec33ee3222edf6a52fff90af03aead6e9e04dfedcf22e8410687bd8d11edea92203a26
-  data.tar.gz: 057af3f3d8bba6f971a4f6e18c40ab69a13829973b38b3bf1c73ddb6477104d704d5d24d524cbf6b567c8f2ebf2c4e1a7587161c3e601256efd9bfb843040f85
+  metadata.gz: 2c465be8c2c042766086b3c11a9ceee1924a2b0883c89bb2d4d8372792cfc213fa9241e35694a5f826f5025a485858aa75a63fe52362665f59595d90d183b867
+  data.tar.gz: e3355786455ec3222b5fdf97edac2e1ca2c6cfb094afc6148c223ca4454ef9939e6e5ef2138fb4b90e8826573d6953c43536c108b4bfb7d708bcab8b37e30fab

data/lib/factory_bot/blueprint/rspec/driver.rb

@@ -27,6 +27,7 @@ module FactoryBot
         #   end
         def let_blueprint(name, inherit: false, &)
           let(name) { ::FactoryBot::Blueprint.plan(inherit ? super() : nil, ext: self, &) }
+          name
         end
 
         # Build objects by <code>build</code> strategy in FactoryBot from a blueprint and declare them using RSpec's
@@ -41,7 +42,7 @@ module FactoryBot
         #     end
         #
         #     # Simplest example:
-        #     # This is equivalent to `let_blueprint_build blog_bp: { representative: :blog }`
+        #     # This is equivalent to `let_blueprint_build blog_bp: { result: :blog }`
         #     let_blueprint_build blog_bp: :blog
         #
         #     # Another shorthand example:
@@ -49,15 +50,15 @@ module FactoryBot
         #     let_blueprint_build blog_bp: %i[blog article]
         #
         #     # Most flexible example:
-        #     #   :representative specifies the name of the representative object to be declared. Defaults to nil
+        #     #   :result specifies the name of the result object to be declared. Defaults to nil
         #     #   :items specifies the names of the objects to be declared. Defaults to []
         #     #   :instance specifies the name of the instance object to be declared. Defaults to :"#{source}_instance"
-        #     let_blueprint_build blog_bp: { representative: :blog, items: %i[article], instance: :blog_instance }
+        #     let_blueprint_build blog_bp: { result: :blog, items: %i[article], instance: :blog_instance }
         #
         #     # Above example will be expanded to:
         #     let(:blog_instance) { ::FactoryBot::Blueprint.build(blog_bp) }  # the instance object
-        #     let(:blog) { blog_instance[blog_bp.representative_node.name] }  # the representative object
-        #     let(:article) { blog_instance[:article] }                       # the item objects
+        #     let(:blog) { blog_instance[0] }                                 # the result object
+        #     let(:article) { blog_instance[1][:article] }                    # the item objects
         #   end
         def let_blueprint_build(**map) = let_blueprint_instantiate(:build, **map)
 
@@ -73,13 +74,13 @@ module FactoryBot
         def let_blueprint_instantiate(strategy, **map)
           raise ArgumentError, "Unsupported strategy: #{strategy}" if strategy && !%i[create build].include?(strategy)
 
-          map.each do |source, definition|
+          map.map do |source, definition|
             raise TypeError, "source must be a Symbol" unless source.is_a?(Symbol)
 
             definition =
               case definition
               when Symbol
-                { representative: definition }
+                { result: definition }
               when Array
                 { items: definition }
               when Hash
@@ -88,13 +89,11 @@ module FactoryBot
                 raise TypeError, "definition must be one of Symbol, Array, Hash"
               end
 
-            representative_name = definition[:representative]
+            result_name = definition[:result]
             item_names = definition[:items] || []
             instance = definition[:instance] || :"#{source}_instance"
 
-            if representative_name && !representative_name.is_a?(Symbol)
-              raise TypeError, "representative must be a Symbol"
-            end
+            raise TypeError, "result must be a Symbol" if result_name && !result_name.is_a?(Symbol)
             if !item_names.is_a?(Array) || !item_names.all? { _1.is_a?(Symbol) }
               raise TypeError, "items must be an Array of Symbols"
             end
@@ -104,13 +103,11 @@ module FactoryBot
               let(instance) { ::FactoryBot::Blueprint.instantiate(strategy, __send__(source)) }
             end
 
-            if representative_name
-              let(representative_name) { __send__(instance)[__send__(source).representative_node.name] }
-            end
+            let(result_name) { __send__(instance)[0] } if result_name
 
-            item_names.each do |name|
-              let(name) { __send__(instance)[name] }
-            end
+            item_names.each { |name| let(name) { __send__(instance)[1][name] } }
+
+            instance
           end
         end
 
@@ -119,7 +116,7 @@ module FactoryBot
         #
         # This is a shorthand for {#let_blueprint} with {#let_blueprint_build} or {#let_blueprint_create}.
         # @param name [Symbol]
-        #   name of the representative object to be declared using RSpec's <code>let</code>.
+        #   name of the result object to be declared using RSpec's <code>let</code>.
         #   It is also used as a name prefix of the blueprint
         # @param items [Array<Symbol>] names of the objects to be declared using RSpec's <code>let</code>
         # @param inherit [Boolean] whether to extend the blueprint by <code>super()</code>
@@ -145,7 +142,7 @@ module FactoryBot
         #         article(title: "Article 3")
         #       end
         #     end
-        #     let_blueprint_create blog_blueprint: { representative: :blog, items: %i[article] }
+        #     let_blueprint_create blog_blueprint: { result: :blog, items: %i[article] }
         #   end
         def letbp(name, items = [], inherit: false, strategy: :create, &)
           raise TypeError, "name must be a Symbol" unless name.is_a?(Symbol)
@@ -154,7 +151,31 @@ module FactoryBot
           strategy = nil if inherit
 
           let_blueprint(source, inherit:, &)
-          let_blueprint_instantiate strategy, source => { representative: name, items: }
+          let_blueprint_instantiate strategy, source => { result: name, items: }
+        end
+
+        # <code>let!</code> version of {#let_blueprint}.
+        def let_blueprint!(...)
+          name = let_blueprint(...)
+          before { __send__(name) }
+        end
+
+        # <code>let!</code> version of {#let_blueprint_build}.
+        def let_blueprint_build!(...)
+          names = let_blueprint_build(...)
+          before { names.each { __send__(_1) } }
+        end
+
+        # <code>let!</code> version of {#let_blueprint_create}.
+        def let_blueprint_create!(...)
+          names = let_blueprint_create(...)
+          before { names.each { __send__(_1) } }
+        end
+
+        # <code>let!</code> version of {#letbp}.
+        def letbp!(...)
+          names = letbp(...)
+          before { names.each { __send__(_1) } }
         end
       end
     end

data/lib/factory_bot/blueprint/rspec/version.rb

@@ -3,7 +3,7 @@
 module FactoryBot
   module Blueprint
     module RSpec
-      VERSION = "0.1.0"
+      VERSION = "0.3.0"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factory_bot-blueprint-rspec
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - yubrot
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-22 00:00:00.000000000 Z
+date: 2024-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_bot-blueprint
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: rspec-core
   requirement: !ruby/object:Gem::Requirement