Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lerna/lerna-changelog
:book: PR-based changelog generator with monorepo support
https://github.com/lerna/lerna-changelog
changelog changelog-generator github hacktoberfest lerna lerna-changelog monorepo
Last synced: 6 days ago
JSON representation
:book: PR-based changelog generator with monorepo support
- Host: GitHub
- URL: https://github.com/lerna/lerna-changelog
- Owner: lerna
- License: mit
- Created: 2016-05-24T19:41:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T14:22:24.000Z (6 days ago)
- Last Synced: 2024-10-29T17:32:41.406Z (6 days ago)
- Topics: changelog, changelog-generator, github, hacktoberfest, lerna, lerna-changelog, monorepo
- Language: TypeScript
- Homepage:
- Size: 3.7 MB
- Stars: 804
- Watchers: 14
- Forks: 100
- Open Issues: 73
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-f2e-libs - **lerna-changelog** - 为 lerna 项目自动生成 changelog。 (工程 / redux 扩展)
- awesome-fe - **lerna-changelog** - 为 lerna 项目自动生成 changelog。 (工程 / macros)
README
lerna-changelog
==============================================================================
[![TravisCI Build Status][travis-badge]][travis-badge-url]
[![Latest NPM release][npm-badge]][npm-badge-url]
[npm-badge]: https://img.shields.io/npm/v/lerna-changelog.svg
[npm-badge-url]: https://www.npmjs.com/package/lerna-changelog
[travis-badge]: https://img.shields.io/travis/lerna/lerna-changelog/master.svg
[travis-badge-url]: https://travis-ci.org/lerna/lerna-changelog
PR-based changelog generator with monorepo support
Usage
------------------------------------------------------------------------------
```bash
npx lerna-changelog
```
```md
## Unreleased (2018-05-24)
#### :bug: Bug Fix
* [#198](https://github.com/my-org/my-repo/pull/198) Avoid an infinite loop ([@helpful-hacker](https://github.com/helpful-hacker))
#### :house: Internal
* [#183](https://github.com/my-org/my-repo/pull/183) Standardize error messages ([@careful-coder](https://github.com/careful-coder))
#### Commiters: 2
- Helpful Hacker ([@helpful-hacker](https://github.com/helpful-hacker))
- [@careful-coder](https://github.com/careful-coder)
```
By default `lerna-changelog` will show all pull requests that have been merged
since the latest tagged commit in the repository. That is however only true for
pull requests with certain labels applied. The labels that are supported by
default are:
- `breaking` (:boom: Breaking Change)
- `enhancement` (:rocket: Enhancement)
- `bug` (:bug: Bug Fix)
- `documentation` (:memo: Documentation)
- `internal` (:house: Internal)
You can also use the `--from` and `--to` options to view a different
range of pull requests:
```bash
npx lerna-changelog --from=v1.0.0 --to=v2.0.0
```
### Monorepo support
If you have a packages folder and your projects in subfolders of that folder `lerna-changelog` will detect it and include the package names in the changelog for the relevant changes.
### GitHub Token
Since `lerna-changelog` interacts with the GitHub API you may run into rate
limiting issues which can be resolved by supplying a "personal access token":
```
export GITHUB_AUTH="..."
```
You'll need a [personal access token](https://github.com/settings/tokens)
for the GitHub API with the `repo` scope for private repositories or just
`public_repo` scope for public repositories.
Configuration
------------------------------------------------------------------------------
You can configure `lerna-changelog` in various ways. The easiest way is by
adding a `changelog` key to the `package.json` file of your project:
```json5
{
// ...
"changelog": {
"labels": {
"feature": "New Feature",
"bug": "Bug Fix"
}
}
}
```
The supported options are:
- `repo`: Your "org/repo" on GitHub
(automatically inferred from the `package.json` file)
- `nextVersion`: Title for unreleased commits
(e.g. `Unreleased`)
- `labels`: GitHub PR labels mapped to changelog section headers
- `ignoreCommitters`: List of committers to ignore (exact or partial match).
Useful for example to ignore commits from bots.
- `cacheDir`: Path to a GitHub API response cache to avoid throttling
(e.g. `.changelog`)
License
------------------------------------------------------------------------------
`lerna-changelog` is released under the [MIT License](LICENSE).