version 3

Author: ddrv

.gitattributes

@@ -4,6 +4,5 @@
 *.yml   text eol=lf
 *.dist  text eol=lf
 LICENCE text eol=lf
-stuff/  export-ignore
 tests/  export-ignore
 *.dist  export-ignore

.github/ISSUE_TEMPLATE/bug_report.md

@@ -15,8 +15,8 @@ assignees: ddrv
 
 ### Additional info
 
-| Q                | A
-| ---------------- | ---
-| Library version  | 1.?
-| PHP version      | ?
-| Operating system | ?
+| Q                | A   |
+|------------------|-----|
+| Library version  | 3.? |
+| PHP version      | ?   |
+| Operating system | ?   |

.github/workflows/ci.yml

@@ -39,5 +39,8 @@ jobs:
       - name: Check code style
         run: vendor/bin/phpcs
 
+      - name: Stat Analise
+        run: vendor/bin/psalm
+
       - name: Run test suite
         run: vendor/bin/phpunit

.gitignore

@@ -2,3 +2,4 @@ vendor/
 composer.lock
 phpcs.xml
 phpunit.xml
+psalm.xml

README.md

@@ -12,7 +12,7 @@ Mock for PSR-18 HTTP client
 Add package to project
 
 ```bash
-composer require --dev webclient/fake-http-client:^2.0
+composer require --dev webclient/fake-http-client:^3.0
 ```
 
 Set autoload
@@ -40,16 +40,56 @@ $client = new FakeHttpClient($handler);
 
 $response = $client->sendRequest($request);
 ```
+# Handlers
 
-# Routing
+## SpecHandler
+
+This package provides universal handler `\Webclient\Fake\Handler\SpecHandler\SpecHandler` 
+and builder `\Webclient\Fake\Handler\SpecHandler\SpecHandlerBuilder`. 
+With it, you can customize the client for almost any need.
+
+```php
+<?php
+
+use Psr\Http\Message\ResponseInterface;
+use Webclient\Fake\FakeHttpClient;
+use Webclient\Fake\Handler\SpecHandler\SpecHandlerBuilder;
+use Webclient\Fake\Handler\SpecHandler\Rule;
+
+$builder = SpecHandlerBuilder::create();
+
+$builder
+    ->route(function (Rule $rule) {
+        $rule->notEqual('header.authorization', 'bearer xxx');
+        $rule->oneOf(function (Rule $rule) {
+            $rule->allOf(function (Rule $rule) {
+                $rule->equal('uri.path', '/api/v1/posts');
+                $rule->equal('method', 'POST');
+            });
+            $rule->allOf(function (Rule $rule) {
+                $rule->match('uri.path', '^/api/v1/posts/([a-zA-Z0-9\-]+)$');
+                $rule->match('method', '^(PUT|DELETE)$');
+            });
+        });
+    })
+    ->response(function (ResponseInterface $response): ResponseInterface {
+        return $response->withStatus(403);
+    });
+
+$handler = $builder->build();
+
+$client = new FakeHttpClient($handler);
+```
+
+## SimpleRoutingHandler
 
 This package provides simple routing.
 
 ```php
 <?php
 
 use Webclient\Fake\FakeHttpClient;
-use Webclient\Fake\Handler\SimpleRoutingHandler;
+use Webclient\Fake\Handler\SimpleRoutingHandler\SimpleRoutingHandler;
 use Psr\Http\Message\RequestInterface;
 use Psr\Http\Server\RequestHandlerInterface;
 

composer.json

@@ -17,13 +17,14 @@
     "ext-mbstring": "*",
     "psr/http-client": "^1.0",
     "psr/http-message": "^1.0",
+    "psr/http-factory": "^1.0",
     "psr/http-server-handler": "^1.0"
   },
   "require-dev": {
-    "psr/http-factory": "^1.0",
     "nyholm/psr7": "^1.5",
     "phpunit/phpunit": "^6.5 || ^7.5 || 8.5 || 9.5",
-    "squizlabs/php_codesniffer": "^3.5"
+    "squizlabs/php_codesniffer": "^3.5",
+    "vimeo/psalm": "^4.30"
   },
   "provide": {
     "psr/http-client-implementation": "1.0"
@@ -35,14 +36,19 @@
   },
   "autoload-dev": {
     "psr-4": {
-      "Webclient\\Stuff\\Fake\\": "stuff/",
-      "Webclient\\Tests\\Fake\\": "tests/"
+      "Tests\\Webclient\\Fake\\Tools\\": "tests/src",
+      "Tests\\Webclient\\Fake\\Unit\\": "tests/unit"
     }
   },
   "funding": [
     {
       "type": "other",
       "url": "https://www.paypal.me/ddrv"
     }
-  ]
+  ],
+  "config": {
+    "allow-plugins": {
+      "composer/package-versions-deprecated": true
+    }
+  }
 }

phpcs.xml.dist

@@ -12,6 +12,5 @@
 
     <!-- Paths to check -->
     <file>src</file>
-    <file>stuff</file>
     <file>tests</file>
 </ruleset>

phpunit.xml.dist

@@ -2,7 +2,7 @@
 <phpunit bootstrap="vendor/autoload.php" colors="true" cacheResult="false">
     <testsuites>
         <testsuite name="all">
-            <directory>tests</directory>
+            <directory>tests/unit</directory>
         </testsuite>
     </testsuites>
 </phpunit>

psalm.xml.dist

@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<psalm
+    errorLevel="1"
+    resolveFromConfigFile="true"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="https://getpsalm.org/schema/config"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+</psalm>

src/Exception/NetworkError.php

@@ -9,7 +9,7 @@
 use Psr\Http\Message\RequestInterface;
 use Throwable;
 
-class NetworkError extends Exception implements NetworkExceptionInterface
+final class NetworkError extends Exception implements NetworkExceptionInterface
 {
     private RequestInterface $request;