introducing ability to ignore helpers at runtime

Author: devajmeireles

src/Concerns/UsingThen.php

@@ -14,7 +14,7 @@ trait UsingThen
      *
      * @var array<int, string>
      */
-    private array $then = [];
+    private ?array $then = [];
 
     /**
      * Register a "then" hook.

src/FractionBuilder.php

@@ -45,6 +45,8 @@ public function __construct(
      */
     public function __invoke(...$arguments): mixed
     {
+        $arguments = $this->ignores($arguments);
+
         if ($this->queued !== null && $this->deferred !== null) {
             throw new PreventDeferQueueSameTime($this->action);
         }
@@ -68,7 +70,7 @@ public function __invoke(...$arguments): mixed
             }
         }
 
-        $result = $interpreter->then($this->then)->handle($this->application);
+        $result = $interpreter->then($this->then ?? [])->handle($this->application);
 
         if ($this->logged !== null) {
             $this->application->make('log')
@@ -112,4 +114,27 @@ private function configuration(): array
 
         return [false, []];
     }
+
+    /**
+     * Determines if helpers usage should be ignored.
+     */
+    private function ignores(array $arguments = []): array
+    {
+        if ($arguments === []) {
+            return $arguments;
+        }
+
+        $helpers = ['queued', 'deferred', 'rescued', 'logged', 'then'];
+        $unset   = array_intersect($helpers, array_keys($arguments));
+
+        foreach ($unset as $helper) {
+            if ($arguments[$helper] === false) {
+                $this->{$helper} = null;
+            }
+
+            unset($arguments[$helper]);
+        }
+
+        return $arguments;
+    }
 }

tests/Feature/Execution/AsDeferTest.php

@@ -36,3 +36,13 @@
 
     expect($test)->toBeTrue();
 });
+
+test('ignoring defer', function () {
+    execute('one', function () {
+        __output('cancelled');
+    })->deferred();
+
+    run('one', deferred: false);
+
+    expect(__exists('cancelled'))->toBeTrue();
+});

tests/Feature/Execution/AsQueueTest.php

@@ -60,3 +60,13 @@
 
     expect(__exists('two'))->toBeTrue();
 });
+
+test('ignoring queue', function () {
+    execute('one', function () {
+        __output('cancelled');
+    })->queued();
+
+    run('one', queued: false);
+
+    expect(__exists('cancelled'))->toBeTrue();
+});

tests/Feature/Execution/AsSyncTest.php

@@ -137,6 +137,14 @@
     expect($test)->toBeNull();
 });
 
+test('ignoring rescued', function () {
+    execute('one', function () {
+        throw new Exception('foo');
+    })->rescued();
+
+    run('one', rescued: false);
+})->throws(Exception::class, 'foo');
+
 test('call logged', function () {
     LogFake::bind();
 
@@ -155,6 +163,20 @@
     );
 });
 
+test('ignoring logged', function () {
+    LogFake::bind();
+
+    execute('one', function () {
+        __output('cancelled');
+    })->logged();
+
+    run('one', logged: false);
+
+    Log::assertNotLogged(fn (LogEntry $log) => $log->level === 'info'
+        && $log->message === '[Laravel] Action: [one] executed.'
+    );
+});
+
 test('call rescued using default value', function () {
     execute('one', function () {
         throw new Exception('foo');