feat(core): improved exceptions for unwriteable internal storage (#1468)

Author: brendt

packages/core/src/CouldNotRegisterInternalStorage.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Tempest\Core;
+
+use Tempest\DateTime\Exception\RuntimeException;
+
+final class CouldNotRegisterInternalStorage extends RuntimeException
+{
+    public static function fileExists(string $path): self
+    {
+        return new self("Unable to create internal storage directory, as a file with the same name already exists at `{$path}`");
+    }
+
+    public static function directoryNotWritable(string $path): self
+    {
+        return new self("Unable to create internal storage directory because of insufficient user permission on the root directory at `{$path}`");
+    }
+
+    public static function noPermission(string $path): self
+    {
+        return new self("Insufficient user permission to write to internal storage directory as `{$path}`.");
+    }
+}

packages/core/src/FrameworkKernel.php

@@ -169,14 +169,14 @@ public function registerInternalStorage(): self
 
         if (! is_dir($path)) {
             if (file_exists($path)) {
-                throw new \RuntimeException('Unable to create internal storage directory, as a file with the same name (.tempest) already exists.');
+                throw CouldNotRegisterInternalStorage::fileExists($path);
             }
 
             if (! mkdir($path, recursive: true)) {
-                throw new \RuntimeException('Unable to create internal storage directory because of insufficient user permission on the root directory.');
+                throw CouldNotRegisterInternalStorage::directoryNotWritable($path);
             }
         } elseif (! is_writable($path)) {
-            throw new \RuntimeException('Insufficient user permission to write to internal storage directory.');
+            throw CouldNotRegisterInternalStorage::noPermission($path);
         }
 
         $this->internalStorage = realpath($path);