Merge pull request #2 from minicli/fallback-tpldir

Adding fallback mechanism

src/Stencil.php

@@ -5,12 +5,23 @@
 class Stencil
 {
     public string $stencilDir;
+    public array $fallbackDirs = [];
 
     public function __construct(string $stencilDir)
     {
         $this->stencilDir = $stencilDir;
     }
 
+    /**
+     * Additional template dirs to look for
+     * @param array $fallbackDirs
+     * @return void
+     */
+    public function fallbackTo(array $fallbackDirs)
+    {
+        $this->fallbackDirs = $fallbackDirs;
+    }
+
     /**
      * @throws FileNotFoundException
      */
@@ -46,9 +57,21 @@ public function getTemplate(string $template): string
         $templateFile = $this->stencilDir . '/' . $template . '.tpl';
 
         if (!is_file($templateFile)) {
-            throw new FileNotFoundException("Template file not found.");
+            $templateFile = $this->locateFallbackTemplate($template);
         }
 
         return file_get_contents($templateFile);
     }
+
+    public function locateFallbackTemplate(string $template): string
+    {
+        foreach ($this->fallbackDirs as $fallbackDir) {
+            $templateFile = $fallbackDir . '/' . $template . '.tpl';
+            if (is_file($templateFile)) {
+                return $templateFile;
+            }
+        }
+
+        throw new FileNotFoundException("Template file not found.");
+    }
 }

tests/Assets/Fallback/othertemplate.tpl

@@ -0,0 +1,3 @@
+## This is my Other Template
+
+My name is {{ name }} and I am a {{ description }}.

tests/Pest.php

@@ -43,5 +43,7 @@
 
 function getStencil(): Stencil
 {
-    return new Stencil(__DIR__ . '/Assets');
+    $stencil = new Stencil(__DIR__ . '/Assets');
+    $stencil->fallbackTo([__DIR__ . '/Assets/Fallback']);
+    return $stencil;
 }

tests/StencilTest.php

@@ -1,13 +1,22 @@
 <?php
 
+use Minicli\FileNotFoundException;
+
 it('sets the template dir', function () {
     $stencil = getStencil();
     expect($stencil->stencilDir)->toBeString();
 });
 
+it('falls back to secondary tpl dir when tpl not found in default location', function () {
+    $stencil = getStencil();
+    $parsedContent = $stencil->applyTemplate('othertemplate', []);
+    expect($parsedContent)->toBeString();
+    $this->assertStringContainsString("This is my Other Template", $parsedContent);
+});
+
 it('throws exception if template not found', function () {
     $stencil = getStencil();
-    $this->expectException(\Minicli\FileNotFoundException::class);
+    $this->expectException(FileNotFoundException::class);
     $stencil->applyTemplate('notfound', []);
 });