v0.6.0

Author: Verseth

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2025-10-16
+
+[Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.5.1...v0.6.0)
+
+### Changes
+- Add `Shale::Builder::mapper_attributes`, `Shale::Builder::mapper_attributes!`, `Shale::Builder::builder_attributes`, `Shale::Builder::builder_attributes!`
+- Add `Shale::Builder#inject_context`
+
 ## [0.5.1] - 2025-10-15
 
 [Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.5.0...v0.5.1)

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    shale-builder (0.5.2)
+    shale-builder (0.6.0)
       booleans (>= 0.1)
       shale (< 2.0)
       sorbet-runtime (> 0.5)

lib/shale/attribute.rb

@@ -38,5 +38,12 @@ def all_names
     def mapper?
       type.is_a?(Class) && type < Shale::Mapper
     end
+
+    # Returns `true` if the attribute is handled by a shale builder.
+    #
+    #: -> bool
+    def builder?
+      type.is_a?(Class) && type < Shale::Builder
+    end
   end
 end

lib/shale/builder.rb

@@ -169,16 +169,44 @@ def #{new_name}=(val)
         RUBY
       end
 
-    end
-    mixes_in_class_methods(ClassMethods)
+      # Returns a hash of shale attributes that are handled by a shale mapper.
+      # The result gets memoized.
+      #
+      #: -> Hash[Symbol, Shale::Attribute]
+      def mapper_attributes
+        @mapper_attributes ||= mapper_attributes!
+      end
 
-    def initialize(*args, **kwargs, &block)
-      super
-      @__initialized = true
-    end
+      # Returns a hash of shale attributes that are handled by a shale mapper.
+      # Always constructs a new hash.
+      #
+      #: -> Hash[Symbol, Shale::Attribute]
+      def mapper_attributes!
+        attributes.select do |_, attr|
+          attr.mapper?
+        end
+      end
 
-    #: bool?
-    attr_reader :__initialized
+      # Returns a hash of shale attributes that are handled by a shale builder.
+      # The result gets memoized.
+      #
+      #: -> Hash[Symbol, Shale::Attribute]
+      def builder_attributes
+        @builder_attributes ||= builder_attributes!
+      end
+
+      # Returns a hash of shale attributes that are handled by a shale builder.
+      # Always constructs a new hash.
+      #
+      #: -> Hash[Symbol, Shale::Attribute]
+      def builder_attributes!
+        attributes.select do |_, attr|
+          attr.builder?
+        end
+      end
+
+    end
+    mixes_in_class_methods(ClassMethods)
 
     # Returns an array of shale values
     # that have been assigned.
@@ -191,6 +219,25 @@ def attribute_values
       end
     end
 
+    # Attempts to set the given attributes and values
+    # within this shale builder object and all of its sub-builders.
+    # Attributes that aren't defined are ignored.
+    #
+    #: (**untyped) -> void
+    def inject_context(**context)
+      context.each do |name, val|
+        try(:"#{name}=", val)
+      end
+
+      klass = self.class #: as untyped
+      klass.builder_attributes.each_key do |name|
+        val = public_send(name)
+        next unless val
+
+        val.inject_context(context)
+      end
+    end
+
   end
 end
 

lib/shale/builder/assigned_attributes.rb

@@ -59,6 +59,14 @@ def #{name}=(val)
       end
       mixes_in_class_methods ClassMethods
 
+      def initialize(*args, **kwargs, &block)
+        super
+        @__initialized = true
+      end
+
+      #: bool?
+      attr_reader :__initialized
+
       # Returns a set of names of assigned shale attributes.
       #
       #: -> Set[Symbol]

lib/shale/builder/version.rb

@@ -2,6 +2,6 @@
 
 module Shale
   module Builder
-    VERSION = '0.5.2'
+    VERSION = '0.6.0'
   end
 end