test stencil file processor

src/CodeStencilHelpers.php

@@ -26,7 +26,7 @@ public function multilineComment(string|array $comment): static
         return $this->foreach($lines, fn(self $s, string $line) => $s->line($line));
     }
 
-    public function phpdoc(string|array|null $summary = null, string|array|null $description = null, ?array $tags = null): static
+    public function phpdoc(string|array $summary = null, string|array $description = null, array $tags = null): static
     {
         if ($summary === null) {
             $summary = [];

src/Laravel/LaravelCodeStencilServiceProvider.php

@@ -2,7 +2,6 @@
 
 namespace CodeStencil\Laravel;
 
-use CodeStencil\Stencil;
 use Illuminate\Console\Events\CommandFinished;
 use Illuminate\Console\Events\CommandStarting;
 use Illuminate\Support\Facades\App;
@@ -15,6 +14,8 @@
 
 class LaravelCodeStencilServiceProvider extends ServiceProvider
 {
+    use RegistersOverrideStubLocationMacro;
+
     /**
      * Register services.
      */
@@ -63,14 +64,7 @@ public function boot(): void
             });
         }
 
-        Stencil::macro('overrideStubLocation', function(string $path) {
-            $newPath = $this->substituteVariables($path);
-            $newPath = $this->applyFunctions($newPath);
-
-            $this->variable('overrideStubLocation', $newPath);
-
-            return $this;
-        });
+        $this->registerOverrideStubLocationMacro();
     }
 
     private function getFiles(): array

src/Laravel/RegistersOverrideStubLocationMacro.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace CodeStencil\Laravel;
+
+use CodeStencil\Stencil;
+
+trait RegistersOverrideStubLocationMacro
+{
+    private function registerOverrideStubLocationMacro(): void
+    {
+        Stencil::macro('overrideStubLocation', function(string $path) {
+            $newPath = $this->substituteVariables($path);
+            $newPath = $this->applyFunctions($newPath);
+
+            $this->variable('overrideStubLocation', $newPath);
+
+            return $this;
+        });
+    }
+}

src/Stencil.php

@@ -3,11 +3,10 @@
 namespace CodeStencil;
 
 use Closure;
+use function CodeStencil\Utility\array_flatten;
 use Illuminate\Support\Traits\Conditionable;
 use Illuminate\Support\Traits\Macroable;
 
-use function CodeStencil\Utility\array_flatten;
-
 class Stencil
 {
     use CodeStencilHelpers;

tests/.pest/snapshots/StencilFileProcessorTest/process_file.snap

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class test extends Model
+{
+    use HasFactory;
+}

tests/.pest/snapshots/StencilFileProcessorTest/process_file_custom_location.snap

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class test extends Model
+{
+    use HasFactory;
+}

tests/Fixtures/LaravelStub.php

@@ -0,0 +1,12 @@
+<?php
+
+use CodeStencil\Stencil;
+
+return Stencil::make()
+    ->php()
+    ->namespace('App\Models')
+    ->use('Illuminate\Database\Eloquent\Factories\HasFactory')
+    ->use('Illuminate\Database\Eloquent\Model')
+    ->curlyStatement('class i_name extends Model', fn(Stencil $s) => $s
+        ->line('use HasFactory;')
+    );

tests/Fixtures/LaravelStubCustomLocation.php

@@ -0,0 +1,13 @@
+<?php
+
+use CodeStencil\Stencil;
+
+return Stencil::make()
+    ->php()
+    ->namespace('App\Models')
+    ->use('Illuminate\Database\Eloquent\Factories\HasFactory')
+    ->use('Illuminate\Database\Eloquent\Model')
+    ->curlyStatement('class i_name extends Model', fn(Stencil $s) => $s
+        ->line('use HasFactory;')
+    )
+    ->overrideStubLocation(__DIR__ . DIRECTORY_SEPARATOR . 'Output.php');

tests/StencilFileProcessorTest.php

@@ -0,0 +1,35 @@
+<?php
+
+use CodeStencil\Laravel\RegistersOverrideStubLocationMacro;
+use CodeStencil\Laravel\StencilFileProcessor;
+
+uses(RegistersOverrideStubLocationMacro::class);
+
+test('process file', function() {
+    $realStubPath = __DIR__ . DIRECTORY_SEPARATOR . 'Fixtures' . DIRECTORY_SEPARATOR . 'LaravelStub.php';
+    $tmpPath      = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'LaravelStub.php';
+    copy($realStubPath, $tmpPath);
+
+    (new StencilFileProcessor($tmpPath, ['i_name' => 'test']))();
+
+    $contents = file_get_contents($tmpPath);
+
+    expect($contents)->toMatchSnapshot();
+});
+
+test('process file custom location', function() {
+    $realStubPath = __DIR__ . DIRECTORY_SEPARATOR . 'Fixtures' . DIRECTORY_SEPARATOR . 'LaravelStubCustomLocation.php';
+    $tmpDir       = sys_get_temp_dir();
+    $tmpPath      = $tmpDir . DIRECTORY_SEPARATOR . 'LaravelStubCustomLocation.php';
+    copy($realStubPath, $tmpPath);
+
+    $this->registerOverrideStubLocationMacro();
+
+    (new StencilFileProcessor($tmpPath, ['i_name' => 'test']))();
+
+    $contents = file_get_contents($tmpDir . DIRECTORY_SEPARATOR . 'Output.php');
+
+    expect($contents)->toMatchSnapshot();
+
+    expect(file_exists($tmpPath))->toBeFalse();
+});