shale-builder 0.8.5 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ff18fc2a346966ffb57504d1391b21bc1ffb0875210149a9fe9bbfaf8f34cbc
-  data.tar.gz: 0d5b178c4565dbc3471775ae4d3e11c79fc8ddb5c4a80a9d7ae519a43102c7dc
+  metadata.gz: a856175f03b1a09320b45d95ce15389523ef1dcc144cd43465ef158ede3d58a5
+  data.tar.gz: 8e04cd5334e75d2b01010ec5074b160beb6397f23fb2e17a30fb4bd67b45c57b
 SHA512:
-  metadata.gz: 4c63c403ff14f295e3647192ea9f5ae3c6116adbf7c6f0ed6f65a3d635797e51a486788f79bc5f73ee6d3435377b60811aa65e04e37be2b16e26a63febc5fde7
-  data.tar.gz: c9fcbcfcc5d2f76385df8ba4c8cf07ee6c11be284f80bbb2edc8eebeeb4c532b932748f9fdc624ffd76d7b28d05725c442f46ef19976ef050460dea743d0c7ed
+  metadata.gz: 4398f91a2061891d5d4c113fe4bfa23d3cf71e2d37bcc860554390dc6fb05c370c11060fefb3b3f3c54d3d48bddab0664fcc023c2e1cc9c739a8ab5153ac5ea7
+  data.tar.gz: e29af058ad0a347ad4afa01332a5aaa6e78af78fa21ea60ef4cbb01184fdc18d061df5327dd21b479977e28a2745e35f451f934f5798ff58e51292e258708bac

