Added operation helper

Author: andrey-helldar

docs/images/operation_helper_class.png

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+
+use function DragonCode\LaravelDeployOperations\operation;
+
+return new class extends Migration {
+    public function withOperation(): string
+    {
+        return operation('');
+    }
+};

docs/images/operation_helper_class_dark.png

@@ -58,4 +58,16 @@
 
         <code-block lang="bash" src="operations_helper.sh" include-lines="2" />
     </chapter>
+
+    <chapter title="Laravel Idea support" id="laravel_idea_support">
+        <p>
+            If you are using
+            <a href="https://www.jetbrains.com/phpstorm/">JetBrains PhpStorm</a>
+            with the
+            <a href="https://laravel-idea.com">Laravel Idea</a> plugin installed,
+            you can use the <code>operation</code> function to autocomplete.
+        </p>
+
+        <img src="operation_helper_class.png" alt="operation helper" />
+    </chapter>
 </topic>

docs/images/operations_helper_function.png

@@ -262,5 +262,23 @@
             When the <code>%artisan% migrate:rollback</code> console command is called,
             the operation will call the <code>down</code> method if it exists in the operation file.
         </p>
+
+        <chapter title="Laravel Idea support" id="laravel_idea_support">
+            <p>
+                If you are using
+                <a href="https://www.jetbrains.com/phpstorm/">JetBrains PhpStorm</a>
+                with the
+                <a href="https://laravel-idea.com">Laravel Idea</a> plugin installed,
+                then autocomplete will be available to you:
+            </p>
+            <p>
+                To avoid entering file names manually, you can use the <code>deploy_operation</code> helper function.
+                All it does is to suggest IDE paths to operation files with recursive search.
+            </p>
+
+            <code-block lang="php" src="with_operation_helper.php" include-lines="7-" />
+
+            <img src="operations_helper_function.png" alt="operation helper"/>
+        </chapter>
     </chapter>
 </topic>

docs/images/operations_helper_function_dark.png

@@ -30,6 +30,9 @@
                     "methodNames": [
                         "run"
                     ],
+                    "functionFqn": [
+                        "DragonCode\\LaravelDeployOperations\\operation"
+                    ],
                     "place": "parameter",
                     "parameters": [
                         1

docs/snippets/with_operation_helper.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DragonCode\LaravelDeployOperations;
+
+if (! function_exists('\DragonCode\LaravelDeployOperations\operation')) {
+    function operation(string $filename): string
+    {
+        return $filename;
+    }
+}

docs/topics/operation-helper.topic

@@ -4,13 +4,16 @@
 
 use Illuminate\Database\Migrations\Migration;
 
-return new class extends Migration {
-    public function up(): void {}
+use function DragonCode\LaravelDeployOperations\operation;
 
-    public function down(): void {}
+return new class extends Migration {
+    public function up(): void
+    {
+        //
+    }
 
     public function withOperation(): string
     {
-        return '2025_03_31_234251_invoke';
+        return operation('2025_03_31_234251_invoke');
     }
 };

docs/topics/running-operations.topic

@@ -4,13 +4,15 @@
 
 use Illuminate\Database\Migrations\Migration;
 
+use function DragonCode\LaravelDeployOperations\operation;
+
 return new class extends Migration {
     public function up(): void {}
 
     public function down(): void {}
 
     public function withOperation(): string
     {
-        return '2025_03_31_234312_up_down';
+        return operation('2025_03_31_234312_up_down');
     }
 };