px_github_changelog_generator 0.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (68) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +9 -0
  3. data/README.md +357 -0
  4. data/Rakefile +19 -0
  5. data/bin/git-generate-changelog +5 -0
  6. data/bin/github_changelog_generator +5 -0
  7. data/lib/github_changelog_generator/argv_parser.rb +225 -0
  8. data/lib/github_changelog_generator/file_parser_chooser.rb +27 -0
  9. data/lib/github_changelog_generator/generator/entry.rb +218 -0
  10. data/lib/github_changelog_generator/generator/generator.rb +177 -0
  11. data/lib/github_changelog_generator/generator/generator_fetcher.rb +202 -0
  12. data/lib/github_changelog_generator/generator/generator_processor.rb +237 -0
  13. data/lib/github_changelog_generator/generator/generator_tags.rb +210 -0
  14. data/lib/github_changelog_generator/generator/section.rb +129 -0
  15. data/lib/github_changelog_generator/helper.rb +37 -0
  16. data/lib/github_changelog_generator/octo_fetcher.rb +535 -0
  17. data/lib/github_changelog_generator/options.rb +159 -0
  18. data/lib/github_changelog_generator/parser.rb +89 -0
  19. data/lib/github_changelog_generator/parser_file.rb +101 -0
  20. data/lib/github_changelog_generator/reader.rb +88 -0
  21. data/lib/github_changelog_generator/ssl_certs/cacert.pem +3138 -0
  22. data/lib/github_changelog_generator/task.rb +68 -0
  23. data/lib/github_changelog_generator/version.rb +5 -0
  24. data/lib/github_changelog_generator.rb +49 -0
  25. data/man/git-generate-changelog.1 +393 -0
  26. data/man/git-generate-changelog.1.html +359 -0
  27. data/man/git-generate-changelog.html +270 -0
  28. data/man/git-generate-changelog.md +274 -0
  29. data/spec/files/angular.js.md +9395 -0
  30. data/spec/files/bundler.md +1911 -0
  31. data/spec/files/config_example +5 -0
  32. data/spec/files/github-changelog-generator.md +305 -0
  33. data/spec/github_changelog_generator_spec.rb +32 -0
  34. data/spec/install_gem_in_bundler.gemfile +5 -0
  35. data/spec/spec_helper.rb +74 -0
  36. data/spec/unit/generator/entry_spec.rb +766 -0
  37. data/spec/unit/generator/generator_processor_spec.rb +203 -0
  38. data/spec/unit/generator/generator_spec.rb +47 -0
  39. data/spec/unit/generator/generator_tags_spec.rb +337 -0
  40. data/spec/unit/generator/section_spec.rb +43 -0
  41. data/spec/unit/octo_fetcher_spec.rb +590 -0
  42. data/spec/unit/options_spec.rb +67 -0
  43. data/spec/unit/parser_file_spec.rb +94 -0
  44. data/spec/unit/parser_spec.rb +54 -0
  45. data/spec/unit/reader_spec.rb +120 -0
  46. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_commits/when_API_is_valid/returns_commits.json +1 -0
  47. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_commits_before/when_API_is_valid/returns_commits.json +1 -0
  48. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issue_with_proper_key/values.json +1 -0
  49. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issues.json +1 -0
  50. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issues_with_labels.json +1 -0
  51. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_pull_request_with_proper_key/values.json +1 -0
  52. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_pull_requests_with_labels.json +1 -0
  53. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid.json +1 -0
  54. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid/returns_correct_pull_request_keys.json +1 -0
  55. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid/returns_pull_requests.json +1 -0
  56. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid.json +1 -0
  57. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_commit/when_API_call_is_valid/returns_commit.json +1 -0
  58. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_commit/when_API_call_is_valid.json +1 -0
  59. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_date_of_tag/when_API_call_is_valid/returns_date.json +1 -0
  60. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_date_of_tag/when_API_call_is_valid.json +1 -0
  61. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_events_async/when_API_call_is_valid/populates_issues.json +1 -0
  62. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_events_async/when_API_call_is_valid.json +1 -0
  63. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid/should_return_tags.json +1 -0
  64. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid/should_return_tags_count.json +1 -0
  65. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid.json +1 -0
  66. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_wrong_token_provided/should_raise_Unauthorized_error.json +1 -0
  67. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_wrong_token_provided.json +1 -0
  68. metadata +250 -0
