refactor(support): convert PathHelper to immutable class (#743)

Author: brendt

src/Tempest/Cache/src/ProjectCache.php

@@ -18,7 +18,7 @@ public function __construct(
         private readonly CacheConfig $cacheConfig,
     ) {
         $this->pool = $this->cacheConfig->projectCachePool ?? new FilesystemAdapter(
-            directory: path($this->cacheConfig->directory, 'project'),
+            directory: path($this->cacheConfig->directory, 'project')->toString(),
         );
     }
 

src/Tempest/Console/src/ConsoleApplication.php

@@ -13,7 +13,7 @@
 use Tempest\Core\Tempest;
 use Tempest\Log\Channels\AppendLogChannel;
 use Tempest\Log\LogConfig;
-use Tempest\Support\PathHelper;
+use function Tempest\path;
 use Throwable;
 
 final readonly class ConsoleApplication implements Application
@@ -45,8 +45,8 @@ public static function boot(
             $logConfig->debugLogPath === null
             && $logConfig->channels === []
         ) {
-            $logConfig->debugLogPath = PathHelper::make($container->get(Kernel::class)->root, '/log/debug.log');
-            $logConfig->channels[] = new AppendLogChannel(PathHelper::make($container->get(Kernel::class)->root, '/log/tempest.log'));
+            $logConfig->debugLogPath = path($container->get(Kernel::class)->root, '/log/debug.log')->toString();
+            $logConfig->channels[] = new AppendLogChannel(path($container->get(Kernel::class)->root, '/log/tempest.log')->toString());
         }
 
         return $application;

src/Tempest/Console/src/Initializers/LogOutputBufferInitializer.php

@@ -10,7 +10,7 @@
 use Tempest\Container\Initializer;
 use Tempest\Container\Singleton;
 use Tempest\Core\Kernel;
-use Tempest\Support\PathHelper;
+use function Tempest\path;
 
 final readonly class LogOutputBufferInitializer implements Initializer
 {
@@ -20,7 +20,7 @@ public function initialize(Container $container): LogOutputBuffer
         $consoleConfig = $container->get(ConsoleConfig::class);
         $kernel = $container->get(Kernel::class);
 
-        $path = $consoleConfig->logPath ?? PathHelper::make($kernel->root, 'console.log');
+        $path = $consoleConfig->logPath ?? path($kernel->root, 'console.log')->toString();
 
         return new LogOutputBuffer($path);
     }

src/Tempest/Core/composer.json

@@ -6,6 +6,7 @@
     "require": {
         "php": "^8.3",
         "tempest/container": "dev-main",
+        "tempest/support": "dev-main",
         "vlucas/phpdotenv": "^5.6",
         "filp/whoops": "^2.15"
     },

src/Tempest/Core/src/Composer.php

@@ -4,8 +4,8 @@
 
 namespace Tempest\Core;
 
+use function Tempest\path;
 use function Tempest\Support\arr;
-use Tempest\Support\PathHelper;
 
 final class Composer
 {
@@ -19,7 +19,7 @@ final class Composer
     public function __construct(
         string $root,
     ) {
-        $composerFilePath = PathHelper::make($root, 'composer.json');
+        $composerFilePath = path($root, 'composer.json')->toString();
 
         $this->composer = $this->loadComposerFile($composerFilePath);
         $this->namespaces = arr($this->composer)

src/Tempest/Core/src/DiscoveryCache.php

@@ -27,7 +27,7 @@ public function __construct(
         ?CacheItemPoolInterface $pool = null,
     ) {
         $this->pool = $pool ?? new FilesystemAdapter(
-            directory: path($this->cacheConfig->directory, 'discovery'),
+            directory: path($this->cacheConfig->directory, 'discovery')->toString(),
         );
     }
 

src/Tempest/Core/src/Kernel/LoadDiscoveryLocations.php

@@ -8,7 +8,7 @@
 use Tempest\Core\DiscoveryException;
 use Tempest\Core\DiscoveryLocation;
 use Tempest\Core\Kernel;
-use Tempest\Support\PathHelper;
+use function Tempest\path;
 
 /** @internal */
 final readonly class LoadDiscoveryLocations
@@ -35,8 +35,8 @@ public function __invoke(): void
      */
     private function discoverCorePackages(): array
     {
-        $composerPath = PathHelper::make($this->kernel->root, 'vendor/composer');
-        $installed = $this->loadJsonFile(PathHelper::make($composerPath, 'installed.json'));
+        $composerPath = path($this->kernel->root, 'vendor/composer');
+        $installed = $this->loadJsonFile(path($composerPath, 'installed.json')->toString());
         $packages = $installed['packages'] ?? [];
 
         $discoveredLocations = [];
@@ -49,12 +49,12 @@ private function discoverCorePackages(): array
                 continue;
             }
 
-            $packagePath = PathHelper::make($composerPath, $package['install-path'] ?? '');
+            $packagePath = path($composerPath, $package['install-path'] ?? '');
 
             foreach ($package['autoload']['psr-4'] as $namespace => $namespacePath) {
-                $namespacePath = PathHelper::make($packagePath, $namespacePath);
+                $namespacePath = path($packagePath, $namespacePath);
 
-                $discoveredLocations[] = new DiscoveryLocation($namespace, $namespacePath);
+                $discoveredLocations[] = new DiscoveryLocation($namespace, $namespacePath->toString());
             }
         }
 
@@ -69,9 +69,9 @@ private function discoverAppNamespaces(): array
         $discoveredLocations = [];
 
         foreach ($this->composer->namespaces as $namespace) {
-            $path = PathHelper::make($this->kernel->root, $namespace->path);
+            $path = path($this->kernel->root, $namespace->path);
 
-            $discoveredLocations[] = new DiscoveryLocation($namespace->namespace, $path);
+            $discoveredLocations[] = new DiscoveryLocation($namespace->namespace, $path->toString());
         }
 
         return $discoveredLocations;
@@ -82,8 +82,8 @@ private function discoverAppNamespaces(): array
      */
     private function discoverVendorPackages(): array
     {
-        $composerPath = PathHelper::make($this->kernel->root, 'vendor/composer');
-        $installed = $this->loadJsonFile(PathHelper::make($composerPath, 'installed.json'));
+        $composerPath = path($this->kernel->root, 'vendor/composer');
+        $installed = $this->loadJsonFile(path($composerPath, 'installed.json')->toString());
         $packages = $installed['packages'] ?? [];
 
         $discoveredLocations = [];
@@ -96,7 +96,7 @@ private function discoverVendorPackages(): array
                 continue;
             }
 
-            $packagePath = PathHelper::make($composerPath, $package['install-path'] ?? '');
+            $packagePath = path($composerPath, $package['install-path'] ?? '');
             $requiresTempest = isset($package['require']['tempest/framework']) || isset($package['require']['tempest/core']);
             $hasPsr4Namespaces = isset($package['autoload']['psr-4']);
 
@@ -105,9 +105,9 @@ private function discoverVendorPackages(): array
             }
 
             foreach ($package['autoload']['psr-4'] as $namespace => $namespacePath) {
-                $path = PathHelper::make($packagePath, $namespacePath);
+                $path = path($packagePath, $namespacePath);
 
-                $discoveredLocations[] = new DiscoveryLocation($namespace, $path);
+                $discoveredLocations[] = new DiscoveryLocation($namespace, $path->toString());
             }
         }
 

