snapshot of https://github.com/espocrm/espocrm.git (master, 2026-09-18; blobs > 131072B omitted)

tests/unit/Espo/ORM/Query/Part/ExpressionTest.php

@@ -0,0 +1,450 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace tests\unit\Espo\ORM\Query\Part;
+
+use Espo\ORM\Query\Part\Expression as Expr;
+
+use RuntimeException;
+
+class ExpressionTest extends \PHPUnit\Framework\TestCase
+{
+    protected function setUp(): void
+    {
+    }
+
+    public function testAlias1(): void
+    {
+        $actual = Expr::alias('test')->getValue();
+
+        $expected = '#test';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testAlias2(): void
+    {
+        $actual = Expr::alias('test.someAlias')->getValue();
+
+        $expected = 'test.#someAlias';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testColumn1(): void
+    {
+        $actual = Expr::column('test')->getValue();
+
+        $expected = 'test';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testColumn2(): void
+    {
+        $actual = Expr::column('alias.test')->getValue();
+
+        $expected = 'alias.test';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testColumn3(): void
+    {
+        $actual = Expr::column('@alias1.test')->getValue();
+
+        $expected = '@alias1.test';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testColumn4(): void
+    {
+        $this->expectException(RuntimeException::class);
+
+        Expr::column('@alias@test');
+    }
+
+    public function testColumn5(): void
+    {
+        $this->expectException(RuntimeException::class);
+
+        Expr::column('^test');
+    }
+
+    public function testValue1(): void
+    {
+        $actual = Expr::value('"test"')->getValue();
+
+        $expected = "'" . '"test"' . "'";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue2(): void
+    {
+        $actual = Expr::value("'test'")->getValue();
+
+        $expected = "'" . "\\'test\\'" . "'";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue3(): void
+    {
+        $actual = Expr::value(10)->getValue();
+
+        $expected = '10';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue4(): void
+    {
+        $actual = Expr::value(10.5)->getValue();
+
+        $expected = '10.5';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue6(): void
+    {
+        $actual = Expr::value(true)->getValue();
+
+        $expected = 'TRUE';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue7(): void
+    {
+        $actual = Expr::value(false)->getValue();
+
+        $expected = 'FALSE';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testValue8(): void
+    {
+        $actual = Expr::value(null)->getValue();
+
+        $expected = 'NULL';
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testFuncIf1(): void
+    {
+        $actual = Expr::if(
+            Expr::column('test'),
+            '1',
+            2
+        )->getValue();
+
+        $expected = "IF:(test, '1', 2)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testFuncIf2(): void
+    {
+        $actual = Expr::if(
+            Expr::column('test'),
+            Expr::column('hello.man'),
+            true
+        )->getValue();
+
+        $expected = "IF:(test, hello.man, TRUE)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testFuncLike(): void
+    {
+        $actual = Expr::like(
+            Expr::column('test'),
+            'test%'
+        )->getValue();
+
+        $expected = "LIKE:(test, 'test%')";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testFuncEqual(): void
+    {
+        $actual = Expr::equal(
+            Expr::column('test'),
+            1
+        )->getValue();
+
+        $expected = "EQUAL:(test, 1)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testFuncNotEqual(): void
+    {
+        $actual = Expr::notEqual(
+            Expr::column('test'),
+            1
+        )->getValue();
+
+        $expected = "NOT_EQUAL:(test, 1)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testIn(): void
+    {
+        $actual = Expr::in(
+            Expr::column('test'),
+            [
+                Expr::value(1),
+                2
+            ]
+        )->getValue();
+
+        $expected = "IN:(test, 1, 2)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testCoalesce(): void
+    {
+        $actual = Expr::coalesce(
+            Expr::column('test1'),
+            Expr::column('test2')
+        )->getValue();
+
+        $expected = "COALESCE:(test1, test2)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testIfNull(): void
+    {
+        $actual = Expr::ifNull(
+            Expr::column('test1'),
+            ''
+        )->getValue();
+
+        $expected = "IFNULL:(test1, '')";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testMonth(): void
+    {
+        $actual = Expr::month(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "MONTH_NUMBER:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testWeek0(): void
+    {
+        $actual = Expr::week(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "WEEK_NUMBER:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testWeek1(): void
+    {
+        $actual = Expr::week(
+            Expr::column('test'),
+            1
+        )->getValue();
+
+        $expected = "WEEK_NUMBER_1:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testDayOfWeek(): void
+    {
+        $actual = Expr::dayOfWeek(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "DAYOFWEEK:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testDayOfMonth(): void
+    {
+        $actual = Expr::dayOfMonth(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "DAYOFMONTH:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testYear(): void
+    {
+        $actual = Expr::year(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "YEAR:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testYearFiscsal(): void
+    {
+        $actual = Expr::yearFiscal(
+            Expr::column('test'),
+            10
+        )->getValue();
+
+        $expected = "YEAR_10:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testNow(): void
+    {
+        $actual = Expr::now(
+        )->getValue();
+
+        $expected = "NOW:()";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testConvertTimezone(): void
+    {
+        $actual = Expr::convertTimezone(
+            Expr::column('test'),
+            -10.5
+        )->getValue();
+
+        $expected = "TZ:(test, -10.5)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testConcat(): void
+    {
+        $actual = Expr::concat(
+            Expr::column('test'),
+            ' ',
+            'test'
+        )->getValue();
+
+        $expected = "CONCAT:(test, ' ', 'test')";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testReplace(): void
+    {
+        $actual = Expr::replace(
+            Expr::column('test'),
+            'test',
+            'hello'
+        )->getValue();
+
+        $expected = "REPLACE:(test, 'test', 'hello')";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testAdd(): void
+    {
+        $actual = Expr::add(
+            Expr::column('test'),
+            1
+        )->getValue();
+
+        $expected = "ADD:(test, 1)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testRound(): void
+    {
+        $actual = Expr::round(
+            Expr::column('test'),
+            1
+        )->getValue();
+
+        $expected = "ROUND:(test, 1)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testAnd(): void
+    {
+        $actual = Expr::and(
+            Expr::column('test1'),
+            Expr::column('test2')
+        )->getValue();
+
+        $expected = "AND:(test1, test2)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testOr(): void
+    {
+        $actual = Expr::or(
+            Expr::column('test1'),
+            Expr::column('test2')
+        )->getValue();
+
+        $expected = "OR:(test1, test2)";
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testNot(): void
+    {
+        $actual = Expr::not(
+            Expr::column('test')
+        )->getValue();
+
+        $expected = "NOT:(test)";
+
+        $this->assertEquals($expected, $actual);
+    }
+}