Changelog Reader

A GitHub action to read and get data from the CHANGELOG.md file 🚀

This action only works if your CHANGELOG.md file follows the Keep a Changelog standard for now.

Usage

Pre-requisites

Create a workflow .yml file in your repositories .github/workflows directory. An example workflow is available below. For more information, reference the GitHub Help Documentation for Creating a workflow file.

Inputs

• path: The path the action can find the CHANGELOG. Optional. Defaults to ./CHANGELOG.md.
• validation_depth: Specifies how many entries to validate in the CHANGELOG.md file. Defaults to 0.
• version: The exact version of the log entry you want to retreive or "Unreleased" for the unreleased entry. Optional. Defaults to the last version number.

Outputs

• version: Version of the log entry found. Ex: 2.0.0.
• date: Release date of the log entry found. Ex: 2020-08-22.
• status: Status of the log entry found (prereleased, released, unreleased, or yanked).
• changes: Description text of the log entry found.

Validation

Each version in the changelog is subject to validation to enforce Semantic Versioning 2.0.0 standards as well as Keep a Changelog standards and formatting. You can utilize the validation_depth input param to specify how many entries to validate. Setting the validation_depth property to 0 will disable all validation.

Example workflow - create a release from changelog

On every push to a tag matching the pattern v*, create a release using the CHANGELOG.md content. This Workflow example assumes you'll use the @actions/create-release Action to create the release step:

on:
  push:
    # Sequence of patterns matched against refs/tags
    tags:
    - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10

name: Create Release

jobs:
  build:
    name: Create Release
    runs-on: ubuntu-latest
    steps:
      - name: Get version from tag
        id: tag_name
        run: |
          echo ::set-output name=current_version::${GITHUB_REF#refs/tags/v}
        shell: bash
      - name: Checkout code
        uses: actions/checkout@v2
      - name: Get Changelog Entry
        id: changelog_reader
        uses: mindsers/changelog-reader-action@v2
        with:
          validation_depth: 10
          version: ${{ steps.tag_name.outputs.current_version }}
          path: ./CHANGELOG.md
      - name: Create/update release
        uses: ncipollo/release-action@v1
        with:
          # This pulls from the "Get Changelog Entry" step above, referencing it's ID to get its outputs object.
          # See this blog post for more info: https://jasonet.co/posts/new-features-of-github-actions/#passing-data-to-future-steps
          tag: ${{ steps.changelog_reader.outputs.version }}
          name: Release ${{ steps.changelog_reader.outputs.version }}
          body: ${{ steps.changelog_reader.outputs.changes }}
          prerelease: ${{ steps.changelog_reader.outputs.status == 'prereleased' }}
          draft: ${{ steps.changelog_reader.outputs.status == 'unreleased' }}
          allowUpdates: true
          token: ${{ secrets.GITHUB_TOKEN }}

Contribution

Contributions to the source code of Changelog Reader Action are welcomed and greatly appreciated. For help on how to contribute in this project, please refer to How to contribute to Changelog Reader Action.

To see the project's list of awesome contributors, please refer to our Contributors Wall.

Support

Changelog Reader Action is licensed under an MIT license, which means that it's a completely free open source software. Unfortunately, Changelog Reader Action doesn't make itself. Version 2.0.0 is the next step, which will result in many late, beer-filled nights of development.

If you're using Changelog Reader Action and want to support the development, you now have the chance! Go on my GitHub Sponsor page and become my joyful sponsor!!

For more help on how to support Changelog Reader Action, please refer to The awesome people who support Changelog Reader Action.

License

The scripts and documentation in this project are released under the MIT License