cmdx 1.7.0 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8483d78b67a6dfffa6721b39e623ac08d57d443b499287891bfb9c6e06422c89
-  data.tar.gz: 02cb722299d6a97fb4e2d07a84880c7374a8c17b691f42bee995bd4f3ea698ab
+  metadata.gz: 9bbf1d8db7665b82da9af2dd5e017977945bbd550700177368b1363a8e63275e
+  data.tar.gz: 0f1720432a999ff31399d67c602e5277ee8cb1a8062117165c425a39233eb81c
 SHA512:
-  metadata.gz: b6600b6d617c11a3ec3b66367a7fa309e191bd2d1f20a3fb1a538565a0c2b45e05f8093f2c3e07edbb155e308e6c90c486f069db171aac68e8658bbe85bd4b34
-  data.tar.gz: 6ad4a1348066d3aa4d0ed2733fc88f94af293835cc970be5986f3c002cf3b3615f474bff774a2b48f7e043920ca01b5f278cd26850b5b4827a70d2a4b0e6ab50
+  metadata.gz: 144c01abf663258e34b40eaa9e1deba09b59347b97773237f9bd84f5d82474825aca38f21b6ad0c052f1b058f6a5550e24ef8f3598da4cdecad94da1689bea5c
+  data.tar.gz: 25220966f85607b73740107b5af5da7889e75592055ad17156bc48f157550e2d030f542b7f279ec731cbb78ef732be1c6507b8e448a97a8324749d4746549d95

data/CHANGELOG.md

@@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [TODO]
 
+## [1.7.1] - 2025-08-26
+
+### Added
+- Yield result if block given to `execute` and `execute!` methods
+
 ## [1.7.0] - 2025-08-25
 
 ### Added

data/LLM.md

@@ -1251,6 +1251,22 @@ result.index #=> 0 (first task in chain)
 result.chain.results[result.index] == result #=> true
 ```
 
+## Block Yield
+
+Implement conditional logic using a block expression that yields a result for complete encapsulation.
+
+```ruby
+BuildApplication.execute(version: "1.2.3") do |result|
+  if result.success?
+    notify_deployment_ready(result)
+  elsif result.failed?
+    handle_build_failure(result)
+  else
+    log_skip_reason(result)
+  end
+end
+```
+
 ## Handlers
 
 Use result handlers for clean, functional-style conditional logic. Handlers return the result object, enabling method chaining and fluent interfaces.

data/docs/outcomes/result.md

@@ -9,6 +9,7 @@ The result object is the comprehensive return value of task execution, providing
 - [Outcome Analysis](#outcome-analysis)
 - [Chain Analysis](#chain-analysis)
 - [Index and Position](#index-and-position)
+- [Block Yield](#block-yield)
 - [Handlers](#handlers)
 - [Pattern Matching](#pattern-matching)
   - [Array Pattern](#array-pattern)
@@ -113,6 +114,22 @@ result.index #=> 0 (first task in chain)
 result.chain.results[result.index] == result #=> true
 ```
 
+## Block Yield
+
+Implement conditional logic using a block expression that yields a result for complete encapsulation.
+
+```ruby
+BuildApplication.execute(version: "1.2.3") do |result|
+  if result.success?
+    notify_deployment_ready(result)
+  elsif result.failed?
+    handle_build_failure(result)
+  else
+    log_skip_reason(result)
+  end
+end
+```
+
 ## Handlers
 
 Use result handlers for clean, functional-style conditional logic. Handlers return the result object, enabling method chaining and fluent interfaces.

data/lib/cmdx/task.rb

@@ -169,10 +169,10 @@ module CMDx
       #   if result.success?
       #     puts "Task completed successfully"
       #   end
-      def execute(...)
-        task = new(...)
+      def execute(*args, **kwargs)
+        task = new(*args, **kwargs)
         task.execute(raise: false)
-        task.result
+        block_given? ? yield(task.result) : task.result
       end
 
       # @param args [Array] Arguments to pass to the task constructor
@@ -184,10 +184,10 @@ module CMDx
       # @example
       #   result = MyTask.execute!(name: "example")
       #   # Will raise an exception if execution fails
-      def execute!(...)
-        task = new(...)
+      def execute!(*args, **kwargs)
+        task = new(*args, **kwargs)
         task.execute(raise: true)
-        task.result
+        block_given? ? yield(task.result) : task.result
       end
 
     end
@@ -201,6 +201,7 @@ module CMDx
     #   result = task.execute(raise: true)
     def execute(raise: false)
       Executor.execute(self, raise:)
+      block_given? ? yield(result) : result
     end
 
     # @raise [UndefinedMethodError] Always raised as this method must be overridden

data/lib/cmdx/version.rb

@@ -2,6 +2,6 @@
 
 module CMDx
 
-  VERSION = "1.7.0"
+  VERSION = "1.7.1"
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.7.1
 platform: ruby
 authors:
 - Juan Gomez