data/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.9.0] - 2026-04-24
+
+[Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.8.5...v0.9.0)
+
+### Changes
+- Add `memoize:` optional keyword arg to complex getters to preserve the already existing object instead of overriding it
+
 ## [0.8.5] - 2025-10-27
 
 [Diff](https://github.com/Verseth/ruby-shale-builder/compare/v0.8.3...v0.8.5)

data/Gemfile.lock

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

data/README.md

@@ -145,6 +145,47 @@ non-primitive types have been overridden to accept blocks.
 When a block is given to such a getter, it instantiates an empty object
 of its type and yields it to the block.
 
+#### Overriding
+
+By default if you call the builder method with a block a second time
+it will override the previous object with a new one
+
+```rb
+transaction = Transaction.build do |t|
+    t.amount do |a|
+        a.value = 2.3
+        a.currency = 'PLN'
+    end
+    t.amount do |a|
+        a.value = 10
+    end
+end
+
+transaction.amount.value #=> 10
+transaction.amount.currency #=> nil
+```
+
+#### Memoization
+
+You can change the behaviour of builder methods
+so that they preserve existing objects when called a second time.
+You do that by using the `memoize: true` keyword argument.
+
+```rb
+transaction = Transaction.build do |t|
+    t.amount do |a|
+        a.value = 2.3
+        a.currency = 'PLN'
+    end
+    t.amount(memoize: true) do |a|
+        a.value = 10
+    end
+end
+
+transaction.amount.value #=> 10
+transaction.amount.currency #=> 'PLN'
+```
+
 ### Collections
 
 Whenever you call a getter with a block for a collection attribute, the built object will be appended to the array.

data/lib/shale/builder/version.rb

@@ -2,6 +2,6 @@
 
 module Shale
   module Builder
-    VERSION = '0.8.5'
+    VERSION = '0.9.1'
   end
 end

data/lib/shale/builder.rb

@@ -130,27 +130,27 @@ module Shale
 
         if collection
           @builder_methods_module.class_eval <<~RUBY, __FILE__, __LINE__ + 1
-            def #{name}                           # def clients
-              return super unless block_given?    #   return super unless block_given?
-                                                  #
-              arr = self.#{name} ||= []           #   arr = self.clients ||= []
-              object = #{shale_mapper}.new                #   object = Client.new
-              yield(object)                       #   yield(object)
-              arr << object                       #   arr << object
-              object                              #   object
-            end                                   # end
+            def #{name}
+              return super unless block_given?
+
+              arr = self.#{name} ||= []
+              object = #{shale_mapper}.new
+              yield(object)
+              arr << object
+              object
+            end
           RUBY
           return
         end
 
         @builder_methods_module.class_eval <<~RUBY, __FILE__, __LINE__ + 1
-          def #{name}                                   # def amount
-            return super unless block_given?            #   return super unless block_given?
-                                                        #
-            object = #{shale_mapper}.new                        #   object = Amount.new
-            yield(object)                               #   yield(object)
-            self.#{name} = object                       #   self.amount = object
-          end                                           # end
+          def #{name}(memoize: false)
+            return super() unless block_given?
+
+            object = (memoize && self.#{name}) || #{shale_mapper}.new
+            yield(object)
+            self.#{name} = object
+          end
         RUBY
       end
 

data/lib/tapioca/dsl/compilers/shale.rb

@@ -18,7 +18,8 @@ module Tapioca
       class << self
         extend T::Sig
 
-        sig { override.returns(T::Enumerable[Module]) }
+        # @override
+        #: -> T::Enumerable[Module]
         def gather_constants
           # Collect all the classes that inherit from Shale::Mapper
           all_classes.select { |c| c < ::Shale::Mapper }
@@ -27,7 +28,8 @@ module Tapioca
 
       SHALE_ATTRIBUTE_MODULE = 'ShaleAttributeMethods'
 
-      sig { override.void }
+      # @override
+      #: -> void
       def decorate
         # Create a RBI definition for each class that inherits from Shale::Mapper
         root.create_path(constant) do |klass|
@@ -92,60 +94,64 @@ module Tapioca
 
       end
 
-      sig { params(type: T.untyped).returns(String) }
+      #: (untyped type) -> String
       def wrap_nilable_type(type)
         return "T.nilable(#{type})" if type != T.untyped
 
         T.unsafe(type).to_s
       end
 
-      sig { params(type: T.untyped).returns(String) }
+      #: (untyped type) -> String
       def wrap_array_type(type)
         "T::Array[#{type}]"
       end
 
-      sig do
-        params(
-          mod: RBI::Scope,
-          method_name: String,
-          type: Object,
-          getter_without_block_type: String,
-          comments: T::Array[RBI::Comment],
-        ).void
-      end
+      #: (RBI::Scope mod, String method_name, Object type, String getter_without_block_type, Array[RBI::Comment] comments) -> void
       def generate_mapper_getter(mod, method_name, type, getter_without_block_type, comments)
         if mod.respond_to?(:create_sig)
           mod = T.unsafe(mod)
           # for tapioca < 0.16.0
-          sigs = T.let([], T::Array[RBI::Sig])
+          sigs = [] #: Array[RBI::Sig]
 
           # simple getter
           sigs << mod.create_sig(
-            parameters: { block: 'NilClass' },
+            parameters: {
+              memoize: 'FalseClass',
+              block: 'NilClass',
+            },
             return_type: getter_without_block_type,
           )
           # getter with block
           sigs << mod.create_sig(
-            parameters: { block: "T.proc.params(arg0: #{type}).void" },
+            parameters: {
+              memoize: 'T::Boolean',
+              block: "T.proc.params(arg0: #{type}).void"
+            },
             return_type: type.to_s
           )
           mod.create_method_with_sigs(
             method_name,
             sigs: sigs,
             comments: comments,
-            parameters: [RBI::BlockParam.new('block')],
+            parameters: [
+              RBI::KwOptParam.new('memoize', 'false'),
+              RBI::BlockParam.new('block'),
+            ],
           )
         else
           # for tapioca >= 0.16.0
           mod.create_method(method_name, comments: comments) do |method|
+            method.add_kw_opt_param('memoize', 'false')
             method.add_block_param('block')
 
             method.add_sig do |sig|
+              sig.add_param('memoize', 'FalseClass')
               sig.add_param('block', 'NilClass')
               sig.return_type = getter_without_block_type
             end
 
             method.add_sig do |sig|
+              sig.add_param('memoize', 'T::Boolean')
               sig.add_param('block', "T.proc.params(arg0: #{type}).void")
               sig.return_type = type.to_s
             end
@@ -155,51 +161,45 @@ module Tapioca
 
       private
 
-      sig { params(klass: Class).returns(T.nilable(T::Boolean)) }
+      #: (Class klass) -> bool?
       def includes_shale_builder(klass)
         return false unless defined?(::Shale::Builder)
 
         klass < ::Shale::Builder
       end
 
-      sig { returns(T::Boolean) }
+      #: -> bool
       def shale_builder_defined? = Boolean(defined?(::Shale::Builder))
 
       # Maps Shale return types to Sorbet types
-      SHALE_RETURN_TYPES_MAP = T.let(
-        {
-          ::Shale::Type::Value    => T.untyped,
-          ::Shale::Type::String   => String,
-          ::Shale::Type::Float    => Float,
-          ::Shale::Type::Integer  => Integer,
-          ::Shale::Type::Time     => Time,
-          ::Shale::Type::Date     => Date,
-          ::Shale::Type::Boolean  => T::Boolean,
-        }.tap do |h|
-          h[::Shale::Type::Decimal] = BigDecimal if defined?(::Shale::Type::Decimal)
-        end.freeze,
-        T::Hash[Class, Object],
-      )
+      SHALE_RETURN_TYPES_MAP = {
+        ::Shale::Type::Value    => T.untyped,
+        ::Shale::Type::String   => String,
+        ::Shale::Type::Float    => Float,
+        ::Shale::Type::Integer  => Integer,
+        ::Shale::Type::Time     => Time,
+        ::Shale::Type::Date     => Date,
+        ::Shale::Type::Boolean  => T::Boolean,
+      }.tap do |h|
+        h[::Shale::Type::Decimal] = BigDecimal if defined?(::Shale::Type::Decimal)
+      end.freeze #: Hash[Class, Object]
 
       # Maps Shale setter types to Sorbet types
-      SHALE_SETTER_TYPES_MAP = T.let(
-        {
-          ::Shale::Type::Value    => T.untyped,
-          ::Shale::Type::String   => String,
-          ::Shale::Type::Float    => Float,
-          ::Shale::Type::Integer  => Integer,
-          ::Shale::Type::Time     => Time,
-          ::Shale::Type::Date     => Date,
-          ::Shale::Type::Boolean  => Object,
-        }.tap do |h|
-          if defined?(::Shale::Type::Decimal)
-            h[::Shale::Type::Decimal] = T.any(BigDecimal, String, Float, Integer, NilClass)
-          end
-        end.freeze,
-        T::Hash[Class, Object],
-      )
+      SHALE_SETTER_TYPES_MAP = {
+        ::Shale::Type::Value    => T.untyped,
+        ::Shale::Type::String   => String,
+        ::Shale::Type::Float    => Float,
+        ::Shale::Type::Integer  => Integer,
+        ::Shale::Type::Time     => Time,
+        ::Shale::Type::Date     => Date,
+        ::Shale::Type::Boolean  => Object,
+      }.tap do |h|
+        if defined?(::Shale::Type::Decimal)
+          h[::Shale::Type::Decimal] = T.any(BigDecimal, String, Float, Integer, NilClass)
+        end
+      end.freeze #: Hash[Class, Object]
 
-      sig { params(attribute: ::Shale::Attribute).returns([Object, T::Boolean]) }
+      #: (::Shale::Attribute attribute) -> [Object, bool]
       def shale_type_to_sorbet_return_type(attribute)
         return_type = SHALE_RETURN_TYPES_MAP[attribute.type]
         return complex_shale_type_to_sorbet_return_type(attribute) unless return_type
@@ -208,7 +208,7 @@ module Tapioca
         [return_type, true]
       end
 
-      sig { params(attribute: ::Shale::Attribute).returns([Object, T::Boolean]) }
+      #: (::Shale::Attribute attribute) -> [Object, bool]
       def complex_shale_type_to_sorbet_return_type(attribute)
         return attribute.type, true unless attribute.type.respond_to?(:return_type)
 
@@ -216,7 +216,7 @@ module Tapioca
         [return_type_string, false]
       end
 
-      sig { params(attribute: ::Shale::Attribute).returns([Object, T::Boolean]) }
+      #: (::Shale::Attribute attribute) -> [Object, bool]
       def shale_type_to_sorbet_setter_type(attribute)
         setter_type = SHALE_SETTER_TYPES_MAP[attribute.type]
         return complex_shale_type_to_sorbet_setter_type(attribute) unless setter_type
@@ -225,7 +225,7 @@ module Tapioca
         [setter_type, true]
       end
 
-      sig { params(attribute: ::Shale::Attribute).returns([Object, T::Boolean]) }
+      #: (::Shale::Attribute attribute) -> [Object, bool]
       def complex_shale_type_to_sorbet_setter_type(attribute)
         if attribute.type.respond_to?(:setter_type)
           setter_type_string = attribute.type.setter_type

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shale-builder
 version: !ruby/object:Gem::Version
-  version: 0.8.5
+  version: 0.9.1
 platform: ruby
 authors:
 - Mateusz Drewniak