feat(commands): add Soar binary download command

- Added a new `soar:download` console command to download the Soar binary.
- Implemented functionality to specify the source (`github` or `gitee`) and path for the binary download.
- Integrated `DownloadCommand` into `SoarServiceProvider` for console use.
- Updated test cases to include comments on the new download command, though not fully enabled.
- Added `guzzlehttp/guzzle` dependency to handle HTTP requests for binary download.

Author: guanguans

.gitignore

@@ -8,7 +8,7 @@ vendor/
 .phpunit.result.cache
 clover.xml
 composer.lock
-laravel/
+/laravel
 phpunit.xml
 psalm.xml
 tests.*

composer-dependency-analyser.php

@@ -58,7 +58,7 @@
     ->ignoreErrorsOnPackageAndPath(
         'spatie/ray',
         __DIR__.'/src/Outputs/RayOutput.php',
-        [ErrorType::DEV_DEPENDENCY_IN_PROD]
+        [ErrorType::SHADOW_DEPENDENCY]
     )
     ->ignoreErrorsOnPackages(
         [

composer.json

@@ -61,6 +61,7 @@
         "ergebnis/rector-rules": "^1.4",
         "guanguans/ai-commit": "dev-main",
         "guanguans/monorepo-builder-worker": "^2.0",
+        "guzzlehttp/guzzle": "^7.9",
         "itsgoingd/clockwork": "^5.3",
         "laradumps/laradumps": "^2.2 || ^3.0 || ^4.0",
         "laravel/facade-documenter": "dev-main",

laravel

@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Copyright (c) 2020-2025 guanguans<ityaozm@gmail.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * @see https://github.com/guanguans/laravel-soar
+ */
+
+namespace Guanguans\LaravelSoar\Commands;
+
+use Guanguans\LaravelSoar\Soar;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Symfony\Component\Console\Helper\ProgressBar;
+
+/**
+ * @method defaultSoarBinary()
+ */
+class DownloadCommand extends Command
+{
+    private const SOURCES = [
+        'github' => 'https://raw.githubusercontent.com/guanguans/soar-php/master/bin/%s',
+        'gitee' => 'https://gitee.com/guanguans/soar-php/raw/master/bin/%s',
+    ];
+
+    /** @noinspection ClassOverridesFieldOfSuperClassInspection */
+    protected $signature = <<<'SIGNATURE'
+        soar:download
+        {--s|source=github : The source of the Soar binary.}
+        {--p|path= : The saved path of the Soar binary.}
+        SIGNATURE;
+
+    /** @noinspection ClassOverridesFieldOfSuperClassInspection */
+    protected $description = 'Download the Soar binary';
+
+    public function handle(): void
+    {
+        $savedPath = $this->savedPath();
+
+        if (File::isFile($savedPath)) {
+            $this->warn("⚠️ The Soar binary [$savedPath] already exists.");
+
+            return;
+        }
+
+        $this->info('⏳ Downloading Soar binary...');
+
+        Http::withoutVerifying()
+            ->withOptions([
+                'sink' => $savedPath,
+                'progress' => function (int $totalDownload, int $downloaded) use (&$progressBar): void {
+                    if (0 < $totalDownload && 0 < $downloaded && !$progressBar instanceof ProgressBar) {
+                        $progressBar = new ProgressBar($this->output, $totalDownload);
+                        $progressBar->start();
+                    }
+
+                    if ($totalDownload === $downloaded && $progressBar instanceof ProgressBar) {
+                        $progressBar->finish();
+                    }
+
+                    $progressBar and $progressBar->setProgress($downloaded);
+                },
+            ])
+            ->get($this->url());
+
+        $this->info("✅ The Soar binary [$savedPath] has been downloaded.");
+    }
+
+    private function soarBinaryName(): string
+    {
+        return basename((fn () => $this->defaultSoarBinary())->call(resolve(Soar::class)));
+    }
+
+    /**
+     * @noinspection OffsetOperationsInspection
+     */
+    private function url(): string
+    {
+        return \sprintf(self::SOURCES[$this->option('source')], $this->soarBinaryName());
+    }
+
+    private function savedPath(): string
+    {
+        return $this->option('path') ?: base_path($this->soarBinaryName());
+    }
+}

src/Commands/DownloadCommand.php

@@ -15,6 +15,7 @@
 
 use Composer\InstalledVersions;
 use Guanguans\LaravelSoar\Commands\ClearCommand;
+use Guanguans\LaravelSoar\Commands\DownloadCommand;
 use Guanguans\LaravelSoar\Commands\RunCommand;
 use Guanguans\LaravelSoar\Commands\ScoreCommand;
 use Guanguans\LaravelSoar\Mixins\QueryBuilderMixin;
@@ -127,6 +128,7 @@ private function registerCommands(): void
         if ($this->app->runningInConsole()) {
             $this->commands([
                 ClearCommand::class,
+                DownloadCommand::class,
                 RunCommand::class,
                 ScoreCommand::class,
             ]);

src/SoarServiceProvider.php

@@ -0,0 +1,38 @@
+<?php
+
+/** @noinspection AnonymousFunctionStaticInspection */
+/** @noinspection NullPointerExceptionInspection */
+/** @noinspection PhpPossiblePolymorphicInvocationInspection */
+/** @noinspection PhpUndefinedClassInspection */
+/** @noinspection PhpUnhandledExceptionInspection */
+/** @noinspection SqlResolve */
+/** @noinspection StaticClosureCanBeUsedInspection */
+declare(strict_types=1);
+
+/**
+ * Copyright (c) 2020-2025 guanguans<ityaozm@gmail.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * @see https://github.com/guanguans/laravel-soar
+ */
+
+use Guanguans\LaravelSoar\Commands\DownloadCommand;
+use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\Http;
+
+it('can download Soar binary', function (): void {
+    Http::preventStrayRequests();
+
+    Artisan::call(
+        DownloadCommand::class,
+        [
+            // '--path' => null,
+            '--source' => 'gitee',
+        ]
+    );
+
+    // dump(Artisan::output());
+    expect(true)->toBeTrue();
+})->group(__DIR__, __FILE__)->skip();