Changes for beta8 #4
@ -22,8 +22,7 @@
 | 
			
		||||
    "php": ">=8.2",
 | 
			
		||||
    "bit-badger/inspired-by-fsharp": "^1",
 | 
			
		||||
    "netresearch/jsonmapper": "^4",
 | 
			
		||||
    "ext-pdo": "*",
 | 
			
		||||
    "phpoption/phpoption": "^1.9"
 | 
			
		||||
    "ext-pdo": "*"
 | 
			
		||||
  },
 | 
			
		||||
  "require-dev": {
 | 
			
		||||
    "phpunit/phpunit": "^11",
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										77
									
								
								composer.lock
									
									
									
										generated
									
									
									
								
							
							
						
						
									
										77
									
								
								composer.lock
									
									
									
										generated
									
									
									
								
							@ -4,7 +4,7 @@
 | 
			
		||||
        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
 | 
			
		||||
        "This file is @generated automatically"
 | 
			
		||||
    ],
 | 
			
		||||
    "content-hash": "223a16e330809798fc103d89c35faaa7",
 | 
			
		||||
    "content-hash": "f3351c794dd1261ee4bf18380f58463d",
 | 
			
		||||
    "packages": [
 | 
			
		||||
        {
 | 
			
		||||
            "name": "bit-badger/inspired-by-fsharp",
 | 
			
		||||
@ -101,81 +101,6 @@
 | 
			
		||||
                "source": "https://github.com/cweiske/jsonmapper/tree/v4.4.1"
 | 
			
		||||
            },
 | 
			
		||||
            "time": "2024-01-31T06:18:54+00:00"
 | 
			
		||||
        },
 | 
			
		||||
        {
 | 
			
		||||
            "name": "phpoption/phpoption",
 | 
			
		||||
            "version": "1.9.3",
 | 
			
		||||
            "source": {
 | 
			
		||||
                "type": "git",
 | 
			
		||||
                "url": "https://github.com/schmittjoh/php-option.git",
 | 
			
		||||
                "reference": "e3fac8b24f56113f7cb96af14958c0dd16330f54"
 | 
			
		||||
            },
 | 
			
		||||
            "dist": {
 | 
			
		||||
                "type": "zip",
 | 
			
		||||
                "url": "https://api.github.com/repos/schmittjoh/php-option/zipball/e3fac8b24f56113f7cb96af14958c0dd16330f54",
 | 
			
		||||
                "reference": "e3fac8b24f56113f7cb96af14958c0dd16330f54",
 | 
			
		||||
                "shasum": ""
 | 
			
		||||
            },
 | 
			
		||||
            "require": {
 | 
			
		||||
                "php": "^7.2.5 || ^8.0"
 | 
			
		||||
            },
 | 
			
		||||
            "require-dev": {
 | 
			
		||||
                "bamarni/composer-bin-plugin": "^1.8.2",
 | 
			
		||||
                "phpunit/phpunit": "^8.5.39 || ^9.6.20 || ^10.5.28"
 | 
			
		||||
            },
 | 
			
		||||
            "type": "library",
 | 
			
		||||
            "extra": {
 | 
			
		||||
                "bamarni-bin": {
 | 
			
		||||
                    "bin-links": true,
 | 
			
		||||
                    "forward-command": false
 | 
			
		||||
                },
 | 
			
		||||
                "branch-alias": {
 | 
			
		||||
                    "dev-master": "1.9-dev"
 | 
			
		||||
                }
 | 
			
		||||
            },
 | 
			
		||||
            "autoload": {
 | 
			
		||||
                "psr-4": {
 | 
			
		||||
                    "PhpOption\\": "src/PhpOption/"
 | 
			
		||||
                }
 | 
			
		||||
            },
 | 
			
		||||
            "notification-url": "https://packagist.org/downloads/",
 | 
			
		||||
            "license": [
 | 
			
		||||
                "Apache-2.0"
 | 
			
		||||
            ],
 | 
			
		||||
            "authors": [
 | 
			
		||||
                {
 | 
			
		||||
                    "name": "Johannes M. Schmitt",
 | 
			
		||||
                    "email": "schmittjoh@gmail.com",
 | 
			
		||||
                    "homepage": "https://github.com/schmittjoh"
 | 
			
		||||
                },
 | 
			
		||||
                {
 | 
			
		||||
                    "name": "Graham Campbell",
 | 
			
		||||
                    "email": "hello@gjcampbell.co.uk",
 | 
			
		||||
                    "homepage": "https://github.com/GrahamCampbell"
 | 
			
		||||
                }
 | 
			
		||||
            ],
 | 
			
		||||
            "description": "Option Type for PHP",
 | 
			
		||||
            "keywords": [
 | 
			
		||||
                "language",
 | 
			
		||||
                "option",
 | 
			
		||||
                "php",
 | 
			
		||||
                "type"
 | 
			
		||||
            ],
 | 
			
		||||
            "support": {
 | 
			
		||||
                "issues": "https://github.com/schmittjoh/php-option/issues",
 | 
			
		||||
                "source": "https://github.com/schmittjoh/php-option/tree/1.9.3"
 | 
			
		||||
            },
 | 
			
		||||
            "funding": [
 | 
			
		||||
                {
 | 
			
		||||
                    "url": "https://github.com/GrahamCampbell",
 | 
			
		||||
                    "type": "github"
 | 
			
		||||
                },
 | 
			
		||||
                {
 | 
			
		||||
                    "url": "https://tidelift.com/funding/github/packagist/phpoption/phpoption",
 | 
			
		||||
                    "type": "tidelift"
 | 
			
		||||
                }
 | 
			
		||||
            ],
 | 
			
		||||
            "time": "2024-07-20T21:41:07+00:00"
 | 
			
		||||
        }
 | 
			
		||||
    ],
 | 
			
		||||
    "packages-dev": [
 | 
			
		||||
 | 
			
		||||
@ -8,8 +8,8 @@ declare(strict_types=1);
 | 
			
		||||
 | 
			
		||||
namespace BitBadger\PDODocument;
 | 
			
		||||
 | 
			
		||||
use BitBadger\InspiredByFSharp\Option;
 | 
			
		||||
use BitBadger\PDODocument\Mapper\DocumentMapper;
 | 
			
		||||
use PhpOption\Option;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Functions to find documents
 | 
			
		||||
 | 
			
		||||
@ -93,7 +93,7 @@ class CustomTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id", [':id' => 'one'],
 | 
			
		||||
            new DocumentMapper(TestDocument::class));
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('one', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -101,7 +101,7 @@ class CustomTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id",
 | 
			
		||||
            [':id' => 'eighty'], new DocumentMapper(TestDocument::class));
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testNonQuerySucceedsWhenOperatingOnData()
 | 
			
		||||
 | 
			
		||||
