tins 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd2090b923a690d351489aa80cb8792b6b06de766300a287c7ae9f82eb53321a
-  data.tar.gz: b61fd2f899759c53373f9809f59ad74b11a2241adb70fa00cb73c024bf517c6a
+  metadata.gz: 495d7cdbe014ddf4d784dc67f16d6956a7abc7cacd61519cb9f2e82c1150a6bf
+  data.tar.gz: 486eed8c0a2c3cad0927ea935a290dfcf478e820478fc4f49060f8f1c8d170c4
 SHA512:
-  metadata.gz: 74d027369ff665630a795b0a97590c0047d53d09f9dfc2d07064ae837950ef0f48bf1155d249e300f04ee8672f1c0301ad821f837f559e5a4e20c4b732bea5be
-  data.tar.gz: dbd9d024a5f71f4d116ae320010616072d72bb5082ed6e7eef1c24320e0bf2011056d58c24d67d8de7112afe23b3ebd6954b52376dc95eab184493d912d87f87
+  metadata.gz: a6f0055b6921c6ea2adfe4b99e46f54fc846c1e571f0e94c8bd0af42dbb877b3a5eab1d88f8320c3f78e2766b0344e8c5d2e598b518bb5dcf320dfc0936ff11a
+  data.tar.gz: 27e271bdf9858d5924fb56fafef2ae52867cba5e5b9c83c34892a236afac8b0833da040696888e9d029052d406332cc45f5a4123d72fc417ac70132d3b5cdcf5

data/CHANGES.md

@@ -1,5 +1,32 @@
 # Changes
 
+## 2026-09-15 v1.57.0
+
+*   Add keyword and block forwarding to `Expose#expose`
+    *   Add `**kwargs` and `&block` forwarding to `__send__` in
+        `lib/tins/expose.rb`
+    *   Restructure guards so `method_name.nil?` is checked first, preventing
+        kwargs from shadowing the method name
+    *   Update YARD docs to reflect new dispatch order and remove stale `@raise
+        [ArgumentError]`
+    *   Add `with_kw` and `with_block` fixture methods and three new tests in
+        `tests/expose_test.rb` covering kwargs, block, and combined forwarding
+*   Add keyword argument support to `Full#full?`
+    *   Add `**kwargs` to `full?` method signature in `lib/tins/xt/full.rb` and
+        forward via `__send__`
+    *   Update YARD documentation with `@param kwargs`
+    *   Add `test_full_with_kwargs` in `tests/blank_full_test.rb` verifying
+        `**kwargs` forwarding and blank result handling
+*   Add keyword argument support to `AskAndSend`
+    *   Add `**kwargs` to all four methods in `lib/tins/ask_and_send.rb`
+        (`ask_and_send`, `ask_and_send!`, `ask_and_send_or_self`,
+        `ask_and_send_or_self!`) and forward them via `__send__`
+    *   Update YARD documentation with `@param kwargs` for each method
+    *   Add test fixtures `foo_kw`, `foo_args`, `bar_kw`, `bar_args` in
+        `tests/ask_and_send_test.rb`
+    *   Add 8 new test cases covering `**kwargs`, `*args`, and `&block`
+        forwarding across all four `AskAndSend` variants
+
 ## 2026-07-25 v1.56.0
 
 ### Changes

data/lib/tins/ask_and_send.rb

@@ -7,12 +7,13 @@ module Tins
     #
     # @param method_name [ Symbol ] the name of the method to invoke
     # @param args [ Array ] arguments to pass to the method
+    # @param kwargs [ Hash ] keyword arguments to pass to the method
     # @yield [ block ] optional block to pass to the method
     # @return [ Object, nil ] the result of the method call or nil if the
     # method doesn't exist
-    def ask_and_send(method_name, *args, &block)
+    def ask_and_send(method_name, *args, **kwargs, &block)
       if respond_to?(method_name)
-        __send__(method_name, *args, &block)
+        __send__(method_name, *args, **kwargs, &block)
       end
     end
 
@@ -21,13 +22,14 @@ module Tins
     #
     # @param method_name [ Symbol ] the name of the method to call
     # @param args [ Array ] arguments to pass to the method
+    # @param kwargs [ Hash ] keyword arguments to pass to the method
     # @param block [ Proc ] optional block to pass to the method
     #
     # @return [ Object, nil ] the result of the method call or nil if the
     # method doesn't exist
-    def ask_and_send!(method_name, *args, &block)
+    def ask_and_send!(method_name, *args, **kwargs, &block)
       if respond_to?(method_name, true)
-        __send__(method_name, *args, &block)
+        __send__(method_name, *args, **kwargs, &block)
       end
     end
 
@@ -38,13 +40,14 @@ module Tins
     #
     # @param method_name [ Symbol ] the name of the method to call
     # @param args [ Array ] the arguments to pass to the method
