px_github_changelog_generator 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>