Automatically generate change log from your tags, issues, labels and pull requests on GitHub.

Go to file

Petr Korolev 95bdd60c34 Merge branch 'new-features'		2014-11-12 11:06:01 +02:00
bin	make it executable + man fix	2014-11-06 18:59:06 +02:00
lib	Fix bug with auto-detect project name, when there is dot signs in project name	2014-11-12 11:05:03 +02:00
.gitignore	add changelog in lib to gitignore	2014-11-10 14:44:19 +02:00
bump_gemfile.rb	typo fix	2014-11-10 14:39:31 +02:00
CHANGELOG.md	update changelog	2014-11-10 17:06:40 +02:00
Gemfile	add gemfiles	2014-11-06 15:18:07 +02:00
Gemfile.lock	add gemfiles	2014-11-06 15:18:07 +02:00
github_changelog_generator.gemspec	Update to version 1.1.1	2014-11-10 17:04:02 +02:00
README.md	update	2014-11-11 11:00:34 +02:00

README.md

GitHub Changelog Generator

Changelog generation has never been so easy.

This script automatically generate change-log from your tags and merged pull-requests.

Installation:

[sudo] gem install github_changelog_generator

Usage

It's really simple:

cd to your Project folder with configured git and just type:
```
  github_changelog_generator
```

from anywhere:

  github_changelog_generator -u github-username -p github-project

As output you will get CHANGELOG.md file with pretty Markdown-formatted changelog.

Params:

Type github_changelog_generator --help for detailed usage.

Usage: changelog_generator [options]
-u, --user [USER]                Username of the owner of target GitHub repo
-p, --project [PROJECT]          Name of project on GitHub
-t, --token [TOKEN]              To make more than 50 requests this script required your OAuth token for GitHub. You can generate it on https://github.com/settings/applications
-h, --help                       Displays Help
-v, --[no-]verbose               Run verbosely. Default is true
    --[no-]issues                Include closed issues to changelog. Default is true
    --[no-]issues-without-labels Include closed issues without any labels to changelog. Default is true
    --[no-]pull-requests         Include pull-requests to changelog. Default is true
-l, --last-changes               Generate log between last 2 tags only
-f, --date-format [FORMAT]       Date format. Default is %d/%m/%y
-o, --output [NAME]              Output file. Default is CHANGELOG.md
    --labels  x,y,z              List of labels. Issues with that labels will be included to changelog. Default is 'bug,enhancement'

Examples:

Look at changelog for CHANGELOG.md for this project
This changelog: ActionSheetPicker-3.0/CHANGELOG.md was generated by command:
```
  github_changelog_generator -u skywinder -p ActionSheetPicker-3.0
```

FAQ:

Since GitHub allow to make only 50 requests without authentication it's recommended to run this scrip with key -t [your-16-digit-token] that you can easily generate it here.

So, if you got error like this:

! /Library/Ruby/Gems/2.0.0/gems/github_api-0.12.2/lib/github_api/response/raise_error.rb:14:in `on_complete'

It's time to create this token or wait for 1 hour before GitHub reset the counter for your IP.

Am I missed some essential feature?

Nothing is impossible! Open an issue and let's get this generator better together!

Bug reports, feature requests, patches, well-wishes are always welcome!

Contributing

Create an issue to discuss about your idea
[Fork it] (https://github.com/skywinder/Github-Changelog-Generator/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

License

Github Changelog Generator is released under the MIT License.