Add support for public runtimes hosted in github

Author: hadefication

.gitignore

@@ -1,9 +1,4 @@
-*
-!/src/*
-!.editorconfig
-!.gitattributes
-!.gitignore
-!composer.json
-!devstack
-!LICENSE
-!README.md
+composer.lock
+.DS_Store
+vendor
+example

src/Commands/InitStack.php

@@ -4,6 +4,7 @@
 
 use Webteractive\Devstack\RuntimeDownloader;
 use Webteractive\Devstack\File;
+use Webteractive\Devstack\PublicRuntimeDownloader;
 use Webteractive\Devstack\ShouldConfigure;
 
 class InitStack extends Base
@@ -18,10 +19,23 @@ class InitStack extends Base
 
     public function handle(): int
     {
+        $destination = $this->option('dest', getcwd());
+        
         $this->ensureConfigurationIsSet(
             $runtime = $this->argument('runtime')
         );
 
+        if (filter_var($runtime, FILTER_VALIDATE_URL)) {
+            $resolvedRuntime = (new PublicRuntimeDownloader)->download($runtime);
+            if ((new File)->copyDirectory($this->devstackStorage()->path($resolvedRuntime), $destination)) {
+                $this->info($this->makeMessage($runtime, $destination));
+            } else {
+                $this->error("Failed to load the {$runtime} runtime to {$destination}, copy of runtime was unsuccessful.");
+            }
+
+            return static::SUCCESS;
+        }
+
         $this->resolveRuntimes();
 
         if (is_null($runtime)) {
@@ -31,25 +45,11 @@ public function handle(): int
             );
         }
 
-        $destination = $this->option('dest', getcwd());
+        
 
         if ($resolvedRuntime = ($this->runtimes[$runtime] ?? null)) {
             if ((new File)->copyDirectory($this->devstackStorage()->path($resolvedRuntime), $destination)) {
-                $this->info("
-Runtime for <comment>{$runtime}</comment> is now loaded to {$destination}.
-
-You can now run the <comment>dev</comment> command. To get started, run <comment>dev up</comment> or <comment>dev up -d</comment> to start the docker containers.
-For the first run, it will build the images first and proceed running the containers. To stop the
-containers, run <comment>dev down</comment>. For more details on the avaialble commands, run <comment>dev help</comment>.
-
-To exclude the runtime files to your repository, add the following files below to your .gitignore file:
-
-<fg=white>/docker</>
-<fg=white>dev</>
-<fg=white>docker-compose.yml</>
-
-You're now all set, happy trails!
-                ");
+                $this->info($this->makeMessage($runtime, $destination));
             } else {
                 $this->error("Failed to load the {$runtime} runtime to {$destination}, copy of runtime was unsuccessful.");
             }
@@ -88,4 +88,22 @@ public function getAvailableRuntimes()
         return collect($this->devstackStorage()->directories('runtimes'))
             ->map(fn ($item) => pathinfo($item, PATHINFO_BASENAME));
     }
+
+    public function makeMessage($runtime, $destination)
+    {
+        return "
+Runtime for <comment>{$runtime}</comment> is now loaded to {$destination}.
+
+You can now run the <comment>dev</comment> command. To get started, run <comment>dev up</comment> or <comment>dev up -d</comment> to start the docker containers.
+For the first run, it will build the images first and proceed running the containers. To stop the
+containers, run <comment>dev down</comment>. For more details on the avaialble commands, run <comment>dev help</comment>.
+
+To exclude the runtime files to your repository, add the following files below to your .gitignore file:
+
+<fg=white>/docker</>
+<fg=white>dev</>
+<fg=white>docker-compose.yml</>
+
+You're now all set, happy trails!";
+    }
 }

src/PublicRuntimeDownloader.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Webteractive\Devstack;
+
+use ZipArchive;
+use Illuminate\Support\Str;
+
+class PublicRuntimeDownloader
+{
+    use WithStorage,
+        WithHttp;
+
+    public function download($url)
+    {
+        $archive = $this->homePath('runtimes.zip');
+        $finalDownloadUrl = $this->resolveDownloadUrl($url);
+        $response = $this->http()->get($finalDownloadUrl, [
+            'sink' => $archive
+        ]);
+
+        if ($response->getStatusCode() == 200) {
+            if (($zip = new ZipArchive)->open($archive)) {
+                $zip->extractTo($this->homePath('tmp'));
+                $zip->close();
+                $this->devstackStorage()->delete('runtimes.zip');
+                $extracted = $this->devstackStorage()->directories('tmp')[0];
+                $newRuntimeName = sha1($finalDownloadUrl);
+                if ($this->devstackStorage()->exists('runtimes/' . $newRuntimeName)) {
+                   $this->devstackStorage()->deleteDirectory('runtimes/' . $newRuntimeName);
+                }
+                $this->devstackStorage()->move($extracted, 'runtimes/' . $newRuntimeName);
+                $this->devstackStorage()->deleteDirectory('tmp');
+                return join('/', ['runtimes', $newRuntimeName]);
+            }
+        }
+
+        return false;
+    }
+
+    public function isFromGithub($url)
+    {
+        return Str::contains($url, 'github.com');
+    }
+
+    public function resolveDownloadUrl($url)
+    {
+        if ($this->isFromGithub($url)) {
+            $downloadUrl = Str::of($url)
+                ->replace('https://github.com', 'https://api.github.com/repos')
+                ->append('/releases/latest')
+                ->toString();
+            $response = $this->http()->get($downloadUrl);
+            return json_decode($response->getBody(), true)['zipball_url'];
+        }
+
+        return $url;
+    }
+}