factory_bot-blueprint 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f0c7f0e3747308e1e3eecd28cbd960aa98b65ae2c08b55b7e6346d1b953b064
-  data.tar.gz: dcc1a57961d57b1ce4f29f8b2f83f659ccfa9ae19781903516b698d75dedbcdb
+  metadata.gz: e01f7a2b8a4f8b2940edd4c7793e941274356fe21fc294acb3afd27c1eacab73
+  data.tar.gz: b57c70a58ea87edbc8d9a66d6a87b16c63051d5d12eec86ce02c26b6ec1339bc
 SHA512:
-  metadata.gz: e5fb41444b1b0ca831a651deb8a70c7bfd02409b5536a6f5c7367b34abade51463bb03bcc562fc190399f54a493a55564d589d10b3c31ff7207160f5f5da8257
-  data.tar.gz: 784d7af975f12da0a6f576c5dccb3e3ccd121e4dd0826280ec6b9a9cbc2f19df8610c450b34263d0b1252367918584750544ac542ca41e761f4c6ce8ca868d8c
+  metadata.gz: 3e07e0eb13aa6098f34e280b88eeaa4db272432965084da60bd135c481523fadae22edf1bd1678224376ed9ff89b646c3c859f31083e7f05b9b4443a0690e00d
+  data.tar.gz: df80db74e368bea0faa790160ac1d7597163ad45e460bbaa1979d00af5a408fede439efa01dd755387799286031a577459210a8a51662ee59e2f1a9d45d0d02f

data/lib/factory_bot/blueprint/dsl.rb

@@ -2,7 +2,7 @@
 
 module FactoryBot
   module Blueprint
-    # A declarative DSL for building {Factrey::Blueprint}.
+    # A declarative DSL for building {https://rubydoc.info/gems/factrey/Factrey/Blueprint Factrey::Blueprint}.
     # This DSL automatically recognizes factories defined in FactoryBot as types.
     class DSL < Factrey::DSL
       # Internals:
@@ -64,9 +64,9 @@ module FactoryBot
           Factrey::Blueprint::Type.new(type_name, compatible_types:, auto_references:, &FACTORY)
         end
 
-        FACTORY = lambda { |type, context, *args, **kwargs|
-          FactoryBot.__send__(context[:strategy], type.name, *args, **kwargs)
-        }
+        FACTORY = lambda do |type, context, *args, **kwargs|
+          FactoryBot.__send__(context[:build_strategy], type.name, *args, **kwargs)
+        end
 
         private_constant :FACTORY
       end

data/lib/factory_bot/blueprint/methods.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module FactoryBot
+  module Blueprint
+    # This module provides a shortcut to FactoryBot::Blueprint.
+    # @example
+    #   # Configure the same way as FactoryBot::Syntax::Methods
+    #   RSpec.configure do |config|
+    #     config.include FactoryBot::Syntax::Methods
+    #     config.include FactoryBot::Blueprint::Methods
+    #   end
+    #
+    #   # You can use `bp` in your spec files
+    #   RSpec.describe "something" do
+    #     before do
+    #       bp.create do
+    #         blog do
+    #           article(title: "Article 1")
+    #           article(title: "Article 2")
+    #           article(title: "Article 3") do
+    #             comment(name: "John")
+    #             comment(name: "Doe")
+    #           end
+    #         end
+    #       end
+    #     end
+    #   end
+    module Methods
+      # @return [Class<FactoryBot::Blueprint>]
+      def bp = FactoryBot::Blueprint
+    end
+  end
+end

data/lib/factory_bot/blueprint/version.rb

@@ -2,6 +2,6 @@
 
 module FactoryBot
   module Blueprint
-    VERSION = "0.4.0"
+    VERSION = "0.5.0"
   end
 end

data/lib/factory_bot/blueprint.rb

@@ -4,21 +4,25 @@ require "factrey"
 require "factory_bot"
 require_relative "blueprint/version"
 require_relative "blueprint/dsl"
+require_relative "blueprint/methods"
 
 module FactoryBot
   # A FactoryBot extension for building structured objects using a declarative DSL.
-  # First we can build (or extend) a creation plan for a set of objects as <code>Blueprint</code>,
+  # First we can build (or extend) a creation plan for a set of objects as
+  # {https://rubydoc.info/gems/factrey/Factrey/Blueprint Factrey::Blueprint},
   # and then we can create actual objects from it.
   #
-  # <code>Blueprint</code>s can be built using a declarative DSL provided by a core library called {Factrey}.
+  # <code>Blueprint</code>s can be built using a declarative DSL provided by a core library called <code>Factrey</code>.
   # Each node declaration in the DSL code is automatically correspond to the FactoryBot's factory. For example,
   # a declaration <code>user(name: 'John')</code> corresponds to <code>FactoryBot.create(:user, name: 'John')</code>.
   module Blueprint
     class << self
