feat(exceptions): better exception naming, add interface to group all exceptions (#118)

This implement the following pattern : 

* All exceptions throw by the lib implement the `AutoMapperException`
interface
 * Split exceptions in 3 categories : 
   * MetadataException : happens when loading metadata
   * CompileException : happens when generating code
   * RuntimeException : happens when executing the mapping

Author: Korbeil

src/AutoMapper.php

@@ -4,7 +4,7 @@
 
 namespace AutoMapper;
 
-use AutoMapper\Exception\NoMappingFoundException;
+use AutoMapper\Exception\InvalidMappingException;
 use AutoMapper\Generator\MapperGenerator;
 use AutoMapper\Generator\Shared\ClassDiscriminatorResolver;
 use AutoMapper\Loader\ClassLoaderInterface;
@@ -109,7 +109,7 @@ public function map(array|object $source, string|array|object $target, array $co
         }
 
         if ('array' === $sourceType && 'array' === $targetType) {
-            throw new NoMappingFoundException('Cannot map this value, both source and target are array.');
+            throw new InvalidMappingException('Cannot map this value, both source and target are array.');
         }
 
         return $this->getMapper($sourceType, $targetType)->map($source, $context);

src/Exception/NoMappingFoundException.php renamed to src/Exception/AutoMapperException.php

@@ -7,6 +7,6 @@
 /**
  * @author Joel Wurtz <[email protected]>
  */
-final class NoMappingFoundException extends RuntimeException
+interface AutoMapperException
 {
 }

src/Exception/BadMapDefinitionException.php

@@ -7,6 +7,6 @@
 /**
  * @author Joel Wurtz <[email protected]>
  */
-final class BadMapDefinitionException extends RuntimeException
+final class BadMapDefinitionException extends MetadataException
 {
 }

src/Exception/CompileException.php

@@ -7,6 +7,6 @@
 /**
  * @author Joel Wurtz <[email protected]>
  */
-final class CompileException extends RuntimeException
+final class CompileException extends \LogicException implements AutoMapperException
 {
 }

src/Exception/InvalidArgumentException.php

@@ -7,6 +7,6 @@
 /**
  * @author Baptiste Leduc <[email protected]>
  */
-final class InvalidArgumentException extends \InvalidArgumentException
+final class InvalidArgumentException extends \InvalidArgumentException implements AutoMapperException
 {
 }

src/Exception/InvalidMappingException.php

@@ -7,6 +7,6 @@
 /**
  * @author Joel Wurtz <[email protected]>
  */
-final class InvalidMappingException extends RuntimeException
+final class InvalidMappingException extends MetadataException
 {
 }

src/Exception/LogicException.php

@@ -7,6 +7,6 @@
 /**
  * @author Baptiste Leduc <[email protected]>
  */
-final class LogicException extends \LogicException
+final class LogicException extends \LogicException implements AutoMapperException
 {
 }

src/Exception/MetadataException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace AutoMapper\Exception;
+
+class MetadataException extends \RuntimeException implements AutoMapperException
+{
+}

src/Exception/MissingConstructorArgumentsException.php

@@ -4,7 +4,7 @@
 
 namespace AutoMapper\Exception;
 
-final class MissingConstructorArgumentsException extends \RuntimeException
+final class MissingConstructorArgumentsException extends RuntimeException
 {
     /**
      * @param string[]          $missingArguments

src/Exception/RuntimeException.php

@@ -4,9 +4,6 @@
 
 namespace AutoMapper\Exception;
 
-/**
- * @author Joel Wurtz <[email protected]>
- */
-class RuntimeException extends \RuntimeException
+class RuntimeException extends \RuntimeException implements AutoMapperException
 {
 }