New Features

• Better handling of quotes by no longer using {{args}}. Use regular bash syntax like "$@" for all arguments, or $1 for the first argument.
• You can now use a different entrypoint (the thing that runs your commands) instead of bash. Ex. using php, nodejs, python, etc.
• Plugins are now possible by overriding the entrypoint.

Example of new yaml setup in v2

# All files must have v2 set or you'll get an error
ahoyapi: v2

# You can now override the entrypoint. This is the default if you don't override it.
# {{cmd}} is replaced with your command and {{name}} is the name of the command that was run (available as $0)
entrypoint:
  - bash
  - "-c"
  - '{{cmd}}'
  - '{{name}}'
commands:
  example:
    usage: shows the new format
    # Note: Arguments are handled by bash, so all the goodies from there can be used.
    cmd: |
      echo "The first argument is at $1"
      echo "All the arguments are at $@"
      echo "There are ${#@} arguments"
  list:
      usage: List the commands from the imported config files.
      # These commands will be aggregated together with later files overriding earlier ones if they exist.
      imports:
        - ./confirmation.ahoy.yml
        - ./docker.ahoy.yml
        - ./examples.ahoy.yml

CHANGES

• Adds functional tests via the bats project. See https://github.com/sstephenson/bats. This would be a good contributions.
• Update the repo names to the new ahoy-cli organization.
• Most issues around flags not working (--version, --help) and ahoy init are now fixed.
• Documentation added via ReadTheDocs and we have our own website. See http://ahoycli.com

Important Note:

• ahoyapi: v1 is now required in your ahoy.yml files so that we can maintain backwards-compatibility as we move forward. Ahoy will fail with a warning if it's not set. 3d7e5c6

New Features:

• Added a verbose flag for debugging the actual commands that are being called and files that are loaded. #8
• Hide a command from being shown in the help using hide: true f8b1077
• Don't parse any flags that come after your command (they all get sent as args), so no need to use the -- in commands with flags #11
• Specify the .ahoy.yml file you want to use using ahoy -f some/other/ahoy.file.yaml for files relative to the ahoy command being called or ahoy -f /root/ahoy.file.yaml for setting it absolutely. Note that this can be used to import specific commands from other ahoy files! #9
• Added command parameter import: some/file.ahoy.yml to import an entire yaml file as sub-commands. import and cmd should not be used for the same command. #12 See examples dir.
• Support multi-line commands - and even full blown bash scripts in cmd using cmd: | #5
• ahoy init now supports a custom url argument that will install a custom

Bugs Fixed:

• Commands now always listed in alphabetical order. #1
• Replace multiple instances of {{args}} in a command #13
• Don't load default commands (ahoy init) if it's been declared locally.

Known Issues:

• --help, -h flags no longer seem to work as expected. #16
• Long help text (usage) wraps to the beginning of the next line instead of staying within its column. #15
• ahoy init will still overwrite an existing .ahoy.yml file, but the command can be overwritten in an existing .ahoy.yml file to just output a simple error message instead of downloading anything.

CHANGELOG

Everything - check the README.md on github which should get more fleshed out with examples soon.