Allow custom repositories and versions for composer packages

Author: dave-redfern

readme.md

@@ -268,12 +268,26 @@ The source can be one of:
  * git:
  * <folder_name> in the project config `templates` folder
  * empty
- 
+
+##### Composer Templates
+
 `composer:` will use `composer create-project` and requires that the source be a valid installation
 project either registered with packagist.org or with private packagist.com.
 
+To use a custom repository like with Private Packagist add `?repository=https://repo/source`.
+
+To specify a specific version to use add `&version=XXX`. To use the latest version set the version
+to `dev-master`.
+
+The full template source would then look like:
+`composer:namespace/project-name?repository=https://some.repo/somewhere&version=2.0.2`.
+
+##### Git Templates
+
 `git:` will clone and remove the `.git` folder, essentially using the git repo as a template.
 
+##### Static Templates
+
 `<folder_name>` will copy all files in that folder to the new source. Additionally, if the template
 folder contains a `post_copy.php` file, this will be run after the files have been copied. This
 script can perform any actions needed for setup. Further: if a `post_copy_args.php` exists, then
@@ -293,6 +307,8 @@ was created. If the return type of the args is not an array nothing will be aske
 
 The `post_copy.php` file should check the arg inputs before running.
 
+##### Generic Template (fallback)
+
 If the template is left empty then a very basic folder is created with some general defaults including:
 
  * .gitignore

src/Services/Installers/ComposerInstaller.php

@@ -5,6 +5,7 @@
 use IlluminateAgnostic\Str\Support\Str;
 use Somnambulist\ProjectManager\Models\Project;
 use Somnambulist\ProjectManager\Models\Template;
+use function parse_str;
 use function sprintf;
 
 /**
@@ -23,11 +24,17 @@ public function installInto(Project $project, Template $template, string $name,
         $this->tools()->step(++$step, 'creating <info>%s</info> from composer project', $this->type);
         $this->tools()->warning('installer scripts will not be run!');
 
+        $proj = $this->getProjectPackage($template);
+        $repo = $this->getAlternateRepository($template);
+        $ver  = $this->getProjectPackageVersion($template);
+
         $res = $this->tools()->execute(
             sprintf(
-                'composer create-project --no-scripts --remove-vcs %s %s',
-                Str::replaceFirst('composer:', '', $template->source()),
-                $cwd
+                'composer create-project --no-scripts --remove-vcs %s %s %s %s',
+                $repo ? '--repository=' . $repo : '',
+                $proj,
+                $cwd,
+                $ver
             ),
             dirname($cwd)
         );
@@ -49,4 +56,33 @@ public function installInto(Project $project, Template $template, string $name,
 
         return $this->success();
     }
+
+    private function getProjectPackage(Template $template): string
+    {
+        return Str::before(Str::replaceFirst('composer:', '', $template->source()), '?');
+    }
+
+    private function getAlternateRepository(Template $template): ?string
+    {
+        $options = $this->parseTemplateOptions($template);
+
+        return $options['repository'] ?? null;
+    }
+
+    private function getProjectPackageVersion(Template $template): ?string
+    {
+        $options = $this->parseTemplateOptions($template);
+
+        return $options['version'] ?? null;
+    }
+
+    private function parseTemplateOptions(Template $template): array
+    {
+        $query   = Str::after($template->source(), '?');
+        $options = [];
+
+        parse_str($query, $options);
+
+        return $options;
+    }
 }