shale-builder 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a79ea1df97f6d5d49af0d596144d931b5aacea98e142866d7e322497fbeaae5
-  data.tar.gz: 59f671f470be89ed4854798843657160c87163de286a867be73c4832bb4a2df2
+  metadata.gz: febc908c436d767296b5869c0f83de5192ebd2dea56649a68840f951ca61210e
+  data.tar.gz: 921efc21393a6a01516dc0954efe6f87fe74326d51d1969c00e985f3f8ad9824
 SHA512:
-  metadata.gz: f763a5973d2d15c2a2c314ae61ed61f7455724f624f38852f8cd4d174fe2bf12af7bee2eb37a847b5940f9779fa4ad2960eff6a99259c12d0445d16fb63b8775
-  data.tar.gz: e872ffe315cec734fa77af67b1be80efded4b750194e66c2e41d069302b5dc18cc4bd0f3da2932528661cc2fa1d84ff90a08f3326c7052a65030987f5c4685eb
+  metadata.gz: 315da1873bcba3a08cbf4a6d405b975a8c9be51442726faab0e886138be48b50fa6bec7c5367064d1d0cc731af17ec0c10bbe9cfb04716a5b1d0712de46244a5
+  data.tar.gz: 54df3a9708bc1e327ecb7f85338a1420cca5b98d82b754acbecd03417541951472b9f2d005035abe5fe1217bfd5db10d3730a1966043c65956b3cdb83d080299

data/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.5.0] - 2025-10-15
+
+[Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.4.1...v0.5.0)
+
+### Changes
+- Add `Shale::Builder::AssignedAttributes` module which grants a shale mapper class with the ability to record which attributes have been assigned
+- Add `Shale::Builder::Value` which represents a value of a shale attribute.
+- Add `Shale::Builder#attribute_values`, a method that returns an array of `Shale::Builder::Value` objects for each attribute.
+
 ## [0.4.1] - 2025-10-14
 
 [Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.4.0...v0.4.1)

data/Gemfile.lock

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

data/README.md

@@ -263,6 +263,41 @@ obj.errors.messages #=> {cvv_code: ["can't be blank"], "amount.value": ["can't b
 
 You MUST include `ActiveModel::Validations` before `Shale::Builder::NestedValidations`.
 
+### Recording Assigned Attributes
+
+There is an additional module `Shale::Builder::AssignedAttributes` that provides
+support for recording which attributes have been assigned in a shale mapper object.
+
+In order to load it do:
+
+```rb
+require 'shale/builder/assigned_attributes'
+```
+
+Then you can use it like so
+
+```rb
+class AmountType < ::Shale::Mapper
+    include ::Shale::Builder
+    include ::Shale::Builder::AssignedAttributes
+
+    attribute :value, ::Shale::Type::Float
+    attribute :currency, ::Shale::Type::String
+end
+
+obj = AmountType.new
+obj.assigned_attribute_names #=> #<Set: {}>
+
+obj.value = 3
+obj.assigned_attribute_names #=> #<Set: {:value}>
+obj.assigned_attributes #=> [#<Shale::Attribute:0x000000011e959b50 @collection=false, @default=nil, @doc=nil, @name=:value, @setter="value=", @type=Shale::Type::Float>]
+obj.assigned_values #=> [#<Shale::Builder::Value:0x000000011d693318 @attribute=#<Shale::Attribute:0x000000011e959b50 @collection=false, @default=nil, @doc=nil, @name=:value, @setter="value=", @type=Shale::Type::Float>, @value=3.0>]
+```
+
+- `assigned_attribute_names` returns a set of attribute names
+- `assigned_attributes` returns an array of attribute definitions
+- `assigned_values` returns an array of `Shale::Builder::Value`, which contains the current value of an attribute and a reference to its definition
+
 ### Attribute aliases
 
 You can easily create aliases for attributes using `alias_attribute`

data/lib/shale/attribute.rb

@@ -9,15 +9,15 @@ module Shale
 
     # Contains the documentation comment for the shale attribute
     # in a Ruby String.
-    sig { returns(T.nilable(String)) }
+    #: String?
     attr_accessor :doc
 
     # Contains the documentation comment for the shale attribute
     # in a Ruby String.
-    sig { returns(T.nilable(T::Array[Symbol])) }
+    #: Array[Symbol]?
     attr_accessor :aliases
 