+    # @param kwargs [ Hash ] the keyword arguments to pass to the method
     # @param block [ Proc ] the block to pass to the method
     #
     # @return [ Object ] the result of the method call or self if the method
     # doesn't exist
-    def ask_and_send_or_self(method_name, *args, &block)
+    def ask_and_send_or_self(method_name, *args, **kwargs, &block)
       if respond_to?(method_name)
-        __send__(method_name, *args, &block)
+        __send__(method_name, *args, **kwargs, &block)
       else
         self
       end
@@ -57,13 +60,14 @@ module Tins
     #
     # @param method_name [ Symbol ] the name of the method to send
     # @param args [ Array ] the arguments to pass to the method
+    # @param kwargs [ Hash ] the keyword arguments to pass to the method
     # @param block [ Proc ] the block to pass to the method
     #
     # @return [ Object ] the result of the method call or the object itself if
     # the method is not found
-    def ask_and_send_or_self!(method_name, *args, &block)
+    def ask_and_send_or_self!(method_name, *args, **kwargs, &block)
       if respond_to?(method_name, true)
-        __send__(method_name, *args, &block)
+        __send__(method_name, *args, **kwargs, &block)
       else
         self
       end

data/lib/tins/expose.rb

@@ -40,36 +40,42 @@ module Tins
     # This method provides three distinct usage patterns:
     #
     # 1. **Method Call**: When given a method name, directly calls that method
-    #    and returns its result.
+    #    and returns its result. Positional arguments, keyword arguments, and
+    #    a block can be forwarded to the called method.
     #
-    # 2. **Block Execution**: When given a block, evaluates the block in the
-    #    context of the object, allowing access to private/protected methods.
+    # 2. **Block Execution**: When called without a method name but with a
+    #    block, evaluates the block in the context of the object, allowing
+    #    access to private/protected methods.
     #
-    # 3. **Full Exposure**: When called without arguments, returns a duplicate
-    #    of the object with all private and protected methods exposed as public.
+    # 3. **Full Exposure**: When called without a method name and without a
+    #    block, returns a duplicate of the object with all private and
+    #    protected methods exposed as public.
     #
     # @param method_name [Symbol, String, nil] name of the method to call,
     #                                          or nil for full exposure
     # @param args [Array] arguments to pass to the method when calling it
-    # @param block [Proc] block to execute in the context of the object
+    # @param kwargs [Hash] keyword arguments to pass to the method when calling it
+    # @param block [Proc] block to execute in the context of the object or
+    #                     to forward to the called method
     #
     # @return [Object] result of the method call, block execution, or a new
     #                  object with exposed methods (when called without args)
     #
     # @raise [NoMethodError] if method_name is given but doesn't exist
-    # @raise [ArgumentError] if both method_name and block are provided
-    def expose(method_name = nil, *args, &block)
-      if block
-        instance_eval(&block)
-      elsif method_name.nil?
-        methods = private_methods(true) + protected_methods(true)
-        o = dup
-        o.singleton_class.class_eval do
-          public(*methods)
+    def expose(method_name = nil, *args, **kwargs, &block)
+      if method_name.nil?
+        if block
+          instance_eval(&block)
+        else
+          methods = private_methods(true) + protected_methods(true)
+          o = dup
+          o.singleton_class.class_eval do
+            public(*methods)
+          end
+          o
         end
-        o
       elsif method_name
-        __send__(method_name, *args)
+        __send__(method_name, *args, **kwargs, &block)
       end
     end
   end

data/lib/tins/version.rb

@@ -1,6 +1,6 @@
 module Tins
   # Tins version
-  VERSION         = '1.56.0'
+  VERSION         = '1.57.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/tins/xt/full.rb

@@ -26,6 +26,7 @@ module Tins
     #
     # @param dispatch [Symbol, nil] The method to call on the object (optional)
     # @param args [Array] Arguments to pass to the dispatched method (optional)
+    # @param kwargs [Hash] Keyword arguments to pass to the dispatched method (optional)
     # @yield [Object] Optional block to execute with the result if result or
     # dispatched result not nil
     # @return [Object, nil] The object itself if not blank, or the result of
@@ -43,11 +44,11 @@ module Tins
     #
     # @example With block execution
     #   user.full?(:name) { |name| "Hello #{name}" }
-    def full?(dispatch = nil, *args)
+    def full?(dispatch = nil, *args, **kwargs)
       if blank?
         obj = nil
       elsif dispatch
-        obj = __send__(dispatch, *args)
+        obj = __send__(dispatch, *args, **kwargs)
         obj = nil if obj.blank?
       else
         obj = self

data/tests/ask_and_send_test.rb

@@ -10,11 +10,27 @@ module Tins
         :foo
       end
 
+      def foo_kw(x:)
+        [:foo_kw, x]
+      end
+
+      def foo_args(*args, &block)
+        [:foo_args, args, block&.call]
+      end
+
       private
 
       def bar
         :bar
       end
