git-cliff-action/README.md

git-cliff action

This action generates a changelog based on your Git history using git-cliff on the fly!

Usage

Input variables

• config: Path of the configuration file. (Default: "cliff.toml")
• args: Arguments to pass to git-cliff. (Default: "-v")

Output variables

• changelog: Output file that contains the generated changelog.

Environment variables

• OUTPUT: Output file. (Default: "git-cliff/CHANGELOG.md")

Examples

The following example fetches the whole Git history (fetch-depth: 0), generates a changelog in ./CHANGELOG.md, and prints it out.

- name: Checkout
  uses: actions/checkout@v2
  with:
    fetch-depth: 0

- name: Generate a changelog
  uses: orhun/git-cliff-action@v1
  id: git-cliff
  with:
    config: cliff.toml
    args: --verbose
  env:
    OUTPUT: CHANGELOG.md

- name: Print the changelog
  run: cat "${{ steps.git-cliff.outputs.changelog }}"

Credits

This action is based on lycheeverse/lychee-action and uses git-cliff.

License

GNU General Public License (v3.0)

Copyright

Copyright © 2021, Orhun Parmaksız