@@ -0,0 +1,359 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
+ <title>git-generate-changelog(1) - Generate changelog from GitHub</title>
7
+ <style type='text/css' media='all'>
8
+ /* style: man */
9
+ body#manpage {margin:0}
10
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
11
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
12
+ .mp h2 {margin:10px 0 0 0}
13
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
14
+ .mp h3 {margin:0 0 0 4ex}
15
+ .mp dt {margin:0;clear:left}
16
+ .mp dt.flush {float:left;width:8ex}
17
+ .mp dd {margin:0 0 0 9ex}
18
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
19
+ .mp pre {margin-bottom:20px}
20
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
21
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
22
+ .mp img {display:block;margin:auto}
23
+ .mp h1.man-title {display:none}
24
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
25
+ .mp h2 {font-size:16px;line-height:1.25}
26
+ .mp h1 {font-size:20px;line-height:2}
27
+ .mp {text-align:justify;background:#fff}
28
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
29
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
30
+ .mp u {text-decoration:underline}
31
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
32
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
33
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
34
+ .mp b.man-ref {font-weight:normal;color:#434241}
35
+ .mp pre {padding:0 4ex}
36
+ .mp pre code {font-weight:normal;color:#434241}
37
+ .mp h2+pre,h3+pre {padding-left:0}
38
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
39
+ ol.man-decor {width:100%}
40
+ ol.man-decor li.tl {text-align:left}
41
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
42
+ ol.man-decor li.tr {text-align:right;float:right}
43
+ </style>
44
+ </head>
45
+ <!--
46
+ The following styles are deprecated and will be removed at some point:
47
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
48
+
49
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
50
+ .man-navigation should be used instead.
51
+ -->
52
+ <body id='manpage'>
53
+ <div class='mp' id='man'>
54
+
55
+ <div class='man-navigation' style='display:none'>
56
+ <a href="#NAME">NAME</a>
57
+ <a href="#SYNOPSIS">SYNOPSIS</a>
58
+ <a href="#DESCRIPTION">DESCRIPTION</a>
59
+ <a href="#OPTIONS">OPTIONS</a>
60
+ <a href="#REBASED-COMMITS">REBASED COMMITS</a>
61
+ <a href="#EXAMPLES">EXAMPLES</a>
62
+ <a href="#AUTHOR">AUTHOR</a>
63
+ <a href="#REPORTING-BUGS">REPORTING BUGS</a>
64
+ <a href="#SEE-ALSO">SEE ALSO</a>
65
+ </div>
66
+
67
+ <ol class='man-decor man-head man head'>
68
+ <li class='tl'>git-generate-changelog(1)</li>
69
+ <li class='tc'></li>
70
+ <li class='tr'>git-generate-changelog(1)</li>
71
+ </ol>
72
+
73
+ <h2 id="NAME">NAME</h2>
74
+ <p class="man-name">
75
+ <code>git-generate-changelog</code> - <span class="man-whatis">Generate changelog from GitHub</span>
76
+ </p>
77
+
78
+ <h2 id="SYNOPSIS">SYNOPSIS</h2>
79
+
80
+ <p><code>git generate-changelog</code> [-h|--help] [-u|--user] [-p|--project]</p>
81
+
82
+ <h2 id="DESCRIPTION">DESCRIPTION</h2>
83
+
84
+ <p>Automatically generate changelog from your tags, issues, labels and pull requests on GitHub.</p>
85
+
86
+ <h2 id="OPTIONS">OPTIONS</h2>
87
+
88
+ <p> -u, --user USER</p>
89
+
90
+ <p> Username of the owner of target GitHub repo.</p>
91
+
92
+ <p> -p, --project PROJECT</p>
93
+
94
+ <p> Name of project on GitHub.</p>
95
+
96
+ <p> -t, --token TOKEN</p>
97
+
98
+ <p> To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new</p>
99
+
100
+ <p> -f, --date-format FORMAT</p>
101
+
102
+ <p> Date format. Default is %Y-%m-%d.</p>
103
+
104
+ <p> -o, --output NAME</p>
105
+
106
+ <p> Output file. To print to STDOUT instead, use blank as path. Default is CHANGELOG.md.</p>
107
+
108
+ <p> -b, --base NAME</p>
109
+
110
+ <p> Optional base file to append generated changes to.</p>
111
+
112
+ <p> --summary-label LABEL</p>
113
+
114
+ <p> Set up custom label for the release summary section. Default is "".</p>
115
+
116
+ <p> --breaking-label LABEL</p>
117
+
118
+ <p> Set up custom label for breaking changes section. Default is "<strong>Breaking changes:</strong>".</p>
119
+
120
+ <p> --enhancement-label LABEL</p>
121
+
122
+ <p> Set up custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>".</p>
123
+
124
+ <p> --bugs-label LABEL</p>
125
+
126
+ <p> Set up custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong>".</p>
127
+
128
+ <p> --deprecated-label LABEL</p>
129
+
130
+ <p> Set up custom label for deprecated section. Default is "<strong>Deprecated:</strong>".</p>
131
+
132
+ <p> --removed-label LABEL</p>
133
+
134
+ <p> Set up custom label for removed section. Default is "<strong>Removed:</strong>".</p>
135
+
136
+ <p> --security-label LABEL</p>
137
+
138
+ <p> Set up custom label for security section. Default is "<strong>Security:</strong>".</p>
139
+
140
+ <p> --issues-label LABEL</p>
141
+
142
+ <p> Set up custom label for closed-issues section. Default is "<strong>Closed issues:</strong>".</p>
143
+
144
+ <p> --header-label LABEL</p>
145
+
146
+ <p> Set up custom header label. Default is "# Changelog".</p>
147
+
148
+ <p> --configure-sections HASH, STRING</p>
149
+
150
+ <p> Define your own set of sections which overrides all default sections.</p>
151
+
152
+ <p> --add-sections HASH, STRING</p>
153
+
154
+ <p> Add new sections but keep the default sections.</p>
155
+
156
+ <p> --front-matter JSON</p>
157
+
158
+ <p> Add YAML front matter. Formatted as JSON because it's easier to add on the command line.</p>
159
+
160
+ <p> --pr-label LABEL</p>
161
+
162
+ <p> Set up custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>".</p>
163
+
164
+ <p> --[no-]issues</p>
165
+
166
+ <p> Include closed issues in changelog. Default is true.</p>
167
+
168
+ <p> --[no-]issues-wo-labels</p>
169
+
170
+ <p> Include closed issues without labels in changelog. Default is true.</p>
171
+
172
+ <p> --[no-]pr-wo-labels</p>
173
+
174
+ <p> Include pull requests without labels in changelog. Default is true.</p>
175
+
176
+ <p> --[no-]pull-requests</p>
177
+
178
+ <p> Include pull-requests in changelog. Default is true.</p>
179
+
180
+ <p> --[no-]filter-by-milestone</p>
181
+
182
+ <p> Use milestone to detect when issue was resolved. Default is true.</p>
183
+
184
+ <p> --[no-]issues-of-open-milestones</p>
185
+
186
+ <p> Include issues of open milestones. Default is true.</p>
187
+
188
+ <p> --[no-]author</p>
189
+
190
+ <p> Add author of pull request at the end. Default is true.</p>
191
+
192
+ <p> --usernames-as-github-logins</p>
193
+
194
+ <p> Use GitHub tags instead of Markdown links for the author of an issue or pull-request.</p>
195
+
196
+ <p> --unreleased-only</p>
197
+
198
+ <p> Generate log from unreleased closed issues only.</p>
199
+
200
+ <p> --[no-]unreleased</p>
201
+
202
+ <p> Add to log unreleased closed issues. Default is true.</p>
203
+
204
+ <p> --unreleased-label LABEL</p>
205
+
206
+ <p> Set up custom label for unreleased closed issues section. Default is "<strong>Unreleased:</strong>".</p>
207
+
208
+ <p> --[no-]compare-link</p>
209
+
210
+ <p> Include compare link (Full Changelog) between older version and newer version. Default is true.</p>
211
+
212
+ <p> --include-labels x,y,z</p>
213
+
214
+ <p> Of the labeled issues, only include the ones with the specified labels.</p>
215
+
216
+ <p> --exclude-labels x,y,z</p>
217
+
218
+ <p> Issues with the specified labels will be excluded from changelog. Default is 'duplicate,question,invalid,wontfix'.</p>
219
+
220
+ <p> --summary-labels x,y,z</p>
221
+
222
+ <p> Issues with these labels will be added to a new section, called "Release Summary". The section display only body of issues. Default is 'Release summary,release-summary,Summary,summary'.</p>
223
+
224
+ <p> --breaking-labels x,y,z</p>
225
+
226
+ <p> Issues with these labels will be added to a new section, called "Breaking changes". Default is 'backwards-incompatible,breaking'.</p>
227
+
228
+ <p> --enhancement-labels x,y,z</p>
229
+
230
+ <p> Issues with the specified labels will be added to "Implemented enhancements" section. Default is 'enhancement,Enhancement'.</p>
231
+
232
+ <p> --bug-labels x,y,z</p>
233
+
234
+ <p> Issues with the specified labels will be added to "Fixed bugs" section. Default is 'bug,Bug'.</p>
235
+
236
+ <p> --deprecated-labels x,y,z</p>
237
+
238
+ <p> Issues with the specified labels will be added to a section called "Deprecated". Default is 'deprecated,Deprecated'.</p>
239
+
240
+ <p> --removed-labels x,y,z</p>
241
+
242
+ <p> Issues with the specified labels will be added to a section called "Removed". Default is 'removed,Removed'.</p>
243
+
244
+ <p> --security-labels x,y,z</p>
245
+
246
+ <p> Issues with the specified labels will be added to a section called "Security fixes". Default is 'security,Security'.</p>
247
+
248
+ <p> --issue-line-labels x,y,z</p>
249
+
250
+ <p> The specified labels will be shown in brackets next to each matching issue. Use "ALL" to show all labels. Default is [].</p>
251
+
252
+ <p> --exclude-tags x,y,z</p>
253
+
254
+ <p> Changelog will exclude specified tags.</p>
255
+
256
+ <p> --exclude-tags-regex REGEX</p>
257
+
258
+ <p> Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex ".*+\d{1,}".</p>
259
+
260
+ <p> --since-tag x</p>
261
+
262
+ <p> Changelog will start after specified tag.</p>
263
+
264
+ <p> --due-tag x</p>
265
+
266
+ <p> Changelog will end before specified tag.</p>
267
+
268
+ <p> --since-commit x</p>
269
+
270
+ <p> Fetch only commits after this time. eg. "2017-01-01 10:00:00"</p>
271
+
272
+ <p> --max-issues NUMBER</p>
273
+
274
+ <p> Maximum number of issues to fetch from GitHub. Default is unlimited.</p>
275
+
276
+ <p> --release-url URL</p>
277
+
278
+ <p> The URL to point to for release links, in printf format (with the tag as variable).</p>
279
+
280
+ <p> --github-site URL</p>
281
+
282
+ <p> The Enterprise GitHub site where your project is hosted.</p>
283
+
284
+ <p> --github-api URL</p>
285
+
286
+ <p> The enterprise endpoint to use for your GitHub API.</p>
287
+
288
+ <p> --simple-list</p>
289
+
290
+ <p> Create a simple list from issues and pull requests. Default is false.</p>
291
+
292
+ <p> --future-release RELEASE-VERSION</p>
293
+
294
+ <p> Put the unreleased changes in the specified release number.</p>
295
+
296
+ <p> --release-branch RELEASE-BRANCH</p>
297
+
298
+ <p> Limit pull requests to the release branch, such as master or release.</p>
299
+
300
+ <p> --http-cache</p>
301
+
302
+ <p> Use HTTP Cache to cache GitHub API requests (useful for large repos). Default is true.</p>
303
+
304
+ <p> --[no-]cache-file CACHE-FILE</p>
305
+
306
+ <p> Filename to use for cache. Default is github-changelog-http-cache in a temporary directory.</p>
307
+
308
+ <p> --cache-log CACHE-LOG</p>
309
+
310
+ <p> Filename to use for cache log. Default is github-changelog-logger.log in a temporary directory.</p>
311
+
312
+ <p> --ssl-ca-file PATH</p>
313
+
314
+ <p> Path to cacert.pem file. Default is a bundled lib/github_changelog_generator/ssl_certs/cacert.pem. Respects SSL_CA_PATH.</p>
315
+
316
+ <p> --require file1.rb,file2.rb</p>
317
+
318
+ <p> Paths to Ruby file(s) to require before generating changelog.</p>
319
+
320
+ <p> --[no-]verbose</p>
321
+
322
+ <p> Run verbosely. Default is true.</p>
323
+
324
+ <p> -v, --version</p>
325
+
326
+ <p> Print version number.</p>
327
+
328
+ <p> -h, --help</p>
329
+
330
+ <p> Displays Help.</p>
331
+
332
+ <h2 id="REBASED-COMMITS">REBASED COMMITS</h2>
333
+
334
+ <p>GitHub pull requests that have been merged whose merge commit SHA has been modified through rebasing, cherry picking, or some other method may be tracked via a special comment on GitHub. Git commit SHAs found in comments on pull requests matching the regular expression <code>/rebased commit: ([0-9a-f]{40})/i</code> will be used in place of the original merge SHA when being added to the changelog.</p>
335
+
336
+ <h2 id="EXAMPLES">EXAMPLES</h2>
337
+
338
+ <h2 id="AUTHOR">AUTHOR</h2>
339
+
340
+ <p>Written by Petr Korolev sky4winder@gmail.com</p>
341
+
342
+ <h2 id="REPORTING-BUGS">REPORTING BUGS</h2>
343
+
344
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/issues" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/issues</a>&gt;</p>
345
+
346
+ <h2 id="SEE-ALSO">SEE ALSO</h2>
347
+
348
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/</a>&gt;</p>
349
+
350
+
351
+ <ol class='man-decor man-foot man foot'>
352
+ <li class='tl'></li>
353
+ <li class='tc'>May 2020</li>
354
+ <li class='tr'>git-generate-changelog(1)</li>
355
+ </ol>
356
+
357
+ </div>
358
+ </body>
359
+ </html>
@@ -0,0 +1,270 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
+ <title>git-generate-changelog(1) - Generate changelog from github</title>
7
+ <style type='text/css' media='all'>
8
+ /* style: man */
9
+ body#manpage {margin:0}
10
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
11
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
12
+ .mp h2 {margin:10px 0 0 0}
13
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
14
+ .mp h3 {margin:0 0 0 4ex}
15
+ .mp dt {margin:0;clear:left}
16
+ .mp dt.flush {float:left;width:8ex}
17
+ .mp dd {margin:0 0 0 9ex}
18
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
19
+ .mp pre {margin-bottom:20px}
20
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
21
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
22
+ .mp img {display:block;margin:auto}
23
+ .mp h1.man-title {display:none}
24
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
25
+ .mp h2 {font-size:16px;line-height:1.25}
26
+ .mp h1 {font-size:20px;line-height:2}
27
+ .mp {text-align:justify;background:#fff}
28
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
29
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
30
+ .mp u {text-decoration:underline}
31
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
32
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
33
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
34
+ .mp b.man-ref {font-weight:normal;color:#434241}
35
+ .mp pre {padding:0 4ex}
36
+ .mp pre code {font-weight:normal;color:#434241}
37
+ .mp h2+pre,h3+pre {padding-left:0}
38
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
39
+ ol.man-decor {width:100%}
40
+ ol.man-decor li.tl {text-align:left}
41
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
42
+ ol.man-decor li.tr {text-align:right;float:right}
43
+ </style>
44
+ </head>
45
+ <!--
46
+ The following styles are deprecated and will be removed at some point:
47
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
48
+
49
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
50
+ .man-navigation should be used instead.
51
+ -->
52
+ <body id='manpage'>
53
+ <div class='mp' id='man'>
54
+
55
+ <div class='man-navigation' style='display:none'>
56
+ <a href="#NAME">NAME</a>
57
+ <a href="#SYNOPSIS">SYNOPSIS</a>
58
+ <a href="#DESCRIPTION">DESCRIPTION</a>
59
+ <a href="#OPTIONS">OPTIONS</a>
60
+ <a href="#EXAMPLES">EXAMPLES</a>
61
+ <a href="#AUTHOR">AUTHOR</a>
62
+ <a href="#REPORTING-BUGS">REPORTING BUGS</a>
63
+ <a href="#SEE-ALSO">SEE ALSO</a>
64
+ </div>
65
+
66
+ <ol class='man-decor man-head man head'>
67
+ <li class='tl'>git-generate-changelog(1)</li>
68
+ <li class='tc'></li>
69
+ <li class='tr'>git-generate-changelog(1)</li>
70
+ </ol>
71
+
72
+ <h2 id="NAME">NAME</h2>
73
+ <p class="man-name">
74
+ <code>git-generate-changelog</code> - <span class="man-whatis">Generate changelog from github</span>
75
+ </p>
76
+
77
+ <h2 id="SYNOPSIS">SYNOPSIS</h2>
78
+
79
+ <p><code>git generate-changelog</code> [-h|--help] [-u|--user] [-p|--project]</p>
80
+
81
+ <h2 id="DESCRIPTION">DESCRIPTION</h2>
82
+
83
+ <p>Automatically generate changelog from your tags, issues, labels and pull requests on GitHub.</p>
84
+
85
+ <h2 id="OPTIONS">OPTIONS</h2>
86
+
87
+ <p> -u, --user USER</p>
88
+
89
+ <p> Username of the owner of target GitHub repo</p>
90
+
91
+ <p> -p, --project PROJECT</p>
92
+
93
+ <p> Name of project on GitHub</p>
94
+
95
+ <p> -t, --token TOKEN</p>
96
+
97
+ <p> To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new</p>
98
+
99
+ <p> -f, --date-format FORMAT</p>
100
+
101
+ <p> Date format. Default is %Y-%m-%d</p>
102
+
103
+ <p> -o, --output NAME</p>
104
+
105
+ <p> Output file. Default is CHANGELOG.md</p>
106
+
107
+ <p> -b, --base NAME</p>
108
+
109
+ <p> Optional base file to append generated changes to.</p>
110
+
111
+ <p> --bugs-label LABEL</p>
112
+
113
+ <p> Setup custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong></p>
114
+
115
+ <p> --enhancement-label LABEL</p>
116
+
117
+ <p> Setup custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>"</p>
118
+
119
+ <p> --issues-label LABEL</p>
120
+
121
+ <p> Setup custom label for closed-issues section. Default is "<strong>Closed issues:</strong>"</p>
122
+
123
+ <p> --header-label LABEL</p>
124
+
125
+ <p> Setup custom header label. Default is "# Changelog"</p>
126
+
127
+ <p> --pr-label LABEL</p>
128
+
129
+ <p> Setup custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>"</p>
130
+
131
+ <p> --[no-]issues</p>
132
+
133
+ <p> Include closed issues in changelog. Default is true</p>
134
+
135
+ <p> --[no-]issues-wo-labels</p>
136
+
137
+ <p> Include closed issues without labels in changelog. Default is true</p>
138
+
139
+ <p> --[no-]pr-wo-labels</p>
140
+
141
+ <p> Include pull requests without labels in changelog. Default is true</p>
142
+
143
+ <p> --[no-]pull-requests</p>
144
+
145
+ <p> Include pull-requests in changelog. Default is true</p>
146
+
147
+ <p> --[no-]filter-by-milestone</p>
148
+
149
+ <p> Use milestone to detect when issue was resolved. Default is true</p>
150
+
151
+ <p> --[no-]author</p>
152
+
153
+ <p> Add author of pull-request in the end. Default is true</p>
154
+
155
+ <p> --unreleased-only</p>
156
+
157
+ <p> Generate log from unreleased closed issues only.</p>
158
+
159
+ <p> --[no-]unreleased</p>
160
+
161
+ <p> Add to log unreleased closed issues. Default is true</p>
162
+
163
+ <p> --unreleased-label LABEL</p>
164
+
165
+ <p> Add to log unreleased closed issues. Default is true</p>
166
+
167
+ <p> --[no-]compare-link</p>
168
+
169
+ <p> Include compare link (Full Changelog) between older version and newer version. Default is true</p>
170
+
171
+ <p> --include-labels x,y,z</p>
172
+
173
+ <p> Only issues with the specified labels will be included in the changelog.</p>
174
+
175
+ <p> --exclude-labels x,y,z</p>
176
+
177
+ <p> Issues with the specified labels will be always excluded from changelog. Default is 'duplicate,question,invalid,wontfix'</p>
178
+
179
+ <p> --bug-labels x,y,z</p>
180
+
181
+ <p> Issues with the specified labels will be always added to "Fixed bugs" section. Default is 'bug,Bug'</p>
182
+
183
+ <p> --enhancement-labels x,y,z</p>
184
+
185
+ <p> Issues with the specified labels will be always added to "Implemented enhancements" section. Default is 'enhancement,Enhancement'</p>
186
+
187
+ <p> --exclude-tags x,y,z</p>
188
+
189
+ <p> Changelog will exclude specified tags</p>
190
+
191
+ <p> --since-tag x</p>
192
+
193
+ <p> Changelog will start after specified tag</p>
194
+
195
+ <p> --due-tag x</p>
196
+
197
+ <p> Changelog will end before specified tag</p>
198
+
199
+ <p> --max-issues NUMBER</p>
200
+
201
+ <p> Max number of issues to fetch from GitHub. Default is unlimited</p>
202
+
203
+ <p> --release-url URL</p>
204
+
205
+ <p> The URL to point to for release links, in printf format (with the tag as variable).</p>
206
+
207
+ <p> --github-site URL</p>
208
+
209
+ <p> The Enterprise GitHub site on which your project is hosted.</p>
210
+
211
+ <p> --github-api URL</p>
212
+
213
+ <p> The enterprise endpoint to use for your GitHub API.</p>
214
+
215
+ <p> --simple-list</p>
216
+
217
+ <p> Create simple list from issues and pull requests. Default is false.</p>
218
+
219
+ <p> --future-release RELEASE-VERSION</p>
220
+
221
+ <p> Put the unreleased changes in the specified release number.</p>
222
+
223
+ <p> --configure-sections HASH, STRING</p>
224
+
225
+ <p> Define your own set of sections which overrides all default sections") do |v|</p>
226
+
227
+ <p> --add-sections HASH, STRING</p>
228
+
229
+ <p> Add new sections but keep the default sections"</p>
230
+
231
+ <p> --include-merged</p>
232
+
233
+ <p> If configure_sections is set, use this to restore the merged pull requests sections</p>
234
+
235
+ <p> --[no-]verbose</p>
236
+
237
+ <p> Run verbosely. Default is true</p>
238
+
239
+ <p> -v, --version</p>
240
+
241
+ <p> Print version number</p>
242
+
243
+ <p> -h, --help</p>
244
+
245
+ <p> Displays Help</p>
246
+
247
+ <h2 id="EXAMPLES">EXAMPLES</h2>
248
+
249
+ <h2 id="AUTHOR">AUTHOR</h2>
250
+
251
+ <p>Written by Petr Korolev sky4winder@gmail.com</p>
252
+
253
+ <h2 id="REPORTING-BUGS">REPORTING BUGS</h2>
254
+
255
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/issues" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/issues</a>&gt;</p>
256
+
257
+ <h2 id="SEE-ALSO">SEE ALSO</h2>
258
+
259
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/</a>&gt;</p>
260
+
261
+
262
+ <ol class='man-decor man-foot man foot'>
263
+ <li class='tl'></li>
264
+ <li class='tc'>October 2015</li>
265
+ <li class='tr'>git-generate-changelog(1)</li>
266
+ </ol>
267
+
268
+ </div>
269
+ </body>
270
+ </html>