Added operation helper

andrey-helldar · andrey-helldar · commit 65efc796fea6 · 2025-04-04T01:55:36.000+03:00
diff --git a/composer.json b/composer.json
@@ -64,7 +64,10 @@
     "autoload": {
         "psr-4": {
             "DragonCode\\LaravelDeployOperations\\": "src/"
-        }
+        },
+        "files": [
+            "src/helpers.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {
diff --git a/docs/images/operation_helper_class.png b/docs/images/operation_helper_class.png
diff --git a/docs/images/operation_helper_class_dark.png b/docs/images/operation_helper_class_dark.png
diff --git a/docs/images/operations_helper_function.png b/docs/images/operations_helper_function.png
diff --git a/docs/images/operations_helper_function_dark.png b/docs/images/operations_helper_function_dark.png
diff --git a/docs/snippets/with_operation_helper.php b/docs/snippets/with_operation_helper.php
@@ -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('foo/2022_10_14_000002_test2');
+    }
+};
diff --git a/docs/topics/operation-helper.topic b/docs/topics/operation-helper.topic
@@ -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>
diff --git a/docs/topics/running-operations.topic b/docs/topics/running-operations.topic
@@ -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>
diff --git a/ide.json b/ide.json
@@ -30,6 +30,9 @@
                     "methodNames": [
                         "run"
                     ],
+                    "functionFqn": [
+                        "DragonCode\\LaravelDeployOperations\\operation"
+                    ],
                     "place": "parameter",
                     "parameters": [
                         1
diff --git a/src/helpers.php b/src/helpers.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;
+    }
+}
diff --git a/tests/Commands/OperationsTest.php b/tests/Commands/OperationsTest.php
@@ -787,9 +787,9 @@ public function testViaMigrationMethod(): void
         ])->assertSuccessful();
 
         $this->assertDatabaseCount($table, 1);
-        $this->assertDatabaseCount($this->table, 0);
+        $this->assertDatabaseCount($this->table, 1);
         $this->assertDatabaseOperationDoesntLike($this->table, 'custom');
-        $this->assertDatabaseOperationDoesntLike($this->table, 'invoke');
+        $this->assertDatabaseOperationHas($this->table, 'invoke');
         $this->assertDatabaseOperationDoesntLike($this->table, 'up_down');
         $this->assertDatabaseOperationDoesntLike($table, 'custom', column: 'value');
         $this->assertDatabaseOperationHas($table, 'invoke', column: 'value');
diff --git a/tests/fixtures/migrations_with_operations/2025_03_31_213847_call_invokable.php b/tests/fixtures/migrations_with_operations/2025_03_31_213847_call_invokable.php
@@ -4,13 +4,13 @@
 
 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_234251_invoke';
+        return operation('2025_03_31_234251_invoke');
     }
 };
diff --git a/tests/fixtures/migrations_with_operations/2025_03_31_213921_call_up_down.php b/tests/fixtures/migrations_with_operations/2025_03_31_213921_call_up_down.php
@@ -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');
     }
 };

Original file line number	Diff line number	Diff line change
`@@ -30,6 +30,9 @@`
`30`	`30`	`"methodNames": [`
`31`	`31`	`"run"`
`32`	`32`	`],`
	`33`	`+ "functionFqn": [`
	`34`	`+ "DragonCode\\LaravelDeployOperations\\operation"`
	`35`	`+ ],`
`33`	`36`	`"place": "parameter",`
`34`	`37`	`"parameters": [`
`35`	`38`	`1`