adds global parameters

docs/content/en/docs/Getting started/usage.md

@@ -0,0 +1,9 @@
+---
+title: Usage
+description: Basic usage conventions and information
+---
+
+# .magento-cli directories
+
+A project repostiory can override the default configuration by storing replacement services or tasks yaml directories in `.magento-cli`. For example, let's say you would like to change the database docker composition, you canc create `.magento-cli/services/database.yaml` and this file will be interpreted when you run `magento serve` instead of the version sourced by magento-cli.
+

main.go

@@ -34,12 +34,13 @@ var yamlExt string = ".yaml"
 var configDir string = ".magento-cli"
 
 func main() {
-
+	// put services files in a temp directory
 	extractYamlToTemp(services)
 
 	// feeds configuration into paraser and executes
 	cmd.YAML(string(loadYaml(tasks)))
 
+	// clean teh temp diretory
 	rmTemp()
 }
 

tasks/parameters.yaml

@@ -0,0 +1,15 @@
+#!/usr/bin/env variant
+definitions:
+  parameters: &global-parameters
+    - name: host
+      type: string
+      description: hostname to serve
+      default: 0.0.0.0
+    - name: port
+      type: string
+      description: php server port
+      default: "8080"
+    - name: routes
+      type: string
+      description: routes used for local development server
+      default: $(pwd)/pub/ $(pwd)/phpserver/router.php

tasks/passthru.yaml

@@ -1,4 +1,4 @@
 #!/usr/bin/env variant
 script: |
   CMD=$(echo {{ index .args }} |  sed -r 's/(\[|\])//g')
-  $MAGECLI_PHP_CMD bin/magento $CMD
+  $MAGECLI_PHP_CMD bin/magento $CMD

tasks/serve.yaml

@@ -1,18 +1,6 @@
 #!/usr/bin/env variant
 tasks:
   serve:
-    parameters:
-    - name: host
-      type: string
-      description: hostname to serve
-      default: 0.0.0.0
-    - name: port
-      type: string
-      description: php server port
-      default: "8080"
-    - name: routes
-      tyoe: string
-      description: routes used for local development server
-      default: $(pwd)/pub/ $(pwd)/phpserver/router.php
+    parameters: *global-parameters
     script: |
-      php -S {{ get "host" }}:{{ get "port" }} -t {{ get "routes" }}
+      echo {{ index .args }} php -S {{ get "host" }}:{{ get "port" }} -t {{ get "routes" }}