✨ add ability to reset the current query #31

Author: devmoath

src/Jql.php

@@ -95,6 +95,13 @@ public function rawQuery(string $query): self
         return $this;
     }
 
+    public function reset(): self
+    {
+        $this->query = '';
+
+        return $this;
+    }
+
     public function getQuery(): string
     {
         return trim($this->query);
@@ -147,27 +154,23 @@ private function appendQuery(string $query, string $boolean = ''): void
     }
 
     /**
-     * @throws \InvalidArgumentException
+     * @throws InvalidArgumentException
      */
     private function invalidBooleanOrOperator(string $boolean, string $operator, mixed $value): void
     {
-        if (! in_array($boolean, [Keyword::AND, Keyword::OR], true)) {
+        if (! in_array($boolean, Keyword::booleans(), true)) {
             throw new InvalidArgumentException(sprintf(
                 'Illegal boolean [%s] value. only [%s, %s] is acceptable',
                 $boolean,
-                Keyword::AND,
-                Keyword::OR
+                ...Keyword::booleans(),
             ));
         }
 
-        if (! in_array($operator, [Operator::IN, Operator::NOT_IN, Operator::WAS_IN, Operator::WAS_NOT_IN], true) && is_array($value)) {
+        if (is_array($value) && ! in_array($operator, Operator::acceptList(), true)) {
             throw new InvalidArgumentException(sprintf(
                 'Illegal operator [%s] value. only [%s, %s, %s, %s] is acceptable when $value type is array',
                 $operator,
-                Operator::IN,
-                Operator::NOT_IN,
-                Operator::WAS_IN,
-                Operator::WAS_NOT_IN,
+                ...Operator::acceptList(),
             ));
         }
     }

src/Keyword.php

@@ -18,4 +18,15 @@ final class Keyword
     public const NULL = 'null';
 
     public const ORDER_BY = 'order by';
+
+    /**
+     * @return string[]
+     */
+    public static function booleans(): array
+    {
+        return [
+            self::AND,
+            self::OR,
+        ];
+    }
 }

src/Operator.php

@@ -40,4 +40,17 @@ final class Operator
     public const WAS_NOT = 'was not';
 
     public const CHANGED = 'changed';
+
+    /**
+     * @return string[]
+     */
+    public static function acceptList(): array
+    {
+        return [
+            self::IN,
+            self::NOT_IN,
+            self::WAS_IN,
+            self::WAS_NOT_IN,
+        ];
+    }
 }

tests/Jql.php

@@ -114,3 +114,15 @@
 it('will throw exception when invalid operator passed', function () {
     (new Jql())->where('project', '=', ['MY PROJECT']);
 })->throws(InvalidArgumentException::class, 'Illegal operator [=] value. only [in, not in, was in, was not in] is acceptable when $value type is array');
+
+it('can reset the current query', function () {
+    $query = new Jql();
+
+    $query->where('project', 'name');
+
+    expect($query)->getQuery()->toBe('project = "name"');
+
+    $query->reset();
+
+    expect($query)->getQuery()->toBeEmpty();
+});