taski 0.9.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cf783b65df1fdbbb8c8f19d78467243ea1d054c1b47097cae24b11d22d30c56
-  data.tar.gz: f5a88d4f88a6babb6e121b93cd22066691563a539c722cd8a3e336258ebfe495
+  metadata.gz: b71f6af24c3542cbbb646bb6c19b15dfb5418c98b0e7799185e0ec260f0ba976
+  data.tar.gz: 31b9ff2f2f6c8b7a872381f7e1ba93ba59174bb3bf060a2294ba067bf2983a4e
 SHA512:
-  metadata.gz: ff7ccc6b57e2ed321a84406e2e8e913aac4ec5d9cf2e6f3d00f28cc9b22bbb6609147d500a3fca1dde7fe37bb921cd8ba00380c9b52962f71ea5e2331bef8e16
-  data.tar.gz: 5978f76dab28ef8cc3f57338a89996e9ba45fce7c897cf7739e7ada9076e5fc0006bb5663a1723c5492140fec8e14f5811100a8325e96dc56ebdf35684aeca0b
+  metadata.gz: 52daee905c66f2330bc9ee00c2ac2a71aeaf95cb2057feb0757588e0dff379010fa0a8e396e5ee0290b45f12fa134b92d6abdcfbaa9a37e57e454e8b231743b8
+  data.tar.gz: 2ffdecd55d9b0c8a6a39299b4f9ff2c13ca5c88952b16535ef6008a765eded237911d711d72f47cb57e58d0d612a743dacb07b3162e2dde075aaba29952e04ad

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-02-19
+
+### Added
+- Accept `args:` keyword parameter in `Task.value` and class accessor methods generated by `exports` ([#185](https://github.com/ahogappa/taski/pull/185))
+
+### Changed
+- Forward `args:` keyword through `TaskExtension` in test helper, removing `mock_args` ([#185](https://github.com/ahogappa/taski/pull/185))
+
 ## [0.9.2] - 2026-02-16
 
 ### Added

data/README.md

@@ -248,8 +248,13 @@ end
 
 # Pass options when running
 DeployTask.run(args: { env: "production", debug: true })
+
+# Args can also be passed to exported class methods
+Config.timeout(args: { env: "test" })
 ```
 
+**Note:** `args:` is only accepted at the top-level call that starts an execution. If `args:` is passed to a dependency access inside a running task (e.g., `DepTask.value(args: {...})`), the args are ignored and a warning is emitted.
+
 Args API (user-defined options):
 - `Taski.args[:key]` - Get option value (nil if not set)
 - `Taski.args.fetch(:key, default)` - Get with default value
@@ -424,8 +429,31 @@ class BuildReportTest < Minitest::Test
 end
 ```
 
+### Passing Args in Tests
+
+Pass `args:` directly to task class methods instead of setting global state:
+
+```ruby
+class DeployTaskTest < Minitest::Test
+  include Taski::TestHelper::Minitest
+
+  def test_deploy_to_staging
+    mock_task(FetchConfig, url: "https://staging.example.com")
+
+    # Pass args directly - no global state needed
+    DeployTask.run(args: { env: "staging", debug: true })
+  end
+
+  def test_exported_value_with_args
+    result = Config.timeout(args: { env: "test" })
+    assert_equal 30, result
+  end
+end
+```
+
 **Key features:**
 - Mock only direct dependencies; indirect dependencies are automatically isolated
+- Pass `args:` directly to `Task.run`, `Task.value`, and exported class methods
 - Verify which dependencies were accessed with `assert_task_accessed` / `refute_task_accessed`
 - Automatic cleanup after each test
 - Supports both Minitest and RSpec

data/lib/taski/task.rb

@@ -178,9 +178,12 @@ module Taski
       def define_class_accessor(method)
         singleton_class.undef_method(method) if singleton_class.method_defined?(method)
 
-        define_singleton_method(method) do
+        define_singleton_method(method) do |args: {}|
           registry = Taski.current_registry
           if registry
+            unless args.empty?
+              warn "Taski: args: passed to #{self}.#{method} is ignored inside an execution context"
+            end
             if Thread.current[:taski_fiber_context]
               start_deps = Thread.current[:taski_start_deps]
               if start_deps&.include?(self)
@@ -208,7 +211,7 @@ module Taski
           else
             # Outside execution - fresh execution (top-level call)
             Taski.send(:with_env, root_task: self) do
-              Taski.send(:with_args, options: {}) do
+              Taski.send(:with_args, options: args) do
                 validate_no_circular_dependencies!
                 fresh_wrapper.get_exported_value(method)
               end

data/lib/taski/test_helper.rb

@@ -26,11 +26,11 @@ module Taski
         super
         original_method = self.method(method)
 
-        define_singleton_method(method) do
+        define_singleton_method(method) do |args: {}|
           mock = MockRegistry.mock_for(self)
           return mock.get_exported_value(method) if mock
 
-          original_method.call
+          original_method.call(args: args)
         end
       end
     end
@@ -98,21 +98,6 @@ module Taski
       end
     end
 
-    # Sets mock args for the duration of the test.
-    # This allows testing code that depends on Taski.args without running full task execution.
-    # Args are automatically cleared when MockRegistry.reset! is called (in test teardown).
-    # @param options [Hash] User-defined options to include in args
-    # @return [Taski::Args] The created args instance
-    #
-    # @example
-    #   mock_args(env: "test", debug: true)
-    #   assert_equal "test", Taski.args[:env]
-    def mock_args(**options)
-      Taski.reset_args!
-      Taski.send(:start_args, options: options)
-      Taski.args
-    end
-
     # Sets mock env for the duration of the test.
     # This allows testing code that depends on Taski.env without running full task execution.
     # Env is automatically cleared when MockRegistry.reset! is called (in test teardown).

data/lib/taski/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Taski
-  VERSION = "0.9.2"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taski
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.10.0
 platform: ruby
 authors:
 - ahogappa