Commands - waffle-ops/waffle GitHub Wiki

Waffle comes packaged with some commands that provide 'global' interactions. Commands will behave consistently across all projects and use cases as commands cannot be overridden.

Note: For more information about any of the following commands, try running wfl help [command].

docs

The docs command opens a web browser to this wiki!

Usage: wfl docs


help

Provides help text for the provided command, task, or recipe.

Note: Tasks and Recipes can be overridden. Such Tasks and Recipes will not provide useful help text.

Usage: wfl help [command|task|recipe]


init

Provides a 'wizard' that walks you through generating a barebones .waffle.yml file.

Note: The init command is partially destructive. It will overwrite an existing .waffle.yml file, so make sure it is checked into version control!

Usage: wfl init


iterate

Provides a way to execute Waffle commands, tasks, or recipes over a collection of projects.

Note: The iterate command has niche use cases and is not intended for everyday use.

Usage: wfl iterate [command|task|recipe]

Examples:

# The below commands could be used individually or grouped together as a workflow.

# Generates a report of pending updates of all projects that have a .waffle.yml
# file under path/to/projects
wfl iterate update-status --dir=path/to/projects

# Creates a new feature branch for applying monthly updates for all projects
# that have a .waffle.yml file under path/to/projects.
wfl iterate update-prepare --dir=path/to/projects

# Applys pending updates on the current branch for all projects that have a
# .waffle.yml file under path/to/projects.
wfl iterate update-apply --dir=path/to/projects

list

Lists the commands, tasks, and recipes that are available for use.

Note: This is the default command that runs when you simply run wfl.

Usage: wfl list


self-update

Provides an easy way to update the installed version of Waffle.

Note: The self-update command is only available on when using the .phar.

Usage: wfl self-update


If you have some ideas for commands to add feel free to suggest something in the issue queue!