Generate release notes from recent pull requests
npm install release-notes!npm
Generate markdown from all of the PRs that have been closed since your last release!
Originally used to generate notes for zapier-platform-cli and its related repos.
In its simplest form, invoking this pulls the names of all of the closed PRs since the last time the given repo had a release. If passed multiple repos, it'll use the most recent release of the first as the date to filter against.
For more info, run:
> % release-notes -h
Currently, this is only set up to pull from Github. It can be expanded to use other providers if there's interest though!
If you need to access private repos, use either the -t flag or set your GITHUB_API_TOKEN before invoking the CLI.
In addition to a CLI, this package exports two functions for use javascript:
The main method, this does calls to the github API and returns an object with a list of closed PRs grouped by repo name.
Takes the above object of PRs and returns a nicely formatted markdown file. This is separate so if you want to build/parse the output yourself, it's easy to do.
It accepts an object with the following keys as the second parameter (all of which are optional):
| Key | Type | Description |
| --------- | ---------- | --------------------------------------------------------------------------------- |
| keepOrg | boolean | if true, list the repo as false |
| order | string[] | print the repos in this order (which can be different than the supplied order) |
| version | string | pre-fills the version number. Prints MAJOR.MINOR.PATCH if missing |