Added nested path

Author: andrey-helldar

docs/getting-started/how-to-use/creating.md

@@ -1 +1,59 @@
-# Creating Action
+# Creating Actions
+
+To create an action use the `make:migration:action` artisan command:
+
+```bash
+php artisan make:migration:action some_name
+```
+
+The new action's file will be placed in your `actions` directory in the base path of your app.
+
+Each action file name contains a timestamp, which allows Laravel to determine the order of the actions.
+
+
+## Automatically Generate A File Name
+
+If you do not specify the "name" attribute, then the file name will be generated automatically according to the rule:
+
+> git branch name ?: 'auto'
+
+```bash
+php artisan make:migration:action
+
+### When the git repository is found (`base_path('.git')` directory is exists).
+### For example, HEAD branch name is 'qwerty'.
+# 2022_10_11_225116_qwerty.php
+# 2022_10_11_225118_qwerty.php
+# 2022_10_11_225227_qwerty.php
+
+### When the git repository is not found (`base_path('.git')` directory doesn't exists).
+### For example, HEAD branch name is 'qwerty'.
+# 2022_10_11_225116_auto.php
+# 2022_10_11_225118_auto.php
+# 2022_10_11_225227_auto.php
+```
+
+## Nested Files
+
+Since version `3.0` you can use nested paths to create actions:
+
+```bash
+php artisan make:migration:action Foo/Bar/QweRty
+php artisan make:migration:action Foo/Bar/QweRty.php
+
+php artisan make:migration:action Foo\Bar\QweRty
+php artisan make:migration:action Foo\Bar\QweRty.php
+
+php artisan make:migration:action foo\bar\QweRty
+php artisan make:migration:action foo\bar\QweRty.php
+```
+
+All of these commands will create a file called `actions/foo/bar/Y_m_d_His_qwe_rty.php`.
+
+For example:
+
+```bash
+php artisan make:migration:action foo\bar\QweRty
+
+# actions/foo/bar/2022_10_11_225734_qwe_rty.php
+```

src/Values/Options.php

@@ -25,6 +25,16 @@ class Options extends DataTransferObject
 
     protected function castName(?string $value): ?string
     {
-        return empty($value) ? null : Str::snake($value);
+        if (empty($value)) {
+            return null;
+        }
+
+        return Str::of($value)
+            ->replace('\\', '/')
+            ->replace('.php', '')
+            ->explode('/')
+            ->map(fn (string $path) => Str::snake($path))
+            ->implode(DIRECTORY_SEPARATOR)
+            ->toString();
     }
 }

tests/Commands/MakeTest.php

@@ -35,4 +35,76 @@ public function testAutoName()
 
         $this->assertFileExists($path);
     }
+
+    public function testNestedRightSlashWithoutExtension()
+    {
+        $name = 'Foo/bar/QweRty';
+
+        $path = $this->getActionsPath() . '/foo/bar/' . date('Y_m_d_His') . '_qwe_rty.php';
+
+        $this->assertFileDoesNotExist($path);
+
+        $this->artisan(Names::MAKE, compact('name'))->assertExitCode(0);
+
+        $this->assertFileExists($path);
+
+        $this->assertEquals(
+            file_get_contents(__DIR__ . '/../fixtures/app/stubs/make_example.stub'),
+            file_get_contents($path)
+        );
+    }
+
+    public function testNestedRightSlashWithExtension()
+    {
+        $name = 'Foo/bar/QweRty.php';
+
+        $path = $this->getActionsPath() . '/foo/bar/' . date('Y_m_d_His') . '_qwe_rty.php';
+
+        $this->assertFileDoesNotExist($path);
+
+        $this->artisan(Names::MAKE, compact('name'))->assertExitCode(0);
+
+        $this->assertFileExists($path);
+
+        $this->assertEquals(
+            file_get_contents(__DIR__ . '/../fixtures/app/stubs/make_example.stub'),
+            file_get_contents($path)
+        );
+    }
+
+    public function testNestedLeftSlashWithoutExtension()
+    {
+        $name = 'Foo\\bar\\QweRty';
+
+        $path = $this->getActionsPath() . '/foo/bar/' . date('Y_m_d_His') . '_qwe_rty.php';
+
+        $this->assertFileDoesNotExist($path);
+
+        $this->artisan(Names::MAKE, compact('name'))->assertExitCode(0);
+
+        $this->assertFileExists($path);
+
+        $this->assertEquals(
+            file_get_contents(__DIR__ . '/../fixtures/app/stubs/make_example.stub'),
+            file_get_contents($path)
+        );
+    }
+
+    public function testNestedLeftSlashWithExtension()
+    {
+        $name = 'Foo\\bar\\QweRty.php';
+
+        $path = $this->getActionsPath() . '/foo/bar/' . date('Y_m_d_His') . '_qwe_rty.php';
+
+        $this->assertFileDoesNotExist($path);
+
+        $this->artisan(Names::MAKE, compact('name'))->assertExitCode(0);
+
+        $this->assertFileExists($path);
+
+        $this->assertEquals(
+            file_get_contents(__DIR__ . '/../fixtures/app/stubs/make_example.stub'),
+            file_get_contents($path)
+        );
+    }
 }