factory_bot 6.5.1 → 6.5.5

data/lib/factory_bot/uri_manager.rb

@@ -0,0 +1,63 @@
+module FactoryBot
+  # @api private
+  class UriManager
+    attr_reader :endpoints, :paths, :uri_list
+
+    delegate :size, :any?, :empty?, :each?, :include?, :first, to: :@uri_list
+    delegate :build_uri, to: :class
+
+    # Concatenate the parts, sripping leading/following slashes
+    # and returning a Symbolized String or nil.
+    #
+    # Example:
+    #   build_uri(:my_factory, :my_trait, :my_sequence)
+    #   #=> :"myfactory/my_trait/my_sequence"
+    #
+    def self.build_uri(*parts)
+      return nil if parts.empty?
+
+      parts.join("/")
+        .sub(/\A\/+/, "")
+        .sub(/\/+\z/, "")
+        .tr(" ", "_")
+        .to_sym
+    end
+
+    # Configures the new UriManager
+    #
+    # Arguments:
+    #   endpoints: (Array of Strings or Symbols)
+    #     the objects endpoints.
+    #
+    #   paths: (Array of Strings or Symbols)
+    #     the parent URIs to prepend to each endpoint
+    #
+    def initialize(*endpoints, paths: [])
+      if endpoints.empty?
+        fail ArgumentError, "wrong number of arguments (given 0, expected 1+)"
+      end
+
+      @uri_list = []
+      @endpoints = endpoints.flatten
+      @paths = Array(paths).flatten
+
+      build_uri_list
+    end
+
+    def to_a
+      @uri_list.dup
+    end
+
+    private
+
+    def build_uri_list
+      @endpoints.each do |endpoint|
+        if @paths.any?
+          @paths.each { |path| @uri_list << build_uri(path, endpoint) }
+        else
+          @uri_list << build_uri(endpoint)
+        end
+      end
+    end
+  end
+end

data/lib/factory_bot/version.rb

@@ -1,3 +1,3 @@
 module FactoryBot
-  VERSION = "6.5.1".freeze
+  VERSION = "6.5.5".freeze
 end

data/lib/factory_bot.rb

@@ -46,6 +46,7 @@ require "factory_bot/decorator/attribute_hash"
 require "factory_bot/decorator/disallows_duplicates_registry"
 require "factory_bot/decorator/invocation_tracker"
 require "factory_bot/decorator/new_constructor"
+require "factory_bot/uri_manager"
 require "factory_bot/linter"
 require "factory_bot/version"
 
@@ -58,6 +59,9 @@ module FactoryBot
   mattr_accessor :automatically_define_enum_traits, instance_accessor: false
   self.automatically_define_enum_traits = true
 
+  mattr_accessor :sequence_setting_timeout, instance_accessor: false
+  self.sequence_setting_timeout = 3
+
   # Look for errors in factories and (optionally) their traits.
   # Parameters:
   # factories - which factories to lint; omit for all factories
@@ -73,17 +77,43 @@ module FactoryBot
 
   # Set the starting value for ids when using the build_stubbed strategy
   #
-  # Arguments:
-  # * starting_id +Integer+
-  #   The new starting id value.
+  # @param [Integer] starting_id The new starting id value.
   def self.build_stubbed_starting_id=(starting_id)
     Strategy::Stub.next_id = starting_id - 1
   end
 
   class << self
+    # @!method rewind_sequence(*uri_parts)
+    #   Rewind an individual global or inline sequence.
+    #
+    #   @param [Array<Symbol>, String] uri_parts The components of the sequence URI.
+    #
+    #   @example Rewinding a sequence by its URI parts
+    #     rewind_sequence(:factory_name, :trait_name, :sequence_name)
+    #
+    #   @example Rewinding a sequence by its URI string
+    #     rewind_sequence("factory_name/trait_name/sequence_name")
+    #
+    # @!method set_sequence(*uri_parts, value)
+    #   Set the sequence to a specific value, providing the new value is within
+    #   the sequence set.
+    #
+    #   @param [Array<Symbol>, String] uri_parts The components of the sequence URI.
+    #   @param [Object] value The new value for the sequence. This must be a value that is
+    #     within the sequence definition. For example, you cannot set
+    #     a String sequence to an Integer value.
+    #
+    #   @example
+    #     set_sequence(:factory_name, :trait_name, :sequence_name, 450)
+    #   @example
+    #     set_sequence([:factory_name, :trait_name, :sequence_name], 450)
+    #   @example
+    #     set_sequence("factory_name/trait_name/sequence_name", 450)
     delegate :factories,
       :register_strategy,
       :rewind_sequences,
+      :rewind_sequence,
+      :set_sequence,
       :strategy_by_name,
       to: Internal
   end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factory_bot
 version: !ruby/object:Gem::Version
-  version: 6.5.1
+  version: 6.5.5
 platform: ruby
 authors:
 - Josh Clayton
 - Joe Ferris
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-31 00:00:00.000000000 Z
+date: 2025-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -246,13 +245,13 @@ files:
 - lib/factory_bot/syntax/methods.rb
 - lib/factory_bot/syntax_runner.rb
 - lib/factory_bot/trait.rb
+- lib/factory_bot/uri_manager.rb
 - lib/factory_bot/version.rb
 homepage: https://github.com/thoughtbot/factory_bot
 licenses:
 - MIT
 metadata:
   changelog_uri: https://github.com/thoughtbot/factory_bot/blob/main/NEWS.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -267,8 +266,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: factory_bot provides a framework and DSL for defining and using model instance
   factories.