is null / is not null comparisons

Author: tpetry

README.md

@@ -227,7 +227,8 @@ User::where(new BitAnd('acl', new Value(0x8000)), 0x8000)
 ```php
 use Illuminate\Contracts\Database\Query\Expression;
 use Tpetry\QueryExpressions\Operator\Comparison\{
-    Between, DistinctFrom, Equal, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, NotDistinctFrom, NotEqual
+    Between, DistinctFrom, Equal, IsNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual,
+    NotDistinctFrom, NotEqual, NotIsNull
 };
 use Tpetry\QueryExpressions\Function\Comparison\{
     StrListContains
@@ -239,12 +240,15 @@ use Tpetry\QueryExpressions\Operator\Logical\{
 new Between(string|Expression $value, string|Expression $min, string|Expression $max);
 new DistinctFrom(string|Expression $value1, string|Expression $value2);
 new Equal(string|Expression $value1, string|Expression $value2);
+new IsNull(string|Expression $value);
 new GreaterThan(string|Expression $value1, string|Expression $value2);
 new GreaterThanOrEqual(string|Expression $value1, string|Expression $value2);
 new LessThan(string|Expression $value1, string|Expression $value2);
 new LessThanOrEqual(string|Expression $value1, string|Expression $value2);
 new NotDistinctFrom(string|Expression $value1, string|Expression $value2);
 new NotEqual(string|Expression $value1, string|Expression $value2);
+new NotIsNull(string|Expression $value);
+
 
 new StrListContains(string|Expression $strList, string|Expression $str);
 

src/Operator/Comparison/IsNull.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tpetry\QueryExpressions\Operator\Comparison;
+
+use Illuminate\Contracts\Database\Query\ConditionExpression;
+use Illuminate\Contracts\Database\Query\Expression;
+use Illuminate\Database\Grammar;
+use Tpetry\QueryExpressions\Concerns\StringizeExpression;
+
+class IsNull implements ConditionExpression
+{
+    use StringizeExpression;
+
+    public function __construct(
+        private readonly string|Expression $value,
+
+    ) {
+    }
+
+    public function getValue(Grammar $grammar)
+    {
+        $value = $this->stringize($grammar, $this->value);
+
+        return "({$value} is null)";
+    }
+}

src/Operator/Comparison/NotIsNull.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tpetry\QueryExpressions\Operator\Comparison;
+
+use Illuminate\Contracts\Database\Query\ConditionExpression;
+use Illuminate\Contracts\Database\Query\Expression;
+use Illuminate\Database\Grammar;
+use Tpetry\QueryExpressions\Concerns\StringizeExpression;
+
+class NotIsNull implements ConditionExpression
+{
+    use StringizeExpression;
+
+    public function __construct(
+        private readonly string|Expression $value,
+
+    ) {
+    }
+
+    public function getValue(Grammar $grammar)
+    {
+        $value = $this->stringize($grammar, $this->value);
+
+        return "({$value} is not null)";
+    }
+}

tests/Operator/Comparison/IsNullTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Query\Expression;
+use Illuminate\Database\Schema\Blueprint;
+use Tpetry\QueryExpressions\Operator\Comparison\IsNull;
+
+it('can check an expression')
+    ->expect(new IsNull(new Expression(42)))
+    ->toBeExecutable(options: [
+        'sqlsrv' => ['position' => 'where'],
+    ])
+    ->toBeMysql('(42 is null)')
+    ->toBePgsql('(42 is null)')
+    ->toBeSqlite('(42 is null)')
+    ->toBeSqlsrv('(42 is null)');
+
+it('can check a column')
+    ->expect(new IsNull('val'))
+    ->toBeExecutable(function (Blueprint $table) {
+        $table->integer('val');
+    }, options: [
+        'sqlsrv' => ['position' => 'where'],
+    ])
+    ->toBeMysql('(`val` is null)')
+    ->toBePgsql('("val" is null)')
+    ->toBeSqlite('("val" is null)')
+    ->toBeSqlsrv('([val] is null)');

tests/Operator/Comparison/NotIsNullTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Query\Expression;
+use Illuminate\Database\Schema\Blueprint;
+use Tpetry\QueryExpressions\Operator\Comparison\NotIsNull;
+
+it('can check an expression')
+    ->expect(new NotIsNull(new Expression(42)))
+    ->toBeExecutable(options: [
+        'sqlsrv' => ['position' => 'where'],
+    ])
+    ->toBeMysql('(42 is not null)')
+    ->toBePgsql('(42 is not null)')
+    ->toBeSqlite('(42 is not null)')
+    ->toBeSqlsrv('(42 is not null)');
+
+it('can check a column')
+    ->expect(new NotIsNull('val'))
+    ->toBeExecutable(function (Blueprint $table) {
+        $table->integer('val');
+    }, options: [
+        'sqlsrv' => ['position' => 'where'],
+    ])
+    ->toBeMysql('(`val` is not null)')
+    ->toBePgsql('("val" is not null)')
+    ->toBeSqlite('("val" is not null)')
+    ->toBeSqlsrv('([val] is not null)');