Add MAML recipes

Author: antonmedv

composer.json

@@ -41,6 +41,7 @@
     ],
     "require": {
         "php": "^8.3",
+        "maml/maml": "^3.0",
         "symfony/console": "^7.4.0 || ^8.0.0",
         "symfony/process": "^7.4.0 || ^8.0.0",
         "symfony/yaml": "^7.4.0 || ^8.0.0"

src/Deployer.php

@@ -24,7 +24,7 @@
 use Deployer\Host\Host;
 use Deployer\Host\HostCollection;
 use Deployer\Host\Localhost;
-use Deployer\Importer\Importer;
+use Deployer\Import\Import;
 use Deployer\Logger\Handler\FileHandler;
 use Deployer\Logger\Handler\NullHandler;
 use Deployer\Logger\Logger;
@@ -61,7 +61,7 @@
  * @property Logger $logger
  * @property Collection $fail
  * @property InputDefinition $inputDefinition
- * @property Importer $importer
+ * @property Import $importer
  */
 class Deployer extends Container
 {
@@ -158,7 +158,7 @@ public function __construct(Application $console)
             );
         };
         $this['importer'] = function () {
-            return new Importer();
+            return new Import();
         };
 
         self::$instance = $this;

src/Exception/SchemaException.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+/* (c) Anton Medvedev <anton@medv.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Deployer\Exception;
+
+class SchemaException extends \RuntimeException {}

src/Import/Import.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+/* (c) Anton Medvedev <anton@medv.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Deployer\Import;
+
+use Deployer\Exception\Exception;
+
+class Import
+{
+    /**
+     * @param string|string[] $paths
+     * @throws Exception
+     */
+    public static function import(mixed $paths): void
+    {
+        if (!is_array($paths)) {
+            $paths = [$paths];
+        }
+        foreach ($paths as $path) {
+            if (preg_match('/\.php$/i', $path)) {
+                // Prevent variable leak into deploy.php file
+                call_user_func(function () use ($path) {
+                    // Reorder autoload stack
+                    $originStack = spl_autoload_functions();
+
+                    require $path;
+
+                    $newStack = spl_autoload_functions();
+                    if ($originStack[0] !== $newStack[0]) {
+                        foreach (array_reverse($originStack) as $loader) {
+                            spl_autoload_unregister($loader);
+                            spl_autoload_register($loader, true, true);
+                        }
+                    }
+                });
+            } elseif (preg_match('/\.maml$/i', $path)) {
+                $recipe = new MamlRecipe($path);
+                $recipe->run();
+            } elseif (preg_match('/\.ya?ml$/i', $path)) {
+                YamlRecipe::exec($path);
+            } else {
+                throw new Exception("Unknown file format: $path");
+            }
+        }
+    }
+}