github-changelog-generator

command module
Version: v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 22, 2019 License: Apache-2.0 Imports: 4 Imported by: 0

README

GHCL – GitHub ChangeLog Generator

Build Status

A changelog generator for GitHub.

The generator works by,

  • Fetching the time of your repository's most recent release,
  • Fetching all pull requests merged after the time of your most recent release,
  • Outputting a summary of those pull requests.
Installation

github-changelog-generator must be installed from source. Before doing this, you'll need Go 1.11 or later. To install, run go get -u github.com/digitalocean/github-changelog-generator. A github-changelog-generator binary will then be available under your $GOBIN directory.

Usage
Usage of github-changelog-generator
  -org string
    	organization (required)
  -repo string
    	repository (required)
  -token string
    	GitHub token (default env GITHUB_TOKEN)
  -url string
    	alternative GitHub API URL, must be a fully qualified URL with a trailing slash (optional)

The output is in the format - #<pull request number> - @<github username> - <pull request title>. An example of the output is shown below.

- #3 - @some_contributor - update contibuting file
- #2 - @myteammate - update README.md
- #1 - @me - First PR

If there haven't been any changes to the repository since the latest release, the changelog generator will not show any output.

Testing

Some tests use the network to test against real data. To avoid running these with the rest of the suite, use go test -short ./.... See CONTRIBUTING.md for more information.

License

GitHub changelog generator is Apache-2.0 licensed.

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

Directories

Path Synopsis
Package ghcl provides functionality for generating a changelog entry from GitHub.
Package ghcl provides functionality for generating a changelog entry from GitHub.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL