https://github.com/uphold/github-changelog-generator
Generate changelog files from the project's GitHub PRs
https://github.com/uphold/github-changelog-generator
Last synced: 6 months ago
JSON representation
Generate changelog files from the project's GitHub PRs
- Host: GitHub
- URL: https://github.com/uphold/github-changelog-generator
- Owner: uphold
- License: mit
- Created: 2016-11-24T14:32:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-03T14:16:46.000Z (over 1 year ago)
- Last Synced: 2024-11-04T05:35:38.557Z (7 months ago)
- Language: JavaScript
- Homepage:
- Size: 422 KB
- Stars: 14
- Watchers: 66
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# github-changelog-generator
Generate changelog files from the project's GitHub PRs.
## Usage
Generate a new [GitHub Personal Access Token](https://github.com/settings/tokens) and save it to your `.zshrc.local`, `.bashrc.local` or similar:
```sh
export GITHUB_TOKEN=
```
To see a list of available options, run the following command:
```sh
$ github-changelog-generator --help
Usage: github-changelog-generator [options]
Run GitHub changelog generator.
Options:
-h, --help output usage information
-b, --base-branch [optional] specify the base branch name - master by default
-f, --future-release [optional] specify the next release version
-t, --future-release-tag [optional] specify the next release tag name if it is different from the release version
-rtp, --release-tag-prefix [optional] release tag prefix to consider when finding the latest release, useful for monorepos
-cfp, --changed-files-prefix [optional] changed files prefix to consider when finding pull-requests, useful for monorepos
-l, --labels [optional] labels to filter pull requests by
-o, --owner [optional] owner of the repository
-r, --repo [optional] name of the repository
--rebuild rebuild the full changelog
```
To generate a changelog for your GitHub project, use the following command:
```sh
$ echo "$(github-changelog-generator --base-branch= --future-release= --future-release-tag= --owner= --repo=)\n$(tail -n +2 )" >
```
The `--base-branch` option allows you to filter the PRs by base branch. If omitted, it will default to branch master.
Example:
```sh
$ echo "$(github-changelog-generator --base-branch=production)\n$(tail -n +2 CHANGELOG.md)" > CHANGELOG.md
```
The `--future-release` and `--future-release-tag` options are optional. If your future release tag name is the same as your future release version number, then you can skip `--future-release-tag`.
Example:
```sh
$ echo "$(github-changelog-generator --future-release=1.2.3 --future-release-tag=v1.2.3)\n$(tail -n +2 CHANGELOG.md)" > CHANGELOG.md
```
If you are on a mono-repository, you will need to use `--release-tag-prefix` in order to filter release tags of the package you are targeting. There's also the `--changed-files-prefix` option that may be used to specify the base directory of the package. However, this should be automatic in most cases, except when we are unable to infer the root folder.
Example:
```sh
$ echo "$(github-changelog-generator [email protected] [email protected] --release-tag-prefix=my-package@v)\n$(tail -n +2 CHANGELOG.md)" > CHANGELOG.md
```
The `--owner` and `--repo` options allow you to specify the owner and name of the GitHub repository, respectively. If omitted, they will default to the values found in the project's git config.
Example:
```sh
$ echo "$(github-changelog-generator --owner=uphold --repo=github-changelog-generator)\n$(tail -n +2 CHANGELOG.md)" > CHANGELOG.md
```
The `--labels` option allows you to filter what pull requests are used by their labels. This is useful for repositories with more than one project, by labeling each pull request by what project they belong to, generating a changelog for each project becomes as simple as:
Example:
```sh
$ echo "$(github-changelog-generator --labels projectX,general)\n$(tail -n +2 CHANGELOG.md)" > CHANGELOG.md
```
The `--rebuild` option allows you to fetch the repository's full changelog history.
Starting on major version 2, the default behavior for the generator is to only create the changelog for the pull requests that come after the latest release,
so this option allows for backwards compatibility.
Example:
```sh
$ github-changelog-generator --rebuild > CHANGELOG.md
```
## Release
```sh
yarn release [ | major | minor | patch]
```