Added and/or/andNot/orNot to ScalarFunctionsChain (#1378)

Author: norberttech

src/core/etl/src/Flow/ETL/Function/All.php

@@ -6,22 +6,32 @@
 
 use Flow\ETL\Row;
 
-final class All extends ScalarFunctionChain implements CompositeScalarFunction
+final readonly class All implements ScalarFunction
 {
     /**
      * @var array<ScalarFunction>
      */
-    private readonly array $refs;
+    private array $functions;
 
     public function __construct(
-        ScalarFunction ...$refs,
+        ScalarFunction ...$functions,
     ) {
-        $this->refs = $refs;
+        $this->functions = $functions;
+    }
+
+    public function and(ScalarFunction $scalarFunction) : self
+    {
+        return new self(...$this->functions, ...[$scalarFunction]);
+    }
+
+    public function andNot(ScalarFunction $scalarFunction) : self
+    {
+        return new self(...$this->functions, ...[new Not($scalarFunction)]);
     }
 
     public function eval(Row $row) : mixed
     {
-        foreach ($this->refs as $ref) {
+        foreach ($this->functions as $ref) {
             if (!$ref->eval($row)) {
                 return false;
             }
@@ -30,8 +40,13 @@ public function eval(Row $row) : mixed
         return true;
     }
 
-    public function functions() : array
+    public function or(ScalarFunction $scalarFunction) : Any
+    {
+        return new Any(...$this->functions, ...[$scalarFunction]);
+    }
+
+    public function orNot(ScalarFunction $scalarFunction) : Any
     {
-        return $this->refs;
+        return new Any(...$this->functions, ...[new Not($scalarFunction)]);
     }
 }

src/core/etl/src/Flow/ETL/Function/Any.php

@@ -6,22 +6,32 @@
 
 use Flow\ETL\Row;
 
-final class Any extends ScalarFunctionChain implements CompositeScalarFunction
+final readonly class Any implements ScalarFunction
 {
     /**
      * @var array<ScalarFunction>
      */
-    private readonly array $refs;
+    private array $functions;
 
     public function __construct(
-        ScalarFunction ...$values,
+        ScalarFunction ...$functions,
     ) {
-        $this->refs = $values;
+        $this->functions = $functions;
+    }
+
+    public function and(ScalarFunction $scalarFunction) : All
+    {
+        return new All(...$this->functions, ...[$scalarFunction]);
+    }
+
+    public function andNot(ScalarFunction $scalarFunction) : All
+    {
+        return new All(...$this->functions, ...[new Not($scalarFunction)]);
     }
 
     public function eval(Row $row) : mixed
     {
-        foreach ($this->refs as $ref) {
+        foreach ($this->functions as $ref) {
             if ($ref->eval($row)) {
                 return true;
             }
@@ -30,11 +40,13 @@ public function eval(Row $row) : mixed
         return false;
     }
 
-    /**
-     * @return array<ScalarFunction>
-     */
-    public function functions() : array
+    public function or(ScalarFunction $scalarFunction) : self
+    {
+        return new self(...$this->functions, ...[$scalarFunction]);
+    }
+
+    public function orNot(ScalarFunction $scalarFunction) : self
     {
-        return $this->refs;
+        return new self(...$this->functions, ...[new Not($scalarFunction)]);
     }
 }

src/core/etl/src/Flow/ETL/Function/CompositeScalarFunction.php

@@ -15,6 +15,16 @@
 
 abstract class ScalarFunctionChain implements ScalarFunction
 {
+    public function and(ScalarFunction $function) : All
+    {
+        return new All($this, $function);
+    }
+
+    public function andNot(ScalarFunction $function) : All
+    {
+        return new All($this, new Not($function));
+    }
+
     public function arrayGet(ScalarFunction|string $path) : self
     {
         return new ArrayGet($this, $path);
@@ -319,6 +329,16 @@ public function onEach(ScalarFunction $function, ScalarFunction|bool $preserveKe
         return new OnEach($this, $function, $preserveKeys);
     }
 
+    public function or(ScalarFunction $function) : Any
+    {
+        return new Any($this, $function);
+    }
+
+    public function orNot(ScalarFunction $function) : Any
+    {
+        return new Any($this, new Not($function));
+    }
+
     public function plus(ScalarFunction|int|float $ref) : self
     {
         return new Plus($this, $ref);

src/core/etl/src/Flow/ETL/Function/ScalarFunctionChain.php

@@ -4,7 +4,7 @@
 
 namespace Flow\ETL\Tests\Integration\Function;
 
-use function Flow\ETL\DSL\{all, from_array, lit, ref, to_memory, when};
+use function Flow\ETL\DSL\{from_array, lit, ref, to_memory, when};
 use Flow\ETL\Flow;
 use Flow\ETL\Memory\ArrayMemory;
 use Flow\ETL\Tests\FlowTestCase;
@@ -27,7 +27,7 @@ public function test_all_cases_found() : void
             ->withEntry(
                 'result',
                 when(
-                    all(ref('id')->isEven(), ref('array')->exists()),
+                    ref('id')->isEven()->and(ref('array')->exists()),
                     lit('found'),
                     lit('not found')
                 )

src/core/etl/tests/Flow/ETL/Tests/Integration/Function/AllTest.php

@@ -4,7 +4,7 @@
 
 namespace Flow\ETL\Tests\Integration\Function;
 
-use function Flow\ETL\DSL\{any, from_array, lit, ref, to_memory, when};
+use function Flow\ETL\DSL\{from_array, lit, ref, to_memory, when};
 use Flow\ETL\Flow;
 use Flow\ETL\Memory\ArrayMemory;
 use Flow\ETL\Tests\FlowTestCase;
@@ -27,7 +27,7 @@ public function test_any_case_found() : void
             ->withEntry(
                 'result',
                 when(
-                    any(ref('id')->isEven(), ref('array')->exists()),
+                    ref('id')->isEven()->or(ref('array')->exists()),
                     lit('found'),
                     lit('not found')
                 )

src/core/etl/tests/Flow/ETL/Tests/Integration/Function/AnyTest.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Flow\ETL\Tests\Unit\Function;
+
+use function Flow\ETL\DSL\{int_entry, lit, ref, row};
+use Flow\ETL\Tests\FlowTestCase;
+
+final class LogicalFunctionsTest extends FlowTestCase
+{
+    public function test_logical_operations() : void
+    {
+        self::assertFalse(ref('id')->isEven()->andNot(ref('id')->equals(lit(1)))->eval(row(int_entry('id', 1))));
+        self::assertTrue(ref('id')->isOdd()->and(ref('id')->equals(lit(1)))->eval(row(int_entry('id', 1))));
+        self::assertTrue(ref('id')->isEven()->or(ref('id')->equals(lit(1)))->eval(row(int_entry('id', 1))));
+        self::assertFalse(ref('id')->isOdd()->andNot(ref('id')->equals(lit(1)))->eval(row(int_entry('id', 1))));
+    }
+}