Enhancements to exceptions and BE, LU formatters

.gitignore

@@ -1,3 +1,4 @@
 /vendor
 /composer.lock
 /.phpunit.result.cache
+/.idea

src/InvalidPostcodeException.php

@@ -9,4 +9,39 @@
  */
 class InvalidPostcodeException extends \Exception
 {
+    protected string $postcode;
+    protected string $country;
+
+    /**
+     * Construct exception thrown when trying to format an invalid postcode.
+     *
+     * @param string $postcode
+     * @param string $country
+     */
+    public function __construct(string $postcode, string $country)
+    {
+        parent::__construct('Invalid postcode: ' . $postcode);
+        $this->postcode = $postcode;
+        $this->country = $country;
+    }
+
+    /**
+     * Get the invalid postcode associated with this exception.
+     *
+     * @return string
+     */
+    public function getPostcode(): string
+    {
+        return $this->postcode;
+    }
+
+    /**
+     * Get the country code associated with this exception.
+     *
+     * @return string
+     */
+    public function getCountryCode(): string
+    {
+        return $this->country;
+    }
 }

src/PostcodeFormatter.php

@@ -38,17 +38,17 @@ public function format(string $country, string $postcode) : string
         $formatter = $this->getFormatter($country);
 
         if ($formatter === null) {
-            throw new UnknownCountryException('Unknown country: ' . $country);
+            throw new UnknownCountryException($country);
         }
 
         if (preg_match('/^[A-Z0-9]+$/', $postcode) !== 1) {
-            throw new InvalidPostcodeException('Invalid postcode: ' . $postcode);
+            throw new InvalidPostcodeException($postcode, $country);
         }
 
         $formatted = $formatter->format($postcode);
 
         if ($formatted === null) {
-            throw new InvalidPostcodeException('Invalid postcode: ' . $postcode);
+            throw new InvalidPostcodeException($postcode, $country);
         }
 
         return $formatted;

src/UnknownCountryException.php

@@ -9,4 +9,26 @@
  */
 class UnknownCountryException extends \Exception
 {
+    protected string $country;
+
+    /**
+     * Construct exception thrown when an unknown country code is provided.
+     *
+     * @param string $country
+     */
+    public function __construct(string $country)
+    {
+        parent::__construct('Unknown country: ' . $country);
+        $this->country = $country;
+    }
+
+    /**
+     * Get the unknown country code associated with this exception.
+     *
+     * @return string
+     */
+    public function getCountryCode(): string
+    {
+        return $this->country;
+    }
 }