pdo-document/tests/unit/ParametersTest.php

<?php declare(strict_types=1);

namespace Test\Unit;

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

/**
 * Unit tests for the Parameters class
 */
#[TestDox('Parameters (Unit tests)')]
class ParametersTest extends TestCase
{
    #[TestDox('ID succeeds with string')]
    public function testIdSucceedsWithString(): void
    {
        $this->assertEquals([':id' => 'key'], Parameters::id('key'), 'ID parameter not constructed correctly');
    }

    #[TestDox('ID succeeds with non string')]
    public function testIdSucceedsWithNonString(): void
    {
        $this->assertEquals([':id' => '7'], Parameters::id(7), 'ID parameter not constructed correctly');
    }

    public function testJsonSucceeds(): void
    {
        $this->assertEquals([':it' => '{"id":18,"url":"https://www.unittest.com"}'],
            Parameters::json(':it', ['id' => 18, 'url' => 'https://www.unittest.com']),
            'JSON parameter not constructed correctly');
    }

    public function testNameFieldsSucceeds(): void
    {
        $named = Parameters::nameFields([Field::EQ('it', 17), Field::EQ('also', 22, ':also'), Field::EQ('other', 24)]);
        $this->assertCount(3, $named, 'There should be 3 parameters in the array');
        $this->assertEquals(':field0', $named[0]->paramName, 'Parameter 1 not named correctly');
        $this->assertEquals(':also', $named[1]->paramName, 'Parameter 2 not named correctly');
        $this->assertEquals(':field2', $named[2]->paramName, 'Parameter 3 not named correctly');
    }

    public function testAddFieldsSucceeds(): void
    {
        $this->assertEquals([':a' => 1, ':b' => 'two', ':z' => 18],
            Parameters::addFields([Field::EQ('b', 'two', ':b'), Field::EQ('z', 18, ':z')], [':a' => 1]),
            'Field parameters not added correctly');
    }

    #[TestDox('Field names succeeds for PostgreSQL')]
    public function testFieldNamesSucceedsForPostgreSQL(): void
    {
        try {
            Configuration::$mode = Mode::PgSQL;
            $this->assertEquals([':names' => "{one,two,seven}"],
                Parameters::fieldNames(':names', ['one', 'two', 'seven']), 'Field name parameters not correct');
        } finally {
            Configuration::$mode = null;
        }
    }

    #[TestDox('Field names succeeds for SQLite')]
    public function testFieldNamesSucceedsForSQLite(): void
    {
        try {
            Configuration::$mode = Mode::SQLite;
            $this->assertEquals([':it0' => '$.test', ':it1' => '$.unit', ':it2' => '$.wow'],
                Parameters::fieldNames(':it', ['test', 'unit', 'wow']), 'Field name parameters not correct');
        } finally {
            Configuration::$mode = null;
        }
    }

    public function testFieldNamesFailsWhenModeNotSet(): void
    {
        $this->expectException(DocumentException::class);
        Configuration::$mode = null;
        Parameters::fieldNames('', []);
    }
}