pdo-document/tests/integration/postgresql/RemoveFieldsTest.php

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

declare(strict_types=1);

namespace Test\Integration\PostgreSQL;

use BitBadger\PDODocument\{Field, Find, RemoveFields};
use PHPUnit\Framework\Attributes\TestDox;
use PHPUnit\Framework\TestCase;
use Test\Integration\TestDocument;

/**
 * PostgreSQL integration tests for the RemoveFields class
 */
#[TestDox('Remove Fields (PostgreSQL integration)')]
class RemoveFieldsTest extends TestCase
{
    /** @var string Database name for throwaway database */
    private string $dbName;

    protected function setUp(): void
    {
        parent::setUp();
        $this->dbName = ThrowawayDb::create();
    }

    protected function tearDown(): void
    {
        ThrowawayDb::destroy($this->dbName);
        parent::tearDown();
    }

    #[TestDox('By ID succeeds when fields are removed')]
    public function testByIdSucceedsWhenFieldsAreRemoved(): void
    {
        RemoveFields::byId(ThrowawayDb::TABLE, 'two', ['sub', 'value']);
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
        $this->assertNotFalse($tryDoc->isDefined(), 'There should have been a document returned');
        $doc = $tryDoc->get();
        $this->assertEquals('', $doc->value, 'Value should have been blank (its default value)');
        $this->assertNull($doc->sub, 'Sub-document should have been null');
    }

    #[TestDox('By ID succeeds when a field is not removed')]
    public function testByIdSucceedsWhenAFieldIsNotRemoved(): void
    {
        RemoveFields::byId(ThrowawayDb::TABLE, 'one', ['a_field_that_does_not_exist']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    #[TestDox('By ID succeeds when no document is matched')]
    public function testByIdSucceedsWhenNoDocumentIsMatched(): void
    {
        RemoveFields::byId(ThrowawayDb::TABLE, 'fifty', ['sub']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    public function testByFieldsSucceedsWhenAFieldIsRemoved(): void
    {
        RemoveFields::byFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 17)], ['sub']);
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 17)], TestDocument::class);
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
        $this->assertNull($doc->get()->sub, 'Sub-document should have been null');
    }

    public function testByFieldsSucceedsWhenAFieldIsNotRemoved(): void
    {
        RemoveFields::byFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 17)], ['nada']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    public function testByFieldsSucceedsWhenNoDocumentIsMatched(): void
    {
        RemoveFields::byFields(ThrowawayDb::TABLE, [Field::NE('missing', 'nope')], ['value']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    public function testByContainsSucceedsWhenAFieldIsRemoved(): void
    {
        $criteria = ['sub' => ['foo' => 'green']];
        RemoveFields::byContains(ThrowawayDb::TABLE, $criteria, ['value']);
        $docs = Find::byContains(ThrowawayDb::TABLE, $criteria, TestDocument::class);
        $this->assertNotNull($docs, 'There should have been a document list returned');
        $this->assertTrue($docs->hasItems(), 'The document list should not have been empty');
        foreach ($docs->items() as $item) {
            $this->assertContains($item->id, ['two', 'four'], 'An incorrect document was returned');
            $this->assertEquals('', $item->value, 'The value field was not removed');
        }
    }

    public function testByContainsSucceedsWhenAFieldIsNotRemoved(): void
    {
        RemoveFields::byContains(ThrowawayDb::TABLE, ['sub' => ['foo' => 'green']], ['invalid_field']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    public function testByContainsSucceedsWhenNoDocumentIsMatched(): void
    {
        RemoveFields::byContains(ThrowawayDb::TABLE, ['value' => 'substantial'], ['num_value']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    #[TestDox('By JSON Path succeeds when a field is removed')]
    public function testByJsonPathSucceedsWhenAFieldIsRemoved(): void
    {
        $path = '$.value ? (@ == "purple")';
        RemoveFields::byJsonPath(ThrowawayDb::TABLE, $path, ['sub']);
        $docs = Find::byJsonPath(ThrowawayDb::TABLE, $path, TestDocument::class);
        $this->assertNotNull($docs, 'There should have been a document list returned');
        $this->assertTrue($docs->hasItems(), 'The document list should not have been empty');
        foreach ($docs->items() as $item) {
            $this->assertContains($item->id, ['four', 'five'], 'An incorrect document was returned');
            $this->assertNull($item->sub, 'The sub field was not removed');
        }
    }

    #[TestDox('By JSON Path succeeds when a field is not removed')]
    public function testByJsonPathSucceedsWhenAFieldIsNotRemoved(): void
    {
        RemoveFields::byJsonPath(ThrowawayDb::TABLE, '$.value ? (@ == "purple")', ['submarine']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }

    #[TestDox('By JSON Path succeeds when no document is matched')]
    public function testByJsonPathSucceedsWhenNoDocumentIsMatched(): void
    {
        RemoveFields::byJsonPath(ThrowawayDb::TABLE, '$.value ? (@ == "mauve")', ['value']);
        $this->assertTrue(true, 'The above not throwing an exception is the test');
    }
}