Adds basic text substitution to Deploy args

.github/workflows/ci.yaml

@@ -3,7 +3,7 @@ name: CI
 on: [push]
 
 jobs:
-  phpstan:
+  tests-and-static-analysis:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
@@ -12,4 +12,9 @@ jobs:
       - name: PHPStan Static Analysis
         uses: php-actions/phpstan@v3
         with:
-          configuration: ./phpstan.neon
+          configuration: ./phpstan.neon
+      - name: PHPUnit Tests
+        uses: php-actions/phpunit@master
+        with:
+          bootstrap: vendor/autoload.php
+          configuration: phpunit.xml

.gitignore

@@ -2,4 +2,7 @@
 .idea
 lagoon-sync
 /scripts/*
-!/scripts/default.yaml
+!/scripts/default.yaml
+./scratchpad
+.phpunit.result.cache
+.phpunit.cache

README.md

@@ -116,6 +116,16 @@ All steps can take the following optional fields to set retry parameters
 
 Currently, the toolbox supports the following functions.
 
+#### Text Substitutions with environment variables
+
+Some of the steps below support the notion of text substitution - that is, you're able to use string templates of the 
+form `{{ substitutionname }}` and before the step is run, it will replace the substitution with the appropriate text.
+
+This system also allows for substitutions from environment variables. For instance, if you have an environment variable of the name
+`SYSTEM_NAME`, you can use that in the step substitutions by referencing it as `{{ SYSTEM_NAME }}`
+
+We use [twig](https://twig.symfony.com/) for formatting, which makes it simple to add default values, for instance, if `SYSTEM_NAME` is only available conditionally, we can do something like `{{ SYSTEM_NAME ?? 'default val' }}`
+
 ### Exec
 
 The exec step allows you to run a command from inside the current advanced task's container, or within another pod.
@@ -147,9 +157,9 @@ The `exec` step allows you to do textual substitutions in the `command`.
 
 It will do the following substitutions
 
-* '%project%' for current project name
-* '%environment%' for the current environment
-* '%namespace%' for the current namespace
+* '{{ project }}' for current project name
+* '{{ environment }}' for the current environment
+* '{{ namespace }}' for the current namespace
 
 ### scale
 

composer.json

@@ -11,10 +11,13 @@
         "renoki-co/php-k8s": "^3.7",
         "symfony/process": "^6.1",
         "symfony/yaml": "^6.1",
-        "league/climate": "^3.8"
+        "league/climate": "^3.8",
+        "twig/twig": "^3.0",
+        "wyrihaximus/simple-twig": "^2.1"
     },
     "license": "MIT",
     "require-dev": {
-        "phpstan/phpstan": "^1.10"
+        "phpstan/phpstan": "^1.10",
+        "phpunit/phpunit": "^10"
     }
 }