object_forge 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13df90e0eb14f3fb52c1b9be5706a3b2da6c844369005f0500fe31f67ced6091
-  data.tar.gz: 6ce301c70ae87b0e46662482cd46af63d8e282aca65f92e220dc02e4a6b3e2b6
+  metadata.gz: 05dce89141257f37f8b8af6a7f0cdfb1d7ee785a37ad119d0c13ff28c58d9245
+  data.tar.gz: e171f2f3d504d0edadfdb5f2ba2f87d9d9edd1a0f175a0be366b12dc528182a0
 SHA512:
-  metadata.gz: b75f0d0ddacd4f102a02bbb74bd0189e8b2759eb4e9a4f3f62de84a028356800908d3313ec5361299078e49a2101abcedda91358601cfc03cf76ac2bb3fb05b7
-  data.tar.gz: 76231dd798153526c679874b3528d120a7f3562c8dfc540001be54465b46f53a50afa46f04d17f8bc2ddfcb152708d9003e417fd4d8c6d220890c62597930104
+  metadata.gz: c8a330629ce325a8bf78930a3025d5c1d75305e80c970cb5217e9d4ae6f93659d3fc9d3fdd89884920b5843c8c1bfb787bdfc6be8ce220db29124a2d73a749da
+  data.tar.gz: a0515b9f4111c0e3bcd1b9bbb4f5cb3011bb12bba62750a2ca0f49b702f55a459be7877fb540cf16c6a40503a5c2294e962352408345e67bbb7179bc79f2539b

data/lib/object_forge/forge.rb

@@ -55,8 +55,8 @@ module ObjectForge
 
     # Forge a new instance.
     #
-    # @overload forge(*traits, **overrides)
-    # @overload forge(traits, overrides)
+    # @overload forge(*traits, **overrides, &)
+    # @overload forge(traits, overrides, &)
     #
     # Positional arguments are taken as trait names, keyword arguments as attribute overrides,
     # unless there are exactly two positional arguments: an array and a hash.
@@ -64,19 +64,21 @@ module ObjectForge
     # All traits and overrides are applied in argument order,
     # with overrides always applied after traits.
     #
+    # If a block is given, forged instance is yielded to it after being built.
+    #
     # @thread_safety Forging is thread-safe if {#parameters},
     #    +traits+ and +overrides+ are thread-safe.
     #
     # @param traits [Array<Symbol>] traits to apply
     # @param overrides [Hash{Symbol => Any}] attribute overrides
+    # @yieldparam object [Any] forged instance
+    # @yieldreturn [void]
     # @return [Any] built instance
     def forge(*traits, **overrides)
-      # @type var traits: Array[(Array[Symbol] | Hash[Symbol, untyped])]
-      traits, overrides = check_traits_and_overrides(traits, overrides)
-      attributes = @parameters.attributes.merge(*@parameters.traits.values_at(*traits), overrides)
-      attributes = Crucible.new(attributes).resolve!
-
-      forged.new(attributes)
+      resolved_attributes = resolve_attributes(traits, overrides)
+      instance = build_instance(resolved_attributes)
+      yield instance if block_given?
+      instance
     end
 
     alias build forge
@@ -84,19 +86,13 @@ module ObjectForge
 
     private
 
-    def check_traits_and_overrides(traits, overrides)
-      unless traits.size == 2 && overrides.empty?
-        # @type var traits: Array[Symbol]
-        # @type var overrides: Hash[Symbol, untyped]
-        return [traits, overrides]
-      end
+    def resolve_attributes(traits, overrides)
+      attributes = @parameters.attributes.merge(*@parameters.traits.values_at(*traits), overrides)
+      Crucible.new(attributes).resolve!
+    end
 
-      case traits
-      in [Array => real_traits, Hash => real_overrides]
-        [real_traits, real_overrides]
-      else
-        [traits, overrides]
-      end
+    def build_instance(attributes)
+      forged.new(attributes)
     end
   end
 end

data/lib/object_forge/forgeyard.rb

@@ -50,11 +50,13 @@ module ObjectForge
     # @param name [Symbol] name of the forge
     # @param traits [Array<Symbol>] traits to apply
     # @param overrides [Hash{Symbol => Any}] attribute overrides
+    # @yieldparam object [Any] forged instance
+    # @yieldreturn [void]
     # @return [Any] built instance
     #
     # @raise [KeyError] if forge with the specified name is not registered
-    def forge(name, *traits, **overrides)
-      @forges.fetch(name)[traits, overrides]
+    def forge(name, *traits, **overrides, &)
+      @forges.fetch(name)[*traits, **overrides, &]
     end
 
     alias build forge