-      # Entry point to build or extend a {Factrey::Blueprint}.
+      # Entry point to build or extend a {https://rubydoc.info/gems/factrey/Factrey/Blueprint Factrey::Blueprint}.
       # @param blueprint [Factrey::Blueprint, nil] to extend an existing blueprint
-      # @param ext [Object] an external object that can be accessed using {DSL#ext} in the DSL
-      # @yield Write Blueprint DSL code here. See {Factrey::DSL} methods for DSL details
+      # @param ext [Object] an external object that can be accessed using <code>DSL#ext</code> in the DSL
+      # @yield
+      #   Write Blueprint DSL code here. See {https://rubydoc.info/gems/factrey/Factrey/DSL Factrey::DSL} documents for
+      #   more details
       # @return [Factrey::Blueprint] the built or extended blueprint
       # @example
       #   # In this example, we have three factories in FactoryBot:
@@ -40,7 +44,7 @@ module FactoryBot
       #       end
       #     end
       #
-      #   # Create a set of objects in FactoryBot (with `build` strategy) from the blueprint:
+      #   # Create a set of objects in FactoryBot (with `build` build strategy) from the blueprint:
       #   objects = FactoryBot::Blueprint.build(bp)
       #
       #   # This behaves as:
@@ -54,27 +58,37 @@ module FactoryBot
       #   objects[Factrey::Blueprint::Node::RESULT_NAME] = blog
       def plan(blueprint = nil, ext: nil, &) = Factrey.blueprint(blueprint, ext:, dsl: DSL, &)
 
-      # Create a set of objects by <code>build</code> strategy in FactoryBot.
+      # Create a set of objects by <code>build</code> build strategy in FactoryBot.
       # See {.plan} for more details.
       # @param blueprint [Factrey::Blueprint, nil]
-      # @param ext [Object] an external object that can be accessed using {DSL#ext} in the DSL
+      # @param ext [Object] an external object that can be accessed using <code>DSL#ext</code> in the DSL
       # @yield Write Blueprint DSL code here
       # @return [Hash{Symbol => Object}] the created objects
       def build(blueprint = nil, ext: nil, &) = instantiate(:build, blueprint, ext:, &)
 
-      # Create a set of objects by <code>create</code> strategy in FactoryBot.
+      # Create a set of objects by <code>build_stubbed</code> build strategy in FactoryBot.
       # See {.plan} for more details.
       # @param blueprint [Factrey::Blueprint, nil]
-      # @param ext [Object] an external object that can be accessed using {DSL#ext} in the DSL
+      # @param ext [Object] an external object that can be accessed using <code>DSL#ext</code> in the DSL
+      # @yield Write Blueprint DSL code here
+      # @return [Hash{Symbol => Object}] the created objects
+      def build_stubbed(blueprint = nil, ext: nil, &) = instantiate(:build_stubbed, blueprint, ext:, &)
+
+      # Create a set of objects by <code>create</code> build strategy in FactoryBot.
+      # See {.plan} for more details.
+      # @param blueprint [Factrey::Blueprint, nil]
+      # @param ext [Object] an external object that can be accessed using <code>DSL#ext</code> in the DSL
       # @yield Write Blueprint DSL code here
       # @return [Hash{Symbol => Object}] the created objects
       def create(blueprint = nil, ext: nil, &) = instantiate(:create, blueprint, ext:, &)
 
       # @!visibility private
-      def instantiate(strategy, blueprint = nil, ext: nil, &)
-        raise ArgumentError, "Unsupported strategy: #{strategy}" unless %i[create build].include?(strategy)
+      def instantiate(build_strategy, blueprint = nil, ext: nil, &)
+        unless %i[create build build_stubbed].include?(build_strategy)
+          raise ArgumentError, "Unsupported build strategy: #{build_strategy}"
+        end
 
-        plan(blueprint, ext:, &).instantiate(strategy:)
+        plan(blueprint, ext:, &).instantiate(build_strategy:)
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factory_bot-blueprint
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - yubrot
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-13 00:00:00.000000000 Z
+date: 2024-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_bot
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
 description: |
   FactoryBot::Blueprint is a FactoryBot extension for building structured objects using a declarative DSL.
   On the DSL, the factories defined in FactoryBot can be used without any additional configuration.
@@ -51,6 +51,7 @@ files:
 - README.md
 - lib/factory_bot/blueprint.rb
 - lib/factory_bot/blueprint/dsl.rb
+- lib/factory_bot/blueprint/methods.rb
 - lib/factory_bot/blueprint/version.rb
 homepage: https://github.com/yubrot/factory_bot-blueprint
 licenses:
@@ -68,14 +69,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: FactoryBot extension for building structured objects using a declarative