+
+      def bar_kw(x:)
+        [:bar_kw, x]
+      end
+
+      def bar_args(*args, &block)
+        [:bar_args, args, block&.call]
+      end
     end
 
     def test_asking_publicly
@@ -42,5 +58,51 @@ module Tins
       assert_equal :bar, a.ask_and_send_or_self!(:bar)
       assert_equal a, a.ask_and_send_or_self(:baz)
     end
+
+    def test_asking_publicly_with_kwargs
+      assert_equal [:foo_kw, 42], A.new.ask_and_send(:foo_kw, x: 42)
+      assert_nil A.new.ask_and_send(:bar_kw, x: 42)
+    end
+
+    def test_asking_privately_with_kwargs
+      assert_equal [:foo_kw, 42], A.new.ask_and_send!(:foo_kw, x: 42)
+      assert_equal [:bar_kw, 42], A.new.ask_and_send!(:bar_kw, x: 42)
+    end
+
+    def test_asking_selfy_publicly_with_kwargs
+      a = A.new
+      assert_equal [:foo_kw, 7], a.ask_and_send_or_self(:foo_kw, x: 7)
+      assert_equal a, a.ask_and_send_or_self(:bar_kw, x: 7)
+    end
+
+    def test_asking_selfy_privately_with_kwargs
+      a = A.new
+      assert_equal [:foo_kw, 7], a.ask_and_send_or_self!(:foo_kw, x: 7)
+      assert_equal [:bar_kw, 7], a.ask_and_send_or_self!(:bar_kw, x: 7)
+    end
+
+    def test_asking_publicly_with_args_and_block
+      a = A.new
+      assert_equal [:foo_args, [1, 2], :hello], a.ask_and_send(:foo_args, 1, 2) { :hello }
+      assert_nil a.ask_and_send(:bar_args, 1, 2) { :hello }
+    end
+
+    def test_asking_privately_with_args_and_block
+      a = A.new
+      assert_equal [:foo_args, [1, 2], :hello], a.ask_and_send!(:foo_args, 1, 2) { :hello }
+      assert_equal [:bar_args, [3, 4], :world], a.ask_and_send!(:bar_args, 3, 4) { :world }
+    end
+
+    def test_asking_selfy_publicly_with_args_and_block
+      a = A.new
+      assert_equal [:foo_args, [1], :ok], a.ask_and_send_or_self(:foo_args, 1) { :ok }
+      assert_equal a, a.ask_and_send_or_self(:bar_args, 1) { :ok }
+    end
+
+    def test_asking_selfy_privately_with_args_and_block
+      a = A.new
+      assert_equal [:foo_args, [1], :ok], a.ask_and_send_or_self!(:foo_args, 1) { :ok }
+      assert_equal [:bar_args, [2], :ok], a.ask_and_send_or_self!(:bar_args, 2) { :ok }
+    end
   end
 end

data/tests/blank_full_test.rb

@@ -58,6 +58,15 @@ module Tins
       assert_equal 3, "foo".full?(:size)
     end
 
+    def test_full_with_kwargs
+      obj = Object.new
+      def obj.greet(name:)
+        "hello #{name}"
+      end
+      assert_equal 'hello world', obj.full?(:greet, name: 'world')
+      assert_nil ''.full?(:greet, name: 'world')
+    end
+
     def test_all_full
       assert_equal [1, 2], [1, 2].all_full?
       assert_nil [nil, 2].all_full?

data/tests/expose_test.rb

@@ -13,6 +13,16 @@ module Tins
         :prot
       end
       protected :prot
+
+      def with_kw(x:)
+        [:with_kw, x]
+      end
+      private :with_kw
+
+      def with_block
+        yield :from_block
+      end
+      private :with_block
     end
 
     def setup
@@ -39,5 +49,17 @@ module Tins
       assert_equal :priv, @a.expose(:priv)
       assert_equal :prot, @a.expose(:prot, :any)
     end
+
+    def test_exposes_method_with_kwargs
+      assert_equal [:with_kw, 42], @a.expose(:with_kw, x: 42)
+    end
+
+    def test_exposes_method_with_block
+      assert_equal :from_block, @a.expose(:with_block) { |v| v }
+    end
+
+    def test_exposes_method_with_kwargs_and_block
+      assert_equal [:with_kw, 7], @a.expose(:with_kw, x: 7) { :ignored }
+    end
   end
 end

data/tins.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: tins 1.56.0 ruby lib
+# stub: tins 1.57.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "tins".freeze
-  s.version = "1.56.0".freeze
+  s.version = "1.57.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -23,7 +23,7 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.17.1".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.18.0".freeze])
   s.add_development_dependency(%q<all_images>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tins
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.57.0
 platform: ruby
 authors:
 - Florian Frank
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.17.1
+        version: 2.18.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.17.1
+        version: 2.18.0
 - !ruby/object:Gem::Dependency
   name: all_images
   requirement: !ruby/object:Gem::Requirement