Add plugin client builder

Author: Taluu

src/PluginClientBuilder.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Http\Client\Common;
+
+use Http\Client\HttpClient;
+use Http\Client\HttpAsyncClient;
+use Psr\Http\Client\ClientInterface;
+
+/**
+ * Build an instance of a PluginClient with a dynamic list of plugins.
+ *
+ * This builder is immutable, each "build" methods will instead create a new
+ * instance of itself with or without the affected plugin, destroying a
+ * potentially http client built in the new instance.
+ *
+ * @author Baptiste Clavié <clavie.b@gmail.com>
+ */
+final class PluginClientBuilder
+{
+    /** @var Plugin[] */
+    private $plugins = [];
+
+    /** @var ?PluginClient */
+    private $client;
+
+    public function addPlugin(Plugin $plugin): self
+    {
+        $builder = new self();
+
+        $builder->client = null;
+        $builder->plugins = $this->plugins;
+        $builder->plugins[get_class($plugin)] = $plugin;
+
+        return $builder;
+    }
+
+    public function removePlugin(string $fqcn): self
+    {
+        $builder = new self();
+
+        $builder->client = null;
+        $builder->plugins = $this->plugins;
+        unset($builder->plugins[$fqcn]);
+
+        return $builder;
+    }
+
+    /**
+     * @param ClientInterface | HttpClient | HttpAsyncClient $client Client to nest into the plugin client
+     */
+    public function createClient($client, array $options = []): PluginClient
+    {
+        if (!$client instanceof ClientInterface && !$client instanceof HttpClient && !$client instanceof HttpAsyncClient) {
+            throw new \RuntimeException('You must provide a valid http client');
+        }
+
+        if (null === $this->client) {
+            $this->client = new PluginClient(
+                $client,
+                array_values($this->plugins),
+                $options
+            );
+        }
+
+        return $this->client;
+    }
+}