From f784f3e52cc1e4691fa347eefc82a2e4587c7f38 Mon Sep 17 00:00:00 2001 From: "Daniel J. Summers" Date: Sat, 8 Jun 2024 23:58:45 +0000 Subject: [PATCH] Initial SQLite development (#1) Reviewed-on: https://git.bitbadger.solutions/bit-badger/pdo-document/pulls/1 --- .gitattributes | 4 + .gitignore | 2 + README.md | 12 +- composer.json | 41 + composer.lock | 1705 +++++++++++++++++ src/Configuration.php | 67 + src/Count.php | 39 + src/Custom.php | 143 ++ src/Definition.php | 34 + src/Delete.php | 36 + src/Document.php | 47 + src/DocumentException.php | 30 + src/DocumentList.php | 83 + src/Exists.php | 40 + src/Field.php | 188 ++ src/Find.php | 78 + src/Mapper/ArrayMapper.php | 17 + src/Mapper/CountMapper.php | 17 + src/Mapper/DocumentMapper.php | 44 + src/Mapper/ExistsMapper.php | 24 + src/Mapper/Mapper.php | 19 + src/Mapper/StringMapper.php | 30 + src/Mode.php | 15 + src/Op.php | 48 + src/Parameters.php | 81 + src/Patch.php | 40 + src/Query.php | 77 + src/Query/Count.php | 35 + src/Query/Definition.php | 71 + src/Query/Delete.php | 35 + src/Query/Exists.php | 47 + src/Query/Find.php | 35 + src/Query/Patch.php | 55 + src/Query/RemoveFields.php | 66 + src/RemoveFields.php | 42 + tests/integration/SubDocument.php | 11 + tests/integration/TestDocument.php | 9 + tests/integration/sqlite/CountTest.php | 47 + tests/integration/sqlite/CustomTest.php | 119 ++ tests/integration/sqlite/DefinitionTest.php | 60 + tests/integration/sqlite/DeleteTest.php | 59 + tests/integration/sqlite/DocumentListTest.php | 73 + tests/integration/sqlite/DocumentTest.php | 84 + tests/integration/sqlite/ExistsTest.php | 54 + tests/integration/sqlite/FindTest.php | 109 ++ tests/integration/sqlite/PatchTest.php | 60 + tests/integration/sqlite/RemoveFieldsTest.php | 74 + tests/integration/sqlite/ThrowawayDb.php | 71 + tests/unit/ConfigurationTest.php | 39 + tests/unit/DocumentExceptionTest.php | 46 + tests/unit/FieldTest.php | 446 +++++ tests/unit/Mapper/ArrayMapperTest.php | 19 + tests/unit/Mapper/CountMapperTest.php | 17 + tests/unit/Mapper/DocumentMapperTest.php | 56 + tests/unit/Mapper/ExistsMapperTest.php | 43 + tests/unit/Mapper/StringMapperTest.php | 29 + tests/unit/OpTest.php | 67 + tests/unit/ParametersTest.php | 79 + tests/unit/Query/CountTest.php | 31 + tests/unit/Query/DefinitionTest.php | 65 + tests/unit/Query/DeleteTest.php | 38 + tests/unit/Query/ExistsTest.php | 44 + tests/unit/Query/FindTest.php | 38 + tests/unit/Query/PatchTest.php | 80 + tests/unit/Query/RemoveFieldsTest.php | 117 ++ tests/unit/QueryTest.php | 80 + 66 files changed, 5509 insertions(+), 2 deletions(-) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 composer.json create mode 100644 composer.lock create mode 100644 src/Configuration.php create mode 100644 src/Count.php create mode 100644 src/Custom.php create mode 100644 src/Definition.php create mode 100644 src/Delete.php create mode 100644 src/Document.php create mode 100644 src/DocumentException.php create mode 100644 src/DocumentList.php create mode 100644 src/Exists.php create mode 100644 src/Field.php create mode 100644 src/Find.php create mode 100644 src/Mapper/ArrayMapper.php create mode 100644 src/Mapper/CountMapper.php create mode 100644 src/Mapper/DocumentMapper.php create mode 100644 src/Mapper/ExistsMapper.php create mode 100644 src/Mapper/Mapper.php create mode 100644 src/Mapper/StringMapper.php create mode 100644 src/Mode.php create mode 100644 src/Op.php create mode 100644 src/Parameters.php create mode 100644 src/Patch.php create mode 100644 src/Query.php create mode 100644 src/Query/Count.php create mode 100644 src/Query/Definition.php create mode 100644 src/Query/Delete.php create mode 100644 src/Query/Exists.php create mode 100644 src/Query/Find.php create mode 100644 src/Query/Patch.php create mode 100644 src/Query/RemoveFields.php create mode 100644 src/RemoveFields.php create mode 100644 tests/integration/SubDocument.php create mode 100644 tests/integration/TestDocument.php create mode 100644 tests/integration/sqlite/CountTest.php create mode 100644 tests/integration/sqlite/CustomTest.php create mode 100644 tests/integration/sqlite/DefinitionTest.php create mode 100644 tests/integration/sqlite/DeleteTest.php create mode 100644 tests/integration/sqlite/DocumentListTest.php create mode 100644 tests/integration/sqlite/DocumentTest.php create mode 100644 tests/integration/sqlite/ExistsTest.php create mode 100644 tests/integration/sqlite/FindTest.php create mode 100644 tests/integration/sqlite/PatchTest.php create mode 100644 tests/integration/sqlite/RemoveFieldsTest.php create mode 100644 tests/integration/sqlite/ThrowawayDb.php create mode 100644 tests/unit/ConfigurationTest.php create mode 100644 tests/unit/DocumentExceptionTest.php create mode 100644 tests/unit/FieldTest.php create mode 100644 tests/unit/Mapper/ArrayMapperTest.php create mode 100644 tests/unit/Mapper/CountMapperTest.php create mode 100644 tests/unit/Mapper/DocumentMapperTest.php create mode 100644 tests/unit/Mapper/ExistsMapperTest.php create mode 100644 tests/unit/Mapper/StringMapperTest.php create mode 100644 tests/unit/OpTest.php create mode 100644 tests/unit/ParametersTest.php create mode 100644 tests/unit/Query/CountTest.php create mode 100644 tests/unit/Query/DefinitionTest.php create mode 100644 tests/unit/Query/DeleteTest.php create mode 100644 tests/unit/Query/ExistsTest.php create mode 100644 tests/unit/Query/FindTest.php create mode 100644 tests/unit/Query/PatchTest.php create mode 100644 tests/unit/Query/RemoveFieldsTest.php create mode 100644 tests/unit/QueryTest.php diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..cd43aad --- /dev/null +++ b/.gitattributes @@ -0,0 +1,4 @@ +.gitignore export-ignore +.gitattributes export-ignore +composer.lock export-ignore +tests/**/* export-ignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..3ce5adb --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +.idea +vendor diff --git a/README.md b/README.md index f77d860..174f327 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,11 @@ -# pdo-document +# PDODocument -Bit Badger Documents PHP implementation with PDO \ No newline at end of file +This library allows SQLite (and, by v1.0.0-beta1, PostgreSQL) to be treated as a document database. It is a PHP implementation of the .NET [BitBadger.Documents](https://git.bitbadger.solutions/bit-badger/BitBadger.Documents) library. + +## Add via Composer + +`compose require bit-badger/pdo-document` + +## Usage + +Documentation for this library is not complete; however, its structure is very similar to the .NET version, so [its documentation will help](https://bitbadger.solutions/open-source/relational-documents/basic-usage.html) until its project specific documentation is developed. Things like `Count.All()` become `Count::all`, and all the `byField` operations are named `byFields` and take an array of fields. diff --git a/composer.json b/composer.json new file mode 100644 index 0000000..f3c3323 --- /dev/null +++ b/composer.json @@ -0,0 +1,41 @@ +{ + "name": "bit-badger/pdo-document", + "description": "Treat SQLite (and soon PostgreSQL) as a document store", + "keywords": ["database", "document", "sqlite", "pdo"], + "license": "MIT", + "authors": [ + { + "name": "Daniel J. Summers", + "email": "daniel@bitbadger.solutions", + "homepage": "https://bitbadger.solutions", + "role": "Developer" + } + ], + "support": { + "email": "daniel@bitbadger.solutions", + "source": "https://git.bitbadger.solutions/bit-badger/pdo-document", + "rss": "https://git.bitbadger.solutions/bit-badger/pdo-document.rss" + }, + "require": { + "php": ">=8.3", + "netresearch/jsonmapper": "^4", + "ext-pdo": "*" + }, + "require-dev": { + "phpunit/phpunit": "^11" + }, + "autoload": { + "psr-4": { + "BitBadger\\PDODocument\\": "./src", + "BitBadger\\PDODocument\\Mapper\\": "./src/Mapper", + "BitBadger\\PDODocument\\Query\\": "./src/Query" + } + }, + "autoload-dev": { + "psr-4": { + "Test\\Unit\\": "./tests/unit", + "Test\\Integration\\": "./tests/integration", + "Test\\Integration\\SQLite\\": "./tests/integration/sqlite" + } + } +} \ No newline at end of file diff --git a/composer.lock b/composer.lock new file mode 100644 index 0000000..c9a364a --- /dev/null +++ b/composer.lock @@ -0,0 +1,1705 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", + "This file is @generated automatically" + ], + "content-hash": "ca79f450e8e715ad61ba3581734c0fe7", + "packages": [ + { + "name": "netresearch/jsonmapper", + "version": "v4.4.1", + "source": { + "type": "git", + "url": "https://github.com/cweiske/jsonmapper.git", + "reference": "132c75c7dd83e45353ebb9c6c9f591952995bbf0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/cweiske/jsonmapper/zipball/132c75c7dd83e45353ebb9c6c9f591952995bbf0", + "reference": "132c75c7dd83e45353ebb9c6c9f591952995bbf0", + "shasum": "" + }, + "require": { + "ext-json": "*", + "ext-pcre": "*", + "ext-reflection": "*", + "ext-spl": "*", + "php": ">=7.1" + }, + "require-dev": { + "phpunit/phpunit": "~7.5 || ~8.0 || ~9.0 || ~10.0", + "squizlabs/php_codesniffer": "~3.5" + }, + "type": "library", + "autoload": { + "psr-0": { + "JsonMapper": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "OSL-3.0" + ], + "authors": [ + { + "name": "Christian Weiske", + "email": "cweiske@cweiske.de", + "homepage": "http://github.com/cweiske/jsonmapper/", + "role": "Developer" + } + ], + "description": "Map nested JSON structures onto PHP classes", + "support": { + "email": "cweiske@cweiske.de", + "issues": "https://github.com/cweiske/jsonmapper/issues", + "source": "https://github.com/cweiske/jsonmapper/tree/v4.4.1" + }, + "time": "2024-01-31T06:18:54+00:00" + } + ], + "packages-dev": [ + { + "name": "myclabs/deep-copy", + "version": "1.11.1", + "source": { + "type": "git", + "url": "https://github.com/myclabs/DeepCopy.git", + "reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/7284c22080590fb39f2ffa3e9057f10a4ddd0e0c", + "reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c", + "shasum": "" + }, + "require": { + "php": "^7.1 || ^8.0" + }, + "conflict": { + "doctrine/collections": "<1.6.8", + "doctrine/common": "<2.13.3 || >=3,<3.2.2" + }, + "require-dev": { + "doctrine/collections": "^1.6.8", + "doctrine/common": "^2.13.3 || ^3.2.2", + "phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13" + }, + "type": "library", + "autoload": { + "files": [ + "src/DeepCopy/deep_copy.php" + ], + "psr-4": { + "DeepCopy\\": "src/DeepCopy/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Create deep copies (clones) of your objects", + "keywords": [ + "clone", + "copy", + "duplicate", + "object", + "object graph" + ], + "support": { + "issues": "https://github.com/myclabs/DeepCopy/issues", + "source": "https://github.com/myclabs/DeepCopy/tree/1.11.1" + }, + "funding": [ + { + "url": "https://tidelift.com/funding/github/packagist/myclabs/deep-copy", + "type": "tidelift" + } + ], + "time": "2023-03-08T13:26:56+00:00" + }, + { + "name": "nikic/php-parser", + "version": "v5.0.2", + "source": { + "type": "git", + "url": "https://github.com/nikic/PHP-Parser.git", + "reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/139676794dc1e9231bf7bcd123cfc0c99182cb13", + "reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13", + "shasum": "" + }, + "require": { + "ext-ctype": "*", + "ext-json": "*", + "ext-tokenizer": "*", + "php": ">=7.4" + }, + "require-dev": { + "ircmaxell/php-yacc": "^0.0.7", + "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0" + }, + "bin": [ + "bin/php-parse" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "5.0-dev" + } + }, + "autoload": { + "psr-4": { + "PhpParser\\": "lib/PhpParser" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Nikita Popov" + } + ], + "description": "A PHP parser written in PHP", + "keywords": [ + "parser", + "php" + ], + "support": { + "issues": "https://github.com/nikic/PHP-Parser/issues", + "source": "https://github.com/nikic/PHP-Parser/tree/v5.0.2" + }, + "time": "2024-03-05T20:51:40+00:00" + }, + { + "name": "phar-io/manifest", + "version": "2.0.4", + "source": { + "type": "git", + "url": "https://github.com/phar-io/manifest.git", + "reference": "54750ef60c58e43759730615a392c31c80e23176" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phar-io/manifest/zipball/54750ef60c58e43759730615a392c31c80e23176", + "reference": "54750ef60c58e43759730615a392c31c80e23176", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-libxml": "*", + "ext-phar": "*", + "ext-xmlwriter": "*", + "phar-io/version": "^3.0.1", + "php": "^7.2 || ^8.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + }, + { + "name": "Sebastian Heuer", + "email": "sebastian@phpeople.de", + "role": "Developer" + }, + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "Developer" + } + ], + "description": "Component for reading phar.io manifest information from a PHP Archive (PHAR)", + "support": { + "issues": "https://github.com/phar-io/manifest/issues", + "source": "https://github.com/phar-io/manifest/tree/2.0.4" + }, + "funding": [ + { + "url": "https://github.com/theseer", + "type": "github" + } + ], + "time": "2024-03-03T12:33:53+00:00" + }, + { + "name": "phar-io/version", + "version": "3.2.1", + "source": { + "type": "git", + "url": "https://github.com/phar-io/version.git", + "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phar-io/version/zipball/4f7fd7836c6f332bb2933569e566a0d6c4cbed74", + "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "type": "library", + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + }, + { + "name": "Sebastian Heuer", + "email": "sebastian@phpeople.de", + "role": "Developer" + }, + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "Developer" + } + ], + "description": "Library for handling version information and constraints", + "support": { + "issues": "https://github.com/phar-io/version/issues", + "source": "https://github.com/phar-io/version/tree/3.2.1" + }, + "time": "2022-02-21T01:04:05+00:00" + }, + { + "name": "phpunit/php-code-coverage", + "version": "11.0.3", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-code-coverage.git", + "reference": "7e35a2cbcabac0e6865fd373742ea432a3c34f92" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/7e35a2cbcabac0e6865fd373742ea432a3c34f92", + "reference": "7e35a2cbcabac0e6865fd373742ea432a3c34f92", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-libxml": "*", + "ext-xmlwriter": "*", + "nikic/php-parser": "^5.0", + "php": ">=8.2", + "phpunit/php-file-iterator": "^5.0", + "phpunit/php-text-template": "^4.0", + "sebastian/code-unit-reverse-lookup": "^4.0", + "sebastian/complexity": "^4.0", + "sebastian/environment": "^7.0", + "sebastian/lines-of-code": "^3.0", + "sebastian/version": "^5.0", + "theseer/tokenizer": "^1.2.0" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "suggest": { + "ext-pcov": "PHP extension that provides line coverage", + "ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "11.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.", + "homepage": "https://github.com/sebastianbergmann/php-code-coverage", + "keywords": [ + "coverage", + "testing", + "xunit" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-code-coverage/issues", + "security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy", + "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/11.0.3" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-12T15:35:40+00:00" + }, + { + "name": "phpunit/php-file-iterator", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-file-iterator.git", + "reference": "99e95c94ad9500daca992354fa09d7b99abe2210" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/99e95c94ad9500daca992354fa09d7b99abe2210", + "reference": "99e95c94ad9500daca992354fa09d7b99abe2210", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "FilterIterator implementation that filters files based on a list of suffixes.", + "homepage": "https://github.com/sebastianbergmann/php-file-iterator/", + "keywords": [ + "filesystem", + "iterator" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-file-iterator/issues", + "security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy", + "source": "https://github.com/sebastianbergmann/php-file-iterator/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:05:04+00:00" + }, + { + "name": "phpunit/php-invoker", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-invoker.git", + "reference": "5d8d9355a16d8cc5a1305b0a85342cfa420612be" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/5d8d9355a16d8cc5a1305b0a85342cfa420612be", + "reference": "5d8d9355a16d8cc5a1305b0a85342cfa420612be", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "ext-pcntl": "*", + "phpunit/phpunit": "^11.0" + }, + "suggest": { + "ext-pcntl": "*" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Invoke callables with a timeout", + "homepage": "https://github.com/sebastianbergmann/php-invoker/", + "keywords": [ + "process" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-invoker/issues", + "security": "https://github.com/sebastianbergmann/php-invoker/security/policy", + "source": "https://github.com/sebastianbergmann/php-invoker/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:05:50+00:00" + }, + { + "name": "phpunit/php-text-template", + "version": "4.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-text-template.git", + "reference": "d38f6cbff1cdb6f40b03c9811421561668cc133e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/d38f6cbff1cdb6f40b03c9811421561668cc133e", + "reference": "d38f6cbff1cdb6f40b03c9811421561668cc133e", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Simple template engine.", + "homepage": "https://github.com/sebastianbergmann/php-text-template/", + "keywords": [ + "template" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-text-template/issues", + "security": "https://github.com/sebastianbergmann/php-text-template/security/policy", + "source": "https://github.com/sebastianbergmann/php-text-template/tree/4.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:06:56+00:00" + }, + { + "name": "phpunit/php-timer", + "version": "7.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-timer.git", + "reference": "8a59d9e25720482ee7fcdf296595e08795b84dc5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/8a59d9e25720482ee7fcdf296595e08795b84dc5", + "reference": "8a59d9e25720482ee7fcdf296595e08795b84dc5", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Utility class for timing", + "homepage": "https://github.com/sebastianbergmann/php-timer/", + "keywords": [ + "timer" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-timer/issues", + "security": "https://github.com/sebastianbergmann/php-timer/security/policy", + "source": "https://github.com/sebastianbergmann/php-timer/tree/7.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:08:01+00:00" + }, + { + "name": "phpunit/phpunit", + "version": "11.2.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/phpunit.git", + "reference": "705eba0190afe04bc057f565ad843267717cf109" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/705eba0190afe04bc057f565ad843267717cf109", + "reference": "705eba0190afe04bc057f565ad843267717cf109", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-json": "*", + "ext-libxml": "*", + "ext-mbstring": "*", + "ext-xml": "*", + "ext-xmlwriter": "*", + "myclabs/deep-copy": "^1.10.1", + "phar-io/manifest": "^2.0.3", + "phar-io/version": "^3.0.2", + "php": ">=8.2", + "phpunit/php-code-coverage": "^11.0", + "phpunit/php-file-iterator": "^5.0", + "phpunit/php-invoker": "^5.0", + "phpunit/php-text-template": "^4.0", + "phpunit/php-timer": "^7.0", + "sebastian/cli-parser": "^3.0", + "sebastian/code-unit": "^3.0", + "sebastian/comparator": "^6.0", + "sebastian/diff": "^6.0", + "sebastian/environment": "^7.0", + "sebastian/exporter": "^6.0", + "sebastian/global-state": "^7.0", + "sebastian/object-enumerator": "^6.0", + "sebastian/type": "^5.0", + "sebastian/version": "^5.0" + }, + "suggest": { + "ext-soap": "To be able to generate mocks based on WSDL files" + }, + "bin": [ + "phpunit" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "11.2-dev" + } + }, + "autoload": { + "files": [ + "src/Framework/Assert/Functions.php" + ], + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "The PHP Unit Testing framework.", + "homepage": "https://phpunit.de/", + "keywords": [ + "phpunit", + "testing", + "xunit" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/phpunit/issues", + "security": "https://github.com/sebastianbergmann/phpunit/security/policy", + "source": "https://github.com/sebastianbergmann/phpunit/tree/11.2.0" + }, + "funding": [ + { + "url": "https://phpunit.de/sponsors.html", + "type": "custom" + }, + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/phpunit/phpunit", + "type": "tidelift" + } + ], + "time": "2024-06-07T04:48:50+00:00" + }, + { + "name": "sebastian/cli-parser", + "version": "3.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/cli-parser.git", + "reference": "00a74d5568694711f0222e54fb281e1d15fdf04a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/00a74d5568694711f0222e54fb281e1d15fdf04a", + "reference": "00a74d5568694711f0222e54fb281e1d15fdf04a", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for parsing CLI options", + "homepage": "https://github.com/sebastianbergmann/cli-parser", + "support": { + "issues": "https://github.com/sebastianbergmann/cli-parser/issues", + "security": "https://github.com/sebastianbergmann/cli-parser/security/policy", + "source": "https://github.com/sebastianbergmann/cli-parser/tree/3.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-02T07:26:58+00:00" + }, + { + "name": "sebastian/code-unit", + "version": "3.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/code-unit.git", + "reference": "6634549cb8d702282a04a774e36a7477d2bd9015" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/code-unit/zipball/6634549cb8d702282a04a774e36a7477d2bd9015", + "reference": "6634549cb8d702282a04a774e36a7477d2bd9015", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Collection of value objects that represent the PHP code units", + "homepage": "https://github.com/sebastianbergmann/code-unit", + "support": { + "issues": "https://github.com/sebastianbergmann/code-unit/issues", + "security": "https://github.com/sebastianbergmann/code-unit/security/policy", + "source": "https://github.com/sebastianbergmann/code-unit/tree/3.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T05:50:41+00:00" + }, + { + "name": "sebastian/code-unit-reverse-lookup", + "version": "4.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/code-unit-reverse-lookup.git", + "reference": "df80c875d3e459b45c6039e4d9b71d4fbccae25d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/code-unit-reverse-lookup/zipball/df80c875d3e459b45c6039e4d9b71d4fbccae25d", + "reference": "df80c875d3e459b45c6039e4d9b71d4fbccae25d", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Looks up which function or method a line of code belongs to", + "homepage": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/", + "support": { + "issues": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/issues", + "security": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/security/policy", + "source": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/tree/4.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T05:52:17+00:00" + }, + { + "name": "sebastian/comparator", + "version": "6.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/comparator.git", + "reference": "bd0f2fa5b9257c69903537b266ccb80fcf940db8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/bd0f2fa5b9257c69903537b266ccb80fcf940db8", + "reference": "bd0f2fa5b9257c69903537b266ccb80fcf940db8", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-mbstring": "*", + "php": ">=8.2", + "sebastian/diff": "^6.0", + "sebastian/exporter": "^6.0" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Volker Dusch", + "email": "github@wallbash.com" + }, + { + "name": "Bernhard Schussek", + "email": "bschussek@2bepublished.at" + } + ], + "description": "Provides the functionality to compare PHP values for equality", + "homepage": "https://github.com/sebastianbergmann/comparator", + "keywords": [ + "comparator", + "compare", + "equality" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/comparator/issues", + "security": "https://github.com/sebastianbergmann/comparator/security/policy", + "source": "https://github.com/sebastianbergmann/comparator/tree/6.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T05:53:45+00:00" + }, + { + "name": "sebastian/complexity", + "version": "4.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/complexity.git", + "reference": "88a434ad86150e11a606ac4866b09130712671f0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/88a434ad86150e11a606ac4866b09130712671f0", + "reference": "88a434ad86150e11a606ac4866b09130712671f0", + "shasum": "" + }, + "require": { + "nikic/php-parser": "^5.0", + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for calculating the complexity of PHP code units", + "homepage": "https://github.com/sebastianbergmann/complexity", + "support": { + "issues": "https://github.com/sebastianbergmann/complexity/issues", + "security": "https://github.com/sebastianbergmann/complexity/security/policy", + "source": "https://github.com/sebastianbergmann/complexity/tree/4.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T05:55:19+00:00" + }, + { + "name": "sebastian/diff", + "version": "6.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/diff.git", + "reference": "ab83243ecc233de5655b76f577711de9f842e712" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/ab83243ecc233de5655b76f577711de9f842e712", + "reference": "ab83243ecc233de5655b76f577711de9f842e712", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0", + "symfony/process": "^4.2 || ^5" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Kore Nordmann", + "email": "mail@kore-nordmann.de" + } + ], + "description": "Diff implementation", + "homepage": "https://github.com/sebastianbergmann/diff", + "keywords": [ + "diff", + "udiff", + "unidiff", + "unified diff" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/diff/issues", + "security": "https://github.com/sebastianbergmann/diff/security/policy", + "source": "https://github.com/sebastianbergmann/diff/tree/6.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-02T07:30:33+00:00" + }, + { + "name": "sebastian/environment", + "version": "7.1.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/environment.git", + "reference": "4eb3a442574d0e9d141aab209cd4aaf25701b09a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/4eb3a442574d0e9d141aab209cd4aaf25701b09a", + "reference": "4eb3a442574d0e9d141aab209cd4aaf25701b09a", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "suggest": { + "ext-posix": "*" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.1-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Provides functionality to handle HHVM/PHP environments", + "homepage": "https://github.com/sebastianbergmann/environment", + "keywords": [ + "Xdebug", + "environment", + "hhvm" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/environment/issues", + "security": "https://github.com/sebastianbergmann/environment/security/policy", + "source": "https://github.com/sebastianbergmann/environment/tree/7.1.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-23T08:56:34+00:00" + }, + { + "name": "sebastian/exporter", + "version": "6.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/exporter.git", + "reference": "f291e5a317c321c0381fa9ecc796fa2d21b186da" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/f291e5a317c321c0381fa9ecc796fa2d21b186da", + "reference": "f291e5a317c321c0381fa9ecc796fa2d21b186da", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "php": ">=8.2", + "sebastian/recursion-context": "^6.0" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Volker Dusch", + "email": "github@wallbash.com" + }, + { + "name": "Adam Harvey", + "email": "aharvey@php.net" + }, + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "description": "Provides the functionality to export PHP variables for visualization", + "homepage": "https://www.github.com/sebastianbergmann/exporter", + "keywords": [ + "export", + "exporter" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/exporter/issues", + "security": "https://github.com/sebastianbergmann/exporter/security/policy", + "source": "https://github.com/sebastianbergmann/exporter/tree/6.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-02T07:28:20+00:00" + }, + { + "name": "sebastian/global-state", + "version": "7.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/global-state.git", + "reference": "c3a307e832f2e69c7ef869e31fc644fde0e7cb3e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/c3a307e832f2e69c7ef869e31fc644fde0e7cb3e", + "reference": "c3a307e832f2e69c7ef869e31fc644fde0e7cb3e", + "shasum": "" + }, + "require": { + "php": ">=8.2", + "sebastian/object-reflector": "^4.0", + "sebastian/recursion-context": "^6.0" + }, + "require-dev": { + "ext-dom": "*", + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Snapshotting of global state", + "homepage": "https://www.github.com/sebastianbergmann/global-state", + "keywords": [ + "global state" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/global-state/issues", + "security": "https://github.com/sebastianbergmann/global-state/security/policy", + "source": "https://github.com/sebastianbergmann/global-state/tree/7.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-02T07:32:10+00:00" + }, + { + "name": "sebastian/lines-of-code", + "version": "3.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/lines-of-code.git", + "reference": "376c5b3f6b43c78fdc049740bca76a7c846706c0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/376c5b3f6b43c78fdc049740bca76a7c846706c0", + "reference": "376c5b3f6b43c78fdc049740bca76a7c846706c0", + "shasum": "" + }, + "require": { + "nikic/php-parser": "^5.0", + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for counting the lines of code in PHP source code", + "homepage": "https://github.com/sebastianbergmann/lines-of-code", + "support": { + "issues": "https://github.com/sebastianbergmann/lines-of-code/issues", + "security": "https://github.com/sebastianbergmann/lines-of-code/security/policy", + "source": "https://github.com/sebastianbergmann/lines-of-code/tree/3.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:00:36+00:00" + }, + { + "name": "sebastian/object-enumerator", + "version": "6.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/object-enumerator.git", + "reference": "f75f6c460da0bbd9668f43a3dde0ec0ba7faa678" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/f75f6c460da0bbd9668f43a3dde0ec0ba7faa678", + "reference": "f75f6c460da0bbd9668f43a3dde0ec0ba7faa678", + "shasum": "" + }, + "require": { + "php": ">=8.2", + "sebastian/object-reflector": "^4.0", + "sebastian/recursion-context": "^6.0" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Traverses array structures and object graphs to enumerate all referenced objects", + "homepage": "https://github.com/sebastianbergmann/object-enumerator/", + "support": { + "issues": "https://github.com/sebastianbergmann/object-enumerator/issues", + "security": "https://github.com/sebastianbergmann/object-enumerator/security/policy", + "source": "https://github.com/sebastianbergmann/object-enumerator/tree/6.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:01:29+00:00" + }, + { + "name": "sebastian/object-reflector", + "version": "4.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/object-reflector.git", + "reference": "bb2a6255d30853425fd38f032eb64ced9f7f132d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/bb2a6255d30853425fd38f032eb64ced9f7f132d", + "reference": "bb2a6255d30853425fd38f032eb64ced9f7f132d", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Allows reflection of object attributes, including inherited and non-public ones", + "homepage": "https://github.com/sebastianbergmann/object-reflector/", + "support": { + "issues": "https://github.com/sebastianbergmann/object-reflector/issues", + "security": "https://github.com/sebastianbergmann/object-reflector/security/policy", + "source": "https://github.com/sebastianbergmann/object-reflector/tree/4.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:02:18+00:00" + }, + { + "name": "sebastian/recursion-context", + "version": "6.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/recursion-context.git", + "reference": "b75224967b5a466925c6d54e68edd0edf8dd4ed4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/b75224967b5a466925c6d54e68edd0edf8dd4ed4", + "reference": "b75224967b5a466925c6d54e68edd0edf8dd4ed4", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Adam Harvey", + "email": "aharvey@php.net" + } + ], + "description": "Provides functionality to recursively process PHP variables", + "homepage": "https://github.com/sebastianbergmann/recursion-context", + "support": { + "issues": "https://github.com/sebastianbergmann/recursion-context/issues", + "security": "https://github.com/sebastianbergmann/recursion-context/security/policy", + "source": "https://github.com/sebastianbergmann/recursion-context/tree/6.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:08:48+00:00" + }, + { + "name": "sebastian/type", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/type.git", + "reference": "b8502785eb3523ca0dd4afe9ca62235590020f3f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/type/zipball/b8502785eb3523ca0dd4afe9ca62235590020f3f", + "reference": "b8502785eb3523ca0dd4afe9ca62235590020f3f", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "require-dev": { + "phpunit/phpunit": "^11.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Collection of value objects that represent the types of the PHP type system", + "homepage": "https://github.com/sebastianbergmann/type", + "support": { + "issues": "https://github.com/sebastianbergmann/type/issues", + "security": "https://github.com/sebastianbergmann/type/security/policy", + "source": "https://github.com/sebastianbergmann/type/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:09:34+00:00" + }, + { + "name": "sebastian/version", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/version.git", + "reference": "13999475d2cb1ab33cb73403ba356a814fdbb001" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/version/zipball/13999475d2cb1ab33cb73403ba356a814fdbb001", + "reference": "13999475d2cb1ab33cb73403ba356a814fdbb001", + "shasum": "" + }, + "require": { + "php": ">=8.2" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library that helps with managing the version number of Git-hosted PHP projects", + "homepage": "https://github.com/sebastianbergmann/version", + "support": { + "issues": "https://github.com/sebastianbergmann/version/issues", + "security": "https://github.com/sebastianbergmann/version/security/policy", + "source": "https://github.com/sebastianbergmann/version/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-02-02T06:10:47+00:00" + }, + { + "name": "theseer/tokenizer", + "version": "1.2.3", + "source": { + "type": "git", + "url": "https://github.com/theseer/tokenizer.git", + "reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/theseer/tokenizer/zipball/737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2", + "reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-tokenizer": "*", + "ext-xmlwriter": "*", + "php": "^7.2 || ^8.0" + }, + "type": "library", + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + } + ], + "description": "A small library for converting tokenized PHP source code into XML and potentially other formats", + "support": { + "issues": "https://github.com/theseer/tokenizer/issues", + "source": "https://github.com/theseer/tokenizer/tree/1.2.3" + }, + "funding": [ + { + "url": "https://github.com/theseer", + "type": "github" + } + ], + "time": "2024-03-03T12:36:25+00:00" + } + ], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": [], + "prefer-stable": false, + "prefer-lowest": false, + "platform": { + "php": ">=8.3", + "ext-pdo": "*" + }, + "platform-dev": [], + "plugin-api-version": "2.6.0" +} diff --git a/src/Configuration.php b/src/Configuration.php new file mode 100644 index 0000000..c12a6ae --- /dev/null +++ b/src/Configuration.php @@ -0,0 +1,67 @@ +getAttribute(PDO::ATTR_DRIVER_NAME); + self::$mode = match ($driver) { + 'pgsql' => Mode::PgSQL, + 'sqlite' => Mode::SQLite, + default => throw new DocumentException( + "Unsupported driver $driver: this library currently supports PostgreSQL and SQLite") + }; + } + } + + return self::$_pdo; + } + + + public static function resetPDO(): void + { + self::$_pdo = null; + } +} diff --git a/src/Count.php b/src/Count.php new file mode 100644 index 0000000..df91c72 --- /dev/null +++ b/src/Count.php @@ -0,0 +1,39 @@ +prepare($query); + } catch (PDOException $ex) { + $keyword = explode(' ', $query, 2)[0]; + throw new DocumentException( + sprintf("Error executing %s statement: [%s] %s", $keyword, Configuration::dbConn()->errorCode(), + Configuration::dbConn()->errorInfo()[2]), + previous: $ex); + } + foreach ($parameters as $key => $value) { + if ($debug) echo "
Binding $value to $key\n
"; + $dataType = match (true) { + is_bool($value) => PDO::PARAM_BOOL, + is_int($value) => PDO::PARAM_INT, + is_null($value) => PDO::PARAM_NULL, + default => PDO::PARAM_STR + }; + $stmt->bindValue($key, $value, $dataType); + } + if ($debug) echo '
SQL: ' . $stmt->queryString . '
'; + try { + if ($stmt->execute()) return $stmt; + } catch (PDOException $ex) { + $keyword = explode(' ', $query, 2)[0]; + throw new DocumentException( + sprintf("Error executing %s statement: [%s] %s", $keyword, $stmt->errorCode(), $stmt->errorInfo()[2]), + previous: $ex); + } + $keyword = explode(' ', $query, 2)[0]; + throw new DocumentException("Error executing $keyword statement: " . $stmt->errorCode()); + } + + /** + * Execute a query that returns a list of results (lazy) + * + * @template TDoc The domain type of the document to retrieve + * @param string $query The query to be executed + * @param array $parameters Parameters to use in executing the query + * @param Mapper $mapper Mapper to deserialize the result + * @return DocumentList The items matching the query + * @throws DocumentException If any is encountered + */ + public static function list(string $query, array $parameters, Mapper $mapper): DocumentList + { + return DocumentList::create($query, $parameters, $mapper); + } + + /** + * Execute a query that returns an array of results (eager) + * + * @template TDoc The domain type of the document to retrieve + * @param string $query The query to be executed + * @param array $parameters Parameters to use in executing the query + * @param Mapper $mapper Mapper to deserialize the result + * @return TDoc[] The items matching the query + * @throws DocumentException If any is encountered + */ + public static function array(string $query, array $parameters, Mapper $mapper): array + { + return iterator_to_array(self::list($query, $parameters, $mapper)->items()); + } + + /** + * Execute a query that returns one or no results (returns false if not found) + * + * @template TDoc The domain type of the document to retrieve + * @param string $query The query to be executed (will have "LIMIT 1" appended) + * @param array $parameters Parameters to use in executing the query + * @param Mapper $mapper Mapper to deserialize the result + * @return false|TDoc The item if it is found, false if not + * @throws DocumentException If any is encountered + */ + public static function single(string $query, array $parameters, Mapper $mapper): mixed + { + try { + $stmt = &self::runQuery("$query LIMIT 1", $parameters); + return ($first = $stmt->fetch(PDO::FETCH_ASSOC)) ? $mapper->map($first) : false; + } finally { + $stmt = null; + } + } + + /** + * Execute a query that does not return a value + * + * @param string $query The query to execute + * @param array $parameters Parameters to use in executing the query + * @throws DocumentException If any is encountered + */ + public static function nonQuery(string $query, array $parameters): void + { + try { + $stmt = &self::runQuery($query, $parameters); + } finally { + $stmt = null; + } + } + + /** + * Execute a query that returns a scalar value + * + * @template T The scalar type to return + * @param string $query The query to retrieve the value + * @param array $parameters Parameters to use in executing the query + * @param Mapper $mapper The mapper to obtain the result + * @return mixed|false|T The scalar value if found, false if not + * @throws DocumentException If any is encountered + */ + public static function scalar(string $query, array $parameters, Mapper $mapper): mixed + { + try { + $stmt = &self::runQuery($query, $parameters); + return ($first = $stmt->fetch(PDO::FETCH_NUM)) ? $mapper->map($first) : false; + } finally { + $stmt = null; + } + } +} diff --git a/src/Definition.php b/src/Definition.php new file mode 100644 index 0000000..be87c3a --- /dev/null +++ b/src/Definition.php @@ -0,0 +1,34 @@ +code == 0 ? '' : "[$this->code] "; + return __CLASS__ . ": $codeStr$this->message\n"; + } +} diff --git a/src/DocumentList.php b/src/DocumentList.php new file mode 100644 index 0000000..5c4c011 --- /dev/null +++ b/src/DocumentList.php @@ -0,0 +1,83 @@ + $mapper The mapper to deserialize JSON + */ + private function __construct(private ?PDOStatement &$result, private readonly Mapper $mapper) + { + if ($row = $this->result->fetch(PDO::FETCH_ASSOC)) { + $this->_first = $this->mapper->map($row); + } else { + $this->result = null; + } + } + + /** + * Construct a new document list + * + * @param string $query The query to run to retrieve results + * @param array $parameters An associative array of parameters for the query + * @param Mapper $mapper A mapper to deserialize JSON documents + * @return static The document list instance + * @throws DocumentException If any is encountered + */ + public static function create(string $query, array $parameters, Mapper $mapper): static + { + $stmt = &Custom::runQuery($query, $parameters); + return new static($stmt, $mapper); + } + + /** + * The items from the query result + * + * @return Generator The items from the document list + */ + public function items(): Generator + { + if (!$this->result) return; + yield $this->_first; + while ($row = $this->result->fetch(PDO::FETCH_ASSOC)) { + yield $this->mapper->map($row); + } + $this->result = null; + } + + /** + * Does this list have items remaining? + * + * @return bool True if there are items still to be retrieved from the list, false if not + */ + public function hasItems(): bool + { + return !is_null($this->result); + } + + /** + * Ensure the statement is destroyed if the generator is not exhausted + */ + public function __destruct() + { + if (!is_null($this->result)) $this->result = null; + } +} diff --git a/src/Exists.php b/src/Exists.php new file mode 100644 index 0000000..11548d4 --- /dev/null +++ b/src/Exists.php @@ -0,0 +1,40 @@ +op) { + case Op::EX: + case Op::NEX: + break; + case Op::BT: + $existing["{$this->paramName}min"] = $this->value[0]; + $existing["{$this->paramName}max"] = $this->value[1]; + break; + default: + $existing[$this->paramName] = $this->value; + } + return $existing; + } + + /** + * Get the WHERE clause fragment for this parameter + * + * @return string The WHERE clause fragment for this parameter + * @throws DocumentException If the database mode has not been set + */ + public function toWhere(): string + { + $criteria = match ($this->op) { + Op::EX, Op::NEX => '', + Op::BT => " {$this->paramName}min AND {$this->paramName}max", + default => " $this->paramName" + }; + $prefix = $this->qualifier == '' ? '' : "$this->qualifier."; + $fieldPath = match (Configuration::$mode) { + Mode::SQLite => "{$prefix}data->>'" + . (str_contains($this->fieldName, '.') + ? implode("'->>'", explode('.', $this->fieldName)) + : $this->fieldName) + . "'", + Mode::PgSQL => $this->op == Op::BT && is_numeric($this->value[0]) + ? "({$prefix}data->>'$this->fieldName')::numeric" + : "{$prefix}data->>'$this->fieldName'", + default => throw new DocumentException('Database mode not set; cannot make field WHERE clause') + }; + return $fieldPath . ' ' . $this->op->toString() . $criteria; + } + + /** + * Create an equals (=) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for which equality will be checked + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function EQ(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::EQ, $value, $paramName); + } + + /** + * Create a greater than (>) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for the greater than comparison + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function GT(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::GT, $value, $paramName); + } + + /** + * Create a greater than or equal to (>=) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for the greater than or equal to comparison + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function GE(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::GE, $value, $paramName); + } + + /** + * Create a less than (<) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for the less than comparison + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function LT(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::LT, $value, $paramName); + } + + /** + * Create a less than or equal to (<=) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for the less than or equal to comparison + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function LE(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::LE, $value, $paramName); + } + + /** + * Create a not equals (<>) field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $value The value for the not equals comparison + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function NE(string $fieldName, mixed $value, string $paramName = ''): static + { + return new static($fieldName, Op::NE, $value, $paramName); + } + + /** + * Create a BETWEEN field criterion + * + * @param string $fieldName The name of the field against which the value will be compared + * @param mixed $minValue The lower value for range + * @param mixed $maxValue The upper value for the range + * @param string $paramName The name of the parameter to which this should be bound (optional; generated if blank) + * @return static The field with the requested criterion + */ + public static function BT(string $fieldName, mixed $minValue, mixed $maxValue, string $paramName = ''): static + { + return new static($fieldName, Op::BT, [$minValue, $maxValue], $paramName); + } + + /** + * Create an exists (IS NOT NULL) field criterion + * + * @param string $fieldName The name of the field for which existence will be checked + * @return static The field with the requested criterion + */ + public static function EX(string $fieldName): static + { + return new static($fieldName, Op::EX, '', ''); + } + + /** + * Create a not exists (IS NULL) field criterion + * + * @param string $fieldName The name of the field for which non-existence will be checked + * @return static The field with the requested criterion + */ + public static function NEX(string $fieldName): static + { + return new static($fieldName, Op::NEX, '', ''); + } +} diff --git a/src/Find.php b/src/Find.php new file mode 100644 index 0000000..a3bb007 --- /dev/null +++ b/src/Find.php @@ -0,0 +1,78 @@ + $className The name of the class to be retrieved + * @return DocumentList A list of all documents from the table + * @throws DocumentException If any is encountered + */ + public static function all(string $tableName, string $className): DocumentList + { + return Custom::list(Query::selectFromTable($tableName), [], new DocumentMapper($className)); + } + + /** + * Retrieve a document by its ID (returns false if not found) + * + * @template TDoc The type of document to be retrieved + * @param string $tableName The table from which the document should be retrieved + * @param mixed $docId The ID of the document to retrieve + * @param class-string $className The name of the class to be retrieved + * @return false|TDoc The document if it exists, false if not + * @throws DocumentException If any is encountered + */ + public static function byId(string $tableName, mixed $docId, string $className): mixed + { + return Custom::single(Query\Find::byId($tableName), Parameters::id($docId), new DocumentMapper($className)); + } + + /** + * Retrieve documents via a comparison on JSON fields + * + * @template TDoc The type of document to be retrieved + * @param string $tableName The table from which documents should be retrieved + * @param array|Field[] $fields The field comparison to match + * @param class-string $className The name of the class to be retrieved + * @param string $conjunction How to handle multiple conditions (optional; defaults to `AND`) + * @return DocumentList A list of documents matching the given field comparison + * @throws DocumentException If any is encountered + */ + public static function byFields(string $tableName, array $fields, string $className, + string $conjunction = 'AND'): DocumentList + { + $namedFields = Parameters::nameFields($fields); + return Custom::list(Query\Find::byFields($tableName, $namedFields, $conjunction), + Parameters::addFields($namedFields, []), new DocumentMapper($className)); + } + + /** + * Retrieve documents via a comparison on JSON fields, returning only the first result + * + * @template TDoc The type of document to be retrieved + * @param string $tableName The table from which the document should be retrieved + * @param array|Field[] $fields The field comparison to match + * @param class-string $className The name of the class to be retrieved + * @param string $conjunction How to handle multiple conditions (optional; defaults to `AND`) + * @return false|TDoc The first document if any matches are found, false otherwise + * @throws DocumentException If any is encountered + */ + public static function firstByFields(string $tableName, array $fields, string $className, + string $conjunction = 'AND'): mixed + { + $namedFields = Parameters::nameFields($fields); + return Custom::single(Query\Find::byFields($tableName, $namedFields, $conjunction), + Parameters::addFields($namedFields, []), new DocumentMapper($className)); + } +} diff --git a/src/Mapper/ArrayMapper.php b/src/Mapper/ArrayMapper.php new file mode 100644 index 0000000..62f1286 --- /dev/null +++ b/src/Mapper/ArrayMapper.php @@ -0,0 +1,17 @@ + Provide a mapping from JSON + */ +class DocumentMapper implements Mapper +{ + /** + * Constructor + * + * @param class-string $className The type of class to be returned by this mapping + * @param string $fieldName The name of the field (optional; defaults to `data`) + */ + public function __construct(public string $className, public string $fieldName = 'data') { } + + /** + * Map a result to a domain class instance + * + * @param array $result An associative array representing a single database result + * @return TDoc The document, deserialized from its JSON representation + * @throws DocumentException If the JSON cannot be deserialized + */ + public function map(array $result): mixed + { + try { + $json = json_decode($result[$this->fieldName]); + if (is_null($json)) { + throw new DocumentException("Could not map document for $this->className: " . json_last_error_msg()); + } + return (new JsonMapper())->map($json, $this->className); + } catch (JsonMapper_Exception $ex) { + throw new DocumentException("Could not map document for $this->className", previous: $ex); + } + } +} diff --git a/src/Mapper/ExistsMapper.php b/src/Mapper/ExistsMapper.php new file mode 100644 index 0000000..7668318 --- /dev/null +++ b/src/Mapper/ExistsMapper.php @@ -0,0 +1,24 @@ + (bool)$result[0], + Mode::SQLite => (int)$result[0] > 0, + default => throw new DocumentException('Database mode not set; cannot map existence result'), + }; + } +} diff --git a/src/Mapper/Mapper.php b/src/Mapper/Mapper.php new file mode 100644 index 0000000..5ed0ff2 --- /dev/null +++ b/src/Mapper/Mapper.php @@ -0,0 +1,19 @@ + + */ +class StringMapper implements Mapper +{ + /** + * Constructor + * + * @param string $fieldName The name of the field to be retrieved as a string + */ + public function __construct(public string $fieldName) { } + + /** + * @inheritDoc + */ + public function map(array $result): ?string + { + return match (false) { + key_exists($this->fieldName, $result) => null, + is_string($result[$this->fieldName]) => "{$result[$this->fieldName]}", + default => $result[$this->fieldName] + }; + } +} diff --git a/src/Mode.php b/src/Mode.php new file mode 100644 index 0000000..f6e21c7 --- /dev/null +++ b/src/Mode.php @@ -0,0 +1,15 @@ +) */ + case GT; + /** Greater Than or Equal To (>=) */ + case GE; + /** Less Than (<) */ + case LT; + /** Less Than or Equal To (<=) */ + case LE; + /** Not Equal to (<>) */ + case NE; + /** Between (BETWEEN) */ + case BT; + /** Exists (IS NOT NULL) */ + case EX; + /** Does Not Exist (IS NULL) */ + case NEX; + + /** + * Get the string representation of this operator + * + * @return string The operator to use in SQL statements + */ + public function toString(): string + { + return match ($this) { + Op::EQ => "=", + Op::GT => ">", + Op::GE => ">=", + Op::LT => "<", + Op::LE => "<=", + Op::NE => "<>", + Op::BT => "BETWEEN", + Op::EX => "IS NOT NULL", + Op::NEX => "IS NULL" + }; + } +} diff --git a/src/Parameters.php b/src/Parameters.php new file mode 100644 index 0000000..e6dffad --- /dev/null +++ b/src/Parameters.php @@ -0,0 +1,81 @@ + is_int($key) || is_string($key) ? $key : "$key"]; + } + + /** + * Create a parameter with a JSON value + * + * @param string $name The name of the JSON parameter + * @param object|array $document The value that should be passed as a JSON string + * @return array An associative array with the named parameter/value pair + */ + public static function json(string $name, object|array $document): array + { + return [$name => json_encode($document, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)]; + } + + /** + * Fill in parameter names for any fields missing one + * + * @param array|Field[] $fields The fields for the query + * @return array|Field[] The fields, all with non-blank parameter names + */ + public static function nameFields(array $fields): array + { + for ($idx = 0; $idx < sizeof($fields); $idx++) { + if ($fields[$idx]->paramName == '') $fields[$idx]->paramName = ":field$idx"; + } + return $fields; + } + + /** + * Add field parameters to the given set of parameters + * + * @param array|Field[] $fields The fields being compared in the query + * @param array $parameters An associative array of parameters to which the fields should be added + * @return array An associative array of parameter names and values with the fields added + */ + public static function addFields(array $fields, array $parameters): array + { + return array_reduce($fields, fn($carry, $item) => $item->appendParameter($carry), $parameters); + } + + /** + * Create JSON field name parameters for the given field names to the given parameter + * + * @param string $paramName The name of the parameter for the field names + * @param array|string[] $fieldNames The names of the fields for the parameter + * @return array An associative array of parameter/value pairs for the field names + * @throws DocumentException If the database mode has not been set + */ + public static function fieldNames(string $paramName, array $fieldNames): array + { + switch (Configuration::$mode) { + case Mode::PgSQL: + return [$paramName => "ARRAY['" . implode("','", $fieldNames) . "']"]; + case Mode::SQLite: + $it = []; + $idx = 0; + foreach ($fieldNames as $field) $it[$paramName . $idx++] = "$.$field"; + return $it; + default: + throw new DocumentException('Database mode not set; cannot generate field name parameters'); + } + } +} diff --git a/src/Patch.php b/src/Patch.php new file mode 100644 index 0000000..98e5378 --- /dev/null +++ b/src/Patch.php @@ -0,0 +1,40 @@ + $it->toWhere(), $fields)); + } + + /** + * Create a WHERE clause fragment to implement an ID-based query + * + * @param string $paramName The parameter name where the value of the ID will be provided (optional; default @id) + * @return string The WHERE clause fragment to match by ID + */ + public static function whereById(string $paramName = ':id'): string + { + return self::whereByFields([Field::EQ(Configuration::$idField, 0, $paramName)]); + } + + /** + * Query to insert a document + * + * @param string $tableName The name of the table into which a document should be inserted + * @return string The INSERT statement for the given table + */ + public static function insert(string $tableName): string + { + return "INSERT INTO $tableName VALUES (:data)"; + } + + /** + * Query to save a document, inserting it if it does not exist and updating it if it does (AKA "upsert") + * + * @param string $tableName The name of the table into which a document should be saved + * @return string The INSERT...ON CONFLICT query for the document + */ + public static function save(string $tableName): string + { + return self::insert($tableName) + . " ON CONFLICT ((data->>'" . Configuration::$idField . "')) DO UPDATE SET data = EXCLUDED.data"; + } + + /** + * Query to update a document + * + * @param string $tableName The name of the table in which the document should be updated + * @return string The UPDATE query for the document + */ + public static function update(string $tableName): string + { + return "UPDATE $tableName SET data = :data WHERE " . self::whereById(); + } +} diff --git a/src/Query/Count.php b/src/Query/Count.php new file mode 100644 index 0000000..87c47e3 --- /dev/null +++ b/src/Query/Count.php @@ -0,0 +1,35 @@ + 'JSONB', + Mode::SQLite => 'TEXT', + default => throw new DocumentException('Database mode not set; cannot make create table statement') + }; + return "CREATE TABLE IF NOT EXISTS $name (data $dataType NOT NULL)"; + } + + /** + * Split a schema and table name + * + * @param string $tableName The name of the table, possibly including the schema + * @return array|string[] An array with the schema at index 0 and the table name at index 1 + */ + private static function splitSchemaAndTable(string $tableName): array + { + $parts = explode('.', $tableName); + return sizeof($parts) == 1 ? ["", $tableName] : [$parts[0], $parts[1]]; + } + + /** + * SQL statement to create an index on one or more fields in a JSON document + * + * @param string $tableName The name of the table which should be indexed + * @param string $indexName The name of the index to create + * @param array $fields An array of fields to be indexed; may contain direction (ex. 'salary DESC') + * @return string The CREATE INDEX statement to ensure the index exists + */ + public static function ensureIndexOn(string $tableName, string $indexName, array $fields): string + { + [, $tbl] = self::splitSchemaAndTable($tableName); + $jsonFields = implode(', ', array_map(function (string $field) { + $parts = explode(' ', $field); + $fieldName = sizeof($parts) == 1 ? $field : $parts[0]; + $direction = sizeof($parts) < 2 ? "" : " $parts[1]"; + return "(data->>'$fieldName')$direction"; + }, $fields)); + return "CREATE INDEX IF NOT EXISTS idx_{$tbl}_$indexName ON $tableName ($jsonFields)"; + } + + /** + * SQL statement to create a key index for a document table + * + * @param string $tableName The name of the table whose key should be ensured + * @return string The CREATE INDEX statement to ensure the key index exists + */ + public static function ensureKey(string $tableName): string + { + return str_replace('INDEX', 'UNIQUE INDEX', self::ensureIndexOn($tableName, 'key', [Configuration::$idField])); + } +} diff --git a/src/Query/Delete.php b/src/Query/Delete.php new file mode 100644 index 0000000..84bd2a0 --- /dev/null +++ b/src/Query/Delete.php @@ -0,0 +1,35 @@ + 'data || :data', + Mode::SQLite => 'json_patch(data, json(:data))', + default => throw new DocumentException('Database mode not set; cannot make patch statement') + }; + return "UPDATE $tableName SET data = $setValue WHERE $whereClause"; + } + + /** + * Query to patch (partially update) a document by its ID + * + * @param string $tableName The name of the table in which a document should be patched + * @return string The query to patch a document by its ID + * @throws DocumentException If the database mode has not been set + */ + public static function byId(string $tableName): string + { + return self::update($tableName, Query::whereById()); + } + + /** + * Query to patch (partially update) a document via a comparison on a JSON field + * + * @param string $tableName The name of the table in which documents should be patched + * @param array|Field[] $field The field comparison to match + * @param string $conjunction How to handle multiple conditions (optional; defaults to `AND`) + * @return string The query to patch documents via field comparison + * @throws DocumentException If the database mode has not been set + */ + public static function byFields(string $tableName, array $field, string $conjunction = 'AND'): string + { + return self::update($tableName, Query::whereByFields($field, $conjunction)); + } +} diff --git a/src/Query/RemoveFields.php b/src/Query/RemoveFields.php new file mode 100644 index 0000000..0e3fea0 --- /dev/null +++ b/src/Query/RemoveFields.php @@ -0,0 +1,66 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + public function testAllSucceeds(): void + { + $count = Count::all(ThrowawayDb::TABLE); + $this->assertEquals(5, $count, 'There should have been 5 matching documents'); + } + + public function testByFieldsSucceedsForANumericRange(): void + { + $count = Count::byFields(ThrowawayDb::TABLE, [Field::BT('num_value', 10, 20)]); + $this->assertEquals(3, $count, 'There should have been 3 matching documents'); + } + + public function testByFieldsSucceedsForANonNumericRange(): void + { + $count = Count::byFields(ThrowawayDb::TABLE, [Field::BT('value', 'aardvark', 'apple')]); + $this->assertEquals(1, $count, 'There should have been 1 matching document'); + } +} diff --git a/tests/integration/sqlite/CustomTest.php b/tests/integration/sqlite/CustomTest.php new file mode 100644 index 0000000..bf83bdd --- /dev/null +++ b/tests/integration/sqlite/CustomTest.php @@ -0,0 +1,119 @@ +dbName = ThrowawayDb::create(); + } + + public function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + } + + public function testRunQuerySucceedsWithAValidQuery() + { + $stmt = &Custom::runQuery('SELECT data FROM ' . ThrowawayDb::TABLE . ' LIMIT 1', []); + try { + $this->assertNotNull($stmt, 'The statement should not have been null'); + } finally { + $stmt = null; + } + } + + public function testRunQueryFailsWithAnInvalidQuery() + { + $this->expectException(DocumentException::class); + $stmt = &Custom::runQuery('GRAB stuff FROM over_there UNTIL done', []); + try { + $this->assertTrue(false, 'This code should not be reached'); + } finally { + $stmt = null; + } + } + + public function testListSucceedsWhenDataIsFound() + { + $list = Custom::list(Query::selectFromTable(ThrowawayDb::TABLE), [], new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'The document list should not be null'); + $count = 0; + foreach ($list->items() as $ignored) $count++; + $this->assertEquals(5, $count, 'There should have been 5 documents in the list'); + } + + public function testListSucceedsWhenNoDataIsFound() + { + $list = Custom::list(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'num_value' > :value", + [':value' => 100], new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'The document list should not be null'); + $this->assertFalse($list->hasItems(), 'There should have been no documents in the list'); + } + + public function testArraySucceedsWhenDataIsFound() + { + $array = Custom::array(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'sub' IS NOT NULL", [], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($array, 'The document array should not be null'); + $this->assertCount(2, $array, 'There should have been 2 documents in the array'); + } + + public function testArraySucceedsWhenNoDataIsFound() + { + $array = Custom::array(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'value' = :value", + [':value' => 'not there'], new DocumentMapper(TestDocument::class)); + $this->assertNotNull($array, 'The document array should not be null'); + $this->assertCount(0, $array, 'There should have been no documents in the array'); + } + + public function testSingleSucceedsWhenARowIsFound(): void + { + $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id", [':id' => 'one'], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($doc, 'There should have been a document returned'); + $this->assertEquals('one', $doc->id, 'The incorrect document was returned'); + } + + public function testSingleSucceedsWhenARowIsNotFound(): void + { + $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id", + [':id' => 'eighty'], new DocumentMapper(TestDocument::class)); + $this->assertFalse($doc, 'There should not have been a document returned'); + } + + public function testNonQuerySucceedsWhenOperatingOnData() + { + Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []); + $remaining = Count::all(ThrowawayDb::TABLE); + $this->assertEquals(0, $remaining, 'There should be no documents remaining in the table'); + } + + public function testNonQuerySucceedsWhenNoDataMatchesWhereClause() + { + Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE . " WHERE data->>'num_value' > :value", [':value' => 100]); + $remaining = Count::all(ThrowawayDb::TABLE); + $this->assertEquals(5, $remaining, 'There should be 5 documents remaining in the table'); + } + + public function testScalarSucceeds() + { + $value = Custom::scalar("SELECT 5 AS it", [], new CountMapper()); + $this->assertEquals(5, $value, 'The scalar value was not returned correctly'); + } +} diff --git a/tests/integration/sqlite/DefinitionTest.php b/tests/integration/sqlite/DefinitionTest.php new file mode 100644 index 0000000..59b192f --- /dev/null +++ b/tests/integration/sqlite/DefinitionTest.php @@ -0,0 +1,60 @@ +dbName = ThrowawayDb::create(withData: false); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + /** + * Does the given named object exist in the database? + * + * @param string $name The name of the object whose existence should be verified + * @return bool True if the object exists, false if not + * @throws DocumentException If any is encountered + */ + private function itExists(string $name): bool + { + return Custom::scalar('SELECT EXISTS (SELECT 1 FROM sqlite_master WHERE name = :name)', + [':name' => $name], new ExistsMapper()); + } + + public function testEnsureTableSucceeds() + { + $this->assertFalse($this->itExists('ensured'), 'The table should not exist already'); + $this->assertFalse($this->itExists('idx_ensured_key'), 'The key index should not exist already'); + Definition::ensureTable('ensured'); + $this->assertTrue($this->itExists('ensured'), 'The table should now exist'); + $this->assertTrue($this->itExists('idx_ensured_key'), 'The key index should now exist'); + } + + public function testEnsureFieldIndexSucceeds() + { + $this->assertFalse($this->itExists('idx_ensured_test'), 'The index should not exist already'); + Definition::ensureTable('ensured'); + Definition::ensureFieldIndex('ensured', 'test', ['name', 'age']); + $this->assertTrue($this->itExists('idx_ensured_test'), 'The index should now exist'); + } +} diff --git a/tests/integration/sqlite/DeleteTest.php b/tests/integration/sqlite/DeleteTest.php new file mode 100644 index 0000000..58a664a --- /dev/null +++ b/tests/integration/sqlite/DeleteTest.php @@ -0,0 +1,59 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + #[TestDox('By ID succeeds when a document is deleted')] + public function testByIdSucceedsWhenADocumentIsDeleted(): void + { + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents to start'); + Delete::byId(ThrowawayDb::TABLE, 'four'); + $this->assertEquals(4, Count::all(ThrowawayDb::TABLE), 'There should have been 4 documents remaining'); + } + + #[TestDox('By ID succeeds when a document is not deleted')] + public function testByIdSucceedsWhenADocumentIsNotDeleted(): void + { + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents to start'); + Delete::byId(ThrowawayDb::TABLE, 'negative four'); + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents remaining'); + } + + public function testByFieldsSucceedsWhenDocumentsAreDeleted(): void + { + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents to start'); + Delete::byFields(ThrowawayDb::TABLE, [Field::NE('value', 'purple')]); + $this->assertEquals(2, Count::all(ThrowawayDb::TABLE), 'There should have been 2 documents remaining'); + } + + public function testByFieldsSucceedsWhenDocumentsAreNotDeleted(): void + { + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents to start'); + Delete::byFields(ThrowawayDb::TABLE, [Field::EQ('value', 'crimson')]); + $this->assertEquals(5, Count::all(ThrowawayDb::TABLE), 'There should have been 5 documents remaining'); + } +} diff --git a/tests/integration/sqlite/DocumentListTest.php b/tests/integration/sqlite/DocumentListTest.php new file mode 100644 index 0000000..08ff618 --- /dev/null +++ b/tests/integration/sqlite/DocumentListTest.php @@ -0,0 +1,73 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + public function testCreateSucceeds(): void + { + $list = DocumentList::create(Query::selectFromTable(ThrowawayDb::TABLE), [], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'There should have been a document list created'); + $list = null; + } + + public function testItems(): void + { + $list = DocumentList::create(Query::selectFromTable(ThrowawayDb::TABLE), [], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'There should have been a document list created'); + $count = 0; + foreach ($list->items() as $item) { + $this->assertContains($item->id, ['one', 'two', 'three', 'four', 'five'], + 'An unexpected document ID was returned'); + $count++; + } + $this->assertEquals(5, $count, 'There should have been 5 documents returned'); + } + + public function testHasItemsSucceedsWithEmptyResults(): void + { + $list = DocumentList::create(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'num_value' < 0", [], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'There should have been a document list created'); + $this->assertFalse($list->hasItems(), 'There should be no items in the list'); + } + + public function testHasItemsSucceedsWithNonEmptyResults(): void + { + $list = DocumentList::create(Query::selectFromTable(ThrowawayDb::TABLE), [], + new DocumentMapper(TestDocument::class)); + $this->assertNotNull($list, 'There should have been a document list created'); + $this->assertTrue($list->hasItems(), 'There should be items in the list'); + foreach ($list->items() as $ignored) { + $this->assertTrue($list->hasItems(), 'There should be items remaining in the list'); + } + $this->assertFalse($list->hasItems(), 'There should be no remaining items in the list'); + } +} diff --git a/tests/integration/sqlite/DocumentTest.php b/tests/integration/sqlite/DocumentTest.php new file mode 100644 index 0000000..2616633 --- /dev/null +++ b/tests/integration/sqlite/DocumentTest.php @@ -0,0 +1,84 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + public function testInsertSucceeds(): void + { + Document::insert(ThrowawayDb::TABLE, new TestDocument('turkey', sub: new SubDocument('gobble', 'gobble'))); + $doc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document inserted'); + $this->assertEquals('turkey', $doc->id, 'The ID was incorrect'); + $this->assertEquals('', $doc->value, 'The value was incorrect'); + $this->assertEquals(0, $doc->num_value, 'The numeric value was incorrect'); + $this->assertNotNull($doc->sub, 'The sub-document should not have been null'); + $this->assertEquals('gobble', $doc->sub->foo, 'The sub-document foo property was incorrect'); + $this->assertEquals('gobble', $doc->sub->bar, 'The sub-document bar property was incorrect'); + } + + public function testInsertFailsForDuplicateKey(): void + { + $this->expectException(DocumentException::class); + Document::insert(ThrowawayDb::TABLE, new TestDocument('one')); + } + + public function testSaveSucceedsWhenADocumentIsInserted(): void + { + Document::save(ThrowawayDb::TABLE, new TestDocument('test', sub: new SubDocument('a', 'b'))); + $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + } + + public function testSaveSucceedsWhenADocumentIsUpdated(): void + { + Document::save(ThrowawayDb::TABLE, new TestDocument('two', num_value: 44)); + $doc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals(44, $doc->num_value, 'The numeric value was not updated'); + $this->assertNull($doc->sub, 'The sub-document should have been null'); + } + + public function testUpdateSucceedsWhenReplacingADocument(): void + { + Document::update(ThrowawayDb::TABLE, 'one', new TestDocument('one', 'howdy', 8, new SubDocument('y', 'z'))); + $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals('howdy', $doc->value, 'The value was incorrect'); + $this->assertEquals(8, $doc->num_value, 'The numeric value was incorrect'); + $this->assertNotNull($doc->sub, 'The sub-document should not have been null'); + $this->assertEquals('y', $doc->sub->foo, 'The sub-document foo property was incorrect'); + $this->assertEquals('z', $doc->sub->bar, 'The sub-document bar property was incorrect'); + } + + public function testUpdateSucceedsWhenNoDocumentIsReplaced(): void + { + Document::update(ThrowawayDb::TABLE, 'two-hundred', new TestDocument('200')); + $doc = Find::byId(ThrowawayDb::TABLE, 'two-hundred', TestDocument::class); + $this->assertFalse($doc, 'There should not have been a document returned'); + } +} diff --git a/tests/integration/sqlite/ExistsTest.php b/tests/integration/sqlite/ExistsTest.php new file mode 100644 index 0000000..0454b10 --- /dev/null +++ b/tests/integration/sqlite/ExistsTest.php @@ -0,0 +1,54 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + #[TestDox('By ID succeeds when a document exists')] + public function testByIdSucceedsWhenADocumentExists(): void + { + $this->assertTrue(Exists::byId(ThrowawayDb::TABLE, 'three'), 'There should have been an existing document'); + } + + #[TestDox('By ID succeeds when a document does not exist')] + public function testByIdSucceedsWhenADocumentDoesNotExist(): void + { + $this->assertFalse(Exists::byId(ThrowawayDb::TABLE, 'seven'), + 'There should not have been an existing document'); + } + + public function testByFieldsSucceedsWhenDocumentsExist(): void + { + $this->assertTrue(Exists::byFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 10)]), + 'There should have been existing documents'); + } + + public function testByFieldsSucceedsWhenNoMatchingDocumentsExist(): void + { + $this->assertFalse(Exists::byFields(ThrowawayDb::TABLE, [Field::LT('nothing', 'none')]), + 'There should not have been any existing documents'); + } +} diff --git a/tests/integration/sqlite/FindTest.php b/tests/integration/sqlite/FindTest.php new file mode 100644 index 0000000..c3b7ced --- /dev/null +++ b/tests/integration/sqlite/FindTest.php @@ -0,0 +1,109 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + public function testAllSucceedsWhenThereIsData(): void + { + $docs = Find::all(ThrowawayDb::TABLE, TestDocument::class); + $this->assertNotNull($docs, 'There should have been a document list returned'); + $count = 0; + foreach ($docs->items() as $ignored) $count++; + $this->assertEquals(5, $count, 'There should have been 5 documents in the list'); + } + + public function testAllSucceedsWhenThereIsNoData(): void + { + Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []); + $docs = Find::all(ThrowawayDb::TABLE, TestDocument::class); + $this->assertNotNull($docs, 'There should have been a document list returned'); + $this->assertFalse($docs->hasItems(), 'There should have been no documents in the list'); + } + + #[TestDox('By ID succeeds when a document is found')] + public function testByIdSucceedsWhenADocumentIsFound(): void + { + $doc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals('two', $doc->id, 'An incorrect document was returned'); + } + + #[TestDox('By ID succeeds when a document is found with numeric ID')] + public function testByIdSucceedsWhenADocumentIsFoundWithNumericId(): void + { + Document::insert(ThrowawayDb::TABLE, ['id' => 18, 'value' => 'howdy']); + $doc = Find::byId(ThrowawayDb::TABLE, 18, TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals('18', $doc->id, 'An incorrect document was returned'); + } + + #[TestDox('By ID succeeds when a document is not found')] + public function testByIdSucceedsWhenADocumentIsNotFound(): void + { + $doc = Find::byId(ThrowawayDb::TABLE, 'seventy-five', TestDocument::class); + $this->assertFalse($doc, 'There should not have been a document returned'); + } + + public function testByFieldsSucceedsWhenDocumentsAreFound(): void + { + $docs = Find::byFields(ThrowawayDb::TABLE, [Field::GT('num_value', 15)], TestDocument::class); + $this->assertNotNull($docs, 'There should have been a document list returned'); + $count = 0; + foreach ($docs->items() as $ignored) $count++; + $this->assertEquals(2, $count, 'There should have been 2 documents in the list'); + } + + public function testByFieldsSucceedsWhenNoDocumentsAreFound(): void + { + $docs = Find::byFields(ThrowawayDb::TABLE, [Field::GT('num_value', 100)], TestDocument::class); + $this->assertNotNull($docs, 'There should have been a document list returned'); + $count = 0; + foreach ($docs->items() as $ignored) $count++; + $this->assertFalse($docs->hasItems(), 'There should have been no documents in the list'); + } + + public function testFirstByFieldsSucceedsWhenADocumentIsFound(): void + { + $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'another')], TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals('two', $doc->id, 'The incorrect document was returned'); + } + + public function testFirstByFieldsSucceedsWhenMultipleDocumentsAreFound(): void + { + $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('sub.foo', 'green')], TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertContains($doc->id, ['two', 'four'], 'An incorrect document was returned'); + } + + public function testFirstByFieldsSucceedsWhenADocumentIsNotFound(): void + { + $doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::EQ('value', 'absent')], TestDocument::class); + $this->assertFalse($doc, 'There should not have been a document returned'); + } +} diff --git a/tests/integration/sqlite/PatchTest.php b/tests/integration/sqlite/PatchTest.php new file mode 100644 index 0000000..ce64f24 --- /dev/null +++ b/tests/integration/sqlite/PatchTest.php @@ -0,0 +1,60 @@ +dbName = ThrowawayDb::create(); + } + + protected function tearDown(): void + { + ThrowawayDb::destroy($this->dbName); + parent::tearDown(); + } + + #[TestDox('By ID succeeds when a document is updated')] + public function testByIdSucceedsWhenADocumentIsUpdated(): void + { + Patch::byId(ThrowawayDb::TABLE, 'one', ['num_value' => 44]); + $doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertEquals(44, $doc->num_value, 'The updated document is not correct'); + } + + #[TestDox('By ID succeeds when no document is updated')] + public function testByIdSucceedsWhenNoDocumentIsUpdated(): void + { + Patch::byId(ThrowawayDb::TABLE, 'forty-seven', ['foo' => 'green']); + $this->assertTrue(true, 'The above not throwing an exception is the test'); + } + + + public function testByFieldsSucceedsWhenADocumentIsUpdated(): void + { + Patch::byFields(ThrowawayDb::TABLE, [Field::EQ('value', 'purple')], ['num_value' => 77]); + $after = Count::byFields(ThrowawayDb::TABLE, [Field::EQ('num_value', 77)]); + $this->assertEquals(2, $after, 'There should have been 2 documents updated'); + } + + public function testByFieldsSucceedsWhenNoDocumentIsUpdated(): void + { + Patch::byFields(ThrowawayDb::TABLE, [Field::EQ('value', 'burgundy')], ['foo' => 'green']); + $this->assertTrue(true, 'The above not throwing an exception is the test'); + } +} diff --git a/tests/integration/sqlite/RemoveFieldsTest.php b/tests/integration/sqlite/RemoveFieldsTest.php new file mode 100644 index 0000000..e1b3cf1 --- /dev/null +++ b/tests/integration/sqlite/RemoveFieldsTest.php @@ -0,0 +1,74 @@ +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']); + $doc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class); + $this->assertNotFalse($doc, 'There should have been a document returned'); + $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->assertNotFalse($doc, 'There should have been a document returned'); + $this->assertNull($doc->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'); + } +} diff --git a/tests/integration/sqlite/ThrowawayDb.php b/tests/integration/sqlite/ThrowawayDb.php new file mode 100644 index 0000000..5a3ab64 --- /dev/null +++ b/tests/integration/sqlite/ThrowawayDb.php @@ -0,0 +1,71 @@ +assertEquals('id', Configuration::$idField, 'Default ID field should be "id"'); + } + + #[TestDox('ID field change succeeds')] + public function testIdFieldChangeSucceeds() + { + try { + Configuration::$idField = 'EyeDee'; + $this->assertEquals('EyeDee', Configuration::$idField, 'ID field should have been updated'); + } finally { + Configuration::$idField = 'id'; + $this->assertEquals('id', Configuration::$idField, 'Default ID value should have been restored'); + } + } + + #[TestDox("Db conn fails when no DSN specified")] + public function testDbConnFailsWhenNoDSNSpecified(): void + { + $this->expectException(DocumentException::class); + Configuration::$pdoDSN = ''; + Configuration::dbConn(); + } +} diff --git a/tests/unit/DocumentExceptionTest.php b/tests/unit/DocumentExceptionTest.php new file mode 100644 index 0000000..7103575 --- /dev/null +++ b/tests/unit/DocumentExceptionTest.php @@ -0,0 +1,46 @@ +assertNotNull($ex, 'The exception should not have been null'); + $this->assertEquals('Test Exception', $ex->getMessage(), 'Message not filled properly'); + $this->assertEquals(17, $ex->getCode(), 'Code not filled properly'); + $this->assertSame($priorEx, $ex->getPrevious(), 'Prior exception not filled properly'); + } + + public function testConstructorSucceedsWithoutCodeAndPriorException() + { + $ex = new DocumentException('Oops'); + $this->assertNotNull($ex, 'The exception should not have been null'); + $this->assertEquals('Oops', $ex->getMessage(), 'Message not filled properly'); + $this->assertEquals(0, $ex->getCode(), 'Code not filled properly'); + $this->assertNull($ex->getPrevious(), 'Prior exception should have been null'); + } + + public function testToStringSucceedsWithoutCode() + { + $ex = new DocumentException('Test failure'); + $this->assertEquals("BitBadger\PDODocument\DocumentException: Test failure\n", "$ex", + 'toString not generated correctly'); + } + + public function testToStringSucceedsWithCode() + { + $ex = new DocumentException('Oof', -6); + $this->assertEquals("BitBadger\PDODocument\DocumentException: [-6] Oof\n", "$ex", + 'toString not generated correctly'); + } +} diff --git a/tests/unit/FieldTest.php b/tests/unit/FieldTest.php new file mode 100644 index 0000000..421d131 --- /dev/null +++ b/tests/unit/FieldTest.php @@ -0,0 +1,446 @@ +assertEquals([], Field::EX('exists')->appendParameter([]), 'EX should not have appended a parameter'); + } + + #[TestDox('Append parameter succeeds for NEX')] + public function testAppendParameterSucceedsForNEX(): void + { + $this->assertEquals([], Field::NEX('absent')->appendParameter([]), 'NEX should not have appended a parameter'); + } + + #[TestDox('Append parameter succeeds for BT')] + public function testAppendParameterSucceedsForBT(): void + { + $this->assertEquals(['@nummin' => 5, '@nummax' => 9], Field::BT('exists', 5, 9, '@num')->appendParameter([]), + 'BT should have appended min and max parameters'); + } + + public function testAppendParameterSucceedsForOthers(): void + { + $this->assertEquals(['@test' => 33], Field::EQ('the_field', 33, '@test')->appendParameter([]), + 'Field parameter not returned correctly'); + } + + #[TestDox('To where succeeds for EX without qualifier for PostgreSQL')] + public function testToWhereSucceedsForEXWithoutQualifierForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $this->assertEquals("data->>'that_field' IS NOT NULL", Field::EX('that_field')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for EX without qualifier for SQLite')] + public function testToWhereSucceedsForEXWithoutQualifierForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $this->assertEquals("data->>'that_field' IS NOT NULL", Field::EX('that_field')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for NEX without qualifier for PostgreSQL')] + public function testToWhereSucceedsForNEXWithoutQualifierForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $this->assertEquals("data->>'a_field' IS NULL", Field::NEX('a_field')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for NEX without qualifier for SQLite')] + public function testToWhereSucceedsForNEXWithoutQualifierForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $this->assertEquals("data->>'a_field' IS NULL", Field::NEX('a_field')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for BT without qualifier for SQLite')] + public function testToWhereSucceedsForBTWithoutQualifierForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $this->assertEquals("data->>'age' BETWEEN @agemin AND @agemax", Field::BT('age', 13, 17, '@age')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for BT without qualifier for PostgreSQL with numeric range')] + public function testToWhereSucceedsForBTWithoutQualifierForPostgreSQLWithNumericRange(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $this->assertEquals("(data->>'age')::numeric BETWEEN @agemin AND @agemax", + Field::BT('age', 13, 17, '@age')->toWhere(), 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for BT without qualifier for PostgreSQL with non-numeric range')] + public function testToWhereSucceedsForBTWithoutQualifierForPostgreSQLWithNonNumericRange(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $this->assertEquals("data->>'city' BETWEEN :citymin AND :citymax", + Field::BT('city', 'Atlanta', 'Chicago', ':city')->toWhere(), 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for BT with qualifier for SQLite')] + public function testToWhereSucceedsForBTWithQualifierForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $field = Field::BT('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::$mode = null; + } + } + + #[TestDox('To where succeeds for BT with qualifier for PostgreSQL with numeric range')] + public function testToWhereSucceedsForBTWithQualifierForPostgreSQLWithNumericRange(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $field = Field::BT('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::$mode = null; + } + } + + #[TestDox('To where succeeds for BT with qualifier for PostgreSQL with non-numeric range')] + public function testToWhereSucceedsForBTWithQualifierForPostgreSQLWithNonNumericRange(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $field = Field::BT('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::$mode = null; + } + } + + #[TestDox('To where succeeds for others without qualifier for PostgreSQL')] + public function testToWhereSucceedsForOthersWithoutQualifierForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $this->assertEquals("data->>'some_field' = @value", Field::EQ('some_field', '', '@value')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds for others without qualifier for SQLite')] + public function testToWhereSucceedsForOthersWithoutQualifierForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $this->assertEquals("data->>'some_field' = @value", Field::EQ('some_field', '', '@value')->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with qualifier no parameter for PostgreSQL')] + public function testToWhereSucceedsWithQualifierNoParameterForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $field = Field::EX('no_field'); + $field->qualifier = 'test'; + $this->assertEquals("test.data->>'no_field' IS NOT NULL", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with qualifier no parameter for SQLite')] + public function testToWhereSucceedsWithQualifierNoParameterForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $field = Field::EX('no_field'); + $field->qualifier = 'test'; + $this->assertEquals("test.data->>'no_field' IS NOT NULL", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with qualifier and parameter for PostgreSQL')] + public function testToWhereSucceedsWithQualifierAndParameterForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $field = Field::LE('le_field', 18, '@it'); + $field->qualifier = 'q'; + $this->assertEquals("q.data->>'le_field' <= @it", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with qualifier and parameter for SQLite')] + public function testToWhereSucceedsWithQualifierAndParameterForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $field = Field::LE('le_field', 18, '@it'); + $field->qualifier = 'q'; + $this->assertEquals("q.data->>'le_field' <= @it", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with sub-document for PostgreSQL')] + public function testToWhereSucceedsWithSubDocumentForPostgreSQL(): void + { + Configuration::$mode = Mode::PgSQL; + try { + $field = Field::EQ('sub.foo.bar', 22, '@it'); + $this->assertEquals("data->>'sub.foo.bar' = @it", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('To where succeeds with sub-document for SQLite')] + public function testToWhereSucceedsWithSubDocumentForSQLite(): void + { + Configuration::$mode = Mode::SQLite; + try { + $field = Field::EQ('sub.foo.bar', 22, '@it'); + $this->assertEquals("data->>'sub'->>'foo'->>'bar' = @it", $field->toWhere(), + 'WHERE fragment not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('EQ succeeds without parameter')] + public function testEQSucceedsWithoutParameter(): void + { + $field = Field::EQ('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::EQ, $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('EQ succeeds with parameter')] + public function testEQSucceedsWithParameter(): void + { + $field = Field::EQ('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::EQ, $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('GT succeeds without parameter')] + public function testGTSucceedsWithoutParameter(): void + { + $field = Field::GT('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::GT, $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('GT succeeds with parameter')] + public function testGTSucceedsWithParameter(): void + { + $field = Field::GT('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::GT, $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('GE succeeds without parameter')] + public function testGESucceedsWithoutParameter(): void + { + $field = Field::GE('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::GE, $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('GE succeeds with parameter')] + public function testGESucceedsWithParameter(): void + { + $field = Field::GE('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::GE, $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('LT succeeds without parameter')] + public function testLTSucceedsWithoutParameter(): void + { + $field = Field::LT('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::LT, $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('LT succeeds with parameter')] + public function testLTSucceedsWithParameter(): void + { + $field = Field::LT('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::LT, $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('LE succeeds without parameter')] + public function testLESucceedsWithoutParameter(): void + { + $field = Field::LE('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::LE, $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('LE succeeds with parameter')] + public function testLESucceedsWithParameter(): void + { + $field = Field::LE('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::LE, $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('NE succeeds without parameter')] + public function testNESucceedsWithoutParameter(): void + { + $field = Field::NE('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::NE, $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('NE succeeds with parameter')] + public function testNESucceedsWithParameter(): void + { + $field = Field::NE('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::NE, $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('BT succeeds without parameter')] + public function testBTSucceedsWithoutParameter(): void + { + $field = Field::BT('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::BT, $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('BT succeeds with parameter')] + public function testBTSucceedsWithParameter(): void + { + $field = Field::BT('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::BT, $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('EX succeeds')] + public function testEXSucceeds(): void + { + $field = Field::EX('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::EX, $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('NEX succeeds')] + public function testNEXSucceeds(): void + { + $field = Field::NEX('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::NEX, $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'); + } +} diff --git a/tests/unit/Mapper/ArrayMapperTest.php b/tests/unit/Mapper/ArrayMapperTest.php new file mode 100644 index 0000000..51a8603 --- /dev/null +++ b/tests/unit/Mapper/ArrayMapperTest.php @@ -0,0 +1,19 @@ + 2, 'three' => 4, 'eight' => 'five']; + $mapped = (new ArrayMapper())->map($result); + $this->assertSame($result, $mapped, 'The array mapper should return the parameter given to it'); + } +} diff --git a/tests/unit/Mapper/CountMapperTest.php b/tests/unit/Mapper/CountMapperTest.php new file mode 100644 index 0000000..130763a --- /dev/null +++ b/tests/unit/Mapper/CountMapperTest.php @@ -0,0 +1,17 @@ +assertEquals(5, (new CountMapper())->map([5, 8, 10]), 'Count not correct'); + } +} diff --git a/tests/unit/Mapper/DocumentMapperTest.php b/tests/unit/Mapper/DocumentMapperTest.php new file mode 100644 index 0000000..5213312 --- /dev/null +++ b/tests/unit/Mapper/DocumentMapperTest.php @@ -0,0 +1,56 @@ +assertEquals('data', $mapper->fieldName, 'Default field name should have been "data"'); + } + + public function testConstructorSucceedsWithSpecifiedField(): void + { + $mapper = new DocumentMapper(Field::class, 'json'); + $this->assertEquals('json', $mapper->fieldName, 'Field name not recorded correctly'); + } + + #[TestDox('Map succeeds with valid JSON')] + public function testMapSucceedsWithValidJSON(): void + { + $doc = (new DocumentMapper(TestDocument::class))->map(['data' => '{"id":7,"subDoc":{"id":22,"name":"tester"}}']); + $this->assertNotNull($doc, 'The document should not have been null'); + $this->assertEquals(7, $doc->id, 'ID not filled correctly'); + $this->assertNotNull($doc->subDoc, 'The sub-document should not have been null'); + $this->assertEquals(22, $doc->subDoc->id, 'Sub-document ID not filled correctly'); + $this->assertEquals('tester', $doc->subDoc->name, 'Sub-document name not filled correctly'); + } + + #[TestDox('Map fails with invalid JSON')] + public function testMapFailsWithInvalidJSON(): void + { + $this->expectException(DocumentException::class); + (new DocumentMapper(TestDocument::class))->map(['data' => 'this is not valid']); + } +} diff --git a/tests/unit/Mapper/ExistsMapperTest.php b/tests/unit/Mapper/ExistsMapperTest.php new file mode 100644 index 0000000..1dbaf02 --- /dev/null +++ b/tests/unit/Mapper/ExistsMapperTest.php @@ -0,0 +1,43 @@ +assertFalse((new ExistsMapper())->map([false, 'nope']), 'Result should have been false'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('Map succeeds for SQLite')] + public function testMapSucceedsForSQLite(): void + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertTrue((new ExistsMapper())->map([1, 'yep']), 'Result should have been true'); + } finally { + Configuration::$mode = null; + } + } + + public function testMapFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + (new ExistsMapper())->map(['0']); + } +} diff --git a/tests/unit/Mapper/StringMapperTest.php b/tests/unit/Mapper/StringMapperTest.php new file mode 100644 index 0000000..57c1c0a --- /dev/null +++ b/tests/unit/Mapper/StringMapperTest.php @@ -0,0 +1,29 @@ + 'test_value']; + $mapper = new StringMapper('test_field'); + $this->assertEquals('test_value', $mapper->map($result), 'String value not returned correctly'); + } + + public function testMapSucceedsWhenFieldIsPresentAndNotString() + { + $result = ['a_number' => 6.7]; + $mapper = new StringMapper('a_number'); + $this->assertEquals('6.7', $mapper->map($result), 'Number value not returned correctly'); + } + + public function testMapSucceedsWhenFieldIsNotPresent() + { + $mapper = new StringMapper('something_else'); + $this->assertNull($mapper->map([]), 'Missing value not returned correctly'); + } +} diff --git a/tests/unit/OpTest.php b/tests/unit/OpTest.php new file mode 100644 index 0000000..3cb3106 --- /dev/null +++ b/tests/unit/OpTest.php @@ -0,0 +1,67 @@ +assertEquals('=', Op::EQ->toString(), 'EQ operator incorrect'); + } + + #[TestDox('To string succeeds for GT')] + public function testToStringSucceedsForGT(): void + { + $this->assertEquals('>', Op::GT->toString(), 'GT operator incorrect'); + } + + #[TestDox('To string succeeds for GE')] + public function testToStringSucceedsForGE(): void + { + $this->assertEquals('>=', Op::GE->toString(), 'GE operator incorrect'); + } + + #[TestDox('To string succeeds for LT')] + public function testToStringSucceedsForLT(): void + { + $this->assertEquals('<', Op::LT->toString(), 'LT operator incorrect'); + } + + #[TestDox('To string succeeds for LE')] + public function testToStringSucceedsForLE(): void + { + $this->assertEquals('<=', Op::LE->toString(), 'LE operator incorrect'); + } + + #[TestDox('To string succeeds for NE')] + public function testToStringSucceedsForNE(): void + { + $this->assertEquals('<>', Op::NE->toString(), 'NE operator incorrect'); + } + + #[TestDox('To string succeeds for BT')] + public function testToStringSucceedsForBT(): void + { + $this->assertEquals('BETWEEN', Op::BT->toString(), 'BT operator incorrect'); + } + + #[TestDox('To string succeeds for EX')] + public function testToStringSucceedsForEX(): void + { + $this->assertEquals('IS NOT NULL', Op::EX->toString(), 'EX operator incorrect'); + } + + #[TestDox('To string succeeds for NEX')] + public function testToStringSucceedsForNEX(): void + { + $this->assertEquals('IS NULL', Op::NEX->toString(), 'NEX operator incorrect'); + } +} diff --git a/tests/unit/ParametersTest.php b/tests/unit/ParametersTest.php new file mode 100644 index 0000000..a633124 --- /dev/null +++ b/tests/unit/ParametersTest.php @@ -0,0 +1,79 @@ +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' => "ARRAY['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('', []); + } +} diff --git a/tests/unit/Query/CountTest.php b/tests/unit/Query/CountTest.php new file mode 100644 index 0000000..69eb6a7 --- /dev/null +++ b/tests/unit/Query/CountTest.php @@ -0,0 +1,31 @@ +assertEquals('SELECT COUNT(*) FROM a_table', Count::all('a_table'), + 'SELECT statement not generated correctly'); + } + + public function testByFieldsSucceeds() + { + Configuration::$mode = Mode::SQLite; + try { + $this->assertEquals("SELECT COUNT(*) FROM somewhere WHERE data->>'errors' > :errors", + Count::byFields('somewhere', [Field::GT('errors', 10, ':errors')])); + } finally { + Configuration::$mode = null; + } + } +} diff --git a/tests/unit/Query/DefinitionTest.php b/tests/unit/Query/DefinitionTest.php new file mode 100644 index 0000000..c579db3 --- /dev/null +++ b/tests/unit/Query/DefinitionTest.php @@ -0,0 +1,65 @@ +assertEquals('CREATE TABLE IF NOT EXISTS documents (data JSONB NOT NULL)', + Definition::ensureTable('documents'), 'CREATE TABLE statement not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('Ensure table succeeds for SQLite')] + public function testEnsureTableSucceedsForSQLite(): void + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals('CREATE TABLE IF NOT EXISTS dox (data TEXT NOT NULL)', Definition::ensureTable('dox'), + 'CREATE TABLE statement not generated correctly'); + } finally { + Configuration::$mode = null; + } + } + + public function testEnsureTableFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + Definition::ensureTable('boom'); + } + + public function testEnsureIndexOnSucceedsWithoutSchemaSingleAscendingField(): void + { + $this->assertEquals("CREATE INDEX IF NOT EXISTS idx_test_fields ON test ((data->>'details'))", + Definition::ensureIndexOn('test', 'fields', ['details']), 'CREATE INDEX statement not generated correctly'); + } + + public function testEnsureIndexOnSucceedsWithSchemaMultipleFields(): void + { + $this->assertEquals( + "CREATE INDEX IF NOT EXISTS idx_testing_json ON sch.testing ((data->>'group'), (data->>'sub_group') DESC)", + Definition::ensureIndexOn('sch.testing', 'json', ['group', 'sub_group DESC']), + 'CREATE INDEX statement not generated correctly'); + } + + public function testEnsureKey(): void + { + $this->assertEquals("CREATE UNIQUE INDEX IF NOT EXISTS idx_tbl_key ON tbl ((data->>'id'))", + Definition::ensureKey('tbl'), 'CREATE INDEX statement for document key not generated correctly'); + } +} diff --git a/tests/unit/Query/DeleteTest.php b/tests/unit/Query/DeleteTest.php new file mode 100644 index 0000000..1ac3c7b --- /dev/null +++ b/tests/unit/Query/DeleteTest.php @@ -0,0 +1,38 @@ +assertEquals("DELETE FROM over_there WHERE data->>'id' = :id", Delete::byId('over_there'), + 'DELETE statement not constructed correctly'); + } + + public function testByFieldsSucceeds(): void + { + $this->assertEquals("DELETE FROM my_table WHERE data->>'value' < :max AND data->>'value' >= :min", + Delete::byFields('my_table', [Field::LT('value', 99, ':max'), Field::GE('value', 18, ':min')]), + 'DELETE statement not constructed correctly'); + } +} diff --git a/tests/unit/Query/ExistsTest.php b/tests/unit/Query/ExistsTest.php new file mode 100644 index 0000000..416c9dd --- /dev/null +++ b/tests/unit/Query/ExistsTest.php @@ -0,0 +1,44 @@ +assertEquals('SELECT EXISTS (SELECT 1 FROM abc WHERE def)', Exists::query('abc', 'def'), + 'Existence query not generated correctly'); + } + + #[TestDox('By ID succeeds')] + public function testByIdSucceeds(): void + { + $this->assertEquals("SELECT EXISTS (SELECT 1 FROM dox WHERE data->>'id' = :id)", Exists::byId('dox'), + 'Existence query not generated correctly'); + } + + public function testByFieldsSucceeds(): void + { + $this->assertEquals("SELECT EXISTS (SELECT 1 FROM box WHERE data->>'status' <> :status)", + Exists::byFields('box', [Field::NE('status', 'occupied', ':status')]), + 'Existence query not generated correctly'); + } +} diff --git a/tests/unit/Query/FindTest.php b/tests/unit/Query/FindTest.php new file mode 100644 index 0000000..5b2fb9a --- /dev/null +++ b/tests/unit/Query/FindTest.php @@ -0,0 +1,38 @@ +assertEquals("SELECT data FROM here WHERE data->>'id' = :id", Find::byId('here'), + 'SELECT query not generated correctly'); + } + + public function testByFieldsSucceeds(): void + { + $this->assertEquals("SELECT data FROM there WHERE data->>'active' = :act OR data->>'locked' = :lock", + Find::byFields('there', [Field::EQ('active', true, ':act'), Field::EQ('locked', true, ':lock')], 'OR'), + 'SELECT query not generated correctly'); + } +} diff --git a/tests/unit/Query/PatchTest.php b/tests/unit/Query/PatchTest.php new file mode 100644 index 0000000..1be92a5 --- /dev/null +++ b/tests/unit/Query/PatchTest.php @@ -0,0 +1,80 @@ +assertEquals("UPDATE doc_table SET data = data || :data WHERE data->>'id' = :id", + Patch::byId('doc_table'), 'Patch UPDATE statement is not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By ID succeeds for SQLite')] + public function testByIdSucceedsForSQLite(): void + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals("UPDATE my_table SET data = json_patch(data, json(:data)) WHERE data->>'id' = :id", + Patch::byId('my_table'), 'Patch UPDATE statement is not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By ID fails when mode not set')] + public function testByIdFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + Patch::byId('oof'); + } + + #[TestDox('By fields succeeds for PostgreSQL')] + public function testByFieldsSucceedsForPostgreSQL(): void + { + try { + Configuration::$mode = Mode::PgSQL; + $this->assertEquals("UPDATE that SET data = data || :data WHERE data->>'something' < :some", + Patch::byFields('that', [Field::LT('something', 17, ':some')]), + 'Patch UPDATE statement is not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By fields succeeds for SQLite')] + public function testByFieldsSucceedsForSQLite(): void + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals( + "UPDATE a_table SET data = json_patch(data, json(:data)) WHERE data->>'something' > :it", + Patch::byFields('a_table', [Field::GT('something', 17, ':it')]), + 'Patch UPDATE statement is not correct'); + } finally { + Configuration::$mode = null; + } + } + + public function testByFieldsFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + Patch::byFields('oops', []); + } +} diff --git a/tests/unit/Query/RemoveFieldsTest.php b/tests/unit/Query/RemoveFieldsTest.php new file mode 100644 index 0000000..b4223e0 --- /dev/null +++ b/tests/unit/Query/RemoveFieldsTest.php @@ -0,0 +1,117 @@ +assertEquals('UPDATE taco SET data = data - :names WHERE it = true', + RemoveFields::update('taco', [':names' => "ARRAY['one','two']"], 'it = true'), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('Update succeeds for SQLite')] + public function testUpdateSucceedsForSQLite(): void + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals('UPDATE burrito SET data = json_remove(data, :name0, :name1, :name2) WHERE a = b', + RemoveFields::update('burrito', Parameters::fieldNames(':name', ['one', 'two', 'ten']), 'a = b'), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + public function testUpdateFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + RemoveFields::update('wow', [], ''); + } + + #[TestDox('By ID succeeds for PostgreSQL')] + public function testByIdSucceedsForPostgreSQL() + { + try { + Configuration::$mode = Mode::PgSQL; + $this->assertEquals("UPDATE churro SET data = data - :bite WHERE data->>'id' = :id", + RemoveFields::byId('churro', Parameters::fieldNames(':bite', ['byte'])), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By ID succeeds for SQLite')] + public function testByIdSucceedsForSQLite() + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals("UPDATE quesadilla SET data = json_remove(data, :bite0) WHERE data->>'id' = :id", + RemoveFields::byId('quesadilla', Parameters::fieldNames(':bite', ['byte'])), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By ID fails when mode not set')] + public function testByIdFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + RemoveFields::byId('oof', []); + } + + #[TestDox('By fields succeeds for PostgreSQL')] + public function testByFieldsSucceedsForPostgreSQL() + { + try { + Configuration::$mode = Mode::PgSQL; + $this->assertEquals("UPDATE enchilada SET data = data - :sauce WHERE data->>'cheese' = :queso", + RemoveFields::byFields('enchilada', [Field::EQ('cheese', 'jack', ':queso')], + Parameters::fieldNames(':sauce', ['white'])), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + #[TestDox('By fields succeeds for SQLite')] + public function testByFieldsSucceedsForSQLite() + { + try { + Configuration::$mode = Mode::SQLite; + $this->assertEquals( + "UPDATE chimichanga SET data = json_remove(data, :filling0) WHERE data->>'side' = :rice", + RemoveFields::byFields('chimichanga', [Field::EQ('side', 'beans', ':rice')], + Parameters::fieldNames(':filling', ['beef'])), + 'UPDATE statement not correct'); + } finally { + Configuration::$mode = null; + } + } + + public function testByFieldsFailsWhenModeNotSet(): void + { + $this->expectException(DocumentException::class); + Configuration::$mode = null; + RemoveFields::byFields('boing', [], []); + } +} diff --git a/tests/unit/QueryTest.php b/tests/unit/QueryTest.php new file mode 100644 index 0000000..b3ac80b --- /dev/null +++ b/tests/unit/QueryTest.php @@ -0,0 +1,80 @@ +assertEquals('SELECT data FROM testing', Query::selectFromTable('testing'), + 'Query not constructed correctly'); + } + + public function testWhereByFieldsSucceedsForSingleField(): void + { + $this->assertEquals("data->>'test_field' <= :it", + Query::whereByFields([Field::LE('test_field', '', ':it')]), 'WHERE fragment not constructed correctly'); + } + + public function testWhereByFieldsSucceedsForMultipleFields(): void + { + $this->assertEquals("data->>'test_field' <= :it AND data->>'other_field' = :other", + Query::whereByFields([Field::LE('test_field', '', ':it'), Field::EQ('other_field', '', ':other')]), + 'WHERE fragment not constructed correctly'); + } + + public function testWhereByFieldsSucceedsForMultipleFieldsWithOr(): void + { + $this->assertEquals("data->>'test_field' <= :it OR data->>'other_field' = :other", + Query::whereByFields([Field::LE('test_field', '', ':it'), Field::EQ('other_field', '', ':other')], 'OR'), + 'WHERE fragment not constructed correctly'); + } + + #[TestDox('Where by ID succeeds with default parameter')] + public function testWhereByIdSucceedsWithDefaultParameter(): void + { + $this->assertEquals("data->>'id' = :id", Query::whereById(), 'WHERE fragment not constructed correctly'); + } + + #[TestDox('Where by ID succeeds with specific parameter')] + public function testWhereByIdSucceedsWithSpecificParameter(): void + { + $this->assertEquals("data->>'id' = :di", Query::whereById(':di'), 'WHERE fragment not constructed correctly'); + } + + public function testInsertSucceeds(): void + { + $this->assertEquals('INSERT INTO my_table VALUES (:data)', Query::insert('my_table'), + 'INSERT statement not constructed correctly'); + } + + public function testSaveSucceeds(): void + { + $this->assertEquals( + "INSERT INTO test_tbl VALUES (:data) ON CONFLICT ((data->>'id')) DO UPDATE SET data = EXCLUDED.data", + Query::save('test_tbl'), 'INSERT ON CONFLICT statement not constructed correctly'); + } + + public function testUpdateSucceeds() + { + $this->assertEquals("UPDATE testing SET data = :data WHERE data->>'id' = :id", Query::update('testing'), + 'UPDATE statement not constructed correctly'); + } +}