src/Tempest/Core/src/PublishesFiles.php

@@ -13,7 +13,8 @@
 use Tempest\Generation\Exceptions\FileGenerationAbortedException;
 use Tempest\Generation\Exceptions\FileGenerationFailedException;
 use Tempest\Generation\StubFileGenerator;
-use Tempest\Support\PathHelper;
+use function Tempest\path;
+use Tempest\Support\NamespaceHelper;
 use function Tempest\Support\str;
 use Tempest\Validation\Rules\EndsWith;
 use Tempest\Validation\Rules\NotEmpty;
@@ -133,15 +134,15 @@ public function publishImports(): void
     public function getSuggestedPath(string $className, ?string $pathPrefix = null, ?string $classSuffix = null): string
     {
         // Separate input path and classname
-        $inputClassName = PathHelper::toClassName($className);
-        $inputPath = str(PathHelper::make($className))->replaceLast($inputClassName, '')->toString();
+        $inputClassName = NamespaceHelper::toClassName($className);
+        $inputPath = str(path($className))->replaceLast($inputClassName, '')->toString();
         $className = str($inputClassName)
             ->pascal()
             ->finish($classSuffix ?? '')
             ->toString();
 
         // Prepare the suggested path from the project namespace
-        return str(PathHelper::make(
+        return str(path(
             $this->composer->mainNamespace->path,
             $pathPrefix ?? '',
             $inputPath,
@@ -158,7 +159,7 @@ public function getSuggestedPath(string $className, ?string $pathPrefix = null,
      */
     public function promptTargetPath(string $suggestedPath): string
     {
-        $className = PathHelper::toClassName($suggestedPath);
+        $className = NamespaceHelper::toClassName($suggestedPath);
 
         return $this->console->ask(
             question: sprintf('Where do you want to save the file "%s"?', $className),

src/Tempest/Core/src/functions.php

@@ -8,28 +8,15 @@
     use Tempest\Core\Composer;
     use Tempest\Core\DeferredTasks;
     use Tempest\Core\Kernel;
+    use function Tempest\Support\path;
     use function Tempest\Support\str;
 
-    /**
-     * Creates and sanitizes a file system path from the given `$parts`. The resulting path is not checked against the file system.
-     */
-    function path(string ...$parts): string
-    {
-        $path = implode('/', $parts);
-
-        return str_replace(
-            ['///', '//', '\\', '\\\\'],
-            '/',
-            $path,
-        );
-    }
-
     /**
      * Creates a path scoped within the root of the project
      */
     function root_path(string ...$parts): string
     {
-        return path(realpath(get(Kernel::class)->root), ...$parts);
+        return path(realpath(get(Kernel::class)->root), ...$parts)->toString();
     }
 
     /**
@@ -39,7 +26,7 @@ function src_path(string ...$parts): string
     {
         $composer = get(Composer::class);
 
-        return path($composer->mainNamespace->path, ...$parts);
+        return path($composer->mainNamespace->path, ...$parts)->toString();
     }
 
     /**

src/Tempest/Framework/Testing/InstallerTester.php

@@ -48,7 +48,7 @@ public function setRoot(string $root): self
 
     public function path(string $path): string
     {
-        return path($this->root, $path);
+        return path($this->root, $path)->toString();
     }
 
     public function put(string $path, string $contents): self