Better exception marking (#2)

Author: Jędrzej

src/App.php

@@ -5,12 +5,19 @@
 namespace Depth\Techno;
 
 use Depth\Techno\Exceptions\EnvNotFoundException;
+use Depth\Techno\Exceptions\RouteNotFoundException;
+use Depth\Techno\Exceptions\RouterException;
+use Depth\Techno\Exceptions\ServiceNotFoundException;
 use M1\Env\Parser;
+use ReflectionException;
 
 final readonly class App
 {
     private Container $container;
 
+    /**
+     * @throws EnvNotFoundException
+     */
     public function __construct(
         string $env_path = __DIR__.'/.env',
         private string $router_path = __DIR__.'/routes.php',
@@ -21,6 +28,12 @@ public function __construct(
         $this->container = new Container();
     }
 
+    /**
+     * @throws ServiceNotFoundException
+     * @throws RouterException
+     * @throws ReflectionException
+     * @throws RouteNotFoundException
+     */
     public function run(): void
     {
         if ($_ENV['DEBUG'] ?? false) {
@@ -32,6 +45,9 @@ public function run(): void
         $router->resolve($this->router_path)->send();
     }
 
+    /**
+     * @throws EnvNotFoundException
+     */
     private function loadEnv(string $env_path): void
     {
         $contents = file_get_contents($env_path);

src/Container.php

@@ -21,6 +21,9 @@ final class Container implements ContainerInterface
 
     /**
      * @param class-string $id
+     *
+     * @throws ServiceNotFoundException
+     * @throws ReflectionException
      */
     public function get(string $id): object
     {
@@ -62,6 +65,8 @@ public function set(string $id, object $value): self
 
     /**
      * @param class-string $id
+     *
+     * @throws ServiceNotFoundException
      */
     private function resolve(string $id): object
     {
@@ -83,6 +88,9 @@ private function resolve(string $id): object
 
     /**
      * @param ReflectionClass<object> $item
+     *
+     * @throws ServiceNotFoundException
+     * @throws ReflectionException
      */
     private function getInstance(ReflectionClass $item): object
     {

src/Router.php

@@ -6,6 +6,8 @@
 
 use Depth\Techno\Exceptions\RouteNotFoundException;
 use Depth\Techno\Exceptions\RouterException;
+use Depth\Techno\Exceptions\ServiceNotFoundException;
+use ReflectionException;
 use Symfony\Component\HttpFoundation\Response;
 
 use function array_key_exists;
@@ -18,12 +20,21 @@
     public function __construct(
         private Container $container,
     ) {
-        $this->path = explode('/', trim(explode('?', $_SERVER['REQUEST_URI'] ?? '')[0], '/'));
+        $this->path = explode(
+            '/',
+            trim(explode('?', $_SERVER['REQUEST_URI'] ?? '')[0], '/'),
+        );
     }
 
+    /**
+     * @throws ServiceNotFoundException
+     * @throws RouterException
+     * @throws ReflectionException
+     * @throws RouteNotFoundException
+     */
     public function resolve(string $router_path): Response
     {
-        /** @var array<string, class-string> */
+        /** @var array<string, class-string> $router_path */
         $routes = require $router_path;
 
         $link = "{$_SERVER['REQUEST_METHOD']} /{$this->path[0]}";