data/lib/object_forge/molds/keywords_mold.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# module ObjectForge
+#   module Molds
+#     # Mold which calls +forged.new(**attributes)+.
+#     #
+#     # @since 0.1.1
+#     class KeywordsMold
+#       # Instantiate +forged+ with a hash of attributes.
+#       #
+#       # @param forged [Class]
+#       # @param attributes [Hash{Symbol => Any}]
+#       # @return [Any]
+#       def call(forged:, attributes:, **)
+#         forged.new(**attributes)
+#       end
+#     end
+#   end
+# end

data/lib/object_forge/sequence.rb

@@ -32,7 +32,7 @@ module ObjectForge
       end
 
       @initial = initial
-      @container = Concurrent::MVar.new(initial)
+      @container = Concurrent::MVar.new(initial) # steep:ignore UnknownConstant
     end
 
     # Get the next value in the sequence, starting with the initial value.

data/lib/object_forge/version.rb

@@ -2,5 +2,5 @@
 
 module ObjectForge
   # Current version
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/object_forge.rb

@@ -84,7 +84,7 @@ module ObjectForge
     DEFAULT_YARD.define(...)
   end
 
-  # @overload forge(name, *traits, **overrides)
+  # @overload forge(name, *traits, **overrides, &)
   # Build an instance using a forge from {DEFAULT_YARD}.
   #
   # @!macro default_forgeyard
@@ -94,6 +94,8 @@ module ObjectForge
   # @param name [Symbol] name of the forge
   # @param traits [Array<Symbol>] traits to apply
   # @param overrides [Hash{Symbol => Any}] attribute overrides
+  # @yieldparam object [Any] forged instance
+  # @yieldreturn [void]
   # @return [Any] built instance
   def self.forge(...)
     DEFAULT_YARD.forge(...)

data/sig/object_forge.rbs

@@ -1,14 +1,13 @@
 module ObjectForge
-  class Error < StandardError
-  end
-  class DSLError < Error
-  end
+  type sequenceable = ObjectForge::_RespondTo & ObjectForge::_Sequenceable
 
-  interface _Sequenceable
-    def succ: -> self
+  interface _RespondTo
     def respond_to?: (Symbol name, ?bool include_private) -> bool
     def class: -> Class
   end
+interface _Sequenceable
+    def succ: -> self
+  end
   interface _Forgable
     def new: (Hash[Symbol, untyped]) -> self
   end
@@ -17,31 +16,36 @@ module ObjectForge
     def traits: () -> Hash[Symbol, Hash[Symbol, untyped]]
   end
 
+  class Error < StandardError
+  end
+  class DSLError < Error
+  end
+
   VERSION: String
   DEFAULT_YARD: ObjectForge::Forgeyard
 
   def self.sequence
-    : (?(ObjectForge::_Sequenceable | ObjectForge::Sequence) initial) -> ObjectForge::Sequence
+    : (?(ObjectForge::sequenceable | ObjectForge::Sequence) initial) -> ObjectForge::Sequence
 
   def self.define
     : (Symbol name, ObjectForge::_Forgable forged) { (ObjectForge::ForgeDSL) -> void } -> ObjectForge::Forge
     | (Symbol name, ObjectForge::_Forgable forged) { [self: ObjectForge::ForgeDSL] -> void } -> ObjectForge::Forge
 
   def self.forge
-    : (Symbol name, *Symbol traits, **untyped overrides) -> ObjectForge::_Forgable
+    : (Symbol name, *Symbol traits, **untyped overrides) ?{ (untyped) -> void } -> ObjectForge::_Forgable
 end
 
 class ObjectForge::Sequence
   def self.new
-    : (?(ObjectForge::_Sequenceable | ObjectForge::Sequence) initial) -> ObjectForge::Sequence
+    : (?(ObjectForge::sequenceable | ObjectForge::Sequence) initial) -> ObjectForge::Sequence
   
-  attr_reader initial: ObjectForge::_Sequenceable
+  attr_reader initial: ObjectForge::sequenceable
   
-  def initialize: (ObjectForge::_Sequenceable initial) -> void
+  def initialize: (ObjectForge::sequenceable initial) -> void
 
-  def next: -> ObjectForge::_Sequenceable
+  def next: -> ObjectForge::sequenceable
 
-  def reset: -> ObjectForge::_Sequenceable
+  def reset: -> ObjectForge::sequenceable
   alias rewind reset
 end
   
@@ -59,7 +63,7 @@ class ObjectForge::Forgeyard
     : (Symbol name, ObjectForge::Forge forge) -> ObjectForge::Forge
 
   def forge
-    : (Symbol name, *Symbol traits, **untyped overrides) -> ObjectForge::_Forgable
+    : (Symbol name, *Symbol traits, **untyped overrides) ?{ (untyped) -> void } -> ObjectForge::_Forgable
   alias build forge
   alias [] forge
 end
@@ -68,7 +72,7 @@ class ObjectForge::Forge
   class Parameters
     include ObjectForge::_ForgeParameters
 