-    sig { returns(T::Array[Symbol]) }
+    #: -> Array[Symbol]
     def all_names
       names = [name]
       aliases = self.aliases
@@ -25,5 +25,12 @@ module Shale
 
       names + aliases
     end
+
+    # Returns `true` if the attribute is handled by a shale mapper.
+    #
+    #: -> bool
+    def mapper?
+      type.is_a?(Class) && type < Shale::Mapper
+    end
   end
 end

data/lib/shale/builder/assigned_attributes.rb

@@ -0,0 +1,94 @@
+# typed: true
+# frozen_string_literal: true
+
+require 'shale'
+require 'booleans'
+
+module Shale
+  module Builder
+    # Include in a class that already includes `Shale::Builder` to add support
+    # for getting a list of attributes that have been assigned.
+    #
+    # @requires_ancestor: Object
+    module AssignedAttributes
+      extend T::Sig
+      extend T::Helpers
+
+      class << self
+        extend T::Sig
+
+        # Gets called after including this module in a module or class.
+        #: (Module mod) -> void
+        def included(mod)
+          mod.extend ClassMethods
+          AssignedAttributes.prepare_mod(mod)
+        end
+
+        # Prepares the received module or class
+        # for dynamic method definition.
+        #: (Module mod) -> void
+        def prepare_mod(mod)
+          assigned_attributes_methods_module = ::Module.new
+          mod.instance_variable_set :@assigned_attributes_methods_module, assigned_attributes_methods_module
+          mod.include assigned_attributes_methods_module
+        end
+      end
+
+      # @requires_ancestor: singleton(Shale::Mapper)
+      module ClassMethods
+        extend T::Sig
+
+        # Contains overridden getter methods for attributes
+        # with complex types (so that they accept a block for building)
+        #: Module
+        attr_reader :assigned_attributes_methods_module
+
+        #: (String | Symbol name, Class type, ?collection: bool, ?default: Proc?, ?doc: String?, **untyped kwargs) ?{ -> void } -> void
+        def attribute(name, type, collection: false, default: nil, doc: nil, **kwargs, &block)
+          super
+
+          @assigned_attributes_methods_module.class_eval <<~RUBY, __FILE__, __LINE__ + 1
+            def #{name}=(val)
+              super
+              return unless @__initialized
+
+              self.assigned_attribute_names << #{name.to_sym.inspect}
+            end
+          RUBY
+        end
+      end
+      mixes_in_class_methods ClassMethods
+
+      # Returns a set of names of assigned shale attributes.
+      #
+      #: -> Set[Symbol]
+      def assigned_attribute_names
+        @assigned_attribute_names ||= Set.new
+      end
+
+      # Returns an array of shale attributes
+      # that have been assigned.
+      #
+      #: -> Array[Shale::Attribute]
+      def assigned_attributes
+        klass = self.class #: as untyped
+        assigned_attribute_names.map do |name|
+          klass.attributes.fetch(name)
+        end
+      end
+
+      # Returns an array of shale values
+      # that have been assigned.
+      #
+      #: -> Array[Shale::Builder::Value]
+      def assigned_values
+        klass = self.class #: as untyped
+        assigned_attribute_names.map do |name|
+          attr = klass.attributes.fetch(name)
+          Shale::Builder::Value.new(attr, public_send(attr.name))
+        end
+      end
+
+    end
+  end
+end

data/lib/shale/builder/nested_validations.rb

@@ -6,7 +6,7 @@ require 'booleans'
 
 module Shale
   module Builder
-    # Include in a class tha already includes `Shale::Builder` to add support
+    # Include in a class that already includes `Shale::Builder` to add support
     # for nested ActiveModel validations.
     #
     # @requires_ancestor: Object

data/lib/shale/builder/value.rb

@@ -0,0 +1,30 @@
+# typed: true
+# frozen_string_literal: true
+
+require 'shale'
+
+module Shale
+  module Builder
+    # Represents a value of a particular shale attribute.
+    # Hold the value and a reference to the attribute definition.
+    class Value
+      extend T::Sig
+
+      # Shale attribute definition
+      #
+      #: Shale::Attribute
+      attr_reader :attribute
+
+      # Value of the attribute.
+      #
+      #: untyped
+      attr_reader :value
+
+      #: (Shale::Attribute, untyped) -> void
+      def initialize(attribute, value)
+        @attribute = attribute
+        @value = value
+      end
+    end
+  end
+end

