Add generator commands

src/Commands/MakeAbstractStateCommand.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Spatie\ModelStates\Commands;
+
+use Illuminate\Console\GeneratorCommand;
+
+class MakeAbstractStateCommand extends GeneratorCommand
+{
+    public $name = 'make:abstract-state';
+
+    public $description = 'Create an abstract state class';
+
+    public $type = 'Abstract State';
+
+    protected function getStub(): string
+    {
+        return __DIR__ . '/../../stubs/abstract-state.stub';
+    }
+
+    protected function getDefaultNamespace($rootNamespace): string
+    {
+        return $rootNamespace . '\Models\States';
+    }
+}

src/Commands/MakeStateCommand.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Spatie\ModelStates\Commands;
+
+use Illuminate\Console\GeneratorCommand;
+use Symfony\Component\Console\Input\InputArgument;
+
+class MakeStateCommand extends GeneratorCommand
+{
+    public $name = 'make:state';
+
+    public $description = 'Create a state class';
+
+    public $type = 'State';
+
+    protected function getStub(): string
+    {
+        return __DIR__ . '/../../stubs/state.stub';
+    }
+
+    protected function getDefaultNamespace($rootNamespace): string
+    {
+        return $rootNamespace . '\Models\States';
+    }
+
+    protected function getArguments()
+    {
+        return [
+            ['name', InputArgument::REQUIRED, 'The name of the '.strtolower($this->type)],
+            ['parent', InputArgument::REQUIRED, 'The name of the parent abstract state'],
+        ];
+    }
+
+    protected function buildClass($name)
+    {
+        $stub = $this->files->get($this->getStub());
+        $parent = $this->getParent();
+
+        return $this
+            ->replaceNamespace($stub, $name)
+            ->replaceParent($stub, $parent)
+            ->replaceClass($stub, $name);
+    }
+
+    protected function replaceParent(&$stub, $name): self
+    {
+        $class = str_replace($this->getNamespace($name).'\\', '', $name);
+
+        $stub = str_replace(['DummyParent', '{{ parent }}', '{{parent}}'], $class, $stub);
+
+        return $this;
+    }
+
+    protected function getParent(): string
+    {
+        return trim($this->argument('parent'));
+    }
+}

src/Commands/MakeTransitionCommand.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Spatie\ModelStates\Commands;
+
+use Illuminate\Console\GeneratorCommand;
+use Illuminate\Support\Str;
+use Symfony\Component\Console\Input\InputArgument;
+
+class MakeTransitionCommand extends GeneratorCommand
+{
+    public $name = 'make:transition';
+
+    public $description = 'Create a transition class';
+
+    public $type = 'Transition';
+
+    protected function getStub(): string
+    {
+        return __DIR__ . '/../../stubs/transition.stub';
+    }
+
+    protected function getDefaultNamespace($rootNamespace): string
+    {
+        return $rootNamespace . '\Models\States';
+    }
+
+    protected function getArguments()
+    {
+        return [
+            ['name', InputArgument::REQUIRED, 'The name of the '.strtolower($this->type)],
+            ['parent', InputArgument::REQUIRED, 'The name of the model'],
+        ];
+    }
+
+    protected function buildClass($name)
+    {
+        $stub = $this->files->get($this->getStub());
+        $parent = $this->getParent();
+
+        return $this
+            ->replaceNamespace($stub, $name)
+            ->replaceParent($stub, $parent)
+            ->replaceClass($stub, $name);
+    }
+
+    protected function replaceParent(&$stub, $name): self
+    {
+        $class = str_replace($this->getNamespace($name).'\\', '', $name);
+
+        $stub = str_replace(['DummyParent', '{{ parent }}', '{{parent}}'], $class, $stub);
+        $stub = str_replace('model', Str::camel($class), $stub);
+
+        return $this;
+    }
+
+    protected function getParent(): string
+    {
+        return trim($this->argument('parent'));
+    }
+}

