[pull] main from WatheqAlshowaiter:main

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `model-required-fields` will be documented in this file.
 
+## 3.0.2 - 2025-09-19
+
+Fix banner when install
+
+**Full Changelog**: https://github.com/WatheqAlshowaiter/model-fields/compare/3.0.1...3.0.2
+
+## 3.0.1 - 2025-09-19
+
+### What's Changed
+
+Add Star command after installation
+
+**Full Changelog**: https://github.com/WatheqAlshowaiter/model-fields/compare/3.0.0...3.0.1
+
 ## 3.0.3 - 2025-09-18
 
 ### What's Changed

composer.json

@@ -58,7 +58,10 @@
             "@composer run build",
             "@php vendor/bin/testbench serve"
         ],
-        "test": "vendor/bin/phpunit"
+        "test": "vendor/bin/phpunit",
+        "post-autoload-dump": [
+            "@php -r \"class_exists('WatheqAlshowaiter\\\\ModelFields\\\\Console\\\\ThanksCommand') && WatheqAlshowaiter\\\\ModelFields\\\\Console\\\\ThanksCommand::show();\""
+        ]
     },
     "config": {
         "sort-packages": true,

src/Console/ThanksCommand.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace WatheqAlshowaiter\ModelFields\Console;
+
+use Illuminate\Support\Facades\Cache;
+
+class ThanksCommand
+{
+    private const CACHE_KEY = 'model-fields.banner_shown';
+
+    public static function show(): void
+    {
+        if (self::runningInCi() || Cache::get(self::CACHE_KEY)) {
+            return;
+        }
+
+        echo "\n";
+        echo "🎉 Thanks for using Model Fields!\n";
+        echo "If you find this package useful, please consider starring it on GitHub.\n";
+        echo "Repository: https://github.com/WatheqAlshowaiter/model-fields\n";
+        echo "\n";
+
+        // Only show interactive prompt if terminal is interactive
+        if (function_exists('posix_isatty') && posix_isatty(STDIN)) {
+            echo 'Would you like to open the repository in your browser? [y/N]: ';
+
+            $handle = fopen('php://stdin', 'r');
+            $response = strtolower(trim(fgets($handle)));
+            fclose($handle);
+
+            if ($response === 'y' || $response === 'yes') {
+                self::openUrl('https://github.com/WatheqAlshowaiter/model-fields');
+                echo "Opening repository in your browser...\n";
+            }
+        }
+
+        echo "Thank you! 🙏\n\n";
+
+        Cache::forever(self::CACHE_KEY, true);
+    }
+
+    protected static function runningInCi(): bool
+    {
+        return getenv('CI')
+            || getenv('GITHUB_ACTIONS')
+            || app()->environment() === 'testing';
+    }
+
+    protected static function openUrl(string $url): void
+    {
+        switch (PHP_OS_FAMILY) {
+            case 'Darwin':
+                $command = 'open';
+                break;
+            case 'Windows':
+                $command = 'start';
+                break;
+            default:
+                $command = 'xdg-open';
+                break;
+        }
+
+        exec(sprintf('%s %s', $command, escapeshellarg($url)));
+    }
+}

tests/ThanksCommandTest.php

@@ -0,0 +1,105 @@
+<?php
+
+namespace WatheqAlshowaiter\ModelFields\Tests;
+
+use Illuminate\Support\Facades\Cache;
+use WatheqAlshowaiter\ModelFields\Console\ThanksCommand;
+
+class ThanksCommandTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        Cache::forget('model-fields.banner_shown');
+        parent::tearDown();
+    }
+
+    public function test_class_and_method_exist()
+    {
+        $this->assertTrue(class_exists(ThanksCommand::class));
+        $this->assertTrue(method_exists(ThanksCommand::class, 'show'));
+    }
+
+    public function test_cache_logic()
+    {
+        // Ensure cache key doesn't exist initially
+        Cache::forget('model-fields.banner_shown');
+        $this->assertFalse(Cache::get('model-fields.banner_shown', false));
+
+        // Set cache manually to test the "already shown" logic
+        Cache::forever('model-fields.banner_shown', true);
+        $this->assertTrue(Cache::get('model-fields.banner_shown'));
+
+        // Clean up for next test
+        Cache::forget('model-fields.banner_shown');
+        $this->assertFalse(Cache::get('model-fields.banner_shown', false));
+    }
+
+    public function test_show_outputs_message_and_sets_cache()
+    {
+        // Clear cache and simulate non-CI environment
+        Cache::forget('model-fields.banner_shown');
+        putenv('CI');
+
+        // Mock posix_isatty to return true (interactive terminal)
+        if (! function_exists('posix_isatty')) {
+            function posix_isatty($fd)
+            {
+                return true;
+            }
+        }
+
+        // Create a mock stream for stdin
+        $input = fopen('php://memory', 'r+');
+        fwrite($input, "n\n");
+        rewind($input);
+
+        // Use reflection to temporarily replace the input handling
+        ob_start();
+
+        // Since we can't easily mock stdin in the show method, we'll test the cache behavior
+        // and verify that the method runs without CI detection
+        $reflection = new \ReflectionMethod(ThanksCommand::class, 'runningInCi');
+        $reflection->setAccessible(true);
+
+        // Test that in testing environment, runningInCi returns true
+        $this->assertTrue($reflection->invoke(null));
+
+        // Therefore show() should return early and not output anything
+        ThanksCommand::show();
+        $output = ob_get_clean();
+
+        $this->assertEmpty($output);
+        $this->assertFalse(Cache::get('model-fields.banner_shown', false));
+
+        fclose($input);
+    }
+
+    public function test_show_skips_in_ci_environment()
+    {
+        Cache::forget('model-fields.banner_shown');
+        putenv('CI=1'); // simulate CI environment
+
+        ob_start();
+        ThanksCommand::show(); // should skip showing
+        $output = ob_get_clean();
+
+        $this->assertEmpty($output, 'Expected no output in CI environment');
+
+        putenv('CI'); // clean up
+    }
+
+    public function test_running_in_ci_detects_testing_environment()
+    {
+        // app()->environment() returns 'testing' in PHPUnit
+        $reflection = new \ReflectionMethod(ThanksCommand::class, 'runningInCi');
+        $reflection->setAccessible(true);
+        $this->assertTrue($reflection->invoke(null));
+    }
+
+    public function test_cache_key_constant()
+    {
+        $reflection = new \ReflectionClass(ThanksCommand::class);
+        $constant = $reflection->getConstant('CACHE_KEY');
+        $this->assertEquals('model-fields.banner_shown', $constant);
+    }
+}

todos.md

@@ -48,6 +48,6 @@
 - [x] change the banner 
 - [x] in next version change the whole namespace, github about to model fields
 - [x] remove old code that is not in v3
-- [ ] abstract logic in Field Facade and Builder macro because a lot of duplications
+- [x] star after install
 - [ ] (next version) make commands like backup:tables
 - [ ] (next version) exclude from required fields that are filled in "creating" observers/events and add test cases for that