* @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'); } }