Skip to content
terminal

GitHub Action

Run Dunamai

v1.3.0 Latest version

Run Dunamai

terminal

Run Dunamai

Use Dunamai to determine a dynamic version from your VCS tags. This requires access to Python in the workflow.

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Run Dunamai

uses: mtkennerly/dunamai-action@v1.3.0

Learn more about this action in mtkennerly/dunamai-action

Choose a version

GitHub Action for Dunamai

This repository provides a GitHub Action that uses Dunamai to determine a dynamic version from your VCS tags.

This requires access to Python in the workflow.

Inputs

  • install (optional, default: "latest"): Version of Dunamai to install (e.g., "1.3.0"). Use the default if you don't need a specific version, or use "none" if your workflow installs Dunamai by other means.
  • env-var (optional, default: ""): Name of environment variable in which to set the dynamic version. If this is empty, no environment variable will be set.
  • command (optional, default: "dunamai from any"): Command to run Dunamai.
  • args (optional, default: ""): Additional arguments to pass to the command.

Outputs

  • version: The dynamic version.

Example

jobs:
  example:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/setup-python@v4
        with:
          python-version: '3.7'
      - uses: actions/checkout@v3
        with:
          # This is necessary so that we have the tags.
          fetch-depth: 0
      - uses: mtkennerly/dunamai-action@v1
        with:
          env-var: MY_VERSION
          args: --style semver
      - run: echo $MY_VERSION