Readme updated to describe refactored implementation

Author: remorhaz

README.md

@@ -5,12 +5,14 @@
 [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/remorhaz/php-json-patch/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/remorhaz/php-json-patch/?branch=master)
 [![codecov](https://codecov.io/gh/remorhaz/php-json-patch/branch/master/graph/badge.svg)](https://codecov.io/gh/remorhaz/php-json-patch)
 [![Infection MSI](https://badge.stryker-mutator.io/github.com/remorhaz/php-json-patch/master)](https://infection.github.io)
+[![Total Downloads](https://poser.pugx.org/remorhaz/php-json-patch/downloads)](https://packagist.org/packages/remorhaz/php-json-patch)
 [![License](https://poser.pugx.org/remorhaz/php-json-patch/license)](https://packagist.org/packages/remorhaz/php-json-patch)
 
 This library implements [RFC6902](https://tools.ietf.org/html/rfc6902)-compliant JSON patch tool.
 
 ## Requirements
 - PHP 7.3+
+- [JSON extension](https://www.php.net/manual/en/book.json.php) (ext-json) - required by [remorhaz/php-json-data](https://github.com/remorhaz/php-json-data) to access JSON documents.
 - [Internationalization functions](https://www.php.net/manual/en/book.intl.php) (ext-intl) - required by [`remorhaz/php-json-data`](https://github.com/remorhaz/php-json-data) to compare Unicode strings.
 
 # Installation
@@ -20,43 +22,45 @@ composer require remorhaz/php-json-patch
 ```
 
 # Documentation
-## Data accessors
-Patch tool utilizes JSON data accessor interfaces defined in package
-**[remorhaz/php-json-data](https://github.com/remorhaz/php-json-data)**. Read more about them in package documentation.
-There is a ready-to-work implementation in that package that works with native PHP structures (like the ones you get as
-a result of `json_decode` function). You can use `Remorhaz\JSON\Data\Reference\Selector` class to bind to patch data and
-`Remorhaz\JSON\Data\Reference\Writer` class to bind to the document that is to be patched. You can also implement your own accessors
-if you need to work with another sort of data (like unparsed JSON text, for example).
-
-## Using patch tool
-To apply JSON Patch to the JSON document you need just 4 simple steps:
-
-1. Create an instance of read-only accessor bound to your patch data.
-2. Create an instance of writabe accessor bound to your document.
-3. Create an object of `\Remorhaz\JSON\Patch\Patch` by calling it's constructor with a document accessor as an argument.
-4. Call its `apply()` method with patch accessor as an argument.
-
-## Example of usage
+### Accessing JSON document
+You can create accessible JSON document either from encoded JSON string or from decoded JSON data using corresponding _node value factory_:
 ```php
-<?php
+use Remorhaz\JSON\Data\Value\EncodedJson;
+use Remorhaz\JSON\Data\Value\DecodedJson;
+
+// Creating document from JSON-encoded string:
+$encodedValueFactory = EncodedJson\NodeValueFactory::create();
+$encodedJson = '{"a":1}';
+$document1 = $encodedValueFactory->createValue($encodedJson);
+
+// Creating document from decoded JSON data:
+$decodedValueFactory = DecodedJson\NodeValueFactory::create();
+$decodedJson = (object) ['a' => 1];
+$document2 = $decodedValueFactory->createValue($decodedJson);
+```
 
-use Remorhaz\JSON\Data\Reference\Selector;
-use Remorhaz\JSON\Data\Reference\Writer;
+## Creating and processing query
+You should use _query factory_ to create query from JSON Patch document. Then you should use _processor_ to apply that query:
+```php
+<?php
+use Remorhaz\JSON\Data\Value\EncodedJson;
 use Remorhaz\JSON\Patch\Processor\Processor;
+use Remorhaz\JSON\Patch\Query\QueryFactory;
+
+$encodedValueFactory = EncodedJson\NodeValueFactory::create();
+$queryFactory = QueryFactory::create();
+$processor = Processor::create();
 
-// Setting up document.
-$data = (object) ['a' => (object) ['b' => 'c', 'd' => 'e']];
-$dataWriter = new Writer($data);
+$patch = $encodedValueFactory->createValue('[{"op":"remove","path":"/0"}]');
+$query = $queryFactory->createQuery($patch);
 
-// Setting up patch.
-$patchData = [
-    (object) ['op' => 'add', 'path' => '/a/f', 'value' => 'g'],
-];
-$patchSelector = new Selector($patchData);
+$document = $encodedValueFactory->createValue('[1,2]');
+$result = $processor->apply($query, $document);
 
-// Applying the patch.
-(new Processor($dataWriter))->apply($patchSelector); // $data->a->f property is added and set to 'g'
+var_dump($result->encode()); // string: '[2]'
+var_dump($result->decode()); // array: [2]
 ```
+Note that result can be exported either to JSON-encoded string or to raw PHP value.
 
 # License
-PHP JSON Patch is licensed under MIT license.
+PHP JSON Patch is licensed under [MIT license](./LICENSE).

composer.json

@@ -19,7 +19,7 @@
     "php": "^7.3",
     "ext-intl": "*",
     "remorhaz/php-json-data": "^0.5.2",
-    "remorhaz/php-json-pointer": "dev-master"
+    "remorhaz/php-json-pointer": "^0.6.5"
   },
   "require-dev": {
     "phpunit/phpunit": "^8.4.3",