feat: support custom XML config (./dload.xml by default); added cli…

… option `config`

README.md

@@ -55,3 +55,25 @@ Download all the software from the preset:
 ```bash
 ./vendor/bin/dload get
 ```
+
+### Custom software registry
+
+```xml
+<?xml version="1.0"?>
+<dload>
+    <registry>
+        <software name="RoadRunner"
+                  alias="rr"
+                  description="High performant Application server"
+        >
+            <repository type="github"
+                        uri="roadrunner-server/roadrunner"
+                        asset-pattern="/^roadrunner-.*/"
+            />
+            <file pattern="/^(roadrunner|rr)(?:\.exe)?$/"
+                  rename="rr"
+            />
+        </software>
+    </registry>
+</dload>
+```

dload.xml

@@ -1,17 +1,10 @@
 <?xml version="1.0"?>
+<!-- Example -->
 <dload>
-    <registry>
+    <registry overwrite="false">
         <software name="RoadRunner" alias="rr" description="High performant Application server">
             <repository type="github" uri="roadrunner-server/roadrunner" asset-pattern="/^roadrunner-.*/"/>
             <file rename="rr" pattern="/^(roadrunner|rr)(?:\.exe)?$/" />
         </software>
-        <software name="Dolt" description="Dolt is a SQL database that you can fork, clone, branch, merge, push and pull just like a Git repository">
-            <repository type="github" uri="dolthub/dolt" asset-pattern="/^dolt-.*/"/>
-            <file pattern="/^(dolt)(?:\.exe)?$/" />
-        </software>
-        <software name="Temporal" description="Temporal command-line interface and development server">
-            <repository type="github" uri="temporalio/cli" asset-pattern="/^temporal_cli_.*/"/>
-            <file pattern="/^(temporal)(?:\.exe)?$/" />
-        </software>
     </registry>
 </dload>

resources/software.json

@@ -0,0 +1,58 @@
+[
+    {
+        "name": "RoadRunner",
+        "alias": "rr",
+        "homepage": "https://roadrunner.dev",
+        "description": "High-performance PHP application server, load-balancer and process manager written in Golang",
+        "repositories": [
+            {
+                "type": "github",
+                "uri": "roadrunner-server/roadrunner",
+                "asset-pattern": "/^roadrunner-.*/"
+            }
+        ],
+        "files": [
+            {
+                "pattern": "/^(roadrunner|rr)(?:\\.exe)?$/",
+                "rename": "rr"
+            }
+        ]
+    },
+    {
+        "name": "Temporal",
+        "alias": "temporal",
+        "description": "Temporal SDK",
+        "homepage": "https://temporal.io",
+        "repositories": [
+            {
+                "type": "github",
+                "uri": "temporalio/sdk-php",
+                "asset-pattern": "/^temporal-.*/"
+            }
+        ],
+        "files": [
+            {
+                "pattern": "/^temporal-.*/",
+                "rename": "temporal"
+            }
+        ]
+    },
+    {
+        "name": "Dolt",
+        "alias": "dolt",
+        "description": "Dolt is a SQL database that you can fork, clone, branch, merge, push and pull just like a git repository.",
+        "homepage": "https://www.dolthub.com",
+        "repositories": [
+            {
+                "type": "github",
+                "uri": "dolthub/dolt",
+                "asset-pattern": "/^dolt-.*/"
+            }
+        ],
+        "files": [
+            {
+                "pattern": "/^dolt-.*/"
+            }
+        ]
+    }
+]

src/Command/Base.php

@@ -9,6 +9,7 @@
 use Internal\DLoad\Service\Logger;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console\Style\StyleInterface;
 use Symfony\Component\Console\Style\SymfonyStyle;
@@ -22,22 +23,50 @@ abstract class Base extends Command
 
     protected Container $container;
 
+    public function configure(): void
+    {
+        parent::configure();
+        $this->addOption('config', null, InputOption::VALUE_OPTIONAL, 'Path to the configuration file');
+    }
+
     protected function execute(
         InputInterface $input,
         OutputInterface $output,
     ): int {
         $this->logger = new Logger($output);
         $this->container = $container = Bootstrap::init()->withConfig(
-            xml: \dirname(__DIR__, 2) . '/dload.xml',
+            xml: $this->getConfigFile($input),
             inputOptions: $input->getOptions(),
             inputArguments: $input->getArguments(),
             environment: \getenv(),
         )->finish();
+
         $container->set($input, InputInterface::class);
         $container->set($output, OutputInterface::class);
         $container->set(new SymfonyStyle($input, $output), StyleInterface::class);
         $container->set($this->logger);
 
         return Command::SUCCESS;
     }
+
+    /**
+     * @return non-empty-string|null Path to the configuration file
+     */
+    private function getConfigFile(InputInterface $input): ?string
+    {
+        /** @var string|null $config */
+        $config = $input->getOption('config');
+        $isConfigured = $config !== null;
+        $config ??= './dload.xml';
+
+        if (\is_file($config)) {
+            return $config;
+        }
+
+        $isConfigured and throw new \InvalidArgumentException(
+            'Configuration file not found: ' . $config,
+        );
+
+        return null;
+    }
 }

src/Command/Get.php