-    def intitialize
+    def initialize
       : (attributes: Hash[Symbol, untyped], traits: Hash[Symbol, Hash[Symbol, untyped]]) -> void
   end
 
@@ -83,20 +87,22 @@ class ObjectForge::Forge
     : (ObjectForge::_Forgable forged, ObjectForge::_ForgeParameters parameters, ?name: Symbol?) -> void
   
   def forge
-    : (*Symbol traits, **untyped overrides) -> ObjectForge::_Forgable
-    | (Array[Symbol] traits, Hash[Symbol, untyped] overrides) -> ObjectForge::_Forgable
+    : (*Symbol traits, **untyped overrides) ?{ (untyped) -> void } -> ObjectForge::_Forgable
   alias build forge
   alias [] forge
 
   private
 
-  def check_traits_and_overrides
-    : (Array[Symbol] traits, Hash[Symbol, untyped] overrides) -> [Array[Symbol], Hash[Symbol, untyped]]
-   | (Array[(Array[Symbol] | Hash[Symbol, untyped])], Hash[Symbol, untyped]) -> [Array[Symbol], Hash[Symbol, untyped]]
+  def resolve_attributes
+    : (Array[Symbol] traits, Hash[Symbol, untyped] overrides) -> Hash[Symbol, untyped]
+
+  def build_instance
+    : (Hash[Symbol, untyped] attributes) -> ObjectForge::_Forgable
 end
 
 class ObjectForge::ForgeDSL < ObjectForge::UnBasicObject
   include ObjectForge::_ForgeParameters
+
   attr_reader sequences: Hash[Symbol, ObjectForge::Sequence]
 
   @attributes: Hash[Symbol, Proc]
@@ -110,12 +116,11 @@ class ObjectForge::ForgeDSL < ObjectForge::UnBasicObject
   def freeze: -> self
 
   def attribute
-    : (Symbol name) { -> untyped } -> Symbol
-    | (Symbol name) { (ObjectForge::_Sequenceable) -> untyped } -> Symbol
+    : (Symbol name) { [self: ObjectForge::Crucible] -> untyped } -> Symbol
   alias [] attribute
 
   def sequence
-    : (Symbol name, ?(ObjectForge::_Sequenceable | ObjectForge::Sequence) initial) { (ObjectForge::_Sequenceable) -> untyped } -> Symbol
+    : (Symbol name, ?(ObjectForge::sequenceable | ObjectForge::Sequence) initial) { (ObjectForge::sequenceable) [self: ObjectForge::Crucible] -> untyped } -> Symbol
 
   def trait
     : (Symbol name) { (self) -> void } -> Symbol
@@ -125,7 +130,7 @@ class ObjectForge::ForgeDSL < ObjectForge::UnBasicObject
   private
 
   def method_missing
-    : (Symbol name) { -> untyped } -> Symbol
+    : (Symbol name) { [self: ObjectForge::Crucible] -> untyped } -> Symbol
     # After freezing:
     | (Symbol name) { -> untyped } -> void
 
@@ -182,5 +187,5 @@ class ObjectForge::UnBasicObject < BasicObject
 
   def block_given?: -> bool
 
-  def raise: (_Exception exception, ?String message) -> void
+  def raise: (_Exception exception, ?String message, ?Array[String] backtrace, ?cause: _Exception) -> void
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: object_forge
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Alexandr Bulancov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -30,7 +29,7 @@ description: |
   It has no connection to any framework and, indeed, has nothing to do with a database.
   To use, just define some factories and call them wherever you need,
   be it in tests, console, or application code.
-email:
+  If needed, almost any part of the process can be easily replaced with a custom solution.
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -40,6 +39,7 @@ files:
 - lib/object_forge/forge.rb
 - lib/object_forge/forge_dsl.rb
 - lib/object_forge/forgeyard.rb
+- lib/object_forge/molds/keywords_mold.rb
 - lib/object_forge/sequence.rb
 - lib/object_forge/un_basic_object.rb
 - lib/object_forge/version.rb
@@ -50,11 +50,10 @@ licenses:
 metadata:
   homepage_uri: https://github.com/trinistr/object_forge
   bug_tracker_uri: https://github.com/trinistr/object_forge/issues
-  documentation_uri: https://rubydoc.info/gems/object_forge/0.1.0
-  source_code_uri: https://github.com/trinistr/object_forge/tree/v0.1.0
-  changelog_uri: https://github.com/trinistr/object_forge/blob/v0.1.0/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/object_forge/0.1.1
+  source_code_uri: https://github.com/trinistr/object_forge/tree/v0.1.1
+  changelog_uri: https://github.com/trinistr/object_forge/blob/v0.1.1/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options:
 - "--tag"
 - thread_safety:Thread safety
@@ -71,8 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: A simple factory for objects with minimal assumptions.
 test_files: []