pdo-document/tests/unit/FieldTest.php

<?php
/**
 * @author Daniel J. Summers <daniel@bitbadger.solutions>
 * @license MIT
 */

declare(strict_types=1);

namespace Test\Unit;

use BitBadger\PDODocument\{Configuration, Field, Mode, Op};
use PHPUnit\Framework\Attributes\TestDox;
use PHPUnit\Framework\TestCase;

/**
 * Unit tests for the Field class
 */
#[TestDox('Field (Unit tests)')]
class FieldTest extends TestCase
{
    #[TestDox('appendParameter() succeeds for exists')]
    public function testAppendParameterSucceedsForExists(): void
    {
        $this->assertEquals([], Field::exists('exists')->appendParameter([]),
            'exists should not have appended a parameter');
    }

    #[TestDox('appendParameter() succeeds for notExists')]
    public function testAppendParameterSucceedsForNotExists(): void
    {
        $this->assertEquals([], Field::notExists('absent')->appendParameter([]),
            'notExists should not have appended a parameter');
    }

    #[TestDox('appendParameter() succeeds for between')]
    public function testAppendParameterSucceedsForBetween(): void
    {
        $this->assertEquals(['@nummin' => 5, '@nummax' => 9],
            Field::between('exists', 5, 9, '@num')->appendParameter([]),
            'Between should have appended min and max parameters');
    }

    #[TestDox('appendParameter() succeeds for in')]
    public function testAppendParameterSucceedsForIn(): void
    {
        $this->assertEquals([':val_0' => 'test', ':val_1' => 'unit', ':val_2' => 'great'],
            Field::in('it', ['test', 'unit', 'great'], ':val')->appendParameter([]),
            'In should have appended 3 parameters for the input values');
    }