data/lib/shale/builder/version.rb

@@ -2,6 +2,6 @@
 
 module Shale
   module Builder
-    VERSION = '0.4.1'
+    VERSION = '0.5.0'
   end
 end

data/lib/shale/builder.rb

@@ -39,6 +39,7 @@ module Shale
   #           end
   #       end
   #
+  # @requires_ancestor: Object
   module Builder
     extend T::Sig
     extend T::Helpers
@@ -47,7 +48,7 @@ module Shale
       extend T::Sig
 
       # Gets called after including this module in a module or class.
-      sig { params(mod: Module).void }
+      #: (Module mod) -> void
       def included(mod)
         mod.extend ClassMethods
         Builder.prepare_mod(mod)
@@ -55,7 +56,7 @@ module Shale
 
       # Prepares the received module or class
       # for dynamic method definition.
-      sig { params(mod: Module).void }
+      #: (Module mod) -> void
       def prepare_mod(mod)
         builder_methods_module = ::Module.new
         mod.instance_variable_set :@builder_methods_module, builder_methods_module
@@ -71,7 +72,7 @@ module Shale
       abstract!
       has_attached_class!
 
-      sig { params(subclass: Class).void }
+      #: (Class subclass) -> void
       def inherited(subclass)
         super
         Builder.prepare_mod(subclass)
@@ -79,10 +80,10 @@ module Shale
 
       # Contains overridden getter methods for attributes
       # with complex types (so that they accept a block for building)
-      sig { returns(Module) }
+      #: Module
       attr_reader :builder_methods_module
 
-      sig { params(_block: T.proc.params(arg0: T.attached_class).void).returns(T.attached_class) }
+      #: { (instance arg0) -> void } -> instance
       def build(&_block)
         body = new
         yield(body)
@@ -96,17 +97,7 @@ module Shale
       sig { abstract.returns(T::Hash[Symbol, Shale::Attribute]) }
       def attributes; end
 
-      sig do
-        params(
-          name:       T.any(String, Symbol),
-          type:       Class,
-          collection: T::Boolean,
-          default:    T.nilable(Proc),
-          doc:        T.nilable(String),
-          kwargs:     Object,
-          block:      T.nilable(T.proc.void),
-        ).void
-      end
+      #: ((String | Symbol) name, Class type, ?collection: bool, ?default: Proc?, ?doc: String?, **Object kwargs) ?{ -> void } -> void
       def attribute(name, type, collection: false, default: nil, doc: nil, **kwargs, &block)
         super(name, type, collection:, default:, **kwargs, &block)
         if (attr_def = attributes[name.to_sym])
@@ -141,7 +132,7 @@ module Shale
       end
 
       # Create an alias for the getter and setter of an attribute.
-      sig { params(new_name: Symbol, old_name: Symbol).void }
+      #: (Symbol new_name, Symbol old_name) -> void
       def alias_attribute(new_name, old_name)
         attr = attributes.fetch(old_name)
         (attr.aliases ||= []) << new_name
@@ -160,5 +151,26 @@ module Shale
     end
     mixes_in_class_methods(ClassMethods)
 
+    def initialize(*args, **kwargs, &block)
+      super
+      @__initialized = true
+    end
+
+    #: bool?
+    attr_reader :__initialized
+
+    # Returns an array of shale values
+    # that have been assigned.
+    #
+    #: -> Array[Shale::Builder::Value]
+    def attribute_values
+      klass = self.class #: as untyped
+      klass.attributes.map do |name, attr|
+        Shale::Builder::Value.new(attr, public_send(name))
+      end
+    end
+
   end
 end
+
+require_relative 'builder/value'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shale-builder
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Mateusz Drewniak
@@ -69,7 +69,9 @@ files:
 - Rakefile
 - lib/shale/attribute.rb
 - lib/shale/builder.rb
+- lib/shale/builder/assigned_attributes.rb
 - lib/shale/builder/nested_validations.rb
+- lib/shale/builder/value.rb
 - lib/shale/builder/version.rb
 - lib/shale/mapper.rbi
 - lib/tapioca/dsl/compilers/shale.rb