Reorganize exceptions

Author: BenMorel

src/Exception/InvalidPostcodeException.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Postcode\Exception;
+
+/**
+ * Exception thrown when trying to format an invalid postcode.
+ */
+final class InvalidPostcodeException extends PostcodeException
+{
+    public function __construct(
+        private readonly string $postcode,
+        private readonly string $country,
+    ) {
+        parent::__construct('Invalid postcode: ' . $postcode);
+    }
+
+    /**
+     * Returns the invalid postcode that triggered this exception.
+     */
+    public function getPostcode(): string
+    {
+        return $this->postcode;
+    }
+
+    /**
+     * Returns the ISO country code used to format the postcode.
+     */
+    public function getCountry(): string
+    {
+        return $this->country;
+    }
+}

src/Exception/PostcodeException.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Postcode\Exception;
+
+use RuntimeException;
+
+/**
+ * Base class for postcode exceptions.
+ */
+abstract class PostcodeException extends RuntimeException
+{
+}

src/Exception/UnknownCountryException.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Postcode\Exception;
+
+/**
+ * Exception thrown when trying to format a postcode with an unknown country code.
+ */
+final class UnknownCountryException extends PostcodeException
+{
+    public function __construct(
+        private readonly string $country,
+    ) {
+        parent::__construct('Unknown country: ' . $country);
+    }
+
+    /**
+     * Returns the ISO country code used to format the postcode.
+     */
+    public function getCountry(): string
+    {
+        return $this->country;
+    }
+}

src/InvalidPostcodeException.php

@@ -4,6 +4,9 @@
 
 namespace Brick\Postcode;
 
+use Brick\Postcode\Exception\InvalidPostcodeException;
+use Brick\Postcode\Exception\UnknownCountryException;
+
 use function array_key_exists;
 use function class_exists;
 use function preg_match;

src/PostcodeFormatter.php

@@ -4,9 +4,9 @@
 
 namespace Brick\Postcode\Tests;
 
-use Brick\Postcode\InvalidPostcodeException;
+use Brick\Postcode\Exception\InvalidPostcodeException;
+use Brick\Postcode\Exception\UnknownCountryException;
 use Brick\Postcode\PostcodeFormatter;
-use Brick\Postcode\UnknownCountryException;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;