wip

Author: brendt

docs/1-essentials/02-views.md

@@ -673,15 +673,31 @@ You can choose whichever way you prefer. Chances are that, if you use the minima
 
 ### A note on caching
 
-When you're using the minimal setup, view caching can be enabled by passing in a `$cache` paremeter into `TempestViewRenderer::make()`:
+When you're using the minimal setup, view caching can be enabled by passing in a `$viewCache` paremeter into `TempestViewRenderer::make()`:
 
 ```php
+use Tempest\View\Renderers\TempestViewRenderer;
+use Tempest\View\ViewCache;
+
 $renderer = TempestViewRenderer::make(
-    cache: true,
+    cache: ViewCache::enabled(),
 );
 ```
 
-It's recommended to turn view caching on in production environments. To clear the view cache, you'll have to manually delete the cache directory, which is located at `./vendor/tempest/view/.tempest/cache`.
+It's recommended to turn view caching on in production environments. To clear the view cache, you can call the `clear()` method on the `ViewCache` object:
+
+```php
+use Tempest\View\Renderers\TempestViewRenderer;
+use Tempest\View\ViewCache;
+
+$viewCache = ViewCache::enabled();
+
+$viewCache->clear();
+
+$renderer = TempestViewRenderer::make(
+    cache: $viewCache,
+);
+```
 
 ## Separate view directories
 

packages/view/src/Renderers/TempestViewRenderer.php

@@ -35,7 +35,7 @@ public function __construct(
 
     public static function make(
         ?ViewConfig $viewConfig = null,
-        bool $cache = false,
+        ?ViewCache $viewCache = null,
         Environment $environment = Environment::PRODUCTION,
     ): self {
         $viewConfig ??= new ViewConfig();
@@ -52,10 +52,7 @@ public static function make(
 
         $elementFactory->setViewCompiler($compiler);
 
-        $viewCache = new ViewCache(
-            enabled: $cache,
-            pool: new ViewCachePool(__DIR__ . '/../../.tempest/cache'),
-        );
+        $viewCache = $viewCache ?? ViewCache::disabled();
 
         return new self(
             compiler: $compiler,

packages/view/src/ViewCache.php

@@ -20,6 +20,22 @@ public function __construct(
         );
     }
 
+    public static function enabled(?string $path = null): self
+    {
+        return new self(
+            enabled: true,
+            pool: new ViewCachePool($path ?? __DIR__ . '/../.tempest/cache')
+        );
+    }
+
+    public static function disabled(?string $path = null): self
+    {
+        return new self(
+            enabled: false,
+            pool: new ViewCachePool($path ?? __DIR__ . '/../.tempest/cache')
+        );
+    }
+
     public function clear(): void
     {
         $this->pool->clear();

packages/view/tests/StandaloneViewRendererTest.php

@@ -3,9 +3,11 @@
 namespace Tempest\View\Tests;
 
 use PHPUnit\Framework\TestCase;
+use Symfony\Component\Cache\Adapter\ArrayAdapter;
 use Tempest\View\Exceptions\ViewComponentPathWasInvalid;
 use Tempest\View\Exceptions\ViewComponentPathWasNotFound;
 use Tempest\View\Renderers\TempestViewRenderer;
+use Tempest\View\ViewCache;
 use Tempest\View\ViewComponent;
 use Tempest\View\ViewConfig;
 
@@ -19,10 +21,9 @@ public function test_render(): void
             __DIR__ . '/Fixtures/x-standalone-base.view.php',
         );
 
-        $renderer =
-            TempestViewRenderer::make(
-                viewConfig: $viewConfig,
-            );
+        $renderer = TempestViewRenderer::make(
+            viewConfig: $viewConfig,
+        );
 
         $html = $renderer->render(
             view(__DIR__ . '/Fixtures/standalone.view.php'),
@@ -67,6 +68,43 @@ public function test_invalid_view_component_paths_within_config(): void
         }
     }
 
+    public function test_with_cache_enabled(): void
+    {
+        $viewCache = ViewCache::enabled();
+        $viewCache->clear();
+
+        $renderer = TempestViewRenderer::make(
+            viewCache: $viewCache,
+        );
+
+        $html = $renderer->render(
+            view(__DIR__ . '/Fixtures/standalone.view.php'),
+        );
+
+        $this->assertSnippetsMatch(<<<'HTML'
+        <x-standalone-base>
+            Hi
+        </x-standalone-base>
+        HTML, $html);
+    }
+
+    public function test_with_cache_disabled(): void
+    {
+        $renderer = TempestViewRenderer::make(
+            viewCache: ViewCache::disabled(),
+        );
+
+        $html = $renderer->render(
+            view(__DIR__ . '/Fixtures/standalone.view.php'),
+        );
+
+        $this->assertSnippetsMatch(<<<'HTML'
+        <x-standalone-base>
+            Hi
+        </x-standalone-base>
+        HTML, $html);
+    }
+
     protected function assertSnippetsMatch(string $expected, string $actual): void
     {
         $expected = str_replace([PHP_EOL, ' '], '', $expected);