src/ModelStatesServiceProvider.php

@@ -4,13 +4,21 @@
 
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
+use Spatie\ModelStates\Commands\MakeAbstractStateCommand;
+use Spatie\ModelStates\Commands\MakeStateCommand;
+use Spatie\ModelStates\Commands\MakeTransitionCommand;
 
 class ModelStatesServiceProvider extends PackageServiceProvider
 {
     public function configurePackage(Package $package): void
     {
         $package
             ->name('laravel-model-states')
+            ->hasCommands([
+                MakeAbstractStateCommand::class,
+                MakeStateCommand::class,
+                MakeTransitionCommand::class,
+            ])
             ->hasConfigFile();
     }
 }

stubs/abstract-state.stub

@@ -0,0 +1,10 @@
+<?php
+
+namespace DummyNamespace;
+
+use Spatie\ModelStates\State;
+
+abstract class DummyClass extends State
+{
+    //
+}

stubs/state.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace DummyNamespace;
+
+class DummyClass extends DummyParent
+{
+    //
+}

stubs/transition.stub

@@ -0,0 +1,28 @@
+<?php
+
+namespace DummyNamespace;
+
+use App\Models\DummyParent;
+use Spatie\ModelStates\Transition;
+
+class DummyClass extends Transition
+{
+    public function __construct
+    (
+        private readonly DummyParent $model,
+    ) {
+        //
+    }
+
+    public function handle(): DummyParent
+    {
+        //
+
+        return $this->model;
+    }
+
+    public function canTransition(): bool
+    {
+        //
+    }
+}

tests/CommandsTest.php

@@ -0,0 +1,43 @@
+<?php
+
+it('can generate abstract states', function () {
+    $file = $this->app->basePath('app/Models/States') . '/AbstractState.php';
+
+    $this->artisan('make:abstract-state AbstractState')->assertExitCode(0);
+
+    expect($file)
+        ->toBeFile()
+        ->toContainAsFile('class AbstractState extends State');
+
+    unlink($file);
+});
+
+it('can generate states', function () {
+    $file = $this->app->basePath('app/Models/States') . '/State.php';
+
+    $this->artisan('make:state State')
+        ->expectsQuestion('What is the name of the parent abstract state?', 'AbstractState')
+        ->assertExitCode(0);
+
+    expect($file)
+        ->toBeFile()
+        ->toContainAsFile('class State extends AbstractState');
+
+    unlink($file);
+});
+
+it('can generate transitions', function () {
+    $file = $this->app->basePath('app/Models/States') . '/CustomTransition.php';
+
+    $this->artisan('make:transition CustomTransition')
+        ->expectsQuestion('What is the name of the model?', 'Model')
+        ->assertExitCode(0);
+
+    expect($file)
+        ->toBeFile()
+        ->toContainAsFile('class CustomTransition extends Transition')
+        ->toContainAsFile('private readonly Model $model,')
+        ->toContainAsFile('return $this->model;');
+
+    unlink($file);
+});

tests/Pest.php

@@ -16,6 +16,13 @@
 |--------------------------------------------------------------------------
 */
 
+expect()->extend('toContainAsFile', function ($needle) {
+    expect(file_get_contents($this->value))
+        ->toContain($needle);
+
+    return $this;
+});
+
 /*
 |--------------------------------------------------------------------------
 | Functions

tests/TestCase.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Database\Schema\Blueprint;
 use Orchestra\Testbench\TestCase as Orchestra;
+use Spatie\ModelStates\ModelStatesServiceProvider;
 
 abstract class TestCase extends Orchestra
 {
@@ -14,6 +15,13 @@ protected function setUp(): void
         $this->setUpDatabase();
     }
 
+    protected function getPackageProviders($app)
+    {
+        return [
+            ModelStatesServiceProvider::class,
+        ];
+    }
+
     protected function getEnvironmentSetUp($app)
     {
         $app['config']->set('database.default', 'sqlite');