Added local Ahoy config.

Author: AlexSkrypnyk

.ahoy.local.example.yml

@@ -0,0 +1,14 @@
+---
+ahoyapi: v2
+usage: Project specific ahoy commands.
+
+commands:
+  help:
+    cmd: |
+      echo "[INFO] Custom local commands"
+      echo "You may add custom local commands to your toolchain. This local Ahoy file will not be comitted to the repository"
+      echo
+
+#  mylocalcommand:
+#    cmd: |
+#      echo "Anything complex you can do on the command line."

.ahoy.yml

@@ -11,10 +11,10 @@ commands:
       ahoy clean
       ahoy up
       ahoy install
-      ahoy install-site
-      ahoy title "Build complete"
+      ahoy provision
       ahoy doctor
       ahoy info
+      ahoy title "Build complete"
 
   cli:
     usage: Start a shell inside CLI container or run a command.
@@ -78,19 +78,48 @@ commands:
 
   # Utilities.
   title:
-    cmd: printf "$(tput -Txterm setaf 4)==> ${1}$(tput -Txterm sgr0)\n"
+    cmd: printf "$(tput -Txterm setaf 4)[INFO] ${1}$(tput -Txterm sgr0)\n"
     hide: true
 
   pre-flight:
     cmd: echo "Would run pre-flight checks."
     hide: true
 
+  local:
+    usage: Custom local commands. See `ahoy local help`.
+    cmd: |
+      if [ -f .ahoy.local.yml ]; then
+        ahoy -f ".ahoy.local.yml" "$@"
+      else
+        echo ".ahoy.local.yml does not exist."
+        echo "Copy .ahoy.local.example.yml to .ahoy.local.yml and rerun this command.";
+      fi
+
+  # ----------------------------------------------------------------------------
+  # Utilities.
+  # ----------------------------------------------------------------------------
+  confirm:
+    cmd: |
+      if [ -z "$AHOY_CONFIRM_RESPONSE" ]; then
+        read -r -p ">> $1 [y/N] " AHOY_CONFIRM_RESPONSE
+        [ "$AHOY_CONFIRM_RESPONSE" = "y" ] || [ "$AHOY_CONFIRM_RESPONSE" = true ] || ( echo "The operation was canceled." && exit 1 )
+      else
+        echo ">> $1 [y/N] $AHOY_CONFIRM_RESPONSE" \
+        && if [ "${AHOY_CONFIRM_WAIT_SKIP}" != "1" ]; then echo "Waiting for 3 seconds... Press Ctrl+C to cancel."; sleep 3; fi
+      fi
+    hide: true
+
+# Override entrypoint to alter default behaviour of Ahoy.
 entrypoint:
+  # Run all commands in Bash.
   - bash
-  - "-c"
-  - "-e"
+  # Read the commands from the string.
+  - -c
+  # Exit the script if any statement returns a non-true return value.
+  - -e
+  # Read variables from .env file, respecting existing environment variable values.
   - |
-    [ -f .env ] && [ -s .env ] && export $(grep -v '^#' .env | xargs) && if [ -f .env.local ] && [ -s .env.local ]; then export $(grep -v '^#' .env.local | xargs); fi
+    [ -f .env ] && [ -s .env ] && t=$(mktemp) && export -p > "$t" && set -a && . ./.env && if [ -f ./.env.local ];then . ./.env.local;fi && set +a && . "$t" && rm "$t" && unset t
     bash -e -c "$0" "$@"
   - '{{cmd}}'
   - '{{name}}'

README.md

@@ -26,23 +26,23 @@ way.
 
 Depending on your language or a framework, you may create your own
 implementation of
-the [.ahoy.yml](https://github.com/integratedexperts/dx/blob/master/.ahoy.yml)
+the [.ahoy.yml](https://github.com/drevops/dx/blob/master/.ahoy.yml)
 file.
 
 Check it out locally and run `ahoy build` to see how it works (you need to have
 Ahoy installed):
 
-```
+```bash
 $ ahoy build
-==> Building project
+[INFO] Building project
 Would run pre-flight checks.
 Would remove containers and all build files.
 Would build and start Docker containers.
 Would install project and all dependencies.
 Would run provision operations.
-==> Build complete
 Would find problems with current project setup.
 Would print project information
+[INFO] Build complete
 ```
 
 ## Existing implementations
@@ -54,7 +54,7 @@ Would print project information
 ## Similar and partial implementations (that would be nice to unify)
 
 - GovCMS (PHP,
-  Drupal, [https://github.com/govCMS/govCMS/blob/7.x-3.x/.ahoy.yml](https://github.com/govCMS/govCMS/blob/7.x-3.x/.ahoy.yml))
+  Drupal, [https://github.com/govCMS/GovCMS/blob/3.x-develop/.ahoy.yml](https://github.com/govCMS/GovCMS/blob/3.x-develop/.ahoy.yml))
 - SDP (PHP,
   Drupal, [https://github.com/dpc-sdp/dev-tools/blob/master/.ahoy.yml](https://github.com/dpc-sdp/dev-tools/blob/master/.ahoy.yml))
 
@@ -76,7 +76,7 @@ Would print project information
 
 - Install project and all dependencies.
 
-## `provision` (for web-based projects)
+## `provision`
 
 - Perform application-level operations to guarantee consistent application
   state.
@@ -90,8 +90,8 @@ Would print project information
 
 ## `test-unit`
 
-- Run unit tests
-- Agnostic to framework
+- Run unit tests.
+- Agnostic to framework.
 - Must run all tests if no arguments provided.
 
 ## `test-bdd`
@@ -110,20 +110,19 @@ Would print project information
 
 ## `clean`
 
-- Bring project to default state
-- Remove installed dependencies
+- Bring project to default state.
+- Remove installed dependencies.
 
 ## `update`
-- 
 
-- Update ahoy configuration itself
-- Possible to update some platform files
+- Update ahoy configuration itself.
+- Possible to update some platform files.
 
 ## `doctor`
 
-- Identify any problems with the stack
-- Offer resolution suggestions
-- Run before build in pre-flight mode
+- Identify any problems with the stack.
+- Offer resolution suggestions.
+- Run before build in pre-flight mode.
 
 ## Command wrapper
 
@@ -133,6 +132,11 @@ to create and maintain unified commands within a single YAML file.
 [.ahoy.yml](https://github.com/drevops/dx/blob/main/.ahoy.yml) file
 in this repository is an example of the command configuration file.
 
+[.ahoy.local.example.yml](https://github.com/drevops/dx/blob/main/.ahoy.local.example.yml)
+file in this repository is an example of the local command configuration file
+that would be excluded from the repository. This file is used to define
+additional local commands.
+
 ### Ahoy config
 
 - Contain as less custom code as possible: rely on scripts or binaries that can