@ -40,7 +40,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, ['id' => 'turkey', 'sub' => ['foo' => 'gobble', 'bar' => 'gobble']]);
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document inserted');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document inserted');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
 | 
			
		||||
        $this->assertEquals('', $doc->value, 'The value was incorrect');
 | 
			
		||||
@ -59,14 +59,14 @@ class DocumentTest extends TestCase
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(1, $obj->id, 'The ID 1 should have been auto-generated');
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'again', 'num_value' => 7]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE " . Query::whereById(docId: 2),
 | 
			
		||||
                [':id' => 2], new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(2, $obj->id, 'The ID 2 should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -82,7 +82,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 7, 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(7, $obj->id, 'The ID 7 should have been stored');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -98,7 +98,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => '', 'num_value' => 5]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 5)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertNotEmpty($doc->get()->id, 'The ID should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -114,7 +114,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            $uuid = AutoId::generateUUID();
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => $uuid, 'value' => 'uuid', 'num_value' => 12]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 12)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals($uuid, $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -130,7 +130,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => '', 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 8)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(6, strlen($doc->get()->id),
 | 
			
		||||
                'The ID should have been auto-generated and had 6 characters');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -147,7 +147,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 'my-key', 'value' => 'old', 'num_value' => 3]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 3)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals('my-key', $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -159,7 +159,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, new TestDocument('turkey', sub: new SubDocument('gobble', 'gobble')));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document inserted');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document inserted');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
 | 
			
		||||
        $this->assertEquals('', $doc->value, 'The value was incorrect');
 | 
			
		||||