    #[TestDox('appendParameter() succeeds for inArray for PostgreSQL')]
    public function testAppendParameterSucceedsForInArrayForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals([':bit_0' => '2', ':bit_1' => '8', ':bit_2' => '64'],
                Field::inArray('it', 'table', [2, 8, 64], ':bit')->appendParameter([]),
                'InArray should have appended 3 string parameters for the input values');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('appendParameter() succeeds for inArray for SQLite')]
    public function testAppendParameterSucceedsForInArrayForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals([':bit_0' => 2, ':bit_1' => 8, ':bit_2' => 64],
                Field::inArray('it', 'table', [2, 8, 64], ':bit')->appendParameter([]),
                'InArray should have appended 3 parameters for the input values');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('appendParameter() succeeds for others')]
    public function testAppendParameterSucceedsForOthers(): void
    {
        $this->assertEquals(['@test' => 33], Field::equal('the_field', 33, '@test')->appendParameter([]),
            'Field parameter not returned correctly');
    }

    #[TestDox('path() succeeds for simple SQL path for PostgreSQL')]
    public function testPathSucceedsForSimpleSqlPathForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->>'it'", Field::equal('it', 'that')->path(),
                'SQL value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for simple SQL path for SQLite')]
    public function testPathSucceedsForSimpleSqlPathForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->>'top'", Field::equal('top', 'that')->path(),
                'SQL value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for nested SQL path for PostgreSQL')]
    public function testPathSucceedsForNestedSqlPathForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data#>>'{parts,to,the,path}'", Field::equal('parts.to.the.path', '')->path(),
                'SQL value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for nested SQL path for SQLite')]
    public function testPathSucceedsForNestedSqlPathForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->'one'->'two'->>'three'", Field::equal('one.two.three', '')->path(),
                'SQL value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for simple JSON path for PostgreSQL')]
    public function testPathSucceedsForSimpleJsonPathForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->'it'", Field::equal('it', 'that')->path(true),
                'JSON value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for simple JSON path for SQLite')]
    public function testPathSucceedsForSimpleJsonPathForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->'top'", Field::equal('top', 'that')->path(true),
                'JSON value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for nested JSON path for PostgreSQL')]
    public function testPathSucceedsForNestedJsonPathForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data#>'{parts,to,the,path}'", Field::equal('parts.to.the.path', '')->path(true),
                'JSON value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('path() succeeds for nested JSON path for SQLite')]
    public function testPathSucceedsForNestedJsonPathForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->'one'->'two'->'three'", Field::equal('one.two.three', '')->path(true),
                'SQL value path not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for exists without qualifier for PostgreSQL')]
    public function testToWhereSucceedsForExistsWithoutQualifierForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->>'that_field' IS NOT NULL", Field::exists('that_field')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for exists without qualifier for SQLite')]
    public function testToWhereSucceedsForExistsWithoutQualifierForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->>'that_field' IS NOT NULL", Field::exists('that_field')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for notExists without qualifier for PostgreSQL')]
    public function testToWhereSucceedsForNotExistsWithoutQualifierForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->>'a_field' IS NULL", Field::notExists('a_field')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for notExists without qualifier for SQLite')]
    public function testToWhereSucceedsForNotExistsWithoutQualifierForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->>'a_field' IS NULL", Field::notExists('a_field')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between without qualifier for SQLite')]
    public function testToWhereSucceedsForBetweenWithoutQualifierForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->>'age' BETWEEN @agemin AND @agemax",
                Field::between('age', 13, 17, '@age')->toWhere(), 'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between without qualifier for PostgreSQL with numeric range')]
    public function testToWhereSucceedsForBetweenWithoutQualifierForPostgreSQLWithNumericRange(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("(data->>'age')::numeric BETWEEN @agemin AND @agemax",
                Field::between('age', 13, 17, '@age')->toWhere(), 'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between without qualifier for PostgreSQL with non-numeric range')]
    public function testToWhereSucceedsForBetweenWithoutQualifierForPostgreSQLWithNonNumericRange(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->>'city' BETWEEN :citymin AND :citymax",
                Field::between('city', 'Atlanta', 'Chicago', ':city')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between with qualifier for SQLite')]
    public function testToWhereSucceedsForBetweenWithQualifierForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $field = Field::between('age', 13, 17, '@age');
            $field->qualifier = 'me';
            $this->assertEquals("me.data->>'age' BETWEEN @agemin AND @agemax", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between with qualifier for PostgreSQL with numeric range')]
    public function testToWhereSucceedsForBetweenWithQualifierForPostgreSQLWithNumericRange(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::between('age', 13, 17, '@age');
            $field->qualifier = 'me';
            $this->assertEquals("(me.data->>'age')::numeric BETWEEN @agemin AND @agemax", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for between with qualifier for PostgreSQL with non-numeric range')]
    public function testToWhereSucceedsForBetweenWithQualifierForPostgreSQLWithNonNumericRange(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::between('city', 'Atlanta', 'Chicago', ':city');
            $field->qualifier = 'me';
            $this->assertEquals("me.data->>'city' BETWEEN :citymin AND :citymax", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for in for PostgreSQL with non-numeric values')]
    public function testToWhereSucceedsForInForPostgreSQLWithNonNumericValues(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::in('test', ['Atlanta', 'Chicago'], ':city');
            $this->assertEquals("data->>'test' IN (:city_0, :city_1)", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for in for PostgreSQL with numeric values')]
    public function testToWhereSucceedsForInForPostgreSQLWithNumericValues(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::in('even', [2, 4, 6], ':nbr');
            $this->assertEquals("(data->>'even')::numeric IN (:nbr_0, :nbr_1, :nbr_2)", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for in for SQLite')]
    public function testToWhereSucceedsForInForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $field = Field::in('test', ['Atlanta', 'Chicago'], ':city');
            $this->assertEquals("data->>'test' IN (:city_0, :city_1)", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for inArray for PostgreSQL')]
    public function testToWhereSucceedsForInArrayForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::inArray('even', 'tbl', [2, 4, 6, 8], ':it');
            $this->assertEquals("data->'even' ??| ARRAY[:it_0, :it_1, :it_2, :it_3]", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for inArray for SQLite')]
    public function testToWhereSucceedsForInArrayForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $field = Field::inArray('test', 'tbl', ['Atlanta', 'Chicago'], ':city');
            $this->assertEquals(
                "EXISTS (SELECT 1 FROM json_each(tbl.data, '\$.test') WHERE value IN (:city_0, :city_1))",
                $field->toWhere(), 'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for others without qualifier for PostgreSQL')]
    public function testToWhereSucceedsForOthersWithoutQualifierForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $this->assertEquals("data->>'some_field' = @value", Field::equal('some_field', '', '@value')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds for others without qualifier for SQLite')]
    public function testToWhereSucceedsForOthersWithoutQualifierForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $this->assertEquals("data->>'some_field' = @value", Field::equal('some_field', '', '@value')->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds with qualifier no parameter for PostgreSQL')]
    public function testToWhereSucceedsWithQualifierNoParameterForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::exists('no_field');
            $field->qualifier = 'test';
            $this->assertEquals("test.data->>'no_field' IS NOT NULL", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds with qualifier no parameter for SQLite')]
    public function testToWhereSucceedsWithQualifierNoParameterForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $field = Field::exists('no_field');
            $field->qualifier = 'test';
            $this->assertEquals("test.data->>'no_field' IS NOT NULL", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds with qualifier and parameter for PostgreSQL')]
    public function testToWhereSucceedsWithQualifierAndParameterForPostgreSQL(): void
    {
        Configuration::overrideMode(Mode::PgSQL);
        try {
            $field = Field::lessOrEqual('le_field', 18, '@it');
            $field->qualifier = 'q';
            $this->assertEquals("(q.data->>'le_field')::numeric <= @it", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('toWhere() succeeds with qualifier and parameter for SQLite')]
    public function testToWhereSucceedsWithQualifierAndParameterForSQLite(): void
    {
        Configuration::overrideMode(Mode::SQLite);
        try {
            $field = Field::lessOrEqual('le_field', 18, '@it');
            $field->qualifier = 'q';
            $this->assertEquals("q.data->>'le_field' <= @it", $field->toWhere(),
                'WHERE fragment not generated correctly');
        } finally {
            Configuration::overrideMode(null);
        }
    }

    #[TestDox('equal() succeeds without parameter')]
    public function testEqualSucceedsWithoutParameter(): void
    {
        $field = Field::equal('my_test', 9);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('my_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Equal, $field->op, 'Operation not filled correctly');
        $this->assertEquals(9, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('equal() succeeds with parameter')]
    public function testEqualSucceedsWithParameter(): void
    {
        $field = Field::equal('another_test', 'turkey', '@test');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('another_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Equal, $field->op, 'Operation not filled correctly');
        $this->assertEquals('turkey', $field->value, 'Value not filled correctly');
        $this->assertEquals('@test', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('greater() succeeds without parameter')]
    public function testGreaterSucceedsWithoutParameter(): void
    {
        $field = Field::greater('your_test', 4);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('your_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Greater, $field->op, 'Operation not filled correctly');
        $this->assertEquals(4, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('greater() succeeds with parameter')]
    public function testGreaterSucceedsWithParameter(): void
    {
        $field = Field::greater('more_test', 'chicken', '@value');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('more_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Greater, $field->op, 'Operation not filled correctly');
        $this->assertEquals('chicken', $field->value, 'Value not filled correctly');
        $this->assertEquals('@value', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('greaterOrEqual() succeeds without parameter')]
    public function testGreaterOrEqualSucceedsWithoutParameter(): void
    {
        $field = Field::greaterOrEqual('their_test', 6);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('their_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::GreaterOrEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals(6, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('greaterOrEqual() succeeds with parameter')]
    public function testGreaterOrEqualSucceedsWithParameter(): void
    {
        $field = Field::greaterOrEqual('greater_test', 'poultry', '@cluck');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('greater_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::GreaterOrEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals('poultry', $field->value, 'Value not filled correctly');
        $this->assertEquals('@cluck', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('less() succeeds without parameter')]
    public function testLessSucceedsWithoutParameter(): void
    {
        $field = Field::less('z', 32);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('z', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Less, $field->op, 'Operation not filled correctly');
        $this->assertEquals(32, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('less() succeeds with parameter')]
    public function testLessSucceedsWithParameter(): void
    {
        $field = Field::less('additional_test', 'fowl', '@boo');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('additional_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Less, $field->op, 'Operation not filled correctly');
        $this->assertEquals('fowl', $field->value, 'Value not filled correctly');
        $this->assertEquals('@boo', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('lessOrEqual() succeeds without parameter')]
    public function testLessOrEqualSucceedsWithoutParameter(): void
    {
        $field = Field::lessOrEqual('g', 87);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('g', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::LessOrEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals(87, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('lessOrEqual() succeeds with parameter')]
    public function testLessOrEqualSucceedsWithParameter(): void
    {
        $field = Field::lessOrEqual('lesser_test', 'hen', '@woo');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('lesser_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::LessOrEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals('hen', $field->value, 'Value not filled correctly');
        $this->assertEquals('@woo', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('notEqual() succeeds without parameter')]
    public function testNotEqualSucceedsWithoutParameter(): void
    {
        $field = Field::notEqual('j', 65);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('j', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::NotEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals(65, $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('notEqual() succeeds with parameter')]
    public function testNotEqualSucceedsWithParameter(): void
    {
        $field = Field::notEqual('unequal_test', 'egg', '@zoo');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('unequal_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::NotEqual, $field->op, 'Operation not filled correctly');
        $this->assertEquals('egg', $field->value, 'Value not filled correctly');
        $this->assertEquals('@zoo', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('between() succeeds without parameter')]
    public function testBetweenSucceedsWithoutParameter(): void
    {
        $field = Field::between('k', 'alpha', 'zed');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('k', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Between, $field->op, 'Operation not filled correctly');
        $this->assertEquals(['alpha', 'zed'], $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('between() succeeds with parameter')]
    public function testBetweenSucceedsWithParameter(): void
    {
        $field = Field::between('between_test', 18, 49, '@count');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('between_test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Between, $field->op, 'Operation not filled correctly');
        $this->assertEquals([18, 49], $field->value, 'Value not filled correctly');
        $this->assertEquals('@count', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('in() succeeds without parameter')]
    public function testInSucceedsWithoutParameter(): void
    {
        $field = Field::in('test', [1, 2, 3]);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::In, $field->op, 'Operation not filled correctly');
        $this->assertEquals([1, 2, 3], $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('in() succeeds with parameter')]
    public function testInSucceedsWithParameter(): void
    {
        $field = Field::in('unit', ['a', 'b'], '@inParam');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('unit', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::In, $field->op, 'Operation not filled correctly');
        $this->assertEquals(['a', 'b'], $field->value, 'Value not filled correctly');
        $this->assertEquals('@inParam', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('inArray() succeeds without parameter')]
    public function testInArraySucceedsWithoutParameter(): void
    {
        $field = Field::inArray('test', 'tbl', [1, 2, 3]);
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('test', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::InArray, $field->op, 'Operation not filled correctly');
        $this->assertEquals(['table' => 'tbl', 'values' => [1, 2, 3]], $field->value, 'Value not filled correctly');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('inArray() succeeds with parameter')]
    public function testInArraySucceedsWithParameter(): void
    {
        $field = Field::inArray('unit', 'tab', ['a', 'b'], '@inAParam');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('unit', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::InArray, $field->op, 'Operation not filled correctly');
        $this->assertEquals(['table' => 'tab', 'values' => ['a', 'b']], $field->value, 'Value not filled correctly');
        $this->assertEquals('@inAParam', $field->paramName, 'Parameter name not filled correctly');
    }

    #[TestDox('exists() succeeds')]
    public function testExistsSucceeds(): void
    {
        $field = Field::exists('be_there');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('be_there', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Exists, $field->op, 'Operation not filled correctly');
        $this->assertEquals('', $field->value, 'Value should have been blank');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('notExists() succeeds')]
    public function testNotExistsSucceeds(): void
    {
        $field = Field::notExists('be_absent');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('be_absent', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::NotExists, $field->op, 'Operation not filled correctly');
        $this->assertEquals('', $field->value, 'Value should have been blank');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }

    #[TestDox('named() succeeds')]
    public function testNamedSucceeds(): void
    {
        $field = Field::named('the_field');
        $this->assertNotNull($field, 'The field should not have been null');
        $this->assertEquals('the_field', $field->fieldName, 'Field name not filled correctly');
        $this->assertEquals(Op::Equal, $field->op, 'Operation not filled correctly');
        $this->assertEquals('', $field->value, 'Value should have been blank');
        $this->assertEquals('', $field->paramName, 'Parameter name should have been blank');
    }
}