@@ -27,6 +27,7 @@ final class Get extends Base implements SignalableCommandInterface
 {
     public function configure(): void
     {
+        parent::configure();
         $this->addArgument('binary', InputArgument::REQUIRED, 'Binary name, e.g. "rr", "dolt", "temporal" etc.');
         $this->addOption('path', null, InputOption::VALUE_OPTIONAL, 'Path to store the binary, e.g. "./bin"', ".");
         $this->addOption('arch', null, InputOption::VALUE_OPTIONAL, 'Architecture, e.g. "amd64", "arm64" etc.');

src/Module/Common/Config/SoftwareRegistry.php → src/Module/Common/Config/CustomSoftwareRegistry.php

@@ -4,10 +4,14 @@
 
 namespace Internal\DLoad\Module\Common\Config;
 
+use Internal\DLoad\Module\Common\Internal\Attribute\XPath;
 use Internal\DLoad\Module\Common\Internal\Attribute\XPathEmbedList;
 
-final class SoftwareRegistry
+final class CustomSoftwareRegistry
 {
+    #[XPath('/dload/registry/@overwrite')]
+    public bool $overwrite = false;
+
     /**
      * @var Embed\Software[]
      */

src/Module/Common/Config/Embed/File.php

@@ -16,4 +16,13 @@ final class File
 
     #[XPath('@pattern')]
     public string $pattern = '/^.*$/';
+
+    public static function fromArray(mixed $fileArray): self
+    {
+        $self = new self();
+        $self->rename = $fileArray['rename'] ?? null;
+        $self->pattern = $fileArray['pattern'] ?? '/^.*$/';
+
+        return $self;
+    }
 }

src/Module/Common/Config/Embed/Repository.php

@@ -16,4 +16,14 @@ final class Repository
 
     #[XPath('@asset-pattern')]
     public string $assetPattern = '/^.*$/';
+
+    public static function fromArray(mixed $repositoryArray): self
+    {
+        $self = new self();
+        $self->type = $repositoryArray['type'] ?? 'github';
+        $self->uri = $repositoryArray['uri'];
+        $self->assetPattern = $repositoryArray['asset-pattern'] ?? '/^.*$/';
+
+        return $self;
+    }
 }

src/Module/Common/Config/Embed/Software.php

@@ -33,6 +33,24 @@ final class Software
     #[XPathEmbedList('file', File::class)]
     public array $files = [];
 
+    public static function fromArray(mixed $softwareArray): self
+    {
+        $self = new self();
+        $self->name = $softwareArray['name'];
+        $self->alias = $softwareArray['alias'] ?? null;
+        $self->description = $softwareArray['description'] ?? '';
+        $self->repositories = \array_map(
+            static fn(array $repositoryArray) => Repository::fromArray($repositoryArray),
+            $softwareArray['repository'] ?? [],
+        );
+        $self->files = \array_map(
+            static fn(array $fileArray) => File::fromArray($fileArray),
+            $softwareArray['file'] ?? [],
+        );
+
+        return $self;
+    }
+
     /**
      * @return non-empty-string
      */

src/Module/Common/Internal/Injection/ConfigLoader.php

@@ -126,8 +126,12 @@ private function getXPath(XPath $attribute): mixed
 
     private function getXPathEmbeddedList(XPathEmbedList $attribute): array
     {
+        if ($this->xml === null) {
+            return [];
+        }
+
         $result = [];
-        $value = $this->xml?->xpath($attribute->path);
+        $value = $this->xml->xpath($attribute->path);
         \is_array($value) or throw new \Exception(\sprintf('Invalid XPath `%s`', $attribute->path));
 
         foreach ($value as $xml) {

src/Module/Downloader/SoftwareCollection.php

@@ -4,43 +4,62 @@
 
 namespace Internal\DLoad\Module\Downloader;
 
+use Internal\DLoad\Info;
+use Internal\DLoad\Module\Common\Config\CustomSoftwareRegistry;
 use Internal\DLoad\Module\Common\Config\Embed\Software;
-use Internal\DLoad\Module\Common\Config\SoftwareRegistry;
 use IteratorAggregate;
 
 /**
  * @implements IteratorAggregate<Software>
  */
 final class SoftwareCollection implements \IteratorAggregate, \Countable
 {
+    /** @var array<non-empty-string, Software> */
+    private array $registry = [];
+
     public function __construct(
-        private readonly SoftwareRegistry $softwareRegistry,
-    ) {}
+        CustomSoftwareRegistry $softwareRegistry,
+    ) {
+        foreach ($softwareRegistry->software as $software) {
+            $this->registry[$software->getId()] = $software;
+        }
+
+        $softwareRegistry->overwrite or $this->loadDefaultRegistry();
+    }
 
     public function findSoftware(string $name): ?Software
     {
-        foreach ($this->softwareRegistry->software as $software) {
-            if ($software->getId() === $name) {
-                return $software;
-            }
-        }
-
-        return null;
+        return $this->registry[$name] ?? null;
     }
 
     /**
      * @return \Traversable<Software>
      */
     public function getIterator(): \Traversable
     {
-        yield from $this->softwareRegistry->software;
+        yield from $this->registry;
     }
 
     /**
      * @return int<0, max>
      */
     public function count(): int
     {
-        return \count($this->softwareRegistry->software);
+        return \count($this->registry);
+    }
+
+    private function loadDefaultRegistry(): void
+    {
+        $json = \json_decode(
+            \file_get_contents(Info::ROOT_DIR . '/resources/software.json'),
+            true,
+            16,
+            JSON_THROW_ON_ERROR,
+        );
+
+        foreach ($json as $softwareArray) {
+            $software = Software::fromArray($softwareArray);
+            $this->registry[$software->getId()] ??= $software;
+        }
     }
 }