@ -178,12 +178,12 @@ class DocumentTest extends TestCase
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'taco'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'taco')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(1, $doc->get()->id, 'The ID 1 should have been auto-generated');
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'burrito'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'burrito')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(2, $doc->get()->id, 'The ID 2 should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -198,7 +198,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(64, 'large'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'large')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(64, $doc->get()->id, 'The ID 64 should have been stored');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -213,7 +213,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument(value: 'something', num_value: 9));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EX('value')], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertNotEmpty($doc->get()->id, 'The ID should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -229,7 +229,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            $uuid = AutoId::generateUUID();
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument($uuid, num_value: 14));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 14)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals($uuid, $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -245,7 +245,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument(num_value: 55));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 55)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(40, strlen($doc->get()->id),
 | 
			
		||||
                'The ID should have been auto-generated and had 40 characters');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -262,7 +262,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument('my-key', num_value: 3));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 3)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals('my-key', $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -279,14 +279,14 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::save(ThrowawayDb::TABLE, new TestDocument('test', sub: new SubDocument('a', 'b')));
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testSaveSucceedsWhenADocumentIsUpdated(): void
 | 
			
		||||
    {
 | 
			
		||||
        Document::save(ThrowawayDb::TABLE, new TestDocument('two', num_value: 44));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals(44, $doc->num_value, 'The numeric value was not updated');
 | 
			
		||||
        $this->assertNull($doc->sub, 'The sub-document should have been null');
 | 
			
		||||
@ -296,7 +296,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::update(ThrowawayDb::TABLE, 'one', new TestDocument('one', 'howdy', 8, new SubDocument('y', 'z')));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertNotFalse($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertNotFalse($tryDoc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('howdy', $doc->value, 'The value was incorrect');
 | 
			
		||||
        $this->assertEquals(8, $doc->num_value, 'The numeric value was incorrect');
 | 
			
		||||
@ -309,6 +309,6 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::update(ThrowawayDb::TABLE, 'two-hundred', new TestDocument('200'));
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'two-hundred', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -55,7 +55,7 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testByIdSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('two', $doc->get()->id, 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -65,7 +65,7 @@ class FindTest extends TestCase
 | 
			
		||||
        Delete::byFields(ThrowawayDb::TABLE, [Field::NEX('absent')]);
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, ['id' => 18, 'value' => 'howdy']);
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 18, NumDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals(18, $doc->get()->id, 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -73,7 +73,7 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testByIdSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'seventy-five', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testByFieldsSucceedsWhenDocumentsAreFound(): void
 | 
			
		||||
@ -129,48 +129,48 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'another')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('two', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenMultipleDocumentsAreFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('sub.foo', 'green')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertContains($doc->get()->id, ['two', 'four'], 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'absent')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByContainsSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByContains(ThrowawayDb::TABLE, ['value' => 'FIRST!'], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('one', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByContainsSucceedsWhenMultipleDocumentsAreFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByContains(ThrowawayDb::TABLE, ['value' => 'purple'], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertContains($doc->get()->id, ['four', 'five'], 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByContainsSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByContains(ThrowawayDb::TABLE, ['value' => 'indigo'], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    #[TestDox('First by JSON Path succeeds when a document is found')]
 | 
			
		||||
    public function testFirstByJsonPathSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByJsonPath(ThrowawayDb::TABLE, '$.num_value ? (@ == 10)', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('two', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -178,7 +178,7 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testFirstByJsonPathSucceedsWhenMultipleDocumentsAreFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByJsonPath(ThrowawayDb::TABLE, '$.num_value ? (@ > 10)', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertContains($doc->get()->id, ['four', 'five'], 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -186,6 +186,6 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testFirstByJsonPathSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByJsonPath(ThrowawayDb::TABLE, '$.num_value ? (@ > 100)', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -39,7 +39,7 @@ class PatchTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Patch::byId(ThrowawayDb::TABLE, 'one', ['num_value' => 44]);
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals(44, $doc->get()->num_value, 'The updated document is not correct');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -71,7 +71,7 @@ class PatchTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Patch::byContains(ThrowawayDb::TABLE, ['value' => 'another'], ['num_value' => 12]);
 | 
			
		||||
        $tryDoc = Find::firstByContains(ThrowawayDb::TABLE, ['value' => 'another'], TestDocument::class);
 | 
			
		||||
        $this->assertNotFalse($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('two', $doc->id, 'An incorrect document was returned');
 | 
			
		||||
        $this->assertEquals(12, $doc->num_value, 'The document was not patched');
 | 
			
		||||
 | 
			
		||||
@ -39,7 +39,7 @@ class RemoveFieldsTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        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');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), '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');
 | 
			
		||||
@ -63,7 +63,7 @@ class RemoveFieldsTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        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->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertNull($doc->get()->sub, 'Sub-document should have been null');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -92,7 +92,7 @@ class CustomTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id", [':id' => 'one'],
 | 
			
		||||
            new DocumentMapper(TestDocument::class));
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('one', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -100,7 +100,7 @@ class CustomTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id",
 | 
			
		||||
            [':id' => 'eighty'], new DocumentMapper(TestDocument::class));
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testNonQuerySucceedsWhenOperatingOnData()
 | 
			
		||||
 | 
			
		||||
@ -40,7 +40,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, ['id' => 'turkey', 'sub' => ['foo' => 'gobble', 'bar' => 'gobble']]);
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document inserted');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document inserted');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
 | 
			
		||||
        $this->assertEquals('', $doc->value, 'The value was incorrect');
 | 
			
		||||
@ -59,14 +59,14 @@ class DocumentTest extends TestCase
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(1, $obj->id, 'The ID 1 should have been auto-generated');
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'again', 'num_value' => 7]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = 2", [],
 | 
			
		||||
                new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(2, $obj->id, 'The ID 2 should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -82,7 +82,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 7, 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $obj = json_decode($doc->get()['data']);
 | 
			
		||||
            $this->assertEquals(7, $obj->id, 'The ID 7 should have been stored');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -98,7 +98,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => '', 'num_value' => 5]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 5)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertNotEmpty($doc->get()->id, 'The ID should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -114,7 +114,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            $uuid = AutoId::generateUUID();
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => $uuid, 'value' => 'uuid', 'num_value' => 12]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 12)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals($uuid, $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -130,7 +130,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => '', 'value' => 'new', 'num_value' => 8]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 8)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(6, strlen($doc->get()->id),
 | 
			
		||||
                'The ID should have been auto-generated and had 6 characters');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -147,7 +147,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, ['id' => 'my-key', 'value' => 'old', 'num_value' => 3]);
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 3)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals('my-key', $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -159,7 +159,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, new TestDocument('turkey', sub: new SubDocument('gobble', 'gobble')));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
 | 
			
		||||
        $this->assertNotFalse($tryDoc->isDefined(), 'There should have been a document inserted');
 | 
			
		||||
        $this->assertNotFalse($tryDoc->isSome(), 'There should have been a document inserted');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
 | 
			
		||||
        $this->assertEquals('', $doc->value, 'The value was incorrect');
 | 
			
		||||
@ -178,12 +178,12 @@ class DocumentTest extends TestCase
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'taco'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'taco')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(1, $doc->get()->id, 'The ID 1 should have been auto-generated');
 | 
			
		||||
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'burrito'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'burrito')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(2, $doc->get()->id, 'The ID 2 should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -198,7 +198,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new NumDocument(64, 'large'));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'large')], NumDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(64, $doc->get()->id, 'The ID 64 should have been stored');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -213,7 +213,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument(value: 'something', num_value: 9));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EX('value')], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertNotEmpty($doc->get()->id, 'The ID should have been auto-generated');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -229,7 +229,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            $uuid = AutoId::generateUUID();
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument($uuid, num_value: 14));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 14)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals($uuid, $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -245,7 +245,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument(num_value: 55));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 55)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals(40, strlen($doc->get()->id),
 | 
			
		||||
                'The ID should have been auto-generated and had 40 characters');
 | 
			
		||||
        } finally {
 | 
			
		||||
@ -262,7 +262,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
            Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
 | 
			
		||||
            Document::insert(ThrowawayDb::TABLE, new TestDocument('my-key', num_value: 3));
 | 
			
		||||
            $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 3)], TestDocument::class);
 | 
			
		||||
            $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
            $this->assertEquals('my-key', $doc->get()->id, 'The ID should not have been changed');
 | 
			
		||||
        } finally {
 | 
			
		||||
            Configuration::$autoId = AutoId::None;
 | 
			
		||||
@ -279,14 +279,14 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::save(ThrowawayDb::TABLE, new TestDocument('test', sub: new SubDocument('a', 'b')));
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testSaveSucceedsWhenADocumentIsUpdated(): void
 | 
			
		||||
    {
 | 
			
		||||
        Document::save(ThrowawayDb::TABLE, new TestDocument('two', num_value: 44));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals(44, $doc->num_value, 'The numeric value was not updated');
 | 
			
		||||
        $this->assertNull($doc->sub, 'The sub-document should have been null');
 | 
			
		||||
@ -296,7 +296,7 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::update(ThrowawayDb::TABLE, 'one', new TestDocument('one', 'howdy', 8, new SubDocument('y', 'z')));
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $doc = $tryDoc->get();
 | 
			
		||||
        $this->assertEquals('howdy', $doc->value, 'The value was incorrect');
 | 
			
		||||
        $this->assertEquals(8, $doc->num_value, 'The numeric value was incorrect');
 | 
			
		||||
@ -309,6 +309,6 @@ class DocumentTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::update(ThrowawayDb::TABLE, 'two-hundred', new TestDocument('200'));
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'two-hundred', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -55,7 +55,7 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testByIdSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('two', $doc->get()->id, 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -64,7 +64,7 @@ class FindTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Document::insert(ThrowawayDb::TABLE, ['id' => 18, 'value' => 'howdy']);
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 18, TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('18', $doc->get()->id, 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
@ -72,7 +72,7 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testByIdSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'seventy-five', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testByFieldsSucceedsWhenDocumentsAreFound(): void
 | 
			
		||||
@ -107,21 +107,21 @@ class FindTest extends TestCase
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenADocumentIsFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'another')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals('two', $doc->get()->id, 'The incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenMultipleDocumentsAreFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('sub.foo', 'green')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertContains($doc->get()->id, ['two', 'four'], 'An incorrect document was returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByFieldsSucceedsWhenADocumentIsNotFound(): void
 | 
			
		||||
    {
 | 
			
		||||
        $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'absent')], TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isEmpty(), 'There should not have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isNone(), 'There should not have been a document returned');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    public function testFirstByContainsFails(): void
 | 
			
		||||
 | 
			
		||||
@ -39,7 +39,7 @@ class PatchTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        Patch::byId(ThrowawayDb::TABLE, 'one', ['num_value' => 44]);
 | 
			
		||||
        $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($doc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertEquals(44, $doc->get()->num_value, 'The updated document is not correct');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -39,7 +39,7 @@ class RemoveFieldsTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        RemoveFields::byId(ThrowawayDb::TABLE, 'two', ['sub', 'value']);
 | 
			
		||||
        $tryDoc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
 | 
			
		||||
        $this->assertTrue($tryDoc->isDefined(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertTrue($tryDoc->isSome(), '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');
 | 
			
		||||
@ -63,7 +63,7 @@ class RemoveFieldsTest extends TestCase
 | 
			
		||||
    {
 | 
			
		||||
        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->assertTrue($doc->isSome(), 'There should have been a document returned');
 | 
			
		||||
        $this->assertNull($doc->get()->sub, 'Sub-document should have been null');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user