https://github.com/marvinhagemeister/changelogged

Quickly generate a list of merged PRs in the given git range
https://github.com/marvinhagemeister/changelogged

changelog nodejs

Last synced: about 2 months ago
JSON representation

Quickly generate a list of merged PRs in the given git range

• Host: GitHub
• URL: https://github.com/marvinhagemeister/changelogged
• Owner: marvinhagemeister
• License: mit
• Created: 2019-04-03T22:21:17.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-03-09T11:01:19.000Z (over 3 years ago)
• Last Synced: 2024-04-23T20:20:16.870Z (5 months ago)
• Topics: changelog, nodejs
• Language: TypeScript
• Homepage:
• Size: 79.1 KB
• Stars: 86
• Watchers: 4
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-list - changelogged

README

        
# Changelogged

This is a simple module to autogenerate a list of merged PRs in a given commit range. After trying out various existing CLI tools or Web-Apps I didn't find one that worked or matched the formatting style that we use for [Preact](https://github.com/developit/preact/). It's something that I quickly hacked together to make my life easier when creating the release notes.

People kept asking me what tool I use, so I spent 2 evenings adding proper error handling and converting it into a proper module. It's by no means perfect and doesn't support advanced features or anything, but it does the job for me. I mainly published it because it may prove to be useful for other OSS peers. I'm open to accept PRs though, if somebody wants to add that.

_Note: It's limited to 100 possible entries in a range and you need a valid [GitHub API token](https://developer.github.com/v4/guides/forming-calls/#authenticating-with-graphql) to be able to use this module._

## Usage

```bash

npm install -g changelogged

# or via yarn

yarn add -g changelogged

```

Then `cd` in your git repository and run `changelogged ..HEAD`. Enter your GitHub Token et voilà!

Example output:

```bash

GitHub: developit/preact

PRs: 3

- move JSX namespace into preact one (#1448, thanks @just-boris)

- Remove unused component import (#1508, thanks @marvinhagemeister)

- (fix) - debug message should not throw for undefined and null (#1505, thanks @JoviDeCroock)

```

Full cli args:

```bash

🔍 Autogenerate a Changelog based on merged PRs

Usage:

  $ changelogged [options] 

Options:

  --format, -f    Format changelog entry. The following special characters

                  will be replaced:

                  %n = PR number

                  %m = Commit message (1st line)

                  %a = PR author

                  The default is: '- %m (#%n, thanks @%a)'

  --help, -h      Show usage information and the options listed here

  --version, -v   Show version information

Examples:

  Get all PRs made starting from a git tag

  $ changelogged v1.2.0..HEAD

  Get all PRs since commit "abc"

  $ changelogged abc..HEAD

  Format output:

  $ changelogged --format='PR: %n, msg: %m, author: %a' v1..HEAD

```

## License

`MIT`, see [the license file](./LICENSE.md).