Moves exceptions into a sub-namespace

Exceptions were almost fully half of the classes/interfaces/traits in
the package, and deserved their own namespace.

Author: weierophinney

doc/book/exception.md

@@ -7,7 +7,7 @@ details.
 To facilitate this, we provide an interface, `ProblemDetailsException`:
 
 ```php
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 use JsonSerializable;
 
@@ -50,8 +50,8 @@ transaction problem details, you might do so as follows:
 
 ```php
 use DomainException;
-use ProblemDetails\CommonProblemDetailsException;
-use ProblemDetails\ProblemDetailsException;
+use ProblemDetails\Exception\CommonProblemDetailsException;
+use ProblemDetails\Exception\ProblemDetailsException;
 
 class TransactionException extends DomainException implements ProblemDetailsException
 {

doc/book/middleware.md

@@ -19,7 +19,8 @@ This middleware does the following:
   throwing any errors handled as `ErrorException` instances.
 - Wraps a call to the `$delegate` in a `try`/`catch` block; if nothing is
   caught, and a response is returned, it returns the response immediately. If a
-  response is _not_ returned, it raises a `ProblemDetails\MissingResponseException`.
+  response is _not_ returned, it raises a
+  `ProblemDetails\Exception\MissingResponseException`.
 - For all caught throwables, it passes the throwable to
   `ProblemDetailsResponseFactory::createResponseFromThrowable()` to generate a
   Problem Details response.

doc/book/quick-start.md

@@ -155,11 +155,11 @@ as the HTTP status if it falls in the 400 or 500 range (500 will be used
 otherwise).
 
 You can also create custom exceptions that provide details for the factory to
-consume by implementing `ProblemDetails\ProblemDetailsException`, which defines
-the following:
+consume by implementing `ProblemDetails\Exception\ProblemDetailsException`,
+which defines the following:
 
 ```php
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 use JsonSerializable;
 
@@ -211,8 +211,8 @@ By composing this trait, you can easily define custom exception types:
 namespace Api;
 
 use DomainException as PhpDomainException;
-use ProblemDetails\CommonProblemDetailsException;
-use ProblemDetails\ProblemDetailsException;
+use ProblemDetails\Exception\CommonProblemDetailsException;
+use ProblemDetails\Exception\ProblemDetailsException;
 
 class DomainException extends PhpDomainException implements ProblemDetailsException
 {
@@ -249,8 +249,8 @@ a `ProblemDetailsResponseFactory`, and does the following:
 - Otherwise, it creates a PHP error handler that converts PHP errors to
   `ErrorException` instances, and then wraps processing of the delegate in a
   try/catch block. If the delegate does not return a `ResponseInterface`, a
-  `ProblemDetails\MissingResponseException` is raised; otherwise, the response
-  is returned.
+  `ProblemDetails\Exception\MissingResponseException` is raised; otherwise, the
+  response is returned.
 - Any throwable or exception caught is passed to the
   `ProblemDetailsResponseFactory::createResponseFromThrowable()` method, and the
   response generated is returned.

src/CommonProblemDetailsException.php renamed to src/Exception/CommonProblemDetailsException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 /**
  * Common functionality for ProblemDetailsException implementations.

src/InvalidResponseBodyException.php renamed to src/Exception/InvalidResponseBodyException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 use RuntimeException;
 

src/MissingResponseException.php renamed to src/Exception/MissingResponseException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 use RuntimeException;
 

src/ProblemDetailsException.php renamed to src/Exception/ProblemDetailsException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace ProblemDetails;
+namespace ProblemDetails\Exception;
 
 use JsonSerializable;
 

src/ProblemDetailsMiddleware.php

@@ -41,7 +41,7 @@ public function process(ServerRequestInterface $request, DelegateInterface $dele
             $response = $delegate->process($request);
 
             if (! $response instanceof ResponseInterface) {
-                throw new MissingResponseException('Application did not return a response');
+                throw new Exception\MissingResponseException('Application did not return a response');
             }
         } catch (Throwable $e) {
             $response = $this->responseFactory->createResponseFromThrowable($request, $e);

src/ProblemDetailsResponseFactory.php

@@ -208,7 +208,7 @@ public function createResponseFromThrowable(
         ServerRequestInterface $request,
         Throwable $e
     ) : ResponseInterface {
-        if ($e instanceof ProblemDetailsException) {
+        if ($e instanceof Exception\ProblemDetailsException) {
             return $this->createResponse(
                 $request,
                 $e->getStatus(),
@@ -258,13 +258,13 @@ protected function generateXmlResponse(array $payload) : ResponseInterface
     }
 
     /**
-     * @throws InvalidResponseBodyException
+     * @throws Exception\InvalidResponseBodyException
      */
     protected function generateResponse(int $status, string $contentType, string $payload) : ResponseInterface
     {
         $body = ($this->bodyFactory)();
         if (! $body instanceof StreamInterface) {
-            throw new InvalidResponseBodyException(sprintf(
+            throw new Exception\InvalidResponseBodyException(sprintf(
                 'The factory for generating a problem details response body stream did not return a %s',
                 StreamInterface::class
             ));

test/ProblemDetailsExceptionTest.php renamed to test/Exception/ProblemDetailsExceptionTest.php

@@ -1,10 +1,10 @@
 <?php
 
-namespace ProblemDetailsTest;
+namespace ProblemDetailsTest\Exception;
 
 use PHPUnit\Framework\TestCase;
-use ProblemDetails\CommonProblemDetailsException;
-use ProblemDetails\ProblemDetailsException;
+use ProblemDetails\Exception\CommonProblemDetailsException;
+use ProblemDetails\Exception\ProblemDetailsException;
 
 class ProblemDetailsExceptionTest extends TestCase
 {