KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #cli #desktop-app #typescript #rust #ai-agent

auto-generate-changelog

★ 93 Open GitHub ↗

A Github Action to generate CHANGELOG automatically according to conventional commits. Feel free to contribute!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# auto-generate-changelog

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/47a06388ecd34ff5a1d623827d9bb659)](https://www.codacy.com/manual/bobankhshen/auto-generate-changelog/dashboard?utm_source=github.com&utm_medium=referral&utm_content=BobAnkh/auto-generate-changelog&utm_campaign=Badge_Grade)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/BobAnkh/auto-generate-changelog?color=orange&logo=github-actions)
![language-python](https://img.shields.io/github/languages/top/BobAnkh/auto-generate-changelog?logo=python&logoColor=yellow)
![LICENSE Apache-2.0](https://img.shields.io/github/license/BobAnkh/auto-generate-changelog?logo=apache)

A Github Action to generate CHANGELOG automatically according to conventional commits.

Feel free to submit a pull request or an issue, but make sure to follow the templates.

Welcome contributors to improve this project together!

**If you like this, please give me a star**!

## Usage

Create a workflow file such as [`.github/workflows/changelog.yml`](./.github/workflows/changelog.yml) (you can find it in this repo)

```yaml
name: Generate changelog
on:
  release:
    types: [created, edited]

jobs:
 generate-changelog:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v4
 with:
 fetch-depth: 0
 - uses: BobAnkh/auto-generate-changelog@v1.3.1
 with:
 REPO_NAME: "<YourUserName>/<YourRepoName>"
 ACCESS_TOKEN: ${{secrets.GITHUB_TOKEN}}
 PATH: "CHANGELOG.md"
 COMMIT_MESSAGE: "docs(CHANGELOG): update release notes"
 TYPE: "feat:Feature,fix:Bug Fixes,docs:Documentation,refactor:Refactor,perf:Performance Improvements"
```

> NOTE: Generating CHANGELOG needs all the commit history so you should set `fetch-depth: 0` with `actions/checkout`
>
> NOTE: commit log begins with `docs(changelog)` or `doc(CHANGELOG)` will not be added to the CHANGELOG

### Inputs

**Please see NOTES below the table for how to set some of the parameters**.

| Inputs                     | Description                                                             | Required | Default                                           |
| -------------------------- | ----------------------------------------------------------------------- | -------- | ------------------------------------------------- |
| REPO_NAME                  | Repository name                                                         | no       | `''` which means current repository               |
| ACCESS_TOKEN               | Github Access Token. See **NOTES 1**                                    | yes      | You can just pass `${{secrets.GITHUB_TOKEN}}`     |
| PATH                       | Path to the your file                                                   | no       | `CHANGELOG.md`                                    |
| BRANCH                     | The branch to update file specified in PATH                             | no       | `''` which means default branch                   |
| PULL_REQUEST               | Open a new pull request if set to a target branch name. See **NOTES 2** | no       | `''` which means not open pull request by default |
| COMMIT_MESSAGE             | Commit message                                                          | no       | `docs(CHANGELOG): update release notes`           |
| TYPE                       | The type of commits you want to add to CHANGELOG. See **NOTES 3**       | no       | `'feat:Feature,fix:Fix'`                          |
| COMMITTER                  | The committer you want to use to update file. See **NOTES 4**           | no       | `''` which means default committer                |
| DEFAULT_SCOPE              | The default scope to hold all unscoped commits                          | no       | `general`                                         |
| SUPPRESS_UNSCOPED          | Whether to exclude unscoped commits                                     | no       | false                                             |
| UNRELEASED_COMMITS         | Whether to include unreleased commits in the changelog                  | no       | false                                             |
| REGENERATE_COUNT           | Regenerate n recent releases' changelog. See **NOTES 5**                | no       | 0                                                 |
| REPLACE_EMPTY_RELEASE_INFO | Replace empty release info with some words                              | no       | false                                             |

**NOTES 1**: `${{secrets.GITHUB_TOKEN}}` has a [rate limit](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting) smaller than Personal Access Token (PAT), so if you have much more requests(commits, prs, etc.) or face a 403 rate-limit-error, use PAT instead.

**NOTES 2**: `PULL_REQUEST` must be used with `BRANCH` together, both **should be provided** with a valid branch name if you want to **open a pull request**. The GA will open a pull request from the `BRANCH` (head branch) to the `PULL_REQUEST` (base branch). Leave `PULL_REQUEST` blank if you don't want to open a pull request.

**NOTES 3**: You can define the keyword detected from commit message and the corresponding word presented in the changelog in input `TYPE`. For example, define `feat:Feature,fix:Bug Fixes` will have commit messages like `feat(main): add new option` to be presented in changelog under part `Feature` and have commit messages like `fix(server): adjust rendering` to be presented in changelog under part `Bug Fixes`.

**NOTES 4**: `COMMITTER` should be in the format: `'author <author@email>'`

**NOTES 5**: All the releases not exist in the changelog will of course be added to the changelog. Use this parameter to regenerate the last n releases' changelog. Default set to 0 means only generate for new releases. You can set to -1 to regenerate all the releases.

**NOTES 6**: You can use the format below to avoid some lines in release description to appear in the CHANGELOG:

> ```markdown
> 
>
> See CHANGELOG for more details. This line will be hided when changelog is generated.
>
> 
> ```

## Maintainer

[@BobAnkh](https://github.com/BobAnkh)

## How to contribute

You should follow our [Code of Conduct](/CODE_OF_CONDUCT.md).

See [CONTRIBUTING GUIDELINES](/CONTRIBUTING.md) for contributing conventions.

Make sure to pass all the tests before submitting your code. You can conduct `pytest -ra` at the root directory to run all tests.

You can use local mode when develope it on your local machine, here is the command-line help info:

```console
usage: main.py [-h] [-m MODE] [-f FILE] [-o OUTPUT] [-t TOKEN]

optional arguments:
  -h, --help            show this help message and exit
  -m MODE, --mode MODE  choose to use local-dev mode or on github action mode.
                        Valid values are 'local' or 'github'
  -f FILE, --file FILE  configuration file to read from when running local-dev
                        mode
  -o OUTPUT, --output OUTPUT
                        output file when running local-dev mode
  -t TOKEN, --token TOKEN
                        Github Access Token
```

### Contributors

<table>
<tr>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/BobAnkh>
 <img src=https://avatars.githubusercontent.com/u/44333669?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Yixin Shen/>
 
 Yixin Shen
 </a>
 </td>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/joundso>
 <img src=https://avatars.githubusercontent.com/u/56686638?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Jonathan Mang/>
 
 Jonathan Mang
 </a>
 </td>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/sruehl>
 <img src=https://avatars.githubusercontent.com/u/1769155?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Sebastian Rühl/>
 
 Sebastian Rühl
 </a>
 </td>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/ok-coder1>
 <img src=https://avatars.githubusercontent.com/u/106904247?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=okcoder1/>
 
 okcoder1
 </a>
 </td>
</tr>
</table>

## LICENSE

auto-generate-changelog

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README