From b9b312d94ac9227c2eacf68f5da11b5071ccbfe7 Mon Sep 17 00:00:00 2001 From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com> Date: Thu, 26 Jan 2023 16:10:02 +0200 Subject: [PATCH] Extended RedisJson support by implementing JSON.ARRAPPEND command (#924) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Added CommandResolver, moved resolve command logic there, added ClientConfiguration object * Fixed test, added dependecies * Added resolved command to commands array * Used aggregation approach for modules * Added decorator to check Redis JSON module version * Added support for JSON.SET and JSON.GET commands * Added separate workflow for redis-stack tests * Changed docker imange name to correct one * Fixed indentation * Added test coverage for JSON.GET command * Changed module version resolving using annotations mapping * Re-written CommandResolver test * Update ClientInterface.php * Changes to CI, readme, removed unused modules from configuration * Fixed build badge URL * Refactored annotation check to be generic for each module * Fixed bug with incorrect tests skip * Added CommandResolver, moved resolve command logic there, added ClientConfiguration object * Fixed test, added dependecies * Added resolved command to commands array * Used aggregation approach for modules * Added decorator to check Redis JSON module version * Added support for JSON.SET and JSON.GET commands * Added separate workflow for redis-stack tests * Changed docker imange name to correct one * Fixed indentation * Added test coverage for JSON.GET command * Changed module version resolving using annotations mapping * Re-written CommandResolver test * Update ClientInterface.php * Changes to CI, readme, removed unused modules from configuration * Fixed build badge URL * Refactored annotation check to be generic for each module * Fixed bug with incorrect tests skip * Fixed naming issue with nxXx argument * Removed redundant trait * Fixed NxXxArgument test * Added support for JSON.ARRAPPEND command Co-authored-by: Vladyslav Vildanov Co-authored-by: Till Krüss --- src/ClientContextInterface.php | 1 + src/ClientInterface.php | 1 + src/Command/Redis/Json/JSONARRAPPEND.php | 28 ++++ .../Command/Redis/Json/JSONARRAPPEND_Test.php | 132 ++++++++++++++++++ 4 files changed, 162 insertions(+) create mode 100644 src/Command/Redis/Json/JSONARRAPPEND.php create mode 100644 tests/Predis/Command/Redis/Json/JSONARRAPPEND_Test.php diff --git a/src/ClientContextInterface.php b/src/ClientContextInterface.php index c44b7658..83dabea5 100644 --- a/src/ClientContextInterface.php +++ b/src/ClientContextInterface.php @@ -99,6 +99,7 @@ use Predis\Command\CommandInterface; * @method $this hsetnx($key, $field, $value) * @method $this hvals($key) * @method $this hstrlen($key, $field) + * @method $this jsonarrappend(string $key, string $path = '$', ...$value) * @method $this jsondel(string $key, string $path = '$') * @method $this jsonget(string $key, string $indent = '', string $newline = '', string $space = '', string ...$paths) * @method $this jsonnumincrby(string $key, string $path, int $value) diff --git a/src/ClientInterface.php b/src/ClientInterface.php index 66efb88c..78505ac5 100644 --- a/src/ClientInterface.php +++ b/src/ClientInterface.php @@ -108,6 +108,7 @@ use Predis\Response\Status; * @method int hsetnx(string $key, string $field, string $value) * @method array hvals(string $key) * @method int hstrlen(string $key, string $field) + * @method array jsonarrappend(string $key, string $path = '$', ...$value) * @method int jsondel(string $key, string $path = '$') * @method string jsonget(string $key, string $indent = '', string $newline = '', string $space = '', string ...$paths) * @method string jsonnumincrby(string $key, string $path, int $value) diff --git a/src/Command/Redis/Json/JSONARRAPPEND.php b/src/Command/Redis/Json/JSONARRAPPEND.php new file mode 100644 index 00000000..1b2a9203 --- /dev/null +++ b/src/Command/Redis/Json/JSONARRAPPEND.php @@ -0,0 +1,28 @@ +getCommand(); + $command->setArguments($arguments); + + $this->assertSame($expected, $command->getArguments()); + } + + /** + * @group disconnected + */ + public function testParseResponse(): void + { + $this->assertSame(1, $this->getCommand()->parseResponse(1)); + } + + /** + * @group connected + * @dataProvider jsonProvider + * @param array $jsonArguments + * @param string $key + * @param string $path + * @param array $values + * @param array $expectedArrayLength + * @param string $expectedModifiedJson + * @return void + * @requiresRedisJsonVersion >= 1.0.0 + */ + public function testAppendItemsToGivenJsonArray( + array $jsonArguments, + string $key, + string $path, + array $values, + array $expectedArrayLength, + string $expectedModifiedJson + ): void { + $redis = $this->getClient(); + + $redis->jsonset(...$jsonArguments); + + $actualResponse = $redis->jsonarrappend($key, $path, ...$values); + + $this->assertSame($expectedArrayLength, $actualResponse); + $this->assertSame($expectedModifiedJson, $redis->jsonget($key)); + } + + public function jsonProvider(): array + { + return [ + 'append single item' => [ + ['key', '$', '{"key1":"value1","key2":["value1","value2"]}'], + 'key', + '$.key2', + ['"value3"'], + [3], + '{"key1":"value1","key2":["value1","value2","value3"]}', + ], + 'append multiple items - same type' => [ + ['key', '$', '{"key1":"value1","key2":["value1","value2"]}'], + 'key', + '$.key2', + ['"value3"', '"value4"'], + [4], + '{"key1":"value1","key2":["value1","value2","value3","value4"]}', + ], + 'append multiple items - different types' => [ + ['key', '$', '{"key1":"value1","key2":["value1","value2"]}'], + 'key', + '$.key2', + ['"value3"', '5'], + [4], + '{"key1":"value1","key2":["value1","value2","value3",5]}', + ], + 'append on root and nested level' => [ + ['key', '$', '{"key1":{"key2":["value1","value2"]},"key2":["value1","value2"]}'], + 'key', + '$..key2', + ['"value3"', '5'], + [4, 4], + '{"key1":{"key2":["value1","value2","value3",5]},"key2":["value1","value2","value3",5]}', + ], + 'append on root and nested level - not array key' => [ + ['key', '$', '{"key1":{"key2":"value2"},"key2":["value1","value2"]}'], + 'key', + '$..key2', + ['"value3"', '5'], + [4, null], + '{"key1":{"key2":"value2"},"key2":["value1","value2","value3",5]}', + ], + ]; + } +}