Merge branch 'release/1.3.11'

Update README.md

.gitignore

@@ -1 +0,0 @@
-/lib/CHANGELOG.md

CHANGELOG.md

@@ -1,81 +1,305 @@
-# Changelog
+# Change Log
 
-## [1.2.2] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.2)
-#### 10/12/14
-- *Merged pull-request:* Add a Bitdeli Badge to README [\#36](https://github.com/skywinder/Github-Changelog-Generator/pull/36) ([bitdeli-chef](https://github.com/bitdeli-chef))
+## [1.3.10](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.10) (2015-03-18)
 
-## [1.2.1] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.1)
-#### 22/11/14
-- *Merged pull-request:* Issues for last tag not in list [\#29](https://github.com/skywinder/Github-Changelog-Generator/pull/29) ([skywinder](https://github.com/skywinder))
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.9...1.3.10)
 
-- *Merged pull-request:* Disable default --filter-pull-requests option. [\#28](https://github.com/skywinder/Github-Changelog-Generator/pull/28) ([skywinder](https://github.com/skywinder))
+**Fixed bugs:**
 
-## [1.2.0] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.0)
-#### 19/11/14
-- *Merged pull-request:* Add filter for pull-requests labels. \(option --filter-pull-requests\) [\#27](https://github.com/skywinder/Github-Changelog-Generator/pull/27) ([skywinder](https://github.com/skywinder))
+- Exclude closed PR's from changelog. [\#69](https://github.com/skywinder/Github-Changelog-Generator/issues/69)
 
-- *Merged pull-request:* Test Pull-Request SHOULD NOT APPEAR IN LOG! [\#26](https://github.com/skywinder/Github-Changelog-Generator/pull/26) ([skywinder](https://github.com/skywinder))
+**Merged pull requests:**
 
-- *Merged pull-request:* Add ability to insert authors of pull-requests \(--\[no-\]author option\) [\#25](https://github.com/skywinder/Github-Changelog-Generator/pull/25) ([skywinder](https://github.com/skywinder))
+- Fix termination in case of empty unreleased section with `--unreleased-only` option. [\#70](https://github.com/skywinder/Github-Changelog-Generator/pull/70) ([skywinder](https://github.com/skywinder))
 
-- *Merged pull-request:* Don't receive issues in case of --no-isses flag specied [\#24](https://github.com/skywinder/Github-Changelog-Generator/pull/24) ([skywinder](https://github.com/skywinder))
+## [1.3.9](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.9) (2015-03-06)
 
-## [1.1.4] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.4)
-#### 18/11/14
-- *Merged pull-request:* Sort tags by date [\#23](https://github.com/skywinder/Github-Changelog-Generator/pull/23) ([skywinder](https://github.com/skywinder))
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.8...1.3.9)
 
-- *Implemented enhancement:* Implement ability to retrieve GitHub token from ENV variable \(to not put it to script directly\) [\#19](https://github.com/skywinder/Github-Changelog-Generator/issues/19)
+**Implemented enhancements:**
 
-- *Fixed bug:* Script fills changelog only for first 30 tags. [\#20](https://github.com/skywinder/Github-Changelog-Generator/issues/20)
+- Improve method of detecting owner and repository [\#63](https://github.com/skywinder/Github-Changelog-Generator/issues/63)
 
-## [1.1.2] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.2)
-#### 12/11/14
-- *Merged pull-request:* Fix bug with dot signs in project name [\#18](https://github.com/skywinder/Github-Changelog-Generator/pull/18) ([skywinder](https://github.com/skywinder))
+**Merged pull requests:**
 
-- *Merged pull-request:* Fix bug with dot signs in user name [\#17](https://github.com/skywinder/Github-Changelog-Generator/pull/17) ([skywinder](https://github.com/skywinder))
+- Resolved concurrency problem in case of issues \> 2048 [\#65](https://github.com/skywinder/Github-Changelog-Generator/pull/65) ([skywinder](https://github.com/skywinder))
 
-## [1.1.1] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.1)
-#### 10/11/14
-- *Merged pull-request:* Remove duplicates of issues and pull-requests with same number [\#15](https://github.com/skywinder/Github-Changelog-Generator/pull/15) ([skywinder](https://github.com/skywinder))
+## [1.3.8](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.8) (2015-03-05)
 
-- *Merged pull-request:* Sort issues by tags [\#14](https://github.com/skywinder/Github-Changelog-Generator/pull/14) ([skywinder](https://github.com/skywinder))
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.6...1.3.8)
 
-- *Merged pull-request:* Add ability to add or exclude issues without any labels [\#13](https://github.com/skywinder/Github-Changelog-Generator/pull/13) ([skywinder](https://github.com/skywinder))
+**Merged pull requests:**
 
-## [1.1.0] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.0)
-#### 10/11/14
-- *Implemented enhancement:* Detect username and project form origin [\#11](https://github.com/skywinder/Github-Changelog-Generator/issues/11)
+- Fix `git remote` parsing in case, when script running without parameters inside destination directory [\#61](https://github.com/skywinder/Github-Changelog-Generator/pull/61) ([skywinder](https://github.com/skywinder))
 
-- *Fixed bug:* Markdown formating in the last line wrong [\#9](https://github.com/skywinder/Github-Changelog-Generator/issues/9)
+## [1.3.6](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.6) (2015-03-05)
 
-- *Fixed bug:* Bug with wrong credentials in 1.0.1 [\#12](https://github.com/skywinder/Github-Changelog-Generator/issues/12)
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.5...1.3.6)
 
-## [1.0.1] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.0.1)
-#### 10/11/14
-- *Merged pull-request:* Implement support of different tags. [\#8](https://github.com/skywinder/Github-Changelog-Generator/pull/8) ([skywinder](https://github.com/skywinder))
+## [1.3.5](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.5) (2015-03-04)
 
-## [1.0.0] (https://github.com/skywinder/Github-Changelog-Generator/tree/1.0.0)
-#### 07/11/14
-- *Merged pull-request:* Add support for issues in CHANGELOG [\#7](https://github.com/skywinder/Github-Changelog-Generator/pull/7) ([skywinder](https://github.com/skywinder))
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.4...1.3.5)
 
-- *Merged pull-request:* Fix parsing date of pull request [\#3](https://github.com/skywinder/Github-Changelog-Generator/pull/3) ([skywinder](https://github.com/skywinder))
+**Fixed bugs:**
 
-- *Implemented enhancement:* Implement option to specify output filename [\#4](https://github.com/skywinder/Github-Changelog-Generator/issues/4)
+- Pull Requests in Wrong Tag [\#60](https://github.com/skywinder/Github-Changelog-Generator/issues/60)
 
-- *Implemented enhancement:* Add support for fixed issues and implemented enchanments. [\#6](https://github.com/skywinder/Github-Changelog-Generator/issues/6)
+## [1.3.4](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.4) (2015-03-03)
 
-- *Fixed bug:* Last tag not appeared in changelog [\#5](https://github.com/skywinder/Github-Changelog-Generator/issues/5)
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.3...1.3.4)
 
-## [0.1.0] (https://github.com/skywinder/Github-Changelog-Generator/tree/0.1.0)
-#### 07/11/14
-- *Merged pull-request:* Add changelog generation for last tag [\#2](https://github.com/skywinder/Github-Changelog-Generator/pull/2) ([skywinder](https://github.com/skywinder))
+**Fixed bugs:**
 
-- *Merged pull-request:* Add option \(-o --output\) to specify name of the output file. [\#1](https://github.com/skywinder/Github-Changelog-Generator/pull/1) ([skywinder](https://github.com/skywinder))
+- --no-issues appears to break PRs [\#59](https://github.com/skywinder/Github-Changelog-Generator/issues/59)
 
-## [0.0.2] (https://github.com/skywinder/Github-Changelog-Generator/tree/0.0.2)
-#### 06/11/14
-## [0.0.1] (https://github.com/skywinder/Github-Changelog-Generator/tree/0.0.1)
-#### 06/11/14
+## [1.3.3](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.3) (2015-03-03)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.2...1.3.3)
+
+**Closed issues:**
+
+- Add \# character to encapsulate list. [\#58](https://github.com/skywinder/Github-Changelog-Generator/issues/58)
+
+## [1.3.2](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.2) (2015-03-03)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.1...1.3.2)
+
+**Fixed bugs:**
+
+- generation failed if github commit api return `404 Not Found` [\#57](https://github.com/skywinder/Github-Changelog-Generator/issues/57)
+
+## [1.3.1](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.1) (2015-02-27)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.3.0...1.3.1)
+
+## [1.3.0](https://github.com/skywinder/Github-Changelog-Generator/tree/1.3.0) (2015-02-26)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.8...1.3.0)
+
+**Implemented enhancements:**
+
+- Do not show `Unreleased` section, when it's empty. [\#55](https://github.com/skywinder/Github-Changelog-Generator/issues/55)
+
+- Separate list exclude and include labels [\#52](https://github.com/skywinder/Github-Changelog-Generator/issues/52)
+
+- Unreleased issues in separate section [\#47](https://github.com/skywinder/Github-Changelog-Generator/issues/47)
+
+- Separate by lists: Enhancements, Bugs, Pull requests. [\#31](https://github.com/skywinder/Github-Changelog-Generator/issues/31)
+
+**Fixed bugs:**
+
+- Test pull request with invalid label \(\#26\) in changelog appeared. [\#44](https://github.com/skywinder/Github-Changelog-Generator/issues/44)
+
+**Merged pull requests:**
+
+- Implement filtering of Pull Requests by milestones [\#50](https://github.com/skywinder/Github-Changelog-Generator/pull/50) ([skywinder](https://github.com/skywinder))
+
+## [1.2.8](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.8) (2015-02-17)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.7...1.2.8)
+
+**Closed issues:**
+
+- Bugs, that closed simultaneously with push not appeared in correct version. [\#37](https://github.com/skywinder/Github-Changelog-Generator/issues/37)
+
+**Merged pull requests:**
+
+- Feature/fix 37 [\#49](https://github.com/skywinder/Github-Changelog-Generator/pull/49) ([skywinder](https://github.com/skywinder))
+
+- Prettify output [\#48](https://github.com/skywinder/Github-Changelog-Generator/pull/48) ([skywinder](https://github.com/skywinder))
+
+## [1.2.7](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.7) (2015-01-26)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.6...1.2.7)
+
+**Merged pull requests:**
+
+- Add compare link between older version and newer version [\#46](https://github.com/skywinder/Github-Changelog-Generator/pull/46) ([sue445](https://github.com/sue445))
+
+## [1.2.6](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.6) (2015-01-21)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.5...1.2.6)
+
+**Merged pull requests:**
+
+- fix link tag format [\#45](https://github.com/skywinder/Github-Changelog-Generator/pull/45) ([sugamasao](https://github.com/sugamasao))
+
+## [1.2.5](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.5) (2015-01-15)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.4...1.2.5)
+
+**Implemented enhancements:**
+
+- Use milestone to specify in which version bug was fixed [\#22](https://github.com/skywinder/Github-Changelog-Generator/issues/22)
+
+**Fixed bugs:**
+
+- Error when trying to generate log for repo without tags [\#32](https://github.com/skywinder/Github-Changelog-Generator/issues/32)
+
+**Merged pull requests:**
+
+- PrettyPrint class is included using lowercase 'pp' [\#43](https://github.com/skywinder/Github-Changelog-Generator/pull/43) ([schwing](https://github.com/schwing))
+
+- support enterprise github via command line options [\#42](https://github.com/skywinder/Github-Changelog-Generator/pull/42) ([glenlovett](https://github.com/glenlovett))
+
+## [1.2.4](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.4) (2014-12-16)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.3...1.2.4)
+
+**Fixed bugs:**
+
+- Sometimes user is NULL during merges [\#41](https://github.com/skywinder/Github-Changelog-Generator/issues/41)
+
+- Crash when try generate log for rails [\#35](https://github.com/skywinder/Github-Changelog-Generator/issues/35)
+
+## [1.2.3](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.3) (2014-12-16)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.2...1.2.3)
+
+**Implemented enhancements:**
+
+- Add ability to run with one parameter instead -u -p [\#38](https://github.com/skywinder/Github-Changelog-Generator/issues/38)
+
+- Detailed output [\#33](https://github.com/skywinder/Github-Changelog-Generator/issues/33)
+
+**Fixed bugs:**
+
+- Docs lacking or basic behavior not as advertised [\#30](https://github.com/skywinder/Github-Changelog-Generator/issues/30)
+
+**Merged pull requests:**
+
+- Implement async fetching [\#39](https://github.com/skywinder/Github-Changelog-Generator/pull/39) ([skywinder](https://github.com/skywinder))
+
+- Fix crash when user is NULL [\#40](https://github.com/skywinder/Github-Changelog-Generator/pull/40) ([skywinder](https://github.com/skywinder))
+
+## [1.2.2](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.2) (2014-12-10)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.1...1.2.2)
+
+**Fixed bugs:**
+
+- Encapsulate \[ \> \* \_ \ \] signs in issues names [\#34](https://github.com/skywinder/Github-Changelog-Generator/issues/34)
+
+**Merged pull requests:**
+
+- Add a Bitdeli Badge to README [\#36](https://github.com/skywinder/Github-Changelog-Generator/pull/36) ([bitdeli-chef](https://github.com/bitdeli-chef))
+
+## [1.2.1](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.1) (2014-11-22)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.0...1.2.1)
+
+**Fixed bugs:**
+
+- Script fills changelog only for first 30 tags. [\#20](https://github.com/skywinder/Github-Changelog-Generator/issues/20)
+
+**Merged pull requests:**
+
+- Issues for last tag not in list [\#29](https://github.com/skywinder/Github-Changelog-Generator/pull/29) ([skywinder](https://github.com/skywinder))
+
+- Disable default --filter-pull-requests option. [\#28](https://github.com/skywinder/Github-Changelog-Generator/pull/28) ([skywinder](https://github.com/skywinder))
+
+## [1.2.0](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.0) (2014-11-19)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.1.4...1.2.0)
+
+**Merged pull requests:**
+
+- Add filter for pull-requests labels. \(option --filter-pull-requests\) [\#27](https://github.com/skywinder/Github-Changelog-Generator/pull/27) ([skywinder](https://github.com/skywinder))
+
+- Add ability to insert authors of pull-requests \(--\[no-\]author option\) [\#25](https://github.com/skywinder/Github-Changelog-Generator/pull/25) ([skywinder](https://github.com/skywinder))
+
+- Don't receive issues in case of --no-isses flag specied [\#24](https://github.com/skywinder/Github-Changelog-Generator/pull/24) ([skywinder](https://github.com/skywinder))
+
+## [1.1.4](https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.4) (2014-11-18)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.1.2...1.1.4)
+
+**Implemented enhancements:**
+
+- Implement ability to retrieve GitHub token from ENV variable \(to not put it to script directly\) [\#19](https://github.com/skywinder/Github-Changelog-Generator/issues/19)
+
+**Merged pull requests:**
+
+- Sort tags by date [\#23](https://github.com/skywinder/Github-Changelog-Generator/pull/23) ([skywinder](https://github.com/skywinder))
+
+## [1.1.2](https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.2) (2014-11-12)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.1.1...1.1.2)
+
+**Merged pull requests:**
+
+- Fix bug with dot signs in project name [\#18](https://github.com/skywinder/Github-Changelog-Generator/pull/18) ([skywinder](https://github.com/skywinder))
+
+- Fix bug with dot signs in user name [\#17](https://github.com/skywinder/Github-Changelog-Generator/pull/17) ([skywinder](https://github.com/skywinder))
+
+## [1.1.1](https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.1) (2014-11-10)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.1.0...1.1.1)
+
+**Merged pull requests:**
+
+- Remove duplicates of issues and pull-requests with same number [\#15](https://github.com/skywinder/Github-Changelog-Generator/pull/15) ([skywinder](https://github.com/skywinder))
+
+- Sort issues by tags [\#14](https://github.com/skywinder/Github-Changelog-Generator/pull/14) ([skywinder](https://github.com/skywinder))
+
+- Add ability to add or exclude issues without any labels [\#13](https://github.com/skywinder/Github-Changelog-Generator/pull/13) ([skywinder](https://github.com/skywinder))
+
+## [1.1.0](https://github.com/skywinder/Github-Changelog-Generator/tree/1.1.0) (2014-11-10)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.0.1...1.1.0)
+
+**Implemented enhancements:**
+
+- Detect username and project form origin [\#11](https://github.com/skywinder/Github-Changelog-Generator/issues/11)
+
+**Fixed bugs:**
+
+- Bug with wrong credentials in 1.0.1 [\#12](https://github.com/skywinder/Github-Changelog-Generator/issues/12)
+
+- Markdown formating in the last line wrong [\#9](https://github.com/skywinder/Github-Changelog-Generator/issues/9)
+
+## [1.0.1](https://github.com/skywinder/Github-Changelog-Generator/tree/1.0.1) (2014-11-10)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.0.0...1.0.1)
+
+## [1.0.0](https://github.com/skywinder/Github-Changelog-Generator/tree/1.0.0) (2014-11-07)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/0.1.0...1.0.0)
+
+**Implemented enhancements:**
+
+- Add support for fixed issues and implemented enchanments. [\#6](https://github.com/skywinder/Github-Changelog-Generator/issues/6)
+
+- Implement option to specify output filename [\#4](https://github.com/skywinder/Github-Changelog-Generator/issues/4)
+
+**Fixed bugs:**
+
+- Last tag not appeared in changelog [\#5](https://github.com/skywinder/Github-Changelog-Generator/issues/5)
+
+**Merged pull requests:**
+
+- Implement support of different tags. [\#8](https://github.com/skywinder/Github-Changelog-Generator/pull/8) ([skywinder](https://github.com/skywinder))
+
+- Add support for issues in CHANGELOG [\#7](https://github.com/skywinder/Github-Changelog-Generator/pull/7) ([skywinder](https://github.com/skywinder))
+
+## [0.1.0](https://github.com/skywinder/Github-Changelog-Generator/tree/0.1.0) (2014-11-07)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/0.0.2...0.1.0)
+
+**Merged pull requests:**
+
+- Fix parsing date of pull request [\#3](https://github.com/skywinder/Github-Changelog-Generator/pull/3) ([skywinder](https://github.com/skywinder))
+
+- Add changelog generation for last tag [\#2](https://github.com/skywinder/Github-Changelog-Generator/pull/2) ([skywinder](https://github.com/skywinder))
+
+- Add option \(-o --output\) to specify name of the output file. [\#1](https://github.com/skywinder/Github-Changelog-Generator/pull/1) ([skywinder](https://github.com/skywinder))
+
+## [0.0.2](https://github.com/skywinder/Github-Changelog-Generator/tree/0.0.2) (2014-11-06)
+
+[Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/0.0.1...0.0.2)
+
+## [0.0.1](https://github.com/skywinder/Github-Changelog-Generator/tree/0.0.1) (2014-11-06)
 
 
-\* *This changelog was generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
+
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

README.md

@@ -1,54 +1,110 @@
-GitHub Changelog Generator
+[![Gem Version](https://badge.fury.io/rb/github_changelog_generator.svg)](http://badge.fury.io/rb/github_changelog_generator)
+[![Build Status](https://travis-ci.org/skywinder/github-changelog-generator.svg?branch=master)](https://travis-ci.org/skywinder/github-changelog-generator)
+
+GitHub Changelog Generator ![GitHub Logo](../master/images/logo.jpg)
 ==================
 
-[![Gem Version](https://badge.fury.io/rb/github_changelog_generator.svg)](http://badge.fury.io/rb/github_changelog_generator)
-[![Build Status](https://travis-ci.org/skywinder/Github-Changelog-Generator.svg?branch=master)](https://travis-ci.org/skywinder/Github-Changelog-Generator)
+  - [Installation](#installation)
+  - [Output example](#output-example)
+  - [Usage](#usage)
+    - [Params](#params)
+    - [GitHub token](#github-token)
+  - [Features and advantages of this project](#features-and-advantages-of-this-project)
+    - [Alternatives](#alternatives)
+    - [Projects using this library](#projects-using-this-library)
+  - [Am I missing some essential feature?](#am-i-missing-some-essential-feature)
+  - [Contributing](#contributing)
+  - [License](#license)
 
-Changelog generation has never been so easy.
  
-This script automatically generate change-log from your tags and merged pull-requests.
+### Changelog generation has never been so easy:
 
-## Installation:
-You're almost done!
+**Fully automate changelog generation** - This gem generates change log file based on **tags**, **issues** and merged **pull requests** (and splits them into separate lists according labels) from :octocat: GitHub Issue Tracker.
+
+Since now you don't have to fill your `CHANGELOG.md` manually: just run the script, relax and take a cup of :coffee: before your next release! :tada:
+
+>### *What’s the point of a change log?*
+To make it easier for users and contributors to see precisely what notable changes have been made between each release (or version) of the project.
+### *Why should I care?*
+Because software tools are for people. If you don’t care, why are you contributing to open source? Surely, there must be a kernel (ha!) of care somewhere in that lovely little brain of yours.
+
+> :copyright: *[http://keepachangelog.com](http://keepachangelog.com/)*
+
+## Installation
 
 	[sudo] gem install github_changelog_generator
 
+## Output example
+
+- Look at **[CHANGELOG.md](https://github.com/skywinder/Github-Changelog-Generator/blob/master/CHANGELOG.md)** for this project
+- [ActionSheetPicker-3.0/CHANGELOG.md](https://github.com/skywinder/ActionSheetPicker-3.0/blob/master/CHANGELOG.md)  was generated by command:
+
+		github_changelog_generator -u skywinder -p ActionSheetPicker-3.0
+
+- In general it looks like this:
+
+> ## [1.2.5](https://github.com/skywinder/Github-Changelog-Generator/tree/1.2.5) (2015-01-15)
+> 
+> [Full Changelog](https://github.com/skywinder/Github-Changelog-Generator/compare/1.2.4...1.2.5)
+> 
+> **Implemented enhancements:**
+> 
+> - Use milestone to specify in which version bug was fixed [\#22](https://github.com/skywinder/Github-Changelog-Generator/issues/22)
+> 
+> **Fixed bugs:**
+> 
+> - Error when trying to generate log for repo without tags [\#32](https://github.com/skywinder/Github-Changelog-Generator/issues/32)
+> 
+> **Merged pull requests:**
+> 
+> - PrettyPrint class is included using lowercase 'pp' [\#43](https://github.com/skywinder/Github-Changelog-Generator/pull/43) ([schwing](https://github.com/schwing))
+> 
+> - support enterprise github via command line options [\#42](https://github.com/skywinder/Github-Changelog-Generator/pull/42) ([glenlovett](https://github.com/glenlovett))
+
+
 ## Usage
 **It's really simple**: 
 
-- If your **git remote** `origin` refer to your GitHub repo, then just go to your project folder  just run:
+- If your **git remote** `origin` refers to your GitHub repo, then just go to your project folder and run:
 
 		github_changelog_generator
 
 -  or from anywhere:
+    - `github_changelog_generator -u github_username -p github_project`
+    - `github_changelog_generator  github_username/github_project`
      
-		github_changelog_generator -u github-username -p github-project
+As output you will get `CHANGELOG.md` file with pretty *Markdown-formatted* changelog.
 
-As output you will get `CHANGELOG.md` file with *pretty Markdown-formatted* changelog.
-
-### Params:
+### 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 here: https://github.com/settings/tokens/new
-        -h, --help                       Displays Help
-            --[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
-            --[no-]author                Add author of pull-request in the end. Default is true
+    -t, --token [TOKEN]              To make more than 50 requests per hour your GitHub token required. You can generate it here: https://github.com/settings/tokens/new
     -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'
+        --[no-]verbose               Run verbosely. Default is true
+        --[no-]issues                Include closed issues to changelog. Default is true
+        --[no-]issues-wo-labels      Include closed issues without labels to changelog. Default is true
+        --[no-]pr-wo-labels          Include pull requests without labels to changelog. Default is true
+        --[no-]pull-requests         Include pull-requests to changelog. Default is true
+        --[no-]filter-by-milestone   Use milestone to detect when issue was resolved. Default is true
+        --[no-]author                Add author of pull-request in the end. Default is true
+        --unreleased-only            Generate log from unreleased closed issues only.
+        --[no-]unreleased            Add to log unreleased closed issues. Default is true
+        --[no-]compare-link          Include compare link between older version and newer version. Default is true
+        --include-labels  x,y,z      Issues only with that labels will be included to changelog. Default is 'bug,enhancement'
+        --exclude-labels  x,y,z      Issues with that labels will be always excluded from changelog. Default is 'duplicate,question,invalid,wontfix'
+        --github-site [URL]          The Enterprise Github site on which your project is hosted.
+        --github-api [URL]           The enterprise endpoint to use for your Github API.
     -v, --version                    Print version number
+    -h, --help                       Displays Help
 
 
 ### GitHub token
 
-Since GitHub allow to make only 50 requests without authentication it's recommended to run this script with token
+Since GitHub allows you to make only 50 requests without authentication it's recommended to run this script with a token (`-t, --token` option)
 
 **You can easily [generate it here](https://github.com/settings/applications)**.
 
@@ -57,31 +113,78 @@ And:
 - Run with key `-t [your-16-digit-token]` 
 - Or set environment variable `CHANGELOG_GITHUB_TOKEN` and specify there your token. 
  		
-	i.e. add to your `~/.bash_profile` or `~/.zshrc` or any other place to load ENV variables string `export CHANGELOG_GITHUB_TOKEN="your-40-digit-github-token"'`
+	i.e. add to your `~/.bash_profile` or `~/.zshrc` or any other place to load ENV variables string :
+
+        export CHANGELOG_GITHUB_TOKEN="your-40-digit-github-token"
 
 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.
 
-## Examples:
+##Features and advantages of this project
+- Generate canonical, neat change log file, followed by [basic change log guidlines](http://keepachangelog.com/) :gem:
+- Possible to generate **Unreleased** changes (closed issues that have not released yet) :dizzy:
+- **GitHub Enterprise support** via command line options! :factory:
+- Flexible format **customisation**:
+    - **Customize** issues, that **should be added** to changelog :eight_spoked_asterisk:
+    - **Custom date format** supported (but get in mind [ISO 8601](http://xkcd.com/1179/) ) :date:
+    - Ability to manually specify in which version issue was fixed (in case, when closed date is not match) by setting `milestone` of issue the same name as tag of  required version :pushpin:
+    - Automatically **exclude specific issues**, not-related to change log (any issue, that has label `question` `duplicate` `invalid` `wontfix`by default)  :scissors:
+- **Distinguish** issues **according labels**. :mag_right:
+    - Merged pull requests (all `merged` pull-requests) :twisted_rightwards_arrows:
+    - Bug fixes (by label `bug` in issue) :beetle:
+    - Enhancements (by label `enhancement` in issue) :star2:
+    - 	Issues (closed issues `w/o any labels`) :non-potable_water:    
 
-- Look at **[CHANGELOG.md](https://github.com/skywinder/Github-Changelog-Generator/blob/master/CHANGELOG.md)** for **this** project
-- [ActionSheetPicker-3.0/CHANGELOG.md](https://github.com/skywinder/ActionSheetPicker-3.0/blob/master/CHANGELOG.md)  was generated by command:
-
-		github_changelog_generator -u skywinder -p ActionSheetPicker-3.0
+- You can manually set which labels should be included/excluded. :wrench:
+- Apply a lot of other customisations, to fit changelog for your personal style :tophat: 
+(*look `github_changelog_generator --help`  for details)*
 
 
-## Projects using this library
+###Alternatives
+Here is a [wikipage list of alternatives](https://github.com/skywinder/Github-Changelog-Generator/wiki/Alternatives), that I found. But none satisfied my requirements.
+
+*If you know other projects - feel free to edit this Wiki page!*
+
+
+### Projects using this library
 [Wikipage with list of projects](https://github.com/skywinder/Github-Changelog-Generator/wiki/Projects-using-Github-Changelog-Generator) 
 
-*If you are using `github_changelog_generator` for generation chamgelog in your project or know of project that uses it, please add it to [this] (https://github.com/skywinder/Github-Changelog-Generator/wiki/Projects-using-Github-Changelog-Generator) list.*
+*If you are using `github_changelog_generator` for generation change log in your project or know another project that uses it, please add it to [this] (https://github.com/skywinder/Github-Changelog-Generator/wiki/Projects-using-Github-Changelog-Generator) list.*
 
-## Am I missed some essential feature?
+## Am I missing some essential feature?
 
-**Nothing is impossible!** Open an [issue](https://github.com/skywinder/Github-Changelog-Generator/issues/new) and let's make generator better together!
+- **Nothing is impossible!** 
 
-*Bug reports, feature requests, patches, well-wishes are always welcome!*
+- Open an [issue](https://github.com/skywinder/Github-Changelog-Generator/issues/new) and let's make generator better together! 
+
+- *Bug reports, feature requests, patches, well-wishes are always welcome* :heavy_exclamation_mark:
+
+## FAQ
+
+- ***I already use GitHub Releases. Why do I need this?***
+
+GitHub Releases is a very good thing. And it's very good practice to maintain it (not so much people using it yet)! :congratulations:
+
+*BDW: I would like to support GitHub Releases in [next releases](https://github.com/skywinder/github-changelog-generator/issues/56) ;)*
+
+I'm not try to compare quality of auto-generated and manually generated logs.. but:
+
+The auto generated Changelog really helps even if you manually fill Releases notes!
+
+For example:
+
+When I found a closed bug - it's very useful to understand, in which release it was fixed. In that case you can easily find this issue by \# in `CHANGELOG.md`.
+
+- it's not so quite easy to find it in manually filled Releases notes.
+- this file can also help you to build your Release note and not miss features in manually-filled list.
+
+In the end:
+
+I think, that GitHub Releases is more for end-users.
+But `CHANGELOG.md` could stay in the repo for developers with detailed list of changes.
+And it's nothing bad to combine GitHub Releases and `CHANGELOG.md` file together in that manner.
 
 ## Contributing
 
@@ -91,11 +194,8 @@ It's time to create this token or wait for 1 hour before GitHub reset the counte
 4. Commit your changes (`git commit -am 'Add some feature'`)
 5. Push to the branch (`git push origin my-new-feature`)
 6. Create a new Pull Request
+7. Profit! :white_check_mark:
 
 ## License
 
 Github Changelog Generator is released under the [MIT License](http://www.opensource.org/licenses/MIT).
-
-
-[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/skywinder/github-changelog-generator/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
-

github_changelog_generator.gemspec

@@ -13,8 +13,8 @@ Gem::Specification.new do |spec|
   spec.authors = ["Petr Korolev"]
   spec.email = %q{sky4winder+github_changelog_generator@gmail.com}
   spec.date = `date +"%Y-%m-%d"`.strip!
-  spec.summary = %q{Script, that automatically generate change-log from your tags and pull-requests.}
-  spec.description = %q{Script, that automatically generate change-log from your tags and pull-requests}
+  spec.summary = %q{Script, that automatically generate changelog from your tags, issues, labels and pull requests.}
+  spec.description = %q{Changelog generation has never been so easy. Fully automate changelog generation - this gem generate change log file based on tags, issues and merged pull requests from Github issue tracker.}
   spec.homepage = %q{https://github.com/skywinder/Github-Changelog-Generator}
   spec.license       = "MIT"
 

lib/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Change Log
+
+## [Unreleased](https://github.com/skywinder/changelog_test/tree/HEAD)
+
+[Full Changelog](https://github.com/skywinder/changelog_test/compare/v0.0.3...HEAD)
+
+**Merged pull requests:**
+
+- Add automatically generated change log file. [\#5](https://github.com/skywinder/changelog_test/pull/5) ([skywinder](https://github.com/skywinder))
+
+## [v0.0.3](https://github.com/skywinder/changelog_test/tree/v0.0.3) (2015-03-04)
+
+[Full Changelog](https://github.com/skywinder/changelog_test/compare/v0.0.2...v0.0.3)
+
+**Merged pull requests:**
+
+- fix \#3. hotfix. Should appear in v0.0.3 [\#4](https://github.com/skywinder/changelog_test/pull/4) ([skywinder](https://github.com/skywinder))
+
+## [v0.0.2](https://github.com/skywinder/changelog_test/tree/v0.0.2) (2015-03-04)
+
+[Full Changelog](https://github.com/skywinder/changelog_test/compare/v0.0.1...v0.0.2)
+
+**Merged pull requests:**
+
+- Here is a test hotfix should appear in v.0.0.2 [\#2](https://github.com/skywinder/changelog_test/pull/2) ([skywinder](https://github.com/skywinder))
+
+## [v0.0.1](https://github.com/skywinder/changelog_test/tree/v0.0.1) (2015-03-02)
+
+
+
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

lib/github_changelog_generator.rb

@@ -20,109 +20,177 @@ module GitHubChangelogGenerator
 
       @options = Parser.parse_options
 
-      if options[:verbose]
-        puts 'Input options:'
-        pp options
-        puts ''
-      end
+      fetch_github_token
 
-      github_token
+      github_options = {per_page: PER_PAGE_NUMBER}
+      github_options[:oauth_token] = @github_token unless @github_token.nil?
+      github_options[:endpoint] = options[:github_endpoint] unless options[:github_endpoint].nil?
+      github_options[:site] = options[:github_endpoint] unless options[:github_site].nil?
 
-      if @github_token.nil?
-        @github = Github.new per_page: PER_PAGE_NUMBER
-      else
-        @github = Github.new oauth_token: @github_token,
-                             per_page: PER_PAGE_NUMBER
+begin
+         @github = Github.new github_options
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
  end
 
       @generator = Generator.new(@options)
 
       @all_tags = self.get_all_tags
-      @pull_requests = self.get_all_closed_pull_requests
+      @issues, @pull_requests = self.fetch_issues_and_pull_requests
+
+      if @options[:pulls]
+        @pull_requests = self.get_filtered_pull_requests
+      else
+        @pull_requests = []
+      end
+
       if @options[:issues]
-        @issues = self.get_all_issues
+        @issues = self.get_filtered_issues
       else
         @issues = []
       end
 
+      fetch_event_for_issues_and_pr
+      detect_actual_closed_dates
       @tag_times_hash = {}
     end
 
+    def detect_actual_closed_dates
+
+      if @options[:verbose]
+        print "Fetching closed dates for issues...\r"
+      end
+
+      threads = []
+
+      @issues.each { |issue|
+        threads << Thread.new {
+          find_closed_date_by_commit(issue)
+        }
+      }
+
+      @pull_requests.each { |pull_request|
+        threads << Thread.new {
+          find_closed_date_by_commit(pull_request)
+        }
+      }
+      threads.each { |thr| thr.join }
+
+      if @options[:verbose]
+        puts 'Fetching closed dates for issues: Done!'
+      end
+    end
+
+    def find_closed_date_by_commit(issue)
+      unless issue['events'].nil?
+        #if it's PR -> then find "merged event", in case of usual issue -> fond closed date
+        compare_string = issue[:merged_at].nil? ? 'closed' : 'merged'
+        # reverse! - to find latest closed event. (event goes in date order)
+        issue['events'].reverse!.each { |event|
+          if event[:event].eql? compare_string
+            if event[:commit_id].nil?
+              issue[:actual_date] = issue[:closed_at]
+            else
+              begin
+begin
+                   commit = @github.git_data.commits.get @options[:user], @options[:project], event[:commit_id]
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
+                issue[:actual_date] = commit[:author][:date]
+              rescue
+                puts "Warning: can't fetch commit #{event[:commit_id]} probably it referenced from another repo."
+                issue[:actual_date] = issue[:closed_at]
+              end
+            end
+            break
+          end
+        }
+      end
+      #TODO: assert issues, that remain without 'actual_date' hash for some reason.
+    end
+
     def print_json(json)
       puts JSON.pretty_generate(json)
     end
 
-    def exec_command(cmd)
-      exec_cmd = "cd #{$project_path} and #{cmd}"
-      %x[#{exec_cmd}]
-    end
-
-
-    def get_all_closed_pull_requests
-
+    def fetch_merged_at_pull_requests
       if @options[:verbose]
-        print "Fetching pull requests...\r"
+        print "Fetching merged dates...\r"
       end
-
-      response = @github.pull_requests.list @options[:user], @options[:project], :state => 'closed'
-
       pull_requests = []
+begin
+         response = @github.pull_requests.list @options[:user], @options[:project], :state => 'closed'
          page_i = 0
          response.each_page do |page|
            page_i += PER_PAGE_NUMBER
-        print "Fetching pull requests... #{page_i}\r"
+           count_pages = response.count_pages
+           print "Fetching merged dates... #{page_i}/#{count_pages * PER_PAGE_NUMBER}\r"
            pull_requests.concat(page)
          end
-
-      print "\r"
-
-      if @options[:verbose]
-        puts "Received closed pull requests: #{pull_requests.count}"
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
  end
 
-      unless @options[:pull_request_labels].nil?
 
-        if @options[:verbose]
-          puts 'Filter all pull requests by labels.'
-        end
 
-        filtered_pull_requests = pull_requests.select { |pull_request|
-          #We need issue to fetch labels
-          issue = @github.issues.get @options[:user], @options[:project], pull_request.number
-          #compare is there any labels from @options[:labels] array
-          select_no_label = !issue.labels.map { |label| label.name }.any?
+      print "                                                   \r"
 
-          if @options[:verbose]
-            puts "Filter request \##{issue.number}."
-          end
-
-          if @options[:pull_request_labels].any?
-            select_by_label = (issue.labels.map { |label| label.name } & @options[:pull_request_labels]).any?
-          else
-            select_by_label = false
-          end
-
-          select_by_label | select_no_label
+      @pull_requests.each { |pr|
+        fetched_pr = pull_requests.find { |fpr|
+          fpr.number == pr.number }
+        pr[:merged_at] = fetched_pr[:merged_at]
+        pull_requests.delete(fetched_pr)
       }
 
       if @options[:verbose]
-          puts "Filtered pull requests with specified labels and w/o labels: #{filtered_pull_requests.count}"
-        end
-        return filtered_pull_requests
+        puts 'Fetching merged dates... Done!'
       end
 
-      pull_requests
+    end
+
+    def get_filtered_pull_requests
+
+      self.fetch_merged_at_pull_requests
+
+      filtered_pull_requests = @pull_requests.select {|pr| pr[:merged_at] != nil }
+
+      unless @options[:include_labels].nil?
+        filtered_pull_requests = @pull_requests.select { |issue|
+          #add all labels from @options[:incluse_labels] array
+          (issue.labels.map { |label| label.name } & @options[:include_labels]).any?
+        }
+      end
+
+      unless @options[:exclude_labels].nil?
+        filtered_pull_requests = filtered_pull_requests.select { |issue|
+          #delete all labels from @options[:exclude_labels] array
+          !(issue.labels.map { |label| label.name } & @options[:exclude_labels]).any?
+        }
+      end
+
+      if @options[:add_issues_wo_labels]
+        issues_wo_labels = @pull_requests.select {
+          # add issues without any labels
+            |issue| !issue.labels.map { |label| label.name }.any?
+        }
+        filtered_pull_requests |= issues_wo_labels
+      end
+
+
+      if @options[:verbose]
+        puts "Filtered pull requests: #{filtered_pull_requests.count}"
+      end
+
+      filtered_pull_requests
     end
 
     def compund_changelog
-      if @options[:verbose]
-        puts 'Generating changelog:'
-      end
 
-      log = "# Changelog\n\n"
+      log = "# Change Log\n\n"
 
-      if @options[:last]
-        log += self.generate_log_between_tags(self.all_tags[0], self.all_tags[1])
+      if @options[:unreleased_only]
+        log += self.generate_log_between_tags(self.all_tags[0], nil)
       elsif @options[:tag1] and @options[:tag2]
         tag1 = @options[:tag1]
         tag2 = @options[:tag2]
@@ -131,7 +199,8 @@ module GitHubChangelogGenerator
 
         if tags_strings.include?(tag1)
           if tags_strings.include?(tag2)
-            hash = Hash[tags_strings.map.with_index.to_a]
+            to_a = tags_strings.map.with_index.to_a
+            hash = Hash[to_a]
             index1 = hash[tag1]
             index2 = hash[tag2]
             log += self.generate_log_between_tags(self.all_tags[index1], self.all_tags[index2])
@@ -147,24 +216,18 @@ module GitHubChangelogGenerator
         log += self.generate_log_for_all_tags
       end
 
-      log += "\n\n\\* *This changelog was generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*"
+      log += "\n\n\\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*"
 
       output_filename = "#{@options[:output]}"
       File.open(output_filename, 'w') { |file| file.write(log) }
-
-      puts "Done! Generated log placed in #{`pwd`.strip!}/#{output_filename}"
+      puts 'Done!'
+      puts "Generated log placed in #{`pwd`.strip!}/#{output_filename}"
 
     end
 
     def generate_log_for_all_tags
-      log = ''
 
-      # Async fetching tags:
-      threads = []
-      @all_tags.each { |tag|
-        threads << Thread.new { self.get_time_of_tag(tag) }
-      }
-      threads.each { |thr| thr.join }
+      fetch_tags_dates
 
       if @options[:verbose]
         puts "Sorting tags.."
@@ -176,17 +239,62 @@ module GitHubChangelogGenerator
         puts "Generating log.."
       end
 
+
+      log = ''
+
+      if @options[:unreleased] && @all_tags.count != 0
+        unreleased_log = self.generate_log_between_tags(self.all_tags[0], nil)
+        if unreleased_log
+          log += unreleased_log
+        end
+      end
+
       (1 ... self.all_tags.size).each { |index|
         log += self.generate_log_between_tags(self.all_tags[index], self.all_tags[index-1])
       }
-
+      if @all_tags.count != 0
         log += generate_log_between_tags(nil, self.all_tags.last)
+      end
 
       log
     end
 
+    def fetch_tags_dates
+      if @options[:verbose]
+        print "Fetching tags dates..\r"
+      end
+
+      # Async fetching tags:
+      threads = []
+      i = 0
+      all = @all_tags.count
+      @all_tags.each { |tag|
+        # explicit set @tag_times_hash to write data safety.
+        threads << Thread.new {
+          self.get_time_of_tag(tag, @tag_times_hash)
+          if @options[:verbose]
+            print "Fetching tags dates: #{i+1}/#{all}\r"
+            i+=1
+          end
+
+        }
+      }
+
+      print "                                 \r"
+
+      threads.each { |thr| thr.join }
+
+      if @options[:verbose]
+        puts 'Fetching tags: Done!'
+      end
+    end
+
     def is_megred(number)
+begin
          @github.pull_requests.merged? @options[:user], @options[:project], number
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
     end
 
     def get_all_tags
@@ -195,29 +303,32 @@ module GitHubChangelogGenerator
         print "Fetching tags...\r"
       end
 
-      response = @github.repos.tags @options[:user], @options[:project]
-
       tags = []
+
+      begin
+         response = @github.repos.tags @options[:user], @options[:project]
          page_i = 0
+         count_pages = response.count_pages
          response.each_page do |page|
            page_i += PER_PAGE_NUMBER
-        print "Fetching tags... #{page_i}\r"
+           print "Fetching tags... #{page_i}/#{count_pages * PER_PAGE_NUMBER}\r"
            tags.concat(page)
          end
-      print "\r"
+         print "                               \r"
          if @options[:verbose]
            puts "Found #{tags.count} tags"
          end
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
+
+
 
       tags
     end
 
-    def github_token
-      if @options[:token]
-        return @github_token ||= @options[:token]
-      end
-
-      env_var = ENV.fetch 'CHANGELOG_GITHUB_TOKEN', nil
+    def fetch_github_token
+      env_var = @options[:token] ? @options[:token] : (ENV.fetch 'CHANGELOG_GITHUB_TOKEN', nil)
 
       unless env_var
         puts "Warning: No token provided (-t option) and variable $CHANGELOG_GITHUB_TOKEN was not found.".yellow
@@ -228,26 +339,70 @@ module GitHubChangelogGenerator
 
     end
 
-
     def generate_log_between_tags(older_tag, newer_tag)
+      # older_tag nil - means it's first tag, newer_tag nil - means it unreleased section
+      filtered_pull_requests = delete_by_time(@pull_requests, :actual_date, older_tag, newer_tag)
+      filtered_issues = delete_by_time(@issues, :actual_date, older_tag, newer_tag)
+
+      newer_tag_name = newer_tag.nil? ? nil : newer_tag['name']
+      older_tag_name = older_tag.nil? ? nil : older_tag['name']
+
+      if @options[:filter_issues_by_milestone]
+        #delete excess irrelevant issues (according milestones)
+        filtered_issues = filter_by_milestone(filtered_issues, newer_tag_name, @issues)
+        filtered_pull_requests = filter_by_milestone(filtered_pull_requests, newer_tag_name, @pull_requests)
+      end
+
+      if filtered_issues.empty? && filtered_pull_requests.empty? && newer_tag.nil?
+        # do not generate empty unreleased section
+        return ''
+      end
+
+      self.create_log(filtered_pull_requests, filtered_issues, newer_tag, older_tag_name)
+    end
+
+    def filter_by_milestone(filtered_issues, newer_tag_name, src_array)
+      filtered_issues.select! { |issue|
+        # leave issues without milestones
+        if issue.milestone.nil?
+          true
+        else
+          #check, that this milestone in tag list:
+          @all_tags.find { |tag| tag.name == issue.milestone.title }.nil?
+        end
+      }
+      unless newer_tag_name.nil?
+
+        #add missed issues (according milestones)
+        issues_to_add = src_array.select { |issue|
+          if issue.milestone.nil?
+            false
+          else
+            #check, that this milestone in tag list:
+            milestone_is_tag = @all_tags.find { |tag|
+              tag.name == issue.milestone.title
+            }
+
+            if milestone_is_tag.nil?
+              false
+            else
+              issue.milestone.title == newer_tag_name
+            end
+          end
+        }
+
+        filtered_issues |= issues_to_add
+      end
+      filtered_issues
+    end
+
+    def delete_by_time(array, hash_key, older_tag = nil, newer_tag = nil)
+
+      raise 'At least one of the tags should be not nil!' if (older_tag.nil? && newer_tag.nil?)
 
       newer_tag_time = self.get_time_of_tag(newer_tag)
-      newer_tag_name = newer_tag['name']
-
-      if older_tag.nil?
-        filtered_pull_requests = delete_by_time(@pull_requests, :merged_at, newer_tag_time)
-        filtered_issues = delete_by_time(@issues, :closed_at, newer_tag_time)
-      else
       older_tag_time = self.get_time_of_tag(older_tag)
-        filtered_pull_requests = delete_by_time(@pull_requests, :merged_at, newer_tag_time, older_tag_time)
-        filtered_issues = delete_by_time(@issues, :closed_at, newer_tag_time, older_tag_time)
-      end
 
-      self.create_log(filtered_pull_requests, filtered_issues, newer_tag_name, newer_tag_time)
-
-    end
-
-    def delete_by_time(array, hash_key, newer_tag_time, older_tag_time = nil)
       array.select { |req|
         if req[hash_key]
           t = Time.parse(req[hash_key]).utc
@@ -258,7 +413,12 @@ module GitHubChangelogGenerator
             tag_in_range_old = t > older_tag_time
           end
 
+          if newer_tag_time.nil?
+            tag_in_range_new = true
+          else
             tag_in_range_new = t <= newer_tag_time
+          end
+
 
           tag_in_range = (tag_in_range_old) && (tag_in_range_new)
 
@@ -269,135 +429,151 @@ module GitHubChangelogGenerator
       }
     end
 
-# @param [Array] pull_requests
-# @param [Array] issues
-# @param [String] tag_name
-# @param [String] tag_time
-# @return [String]
-    def create_log(pull_requests, issues, tag_name, tag_time)
+    # @param [Array] pull_requests
+    # @param [Array] issues
+    # @param [String] older_tag_name
+    # @return [String]
+    def create_log(pull_requests, issues, newer_tag, older_tag_name = nil)
 
-      # Generate tag name and link
-      log = "## [#{tag_name}] (https://github.com/#{@options[:user]}/#{@options[:project]}/tree/#{tag_name})\n"
+      newer_tag_time = newer_tag.nil? ? nil : self.get_time_of_tag(newer_tag)
+      newer_tag_name = newer_tag.nil? ? nil : newer_tag['name']
 
-      #Generate date string:
-      time_string = tag_time.strftime @options[:format]
-      log += "#### #{time_string}\n"
+      github_site = options[:github_site] || 'https://github.com'
+      project_url = "#{github_site}/#{@options[:user]}/#{@options[:project]}"
 
-      if @options[:pulls]
-        # Generate pull requests:
-        pull_requests.each { |pull_request|
-          merge = @generator.get_string_for_pull_request(pull_request)
-          log += "- #{merge}"
-
-        } if pull_requests
+      if newer_tag.nil?
+        newer_tag_name = @options[:unreleased_label]
+        newer_tag_link = 'HEAD'
+        newer_tag_time = Time.new
+      else
+        newer_tag_link = newer_tag_name
       end
 
+      log = ''
+
+      log += generate_header(log, newer_tag_name, newer_tag_link, newer_tag_time, older_tag_name, project_url)
+
       if @options[:issues]
         # Generate issues:
-        if issues
-          issues.sort! { |x, y|
-            if x.labels.any? && y.labels.any?
-              x.labels[0].name <=> y.labels[0].name
-            else
-              if x.labels.any?
-                1
-              else
-                if y.labels.any?
-                  -1
-                else
-                  0
-                end
-              end
-            end
-          }.reverse!
-        end
+        issues_a = []
+        enhancement_a = []
+        bugs_a =[]
+
         issues.each { |dict|
-          is_bug = false
-          is_enhancement = false
+          added = false
           dict.labels.each { |label|
             if label.name == 'bug'
-              is_bug = true
+              bugs_a.push dict
+              added = true
+              next
             end
             if label.name == 'enhancement'
-              is_enhancement = true
+              enhancement_a.push dict
+              added = true
+              next
+            end
+          }
+          unless added
+            issues_a.push dict
           end
         }
 
-          intro = 'Closed issue'
-          if is_bug
-            intro = 'Fixed bug'
+        log += generate_log_from_array(enhancement_a, @options[:enhancement_prefix])
+        log += generate_log_from_array(bugs_a, @options[:bug_prefix])
+        log += generate_log_from_array(issues_a, @options[:issue_prefix])
       end
 
-          if is_enhancement
-            intro = 'Implemented enhancement'
+      if @options[:pulls]
+        # Generate pull requests:
+        log += generate_log_from_array(pull_requests, @options[:merge_prefix])
       end
 
-          enc_string = @generator.encapsulate_string dict[:title]
+      log
+    end
 
-          merge = "*#{intro}:* #{enc_string} [\\##{dict[:number]}](#{dict.html_url})\n\n"
-          log += "- #{merge}"
+    def generate_log_from_array(issues, prefix)
+      log = ''
+      if options[:simple_list].nil? && issues.any?
+        log += "#{prefix}\n\n"
+      end
+
+      if issues.any?
+        issues.each { |issue|
+          merge_string = @generator.get_string_for_issue(issue)
+          log += "- #{merge_string}\n\n"
         }
       end
       log
     end
 
-    def get_time_of_tag(prev_tag)
+    def generate_header(log, newer_tag_name, newer_tag_name2, newer_tag_time, older_tag_name, project_url)
 
-      if @tag_times_hash[prev_tag['name']]
-        return @tag_times_hash[prev_tag['name']]
+      #Generate date string:
+      time_string = newer_tag_time.strftime @options[:format]
+
+      # Generate tag name and link
+      if newer_tag_name.equal? @options[:unreleased_label]
+        log += "## [#{newer_tag_name}](#{project_url}/tree/#{newer_tag_name2})\n\n"
+      else
+        log += "## [#{newer_tag_name}](#{project_url}/tree/#{newer_tag_name2}) (#{time_string})\n\n"
       end
 
-      github_git_data_commits_get = @github.git_data.commits.get @options[:user], @options[:project], prev_tag['commit']['sha']
+      if @options[:compare_link] && older_tag_name
+        # Generate compare link
+        log += "[Full Changelog](#{project_url}/compare/#{older_tag_name}...#{newer_tag_name2})\n\n"
+      end
+
+      log
+    end
+
+    def get_time_of_tag(tag_name, tag_times_hash = @tag_times_hash)
+
+      if tag_name.nil?
+        return nil
+      end
+
+      if tag_times_hash[tag_name['name']]
+        return @tag_times_hash[tag_name['name']]
+      end
+
+begin
+         github_git_data_commits_get = @github.git_data.commits.get @options[:user], @options[:project], tag_name['commit']['sha']
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
       time_string = github_git_data_commits_get['committer']['date']
-      Time.parse(time_string)
-      @tag_times_hash[prev_tag['name']] = Time.parse(time_string)
+      @tag_times_hash[tag_name['name']] = Time.parse(time_string)
     end
 
-    def get_all_issues
+    def get_filtered_issues
 
-      if @options[:verbose]
-        print "Fetching closed issues...\r"
-      end
+      issues = @issues
 
-      response = @github.issues.list user: @options[:user], repo: @options[:project], state: 'closed', filter: 'all', labels: nil
-
-      issues = []
-      page_i = 0
-      response.each_page do |page|
-        page_i += PER_PAGE_NUMBER
-        print "Fetching closed issues... #{page_i}\r"
-        issues.concat(page)
-      end
-
-      print "\r"
-
-      # remove pull request from issues:
-      issues.select! { |x|
-        x.pull_request == nil
-      }
-
-      if @options[:verbose]
-        puts "Received closed issues: #{issues.count}"
-      end
-
-
-      if @options[:verbose]
-        puts "Filtering issues with labels #{@options[:labels]}#{@options[:add_issues_wo_labels] ? ' and w/o labels' : ''}"
-      end
+      filtered_issues = issues
 
+      unless @options[:include_labels].nil?
         filtered_issues = issues.select { |issue|
-        #compare is there any labels from @options[:labels] array
-        (issue.labels.map { |label| label.name } & @options[:labels]).any?
+          #add all labels from @options[:incluse_labels] array
+          (issue.labels.map { |label| label.name } & @options[:include_labels]).any?
         }
+      end
+
+      unless @options[:exclude_labels].nil?
+        filtered_issues = filtered_issues.select { |issue|
+          #delete all labels from @options[:exclude_labels] array
+          !(issue.labels.map { |label| label.name } & @options[:exclude_labels]).any?
+        }
+      end
 
       if @options[:add_issues_wo_labels]
         issues_wo_labels = issues.select {
           # add issues without any labels
             |issue| !issue.labels.map { |label| label.name }.any?
         }
-        filtered_issues.concat(issues_wo_labels)
+        filtered_issues |= issues_wo_labels
       end
 
+
       if @options[:verbose]
         puts "Filtered issues: #{filtered_issues.count}"
       end
@@ -406,6 +582,82 @@ module GitHubChangelogGenerator
 
     end
 
+    def fetch_issues_and_pull_requests
+      if @options[:verbose]
+        print "Fetching closed issues...\r"
+      end
+      issues = []
+
+begin
+         response = @github.issues.list user: @options[:user], repo: @options[:project], state: 'closed', filter: 'all', labels: nil
+         page_i = 0
+         count_pages = response.count_pages
+         response.each_page do |page|
+           page_i += PER_PAGE_NUMBER
+           print "Fetching issues... #{page_i}/#{count_pages * PER_PAGE_NUMBER}\r"
+           issues.concat(page)
+         end
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
+
+
+
+      print "                               \r"
+
+      if @options[:verbose]
+        puts "Received issues: #{issues.count}"
+      end
+
+      # remove pull request from issues:
+      issues_wo_pr = issues.select { |x|
+        x.pull_request == nil
+      }
+      pull_requests = issues.select { |x|
+        x.pull_request != nil
+      }
+      return issues_wo_pr, pull_requests
+    end
+
+    def fetch_event_for_issues_and_pr
+      if @options[:verbose]
+        print "Fetching events for issues and PR: 0/#{@issues.count + @pull_requests.count}\r"
+      end
+
+      # Async fetching events:
+
+      fetch_events_async(@issues + @pull_requests)
+
+      #to clear line from prev print
+      print "                                                            \r"
+
+      if @options[:verbose]
+        puts 'Fetching events for issues and PR: Done!'
+      end
+    end
+
+    def fetch_events_async(issues)
+      i = 0
+      max_thread_number = 50
+      threads = []
+      issues.each_slice(max_thread_number) { |issues_slice|
+        issues_slice.each { |issue|
+          threads << Thread.new {
+begin
+               obj = @github.issues.events.list user: @options[:user], repo: @options[:project], issue_number: issue['number']
+rescue
+         puts "Warning: GitHub API rate limit exceed (5000 per hour), change log may not contain some issues.".yellow
+ end
+            issue[:events] = obj.body
+            print "Fetching events for issues and PR: #{i+1}/#{@issues.count + @pull_requests.count}\r"
+            i +=1
+          }
+        }
+        threads.each { |thr| thr.join }
+        threads = []
+      }
+    end
+
   end
 
   if __FILE__ == $0

lib/github_changelog_generator/generator.rb

@@ -5,28 +5,29 @@ module GitHubChangelogGenerator
       @options = options
     end
 
-    def get_string_for_pull_request(pull_request)
-      encapsulated_title = self.encapsulate_string pull_request[:title]
+    def get_string_for_issue(issue)
+      encapsulated_title = self.encapsulate_string issue[:title]
 
-      merge = "#{@options[:merge_prefix]}#{encapsulated_title} [\\##{pull_request[:number]}](#{pull_request.html_url})"
+      title_with_number = "#{encapsulated_title} [\\##{issue[:number]}](#{issue.html_url})"
+
+      unless issue.pull_request.nil?
         if @options[:author]
-        if !pull_request.user.nil?
-          merge += " ([#{pull_request.user.login}](#{pull_request.user.html_url}))\n\n"
+          if issue.user.nil?
+            title_with_number += " ({Null user})"
           else
-          merge += " ({Null user})\n\n"
+            title_with_number += " ([#{issue.user.login}](#{issue.user.html_url}))"
           end
-      else
-        merge += "\n\n"
         end
-      merge
+      end
+      title_with_number
     end
 
     def encapsulate_string(string)
 
       string.gsub! '\\', '\\\\'
 
-      encpas_chars = %w(> * _ \( \) [ ])
-      encpas_chars.each{ |char|
+      encpas_chars = %w(> * _ \( \) [ ] #)
+      encpas_chars.each { |char|
         string.gsub! char, "\\#{char}"
       }
 

lib/github_changelog_generator/parser.rb

@@ -1,15 +1,37 @@
 #!/usr/bin/env ruby
 require 'optparse'
-require 'PP'
+require 'pp'
 require_relative 'version'
 
 module GitHubChangelogGenerator
   class Parser
     def self.parse_options
-      options = {:tag1 => nil, :tag2 => nil, :format => '%d/%m/%y', :output => 'CHANGELOG.md', :labels => %w(bug enhancement), :pulls => true, :issues => true, :verbose => true, :add_issues_wo_labels => true, :merge_prefix => '*Merged pull-request:* ', :author => true, :pull_request_labels => nil}
+
+      options = {
+          :tag1 => nil,
+          :tag2 => nil,
+          :format => '%Y-%m-%d',
+          :output => 'CHANGELOG.md',
+          :exclude_labels => %w(duplicate question invalid wontfix),
+          :pulls => true,
+          :issues => true,
+          :verbose => true,
+          :add_issues_wo_labels => true,
+          :add_pr_wo_labels => true,
+          :merge_prefix => '**Merged pull requests:**',
+          :issue_prefix => '**Closed issues:**',
+          :bug_prefix => '**Fixed bugs:**',
+          :enhancement_prefix => '**Implemented enhancements:**',
+          :author => true,
+          :filter_issues_by_milestone => true,
+          :compare_link => true,
+          :unreleased => true,
+          :unreleased_label => 'Unreleased',
+          :branch => 'origin'
+      }
 
       parser = OptionParser.new { |opts|
-        opts.banner = 'Usage: changelog_generator [options]'
+        opts.banner = 'Usage: github_changelog_generator [options]'
         opts.on('-u', '--user [USER]', 'Username of the owner of target GitHub repo') do |last|
           options[:user] = last
         end
@@ -25,26 +47,53 @@ module GitHubChangelogGenerator
         opts.on('-o', '--output [NAME]', 'Output file. Default is CHANGELOG.md') do |last|
           options[:output] = last
         end
-        opts.on('--[no-]verbose', 'Run verbosely. Default is true') do |v|
-          options[:verbose] = v
-        end
         opts.on('--[no-]issues', 'Include closed issues to changelog. Default is true') do |v|
           options[:issues] = v
         end
-        opts.on('--[no-]issues-without-labels', 'Include closed issues without any labels to changelog. Default is true') do |v|
+        opts.on('--[no-]issues-wo-labels', 'Include closed issues without labels to changelog. Default is true') do |v|
           options[:add_issues_wo_labels] = v
         end
+        opts.on('--[no-]pr-wo-labels', 'Include pull requests without labels to changelog. Default is true') do |v|
+          options[:add_pr_wo_labels] = v
+        end
         opts.on('--[no-]pull-requests', 'Include pull-requests to changelog. Default is true') do |v|
           options[:pulls] = v
         end
+        opts.on('--[no-]filter-by-milestone', 'Use milestone to detect when issue was resolved. Default is true') do |last|
+          options[:filter_issues_by_milestone] = last
+        end
         opts.on('--[no-]author', 'Add author of pull-request in the end. Default is true') do |author|
-          options[:last] = author
+          options[:author] = author
         end
-        opts.on('--labels  x,y,z', Array, 'Issues with that labels will be included to changelog. Default is \'bug,enhancement\'') do |list|
-          options[:labels] = list
+        opts.on('--unreleased-only', 'Generate log from unreleased closed issues only.') do |v|
+          options[:unreleased_only] = v
         end
-        opts.on('--labels-pr x,y,z', Array, 'Only pull requests with specified labels will be included to changelog. Default is nil') do |list|
-          options[:pull_request_labels] = list
+        opts.on('--[no-]unreleased', 'Add to log unreleased closed issues. Default is true') do |v|
+          options[:unreleased] = v
+        end
+        opts.on('--unreleased-label [label]', 'Add to log unreleased closed issues. Default is true') do |v|
+          options[:unreleased_label] = v
+        end
+        opts.on('--[no-]compare-link', 'Include compare link (Full Changelog) between older version and newer version. Default is true') do |v|
+          options[:compare_link] = v
+        end
+        opts.on('--include-labels  x,y,z', Array, 'Issues only with that labels will be included to changelog. Default is \'bug,enhancement\'') do |list|
+          options[:include_labels] = list
+        end
+        opts.on('--exclude-labels  x,y,z', Array, 'Issues with that labels will be always excluded from changelog. Default is \'duplicate,question,invalid,wontfix\'') do |list|
+          options[:exclude_labels] = list
+        end
+        opts.on('--github-site [URL]', 'The Enterprise Github site on which your project is hosted.') do |last|
+          options[:github_site] = last
+        end
+        opts.on('--github-api [URL]', 'The enterprise endpoint to use for your Github API.') do |last|
+          options[:github_endpoint] = last
+        end
+        opts.on('--simple-list', 'Create simple list from issues and pull requests. Default is false.') do |v|
+          options[:simple_list] = v
+        end
+        opts.on('--[no-]verbose', 'Run verbosely. Default is true') do |v|
+          options[:verbose] = v
         end
         opts.on('-v', '--version', 'Print version number') do |v|
           puts "Version: #{GitHubChangelogGenerator::VERSION}"
@@ -59,24 +108,45 @@ module GitHubChangelogGenerator
       parser.parse!
 
       if ARGV[0] && !ARGV[1]
-        # this match should parse https://github.com/skywinder/Github-Changelog-Generator and skywinder/Github-Changelog-Generator to user and name
-        match = /(?:.+github\.com\/)?(.+)\/(.+)/.match(ARGV[0])
+        github_site = options[:github_site] ? options[:github_site] : 'github.com'
+        # this match should parse  strings such "https://github.com/skywinder/Github-Changelog-Generator" or "skywinder/Github-Changelog-Generator" to user and name
+        match = /(?:.+#{Regexp.escape(github_site)}\/)?(.+)\/(.+)/.match(ARGV[0])
 
-        if match[2].nil?
+        begin
+          param = match[2].nil?
+        rescue
+          puts "Can't detect user and name from first parameter: '#{ARGV[0]}' -> exit'"
+          exit
+        end
+        if param
           exit
         else
           options[:user] = match[1]
           options[:project]= match[2]
         end
+
+
       end
 
       if !options[:user] && !options[:project]
-        remote = `git remote -vv`.split("\n")
-        match = /.*(?:[:\/])((?:-|\w|\.)*)\/((?:-|\w|\.)*)(?:\.git)?.*/.match(remote[0])
+        remote = `git config --get remote.#{options[:branch]}.url`
+        # try to find repo in format:
+        # origin	git@github.com:skywinder/Github-Changelog-Generator.git (fetch)
+        # git@github.com:skywinder/Github-Changelog-Generator.git
+        match = /.*(?:[:\/])((?:-|\w|\.)*)\/((?:-|\w|\.)*)(?:\.git).*/.match(remote)
 
         if match && match[1] && match[2]
           puts "Detected user:#{match[1]}, project:#{match[2]}"
           options[:user], options[:project] = match[1], match[2]
+        else
+        # try to find repo in format:
+        # origin	https://github.com/skywinder/ChangelogMerger (fetch)
+        # https://github.com/skywinder/ChangelogMerger
+          match = /.*\/((?:-|\w|\.)*)\/((?:-|\w|\.)*).*/.match(remote)
+          if match && match[1] && match[2]
+            puts "Detected user:#{match[1]}, project:#{match[2]}"
+            options[:user], options[:project] = match[1], match[2]
+          end
         end
       end
 
@@ -91,6 +161,12 @@ module GitHubChangelogGenerator
         options[:tag2] = ARGV[1]
       end
 
+      if options[:verbose]
+        puts 'Performing task with options:'
+        pp options
+        puts ''
+      end
+
       options
     end
   end

lib/github_changelog_generator/version.rb

@@ -1,3 +1,3 @@
 module GitHubChangelogGenerator
-  VERSION = '1.2.3'
+  VERSION = '1.3.11'
 end