Release 0.3.0

Author: othercodes

.github/workflows/test.yml

@@ -11,7 +11,8 @@ jobs:
     strategy:
       matrix:
         php-version:
-          - "7.4"
+          - 7.4
+          - 8.0
 
     steps:
       - name: Checkout source code
@@ -22,7 +23,7 @@ jobs:
         with:
           php-version: ${{ matrix.php-version }}
           extensions: mbstring
-          coverage: xdebug
+          coverage: pcov
           tools: composer:v2
 
       - name: Cache dependencies

composer.json

@@ -19,7 +19,6 @@
     "spatie/data-transfer-object": "^2.6"
   },
   "require-dev": {
-    "ext-xdebug": "*",
     "mockery/mockery": "^1.4",
     "phpunit/phpunit": "^9.3",
     "fakerphp/faker": "^1.9.1",

src/Application/CriteriaBuilder.php

@@ -0,0 +1,223 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OtherCode\ComplexHeart\Application;
+
+use OtherCode\ComplexHeart\Domain\Criteria\Criteria;
+use OtherCode\ComplexHeart\Domain\Criteria\Filter;
+use OtherCode\ComplexHeart\Domain\Criteria\FilterGroup;
+use OtherCode\ComplexHeart\Domain\Criteria\Order;
+use OtherCode\ComplexHeart\Domain\Criteria\Page;
+
+/**
+ * Class CriteriaBuilder
+ *
+ * @author Unay Santisteban <[email protected]>
+ * @package OtherCode\ComplexHeart\Application
+ */
+final class CriteriaBuilder
+{
+    private array $filters = [];
+
+    private string $orderBy = '';
+
+    private string $orderType = 'asc';
+
+    private int $pageOffset = 0;
+
+    private int $pageLimit = 1000;
+
+    /**
+     * Adds an arbitrary filter.
+     *
+     * @param  string  $field
+     * @param  string  $operator
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filter(string $field, string $operator, $value): self
+    {
+        $this->filters[] = [$field, $operator, $value];
+        return $this;
+    }
+
+    /**
+     * Adds new filter for equals operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterEqual(string $field, $value): self
+    {
+        $this->filter($field, Filter::EQUAL, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for not equals operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterNotEqual(string $field, $value): self
+    {
+        $this->filter($field, Filter::NOT_EQUAL, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for greater than operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterGreaterThan(string $field, $value): self
+    {
+        $this->filter($field, Filter::GT, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for greater or equal than operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterGreaterOrEqualThan(string $field, $value): self
+    {
+        $this->filter($field, Filter::GTE, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for less than operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterLessThan(string $field, $value): self
+    {
+        $this->filter($field, Filter::LT, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for less or equal than operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterLessOrEqualThan(string $field, $value): self
+    {
+        $this->filter($field, Filter::LTE, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for in operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterIn(string $field, $value): self
+    {
+        $this->filter($field, Filter::IN, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for not in operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterNotIn(string $field, $value): self
+    {
+        $this->filter($field, Filter::NOT_IN, $value);
+        return $this;
+    }
+
+    /**
+     * Adds new filter for like operator.
+     *
+     * @param  string  $field
+     * @param  mixed  $value
+     * @return $this
+     */
+    public function filterLike(string $field, $value): self
+    {
+        $this->filter($field, Filter::LIKE, $value);
+        return $this;
+    }
+
+    /**
+     * Sets the order by field parameter.
+     *
+     * @param  string  $field
+     * @return $this
+     */
+    public function orderedBy(string $field): self
+    {
+        $this->orderBy = $field;
+        return $this;
+    }
+
+    /**
+     * Sets the order type parameter.
+     *
+     * @param  string  $type
+     * @return $this
+     */
+    public function orderedType(string $type): self
+    {
+        $this->orderType = $type;
+        return $this;
+    }
+
+    /**
+     * Set the page limit parameter.
+     *
+     * @param  int  $limit
+     * @return $this
+     */
+    public function withLimit(int $limit): self
+    {
+        $this->pageLimit = $limit;
+        return $this;
+    }
+
+    /**
+     * Set the page offset parameter.
+     *
+     * @param  int  $offset
+     * @return $this
+     */
+    public function withOffset(int $offset): self
+    {
+        $this->pageOffset = $offset;
+        return $this;
+    }
+
+    /**
+     * Builds the Criteria object.
+     *
+     * @return Criteria
+     */
+    public function build(): Criteria
+    {
+        return new Criteria(
+            FilterGroup::create($this->filters),
+            Order::create($this->orderBy, $this->orderType),
+            Page::create($this->pageLimit, $this->pageOffset)
+        );
+    }
+}

src/Domain/Criteria/FilterGroup.php

@@ -42,7 +42,7 @@ public static function create(array $filters): FilterGroup
 
     public function add(Filter $filter): FilterGroup
     {
-        return new self(array_merge($this->filters, [$filter]));
+        return new self(...array_merge($this->filters, [$filter]));
     }
 
     public function filters(): array

src/Domain/Exceptions/ImmutableException.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OtherCode\ComplexHeart\Domain\Exceptions;
+
+use RuntimeException;
+
+/**
+ * Class ImmutableException
+ *
+ * @author Unay Santisteban <[email protected]>
+ * @package OtherCode\ComplexHeart\Domain\Exceptions
+ */
+class ImmutableException extends RuntimeException
+{
+
+}