Add exception and deprecated factory method "createExternalApiClient"

Author: Ang3

src/Exception/ClientConfigException.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Ang3\Component\OdooApiClient\Exception;
+
+use Throwable;
+
+/**
+ * @author Joanis ROUANET
+ */
+class ClientConfigException extends OdooException
+{
+    /**
+     * @var array
+     */
+    private $config;
+
+    /**
+     * Constructor of the exception.
+     *
+     * @param string         $message
+     * @param array          $config
+     * @param Throwable|null $previous
+     */
+    public function __construct(string $message, array $config = [], Throwable $previous = null)
+    {
+        // Hydratation
+        $this->config = $config;
+
+        // Construction de l'exception parent
+        parent::__construct($message, 0, $previous);
+    }
+
+    /**
+     * @return array
+     */
+    public function getConfig()
+    {
+        return $this->config;
+    }
+}

src/Exception/OdooException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Ang3\Component\OdooApiClient\Exception;
+
+use RuntimeException;
+
+/**
+ * @author Joanis ROUANET
+ */
+class OdooException extends RuntimeException
+{
+}

src/Exception/RequestException.php

@@ -2,14 +2,13 @@
 
 namespace Ang3\Component\OdooApiClient\Exception;
 
-use RuntimeException;
 use Throwable;
 use Ang3\Component\OdooApiClient\ExternalApiClient;
 
 /**
  * @author Joanis ROUANET
  */
-class RequestException extends RuntimeException
+class RequestException extends OdooException
 {
     /**
      * @var ExternalApiClient
@@ -45,6 +44,7 @@ class RequestException extends RuntimeException
      * @param array             $parameters
      * @param array             $options
      * @param array             $result
+     * @param Throwable|null    $previous
      */
     public function __construct(ExternalApiClient $client, $method, $modelName, array $parameters = [], array $options = [], array $result = [], Throwable $previous = null)
     {

src/Factory/ApiClientFactory.php

@@ -2,7 +2,7 @@
 
 namespace Ang3\Component\OdooApiClient\Factory;
 
-use InvalidArgumentException;
+use Ang3\Component\OdooApiClient\Exception\ClientConfigException;
 use Ang3\Component\OdooApiClient\ExternalApiClient;
 
 /**
@@ -12,36 +12,51 @@
  */
 class ApiClientFactory
 {
+    /**
+     * @deprecated This method will be removed in 3.0. Please use method "create" instead.
+     *
+     * @param array $parameters
+     * @param array $options
+     *
+     * @return ExternalApiClient
+     */
+    public function createExternalApiClient(array $parameters = [], array $options = [])
+    {
+        trigger_error(sprintf('The method %s:%s() is deprecated and will be removed in 3.0. Please use %s:create() instead.', __CLASS__, __METHOD__, __CLASS__), E_USER_DEPRECATED);
+
+        return $this->create($parameters, $options);
+    }
+
     /**
      * Create external API client for Odoo from config array.
      *
      * @param array $parameters
      * @param array $options
      *
-     * @throws InvalidArgumentException when a required parameter is missing
+     * @throws ClientConfigException when a required parameter is missing
      *
      * @return ExternalApiClient
      */
-    public function createExternalApiClient(array $parameters = [], array $options = [])
+    public function create(array $parameters = [], array $options = [])
     {
         // Si pas d'URL
         if (!array_key_exists('url', $parameters)) {
-            throw new InvalidArgumentException('Missing required parameter "url".');
+            throw new ClientConfigException('Missing required parameter "url".');
         }
 
         // Si pas de nom de base de données Odoo
         if (!array_key_exists('database', $parameters)) {
-            throw new InvalidArgumentException('Missing required parameter "database".');
+            throw new ClientConfigException('Missing required parameter "database".');
         }
 
         // Si pas d'utilisateur
         if (!array_key_exists('user', $parameters)) {
-            throw new InvalidArgumentException('Missing required parameter "user".');
+            throw new ClientConfigException('Missing required parameter "user".');
         }
 
         // Si pas de mot de passe
         if (!array_key_exists('password', $parameters)) {
-            throw new InvalidArgumentException('Missing required parameter "password".');
+            throw new ClientConfigException('Missing required parameter "password".');
         }
 
         // Récupération des options éventuelles du client