Call (Leaves)

Mint leaves are external task definitions that are similar to GitHub's Actions.

To use a leaf, add call instead of run to your task definition.

View all available leaves at https://cloud.rwx.com/leaves

Example

tasks:
  - key: greeting
    call: mint/greeting 1.0.3
    with:
      name: world

The logs for this task will contain:

hello world!

Semantic Versioning

When calling a leaf, you must specify a version number.

You can only specify an exact version, you cannot specify a range or use any sort of semver notation.

Mint enforces semver. Leaves cannot add a required parameter or remove an available parameter without updating the major version number.

Bumping Leaf Versions

You can use the Mint CLI to update leaves to the latest version. Run:

mint leaves update

The CLI will print the list of leaves that it updated:

Updated the following leaves:
        mint/git-clone 1.1.7 -> mint/git-clone 1.1.9
        mint/install-node 1.0.5 -> mint/install-node 1.0.6

By default, the CLI will only apply minor version updates.

To check for major version updates, run:

mint leaves update --allow-major-version-change

The CLI looks for any files matching .mint/*.yml or .mint/*.yaml. You can also specify a file if you only want to update a single file. See mint leaves update --help for all configuration options.

Development

Currently, only RWX can develop leaves. Support for third-party leaves will be enabled in the future.

Available Leaves

See all available leaves at https://cloud.rwx.com/leaves