Add “Abs” function (tpetry#21)

Co-authored-by: tpetry <[email protected]>

Author: morloderex

README.md

@@ -253,6 +253,15 @@ BlogArticle::select([
 ->get();
 ```
 
+#### Math
+```php
+use Tpetry\QueryExpressions\Function\Math\{
+    Abs,
+};
+
+new Abs(string|Expression $expression);
+```
+
 #### String
 ```php
 use Tpetry\QueryExpressions\Function\String\{

src/Function/Math/Abs.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tpetry\QueryExpressions\Function\Math;
+
+use Illuminate\Contracts\Database\Query\Expression;
+use Illuminate\Database\Grammar;
+use Tpetry\QueryExpressions\Concerns\IdentifiesDriver;
+use Tpetry\QueryExpressions\Concerns\StringizeExpression;
+
+class Abs implements Expression
+{
+    use IdentifiesDriver;
+    use StringizeExpression;
+
+    public function __construct(
+        private readonly string|Expression $expression,
+    ) {
+    }
+
+    public function getValue(Grammar $grammar): string
+    {
+        $expression = $this->stringize($grammar, $this->expression);
+
+        return match ($this->identify($grammar)) {
+            'mysql', 'sqlite' => "(abs({$expression}))",
+            'pgsql', 'sqlsrv' => "abs({$expression})",
+        };
+    }
+}

tests/Function/Math/AbsTest.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Query\Expression;
+use Illuminate\Database\Schema\Blueprint;
+use Tpetry\QueryExpressions\Function\Math\Abs;
+
+it('can abs a column')
+    ->expect(new Abs('val'))
+    ->toBeExecutable(function (Blueprint $table) {
+        $table->integer('val');
+    })
+    ->toBeMysql('(abs(`val`))')
+    ->toBePgsql('abs("val")')
+    ->toBeSqlite('(abs("val"))')
+    ->toBeSqlsrv('abs([val])');
+
+it('can abs an expression')
+    ->expect(new Abs(new Expression('sum(1)')))
+    ->toBeExecutable()
+    ->toBeMysql('(abs(sum(1)))')
+    ->toBePgsql('abs(sum(1))')
+    ->toBeSqlite('(abs(sum(1)))')
+    ->toBeSqlsrv('abs(sum(1))');