github_changelog_generator 1.16.1 → 1.16.2
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.
- checksums.yaml +4 -4
 - data/README.md +1 -1
 - data/lib/github_changelog_generator/argv_parser.rb +224 -0
 - data/lib/github_changelog_generator/generator/generator_fetcher.rb +4 -5
 - data/lib/github_changelog_generator/generator/generator_processor.rb +2 -1
 - data/lib/github_changelog_generator/octo_fetcher.rb +21 -4
 - data/lib/github_changelog_generator/options.rb +1 -0
 - data/lib/github_changelog_generator/parser.rb +70 -258
 - data/lib/github_changelog_generator/parser_file.rb +28 -13
 - data/lib/github_changelog_generator/ssl_certs/cacert.pem +851 -1680
 - data/lib/github_changelog_generator/version.rb +1 -1
 - data/man/git-generate-changelog.1 +31 -31
 - data/man/git-generate-changelog.1.html +30 -30
 - data/man/git-generate-changelog.html +19 -19
 - data/man/git-generate-changelog.md +31 -31
 - data/spec/files/config_example +5 -0
 - data/spec/unit/parser_spec.rb +50 -0
 - metadata +5 -2
 
| 
         @@ -13,115 +13,115 @@ 
     | 
|
| 
       13 
13 
     | 
    
         
             
            Automatically generate changelog from your tags, issues, labels and pull requests on GitHub\.
         
     | 
| 
       14 
14 
     | 
    
         
             
            .
         
     | 
| 
       15 
15 
     | 
    
         
             
            .SH "OPTIONS"
         
     | 
| 
       16 
     | 
    
         
            -
            \-u, \-\-user  
     | 
| 
      
 16 
     | 
    
         
            +
            \-u, \-\-user USER
         
     | 
| 
       17 
17 
     | 
    
         
             
            .
         
     | 
| 
       18 
18 
     | 
    
         
             
            .P
         
     | 
| 
       19 
19 
     | 
    
         
             
            Username of the owner of target GitHub repo\.
         
     | 
| 
       20 
20 
     | 
    
         
             
            .
         
     | 
| 
       21 
21 
     | 
    
         
             
            .P
         
     | 
| 
       22 
     | 
    
         
            -
            \-p, \-\-project  
     | 
| 
      
 22 
     | 
    
         
            +
            \-p, \-\-project PROJECT
         
     | 
| 
       23 
23 
     | 
    
         
             
            .
         
     | 
| 
       24 
24 
     | 
    
         
             
            .P
         
     | 
| 
       25 
25 
     | 
    
         
             
            Name of project on GitHub\.
         
     | 
| 
       26 
26 
     | 
    
         
             
            .
         
     | 
| 
       27 
27 
     | 
    
         
             
            .P
         
     | 
| 
       28 
     | 
    
         
            -
            \-t, \-\-token  
     | 
| 
      
 28 
     | 
    
         
            +
            \-t, \-\-token TOKEN
         
     | 
| 
       29 
29 
     | 
    
         
             
            .
         
     | 
| 
       30 
30 
     | 
    
         
             
            .P
         
     | 
| 
       31 
31 
     | 
    
         
             
            To make more than 50 requests per hour your GitHub token is required\. You can generate it at: https://github\.com/settings/tokens/new
         
     | 
| 
       32 
32 
     | 
    
         
             
            .
         
     | 
| 
       33 
33 
     | 
    
         
             
            .P
         
     | 
| 
       34 
     | 
    
         
            -
            \-f, \-\-date\-format  
     | 
| 
      
 34 
     | 
    
         
            +
            \-f, \-\-date\-format FORMAT
         
     | 
| 
       35 
35 
     | 
    
         
             
            .
         
     | 
| 
       36 
36 
     | 
    
         
             
            .P
         
     | 
| 
       37 
37 
     | 
    
         
             
            Date format\. Default is %Y\-%m\-%d\.
         
     | 
| 
       38 
38 
     | 
    
         
             
            .
         
     | 
| 
       39 
39 
     | 
    
         
             
            .P
         
     | 
| 
       40 
     | 
    
         
            -
            \-o, \-\-output  
     | 
| 
      
 40 
     | 
    
         
            +
            \-o, \-\-output NAME
         
     | 
| 
       41 
41 
     | 
    
         
             
            .
         
     | 
| 
       42 
42 
     | 
    
         
             
            .P
         
     | 
| 
       43 
43 
     | 
    
         
             
            Output file\. To print to STDOUT instead, use blank as path\. Default is CHANGELOG\.md\.
         
     | 
| 
       44 
44 
     | 
    
         
             
            .
         
     | 
| 
       45 
45 
     | 
    
         
             
            .P
         
     | 
| 
       46 
     | 
    
         
            -
            \-b, \-\-base  
     | 
| 
      
 46 
     | 
    
         
            +
            \-b, \-\-base NAME
         
     | 
| 
       47 
47 
     | 
    
         
             
            .
         
     | 
| 
       48 
48 
     | 
    
         
             
            .P
         
     | 
| 
       49 
     | 
    
         
            -
            Optional base file to append generated changes to\.
         
     | 
| 
      
 49 
     | 
    
         
            +
            Optional base file to append generated changes to\. Default is HISTORY\.md\.
         
     | 
| 
       50 
50 
     | 
    
         
             
            .
         
     | 
| 
       51 
51 
     | 
    
         
             
            .P
         
     | 
| 
       52 
     | 
    
         
            -
            \-\-summary\-label  
     | 
| 
      
 52 
     | 
    
         
            +
            \-\-summary\-label LABEL
         
     | 
| 
       53 
53 
     | 
    
         
             
            .
         
     | 
| 
       54 
54 
     | 
    
         
             
            .P
         
     | 
| 
       55 
55 
     | 
    
         
             
            Set up custom label for the release summary section\. Default is ""\.
         
     | 
| 
       56 
56 
     | 
    
         
             
            .
         
     | 
| 
       57 
57 
     | 
    
         
             
            .P
         
     | 
| 
       58 
     | 
    
         
            -
            \-\-breaking\-label  
     | 
| 
      
 58 
     | 
    
         
            +
            \-\-breaking\-label LABEL
         
     | 
| 
       59 
59 
     | 
    
         
             
            .
         
     | 
| 
       60 
60 
     | 
    
         
             
            .P
         
     | 
| 
       61 
61 
     | 
    
         
             
            Set up custom label for breaking changes section\. Default is "\fBBreaking changes:\fR"\.
         
     | 
| 
       62 
62 
     | 
    
         
             
            .
         
     | 
| 
       63 
63 
     | 
    
         
             
            .P
         
     | 
| 
       64 
     | 
    
         
            -
            \-\-enhancement\-label  
     | 
| 
      
 64 
     | 
    
         
            +
            \-\-enhancement\-label LABEL
         
     | 
| 
       65 
65 
     | 
    
         
             
            .
         
     | 
| 
       66 
66 
     | 
    
         
             
            .P
         
     | 
| 
       67 
67 
     | 
    
         
             
            Set up custom label for enhancements section\. Default is "\fBImplemented enhancements:\fR"\.
         
     | 
| 
       68 
68 
     | 
    
         
             
            .
         
     | 
| 
       69 
69 
     | 
    
         
             
            .P
         
     | 
| 
       70 
     | 
    
         
            -
            \-\-bugs\-label  
     | 
| 
      
 70 
     | 
    
         
            +
            \-\-bugs\-label LABEL
         
     | 
| 
       71 
71 
     | 
    
         
             
            .
         
     | 
| 
       72 
72 
     | 
    
         
             
            .P
         
     | 
| 
       73 
73 
     | 
    
         
             
            Set up custom label for bug\-fixes section\. Default is "\fBFixed bugs:\fR"\.
         
     | 
| 
       74 
74 
     | 
    
         
             
            .
         
     | 
| 
       75 
75 
     | 
    
         
             
            .P
         
     | 
| 
       76 
     | 
    
         
            -
            \-\-deprecated\-label  
     | 
| 
      
 76 
     | 
    
         
            +
            \-\-deprecated\-label LABEL
         
     | 
| 
       77 
77 
     | 
    
         
             
            .
         
     | 
| 
       78 
78 
     | 
    
         
             
            .P
         
     | 
| 
       79 
79 
     | 
    
         
             
            Set up custom label for deprecated section\. Default is "\fBDeprecated:\fR"\.
         
     | 
| 
       80 
80 
     | 
    
         
             
            .
         
     | 
| 
       81 
81 
     | 
    
         
             
            .P
         
     | 
| 
       82 
     | 
    
         
            -
            \-\-removed\-label  
     | 
| 
      
 82 
     | 
    
         
            +
            \-\-removed\-label LABEL
         
     | 
| 
       83 
83 
     | 
    
         
             
            .
         
     | 
| 
       84 
84 
     | 
    
         
             
            .P
         
     | 
| 
       85 
85 
     | 
    
         
             
            Set up custom label for removed section\. Default is "\fBRemoved:\fR"\.
         
     | 
| 
       86 
86 
     | 
    
         
             
            .
         
     | 
| 
       87 
87 
     | 
    
         
             
            .P
         
     | 
| 
       88 
     | 
    
         
            -
            \-\-security\-label  
     | 
| 
      
 88 
     | 
    
         
            +
            \-\-security\-label LABEL
         
     | 
| 
       89 
89 
     | 
    
         
             
            .
         
     | 
| 
       90 
90 
     | 
    
         
             
            .P
         
     | 
| 
       91 
91 
     | 
    
         
             
            Set up custom label for security section\. Default is "\fBSecurity:\fR"\.
         
     | 
| 
       92 
92 
     | 
    
         
             
            .
         
     | 
| 
       93 
93 
     | 
    
         
             
            .P
         
     | 
| 
       94 
     | 
    
         
            -
            \-\-issues\-label  
     | 
| 
      
 94 
     | 
    
         
            +
            \-\-issues\-label LABEL
         
     | 
| 
       95 
95 
     | 
    
         
             
            .
         
     | 
| 
       96 
96 
     | 
    
         
             
            .P
         
     | 
| 
       97 
97 
     | 
    
         
             
            Set up custom label for closed\-issues section\. Default is "\fBClosed issues:\fR"\.
         
     | 
| 
       98 
98 
     | 
    
         
             
            .
         
     | 
| 
       99 
99 
     | 
    
         
             
            .P
         
     | 
| 
       100 
     | 
    
         
            -
            \-\-header\-label  
     | 
| 
      
 100 
     | 
    
         
            +
            \-\-header\-label LABEL
         
     | 
| 
       101 
101 
     | 
    
         
             
            .
         
     | 
| 
       102 
102 
     | 
    
         
             
            .P
         
     | 
| 
       103 
103 
     | 
    
         
             
            Set up custom header label\. Default is "# Changelog"\.
         
     | 
| 
       104 
104 
     | 
    
         
             
            .
         
     | 
| 
       105 
105 
     | 
    
         
             
            .P
         
     | 
| 
       106 
     | 
    
         
            -
            \-\-configure\-sections  
     | 
| 
      
 106 
     | 
    
         
            +
            \-\-configure\-sections HASH, STRING
         
     | 
| 
       107 
107 
     | 
    
         
             
            .
         
     | 
| 
       108 
108 
     | 
    
         
             
            .P
         
     | 
| 
       109 
109 
     | 
    
         
             
            Define your own set of sections which overrides all default sections\.
         
     | 
| 
       110 
110 
     | 
    
         
             
            .
         
     | 
| 
       111 
111 
     | 
    
         
             
            .P
         
     | 
| 
       112 
     | 
    
         
            -
            \-\-add\-sections  
     | 
| 
      
 112 
     | 
    
         
            +
            \-\-add\-sections HASH, STRING
         
     | 
| 
       113 
113 
     | 
    
         
             
            .
         
     | 
| 
       114 
114 
     | 
    
         
             
            .P
         
     | 
| 
       115 
115 
     | 
    
         
             
            Add new sections but keep the default sections\.
         
     | 
| 
       116 
116 
     | 
    
         
             
            .
         
     | 
| 
       117 
117 
     | 
    
         
             
            .P
         
     | 
| 
       118 
     | 
    
         
            -
            \-\-front\-matter  
     | 
| 
      
 118 
     | 
    
         
            +
            \-\-front\-matter JSON
         
     | 
| 
       119 
119 
     | 
    
         
             
            .
         
     | 
| 
       120 
120 
     | 
    
         
             
            .P
         
     | 
| 
       121 
121 
     | 
    
         
             
            Add YAML front matter\. Formatted as JSON because it\'s easier to add on the command line\.
         
     | 
| 
       122 
122 
     | 
    
         
             
            .
         
     | 
| 
       123 
123 
     | 
    
         
             
            .P
         
     | 
| 
       124 
     | 
    
         
            -
            \-\-pr\-label  
     | 
| 
      
 124 
     | 
    
         
            +
            \-\-pr\-label LABEL
         
     | 
| 
       125 
125 
     | 
    
         
             
            .
         
     | 
| 
       126 
126 
     | 
    
         
             
            .P
         
     | 
| 
       127 
127 
     | 
    
         
             
            Set up custom label for pull requests section\. Default is "\fBMerged pull requests:\fR"\.
         
     | 
| 
         @@ -187,7 +187,7 @@ Generate log from unreleased closed issues only\. 
     | 
|
| 
       187 
187 
     | 
    
         
             
            Add to log unreleased closed issues\. Default is true\.
         
     | 
| 
       188 
188 
     | 
    
         
             
            .
         
     | 
| 
       189 
189 
     | 
    
         
             
            .P
         
     | 
| 
       190 
     | 
    
         
            -
            \-\-unreleased\-label  
     | 
| 
      
 190 
     | 
    
         
            +
            \-\-unreleased\-label LABEL
         
     | 
| 
       191 
191 
     | 
    
         
             
            .
         
     | 
| 
       192 
192 
     | 
    
         
             
            .P
         
     | 
| 
       193 
193 
     | 
    
         
             
            Set up custom label for unreleased closed issues section\. Default is "\fBUnreleased:\fR"\.
         
     | 
| 
         @@ -265,7 +265,7 @@ The specified labels will be shown in brackets next to each matching issue\. Use 
     | 
|
| 
       265 
265 
     | 
    
         
             
            Changelog will exclude specified tags\.
         
     | 
| 
       266 
266 
     | 
    
         
             
            .
         
     | 
| 
       267 
267 
     | 
    
         
             
            .P
         
     | 
| 
       268 
     | 
    
         
            -
            \-\-exclude\-tags\-regex  
     | 
| 
      
 268 
     | 
    
         
            +
            \-\-exclude\-tags\-regex REGEX
         
     | 
| 
       269 
269 
     | 
    
         
             
            .
         
     | 
| 
       270 
270 
     | 
    
         
             
            .P
         
     | 
| 
       271 
271 
     | 
    
         
             
            Apply a regular expression on tag names so that they can be excluded, for example: \-\-exclude\-tags\-regex "\.*+\ed{1,}"\.
         
     | 
| 
         @@ -289,25 +289,25 @@ Changelog will end before specified tag\. 
     | 
|
| 
       289 
289 
     | 
    
         
             
            Fetch only commits after this time\. eg\. "2017\-01\-01 10:00:00"
         
     | 
| 
       290 
290 
     | 
    
         
             
            .
         
     | 
| 
       291 
291 
     | 
    
         
             
            .P
         
     | 
| 
       292 
     | 
    
         
            -
            \-\-max\-issues  
     | 
| 
      
 292 
     | 
    
         
            +
            \-\-max\-issues NUMBER
         
     | 
| 
       293 
293 
     | 
    
         
             
            .
         
     | 
| 
       294 
294 
     | 
    
         
             
            .P
         
     | 
| 
       295 
295 
     | 
    
         
             
            Maximum number of issues to fetch from GitHub\. Default is unlimited\.
         
     | 
| 
       296 
296 
     | 
    
         
             
            .
         
     | 
| 
       297 
297 
     | 
    
         
             
            .P
         
     | 
| 
       298 
     | 
    
         
            -
            \-\-release\-url  
     | 
| 
      
 298 
     | 
    
         
            +
            \-\-release\-url URL
         
     | 
| 
       299 
299 
     | 
    
         
             
            .
         
     | 
| 
       300 
300 
     | 
    
         
             
            .P
         
     | 
| 
       301 
301 
     | 
    
         
             
            The URL to point to for release links, in printf format (with the tag as variable)\.
         
     | 
| 
       302 
302 
     | 
    
         
             
            .
         
     | 
| 
       303 
303 
     | 
    
         
             
            .P
         
     | 
| 
       304 
     | 
    
         
            -
            \-\-github\-site  
     | 
| 
      
 304 
     | 
    
         
            +
            \-\-github\-site URL
         
     | 
| 
       305 
305 
     | 
    
         
             
            .
         
     | 
| 
       306 
306 
     | 
    
         
             
            .P
         
     | 
| 
       307 
307 
     | 
    
         
             
            The Enterprise GitHub site where your project is hosted\.
         
     | 
| 
       308 
308 
     | 
    
         
             
            .
         
     | 
| 
       309 
309 
     | 
    
         
             
            .P
         
     | 
| 
       310 
     | 
    
         
            -
            \-\-github\-api  
     | 
| 
      
 310 
     | 
    
         
            +
            \-\-github\-api URL
         
     | 
| 
       311 
311 
     | 
    
         
             
            .
         
     | 
| 
       312 
312 
     | 
    
         
             
            .P
         
     | 
| 
       313 
313 
     | 
    
         
             
            The enterprise endpoint to use for your GitHub API\.
         
     | 
| 
         @@ -319,13 +319,13 @@ The enterprise endpoint to use for your GitHub API\. 
     | 
|
| 
       319 
319 
     | 
    
         
             
            Create a simple list from issues and pull requests\. Default is false\.
         
     | 
| 
       320 
320 
     | 
    
         
             
            .
         
     | 
| 
       321 
321 
     | 
    
         
             
            .P
         
     | 
| 
       322 
     | 
    
         
            -
            \-\-future\-release  
     | 
| 
      
 322 
     | 
    
         
            +
            \-\-future\-release RELEASE\-VERSION
         
     | 
| 
       323 
323 
     | 
    
         
             
            .
         
     | 
| 
       324 
324 
     | 
    
         
             
            .P
         
     | 
| 
       325 
325 
     | 
    
         
             
            Put the unreleased changes in the specified release number\.
         
     | 
| 
       326 
326 
     | 
    
         
             
            .
         
     | 
| 
       327 
327 
     | 
    
         
             
            .P
         
     | 
| 
       328 
     | 
    
         
            -
            \-\-release\-branch  
     | 
| 
      
 328 
     | 
    
         
            +
            \-\-release\-branch RELEASE\-BRANCH
         
     | 
| 
       329 
329 
     | 
    
         
             
            .
         
     | 
| 
       330 
330 
     | 
    
         
             
            .P
         
     | 
| 
       331 
331 
     | 
    
         
             
            Limit pull requests to the release branch, such as master or release\.
         
     | 
| 
         @@ -337,19 +337,19 @@ Limit pull requests to the release branch, such as master or release\. 
     | 
|
| 
       337 
337 
     | 
    
         
             
            Use HTTP Cache to cache GitHub API requests (useful for large repos)\. Default is true\.
         
     | 
| 
       338 
338 
     | 
    
         
             
            .
         
     | 
| 
       339 
339 
     | 
    
         
             
            .P
         
     | 
| 
       340 
     | 
    
         
            -
            \-\-[no\-]cache\-file  
     | 
| 
      
 340 
     | 
    
         
            +
            \-\-[no\-]cache\-file CACHE\-FILE
         
     | 
| 
       341 
341 
     | 
    
         
             
            .
         
     | 
| 
       342 
342 
     | 
    
         
             
            .P
         
     | 
| 
       343 
343 
     | 
    
         
             
            Filename to use for cache\. Default is github\-changelog\-http\-cache in a temporary directory\.
         
     | 
| 
       344 
344 
     | 
    
         
             
            .
         
     | 
| 
       345 
345 
     | 
    
         
             
            .P
         
     | 
| 
       346 
     | 
    
         
            -
            \-\-cache\-log  
     | 
| 
      
 346 
     | 
    
         
            +
            \-\-cache\-log CACHE\-LOG
         
     | 
| 
       347 
347 
     | 
    
         
             
            .
         
     | 
| 
       348 
348 
     | 
    
         
             
            .P
         
     | 
| 
       349 
349 
     | 
    
         
             
            Filename to use for cache log\. Default is github\-changelog\-logger\.log in a temporary directory\.
         
     | 
| 
       350 
350 
     | 
    
         
             
            .
         
     | 
| 
       351 
351 
     | 
    
         
             
            .P
         
     | 
| 
       352 
     | 
    
         
            -
            \-\-ssl\-ca\-file  
     | 
| 
      
 352 
     | 
    
         
            +
            \-\-ssl\-ca\-file PATH
         
     | 
| 
       353 
353 
     | 
    
         
             
            .
         
     | 
| 
       354 
354 
     | 
    
         
             
            .P
         
     | 
| 
       355 
355 
     | 
    
         
             
            Path to cacert\.pem file\. Default is a bundled lib/github_changelog_generator/ssl_certs/cacert\.pem\. Respects SSL_CA_PATH\.
         
     | 
| 
         @@ -85,79 +85,79 @@ 
     | 
|
| 
       85 
85 
     | 
    
         | 
| 
       86 
86 
     | 
    
         
             
            <h2 id="OPTIONS">OPTIONS</h2>
         
     | 
| 
       87 
87 
     | 
    
         | 
| 
       88 
     | 
    
         
            -
            <p>  -u, --user  
     | 
| 
      
 88 
     | 
    
         
            +
            <p>  -u, --user USER</p>
         
     | 
| 
       89 
89 
     | 
    
         | 
| 
       90 
90 
     | 
    
         
             
            <p>  Username of the owner of target GitHub repo.</p>
         
     | 
| 
       91 
91 
     | 
    
         | 
| 
       92 
     | 
    
         
            -
            <p>  -p, --project  
     | 
| 
      
 92 
     | 
    
         
            +
            <p>  -p, --project PROJECT</p>
         
     | 
| 
       93 
93 
     | 
    
         | 
| 
       94 
94 
     | 
    
         
             
            <p>  Name of project on GitHub.</p>
         
     | 
| 
       95 
95 
     | 
    
         | 
| 
       96 
     | 
    
         
            -
            <p>  -t, --token  
     | 
| 
      
 96 
     | 
    
         
            +
            <p>  -t, --token TOKEN</p>
         
     | 
| 
       97 
97 
     | 
    
         | 
| 
       98 
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 
99 
     | 
    
         | 
| 
       100 
     | 
    
         
            -
            <p>  -f, --date-format  
     | 
| 
      
 100 
     | 
    
         
            +
            <p>  -f, --date-format FORMAT</p>
         
     | 
| 
       101 
101 
     | 
    
         | 
| 
       102 
102 
     | 
    
         
             
            <p>  Date format. Default is %Y-%m-%d.</p>
         
     | 
| 
       103 
103 
     | 
    
         | 
| 
       104 
     | 
    
         
            -
            <p>  -o, --output  
     | 
| 
      
 104 
     | 
    
         
            +
            <p>  -o, --output NAME</p>
         
     | 
| 
       105 
105 
     | 
    
         | 
| 
       106 
106 
     | 
    
         
             
            <p>  Output file. To print to STDOUT instead, use blank as path. Default is CHANGELOG.md.</p>
         
     | 
| 
       107 
107 
     | 
    
         | 
| 
       108 
     | 
    
         
            -
            <p>  -b, --base  
     | 
| 
      
 108 
     | 
    
         
            +
            <p>  -b, --base NAME</p>
         
     | 
| 
       109 
109 
     | 
    
         | 
| 
       110 
110 
     | 
    
         
             
            <p>  Optional base file to append generated changes to.</p>
         
     | 
| 
       111 
111 
     | 
    
         | 
| 
       112 
     | 
    
         
            -
            <p>  --summary-label  
     | 
| 
      
 112 
     | 
    
         
            +
            <p>  --summary-label LABEL</p>
         
     | 
| 
       113 
113 
     | 
    
         | 
| 
       114 
114 
     | 
    
         
             
            <p>  Set up custom label for the release summary section. Default is "".</p>
         
     | 
| 
       115 
115 
     | 
    
         | 
| 
       116 
     | 
    
         
            -
            <p>  --breaking-label  
     | 
| 
      
 116 
     | 
    
         
            +
            <p>  --breaking-label LABEL</p>
         
     | 
| 
       117 
117 
     | 
    
         | 
| 
       118 
118 
     | 
    
         
             
            <p>  Set up custom label for breaking changes section. Default is "<strong>Breaking changes:</strong>".</p>
         
     | 
| 
       119 
119 
     | 
    
         | 
| 
       120 
     | 
    
         
            -
            <p>  --enhancement-label  
     | 
| 
      
 120 
     | 
    
         
            +
            <p>  --enhancement-label LABEL</p>
         
     | 
| 
       121 
121 
     | 
    
         | 
| 
       122 
122 
     | 
    
         
             
            <p>  Set up custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>".</p>
         
     | 
| 
       123 
123 
     | 
    
         | 
| 
       124 
     | 
    
         
            -
            <p>  --bugs-label  
     | 
| 
      
 124 
     | 
    
         
            +
            <p>  --bugs-label LABEL</p>
         
     | 
| 
       125 
125 
     | 
    
         | 
| 
       126 
126 
     | 
    
         
             
            <p>  Set up custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong>".</p>
         
     | 
| 
       127 
127 
     | 
    
         | 
| 
       128 
     | 
    
         
            -
            <p>  --deprecated-label  
     | 
| 
      
 128 
     | 
    
         
            +
            <p>  --deprecated-label LABEL</p>
         
     | 
| 
       129 
129 
     | 
    
         | 
| 
       130 
130 
     | 
    
         
             
            <p>  Set up custom label for deprecated section. Default is "<strong>Deprecated:</strong>".</p>
         
     | 
| 
       131 
131 
     | 
    
         | 
| 
       132 
     | 
    
         
            -
            <p>  --removed-label  
     | 
| 
      
 132 
     | 
    
         
            +
            <p>  --removed-label LABEL</p>
         
     | 
| 
       133 
133 
     | 
    
         | 
| 
       134 
134 
     | 
    
         
             
            <p>  Set up custom label for removed section. Default is "<strong>Removed:</strong>".</p>
         
     | 
| 
       135 
135 
     | 
    
         | 
| 
       136 
     | 
    
         
            -
            <p>  --security-label  
     | 
| 
      
 136 
     | 
    
         
            +
            <p>  --security-label LABEL</p>
         
     | 
| 
       137 
137 
     | 
    
         | 
| 
       138 
138 
     | 
    
         
             
            <p>  Set up custom label for security section. Default is "<strong>Security:</strong>".</p>
         
     | 
| 
       139 
139 
     | 
    
         | 
| 
       140 
     | 
    
         
            -
            <p>  --issues-label  
     | 
| 
      
 140 
     | 
    
         
            +
            <p>  --issues-label LABEL</p>
         
     | 
| 
       141 
141 
     | 
    
         | 
| 
       142 
142 
     | 
    
         
             
            <p>  Set up custom label for closed-issues section. Default is "<strong>Closed issues:</strong>".</p>
         
     | 
| 
       143 
143 
     | 
    
         | 
| 
       144 
     | 
    
         
            -
            <p>  --header-label  
     | 
| 
      
 144 
     | 
    
         
            +
            <p>  --header-label LABEL</p>
         
     | 
| 
       145 
145 
     | 
    
         | 
| 
       146 
146 
     | 
    
         
             
            <p>  Set up custom header label. Default is "# Changelog".</p>
         
     | 
| 
       147 
147 
     | 
    
         | 
| 
       148 
     | 
    
         
            -
            <p>  --configure-sections  
     | 
| 
      
 148 
     | 
    
         
            +
            <p>  --configure-sections HASH, STRING</p>
         
     | 
| 
       149 
149 
     | 
    
         | 
| 
       150 
150 
     | 
    
         
             
            <p>  Define your own set of sections which overrides all default sections.</p>
         
     | 
| 
       151 
151 
     | 
    
         | 
| 
       152 
     | 
    
         
            -
            <p>  --add-sections  
     | 
| 
      
 152 
     | 
    
         
            +
            <p>  --add-sections HASH, STRING</p>
         
     | 
| 
       153 
153 
     | 
    
         | 
| 
       154 
154 
     | 
    
         
             
            <p>  Add new sections but keep the default sections.</p>
         
     | 
| 
       155 
155 
     | 
    
         | 
| 
       156 
     | 
    
         
            -
            <p>  --front-matter  
     | 
| 
      
 156 
     | 
    
         
            +
            <p>  --front-matter JSON</p>
         
     | 
| 
       157 
157 
     | 
    
         | 
| 
       158 
158 
     | 
    
         
             
            <p>  Add YAML front matter. Formatted as JSON because it's easier to add on the command line.</p>
         
     | 
| 
       159 
159 
     | 
    
         | 
| 
       160 
     | 
    
         
            -
            <p>  --pr-label  
     | 
| 
      
 160 
     | 
    
         
            +
            <p>  --pr-label LABEL</p>
         
     | 
| 
       161 
161 
     | 
    
         | 
| 
       162 
162 
     | 
    
         
             
            <p>  Set up custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>".</p>
         
     | 
| 
       163 
163 
     | 
    
         | 
| 
         @@ -201,7 +201,7 @@ 
     | 
|
| 
       201 
201 
     | 
    
         | 
| 
       202 
202 
     | 
    
         
             
            <p>  Add to log unreleased closed issues. Default is true.</p>
         
     | 
| 
       203 
203 
     | 
    
         | 
| 
       204 
     | 
    
         
            -
            <p>  --unreleased-label  
     | 
| 
      
 204 
     | 
    
         
            +
            <p>  --unreleased-label LABEL</p>
         
     | 
| 
       205 
205 
     | 
    
         | 
| 
       206 
206 
     | 
    
         
             
            <p>  Set up custom label for unreleased closed issues section. Default is "<strong>Unreleased:</strong>".</p>
         
     | 
| 
       207 
207 
     | 
    
         | 
| 
         @@ -253,7 +253,7 @@ 
     | 
|
| 
       253 
253 
     | 
    
         | 
| 
       254 
254 
     | 
    
         
             
            <p>  Changelog will exclude specified tags.</p>
         
     | 
| 
       255 
255 
     | 
    
         | 
| 
       256 
     | 
    
         
            -
            <p>  --exclude-tags-regex  
     | 
| 
      
 256 
     | 
    
         
            +
            <p>  --exclude-tags-regex REGEX</p>
         
     | 
| 
       257 
257 
     | 
    
         | 
| 
       258 
258 
     | 
    
         
             
            <p>  Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex ".*+\d{1,}".</p>
         
     | 
| 
       259 
259 
     | 
    
         | 
| 
         @@ -269,19 +269,19 @@ 
     | 
|
| 
       269 
269 
     | 
    
         | 
| 
       270 
270 
     | 
    
         
             
            <p>  Fetch only commits after this time. eg. "2017-01-01 10:00:00"</p>
         
     | 
| 
       271 
271 
     | 
    
         | 
| 
       272 
     | 
    
         
            -
            <p>  --max-issues  
     | 
| 
      
 272 
     | 
    
         
            +
            <p>  --max-issues NUMBER</p>
         
     | 
| 
       273 
273 
     | 
    
         | 
| 
       274 
274 
     | 
    
         
             
            <p>  Maximum number of issues to fetch from GitHub. Default is unlimited.</p>
         
     | 
| 
       275 
275 
     | 
    
         | 
| 
       276 
     | 
    
         
            -
            <p>  --release-url  
     | 
| 
      
 276 
     | 
    
         
            +
            <p>  --release-url URL</p>
         
     | 
| 
       277 
277 
     | 
    
         | 
| 
       278 
278 
     | 
    
         
             
            <p>  The URL to point to for release links, in printf format (with the tag as variable).</p>
         
     | 
| 
       279 
279 
     | 
    
         | 
| 
       280 
     | 
    
         
            -
            <p>  --github-site  
     | 
| 
      
 280 
     | 
    
         
            +
            <p>  --github-site URL</p>
         
     | 
| 
       281 
281 
     | 
    
         | 
| 
       282 
282 
     | 
    
         
             
            <p>  The Enterprise GitHub site where your project is hosted.</p>
         
     | 
| 
       283 
283 
     | 
    
         | 
| 
       284 
     | 
    
         
            -
            <p>  --github-api  
     | 
| 
      
 284 
     | 
    
         
            +
            <p>  --github-api URL</p>
         
     | 
| 
       285 
285 
     | 
    
         | 
| 
       286 
286 
     | 
    
         
             
            <p>  The enterprise endpoint to use for your GitHub API.</p>
         
     | 
| 
       287 
287 
     | 
    
         | 
| 
         @@ -289,11 +289,11 @@ 
     | 
|
| 
       289 
289 
     | 
    
         | 
| 
       290 
290 
     | 
    
         
             
            <p>  Create a simple list from issues and pull requests. Default is false.</p>
         
     | 
| 
       291 
291 
     | 
    
         | 
| 
       292 
     | 
    
         
            -
            <p>  --future-release  
     | 
| 
      
 292 
     | 
    
         
            +
            <p>  --future-release RELEASE-VERSION</p>
         
     | 
| 
       293 
293 
     | 
    
         | 
| 
       294 
294 
     | 
    
         
             
            <p>  Put the unreleased changes in the specified release number.</p>
         
     | 
| 
       295 
295 
     | 
    
         | 
| 
       296 
     | 
    
         
            -
            <p>  --release-branch  
     | 
| 
      
 296 
     | 
    
         
            +
            <p>  --release-branch RELEASE-BRANCH</p>
         
     | 
| 
       297 
297 
     | 
    
         | 
| 
       298 
298 
     | 
    
         
             
            <p>  Limit pull requests to the release branch, such as master or release.</p>
         
     | 
| 
       299 
299 
     | 
    
         | 
| 
         @@ -301,15 +301,15 @@ 
     | 
|
| 
       301 
301 
     | 
    
         | 
| 
       302 
302 
     | 
    
         
             
            <p>  Use HTTP Cache to cache GitHub API requests (useful for large repos). Default is true.</p>
         
     | 
| 
       303 
303 
     | 
    
         | 
| 
       304 
     | 
    
         
            -
            <p>  --[no-]cache-file  
     | 
| 
      
 304 
     | 
    
         
            +
            <p>  --[no-]cache-file CACHE-FILE</p>
         
     | 
| 
       305 
305 
     | 
    
         | 
| 
       306 
306 
     | 
    
         
             
            <p>  Filename to use for cache. Default is github-changelog-http-cache in a temporary directory.</p>
         
     | 
| 
       307 
307 
     | 
    
         | 
| 
       308 
     | 
    
         
            -
            <p>  --cache-log  
     | 
| 
      
 308 
     | 
    
         
            +
            <p>  --cache-log CACHE-LOG</p>
         
     | 
| 
       309 
309 
     | 
    
         | 
| 
       310 
310 
     | 
    
         
             
            <p>  Filename to use for cache log. Default is github-changelog-logger.log in a temporary directory.</p>
         
     | 
| 
       311 
311 
     | 
    
         | 
| 
       312 
     | 
    
         
            -
            <p>  --ssl-ca-file  
     | 
| 
      
 312 
     | 
    
         
            +
            <p>  --ssl-ca-file PATH</p>
         
     | 
| 
       313 
313 
     | 
    
         | 
| 
       314 
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 
315 
     | 
    
         | 
| 
         @@ -84,47 +84,47 @@ 
     | 
|
| 
       84 
84 
     | 
    
         | 
| 
       85 
85 
     | 
    
         
             
            <h2 id="OPTIONS">OPTIONS</h2>
         
     | 
| 
       86 
86 
     | 
    
         | 
| 
       87 
     | 
    
         
            -
            <p>  -u, --user  
     | 
| 
      
 87 
     | 
    
         
            +
            <p>  -u, --user USER</p>
         
     | 
| 
       88 
88 
     | 
    
         | 
| 
       89 
89 
     | 
    
         
             
            <p>  Username of the owner of target GitHub repo</p>
         
     | 
| 
       90 
90 
     | 
    
         | 
| 
       91 
     | 
    
         
            -
            <p>  -p, --project  
     | 
| 
      
 91 
     | 
    
         
            +
            <p>  -p, --project PROJECT</p>
         
     | 
| 
       92 
92 
     | 
    
         | 
| 
       93 
93 
     | 
    
         
             
            <p>  Name of project on GitHub</p>
         
     | 
| 
       94 
94 
     | 
    
         | 
| 
       95 
     | 
    
         
            -
            <p>  -t, --token  
     | 
| 
      
 95 
     | 
    
         
            +
            <p>  -t, --token TOKEN</p>
         
     | 
| 
       96 
96 
     | 
    
         | 
| 
       97 
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 
98 
     | 
    
         | 
| 
       99 
     | 
    
         
            -
            <p>  -f, --date-format  
     | 
| 
      
 99 
     | 
    
         
            +
            <p>  -f, --date-format FORMAT</p>
         
     | 
| 
       100 
100 
     | 
    
         | 
| 
       101 
101 
     | 
    
         
             
            <p>  Date format. Default is %Y-%m-%d</p>
         
     | 
| 
       102 
102 
     | 
    
         | 
| 
       103 
     | 
    
         
            -
            <p>  -o, --output  
     | 
| 
      
 103 
     | 
    
         
            +
            <p>  -o, --output NAME</p>
         
     | 
| 
       104 
104 
     | 
    
         | 
| 
       105 
105 
     | 
    
         
             
            <p>  Output file. Default is CHANGELOG.md</p>
         
     | 
| 
       106 
106 
     | 
    
         | 
| 
       107 
     | 
    
         
            -
            <p>  -b, --base  
     | 
| 
      
 107 
     | 
    
         
            +
            <p>  -b, --base NAME</p>
         
     | 
| 
       108 
108 
     | 
    
         | 
| 
       109 
109 
     | 
    
         
             
            <p>  Optional base file to append generated changes to.</p>
         
     | 
| 
       110 
110 
     | 
    
         | 
| 
       111 
     | 
    
         
            -
            <p>   --bugs-label  
     | 
| 
      
 111 
     | 
    
         
            +
            <p>   --bugs-label LABEL</p>
         
     | 
| 
       112 
112 
     | 
    
         | 
| 
       113 
113 
     | 
    
         
             
            <p>   Setup custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong></p>
         
     | 
| 
       114 
114 
     | 
    
         | 
| 
       115 
     | 
    
         
            -
            <p>   --enhancement-label  
     | 
| 
      
 115 
     | 
    
         
            +
            <p>   --enhancement-label LABEL</p>
         
     | 
| 
       116 
116 
     | 
    
         | 
| 
       117 
117 
     | 
    
         
             
            <p>   Setup custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>"</p>
         
     | 
| 
       118 
118 
     | 
    
         | 
| 
       119 
     | 
    
         
            -
            <p>   --issues-label  
     | 
| 
      
 119 
     | 
    
         
            +
            <p>   --issues-label LABEL</p>
         
     | 
| 
       120 
120 
     | 
    
         | 
| 
       121 
121 
     | 
    
         
             
            <p>   Setup custom label for closed-issues section. Default is "<strong>Closed issues:</strong>"</p>
         
     | 
| 
       122 
122 
     | 
    
         | 
| 
       123 
     | 
    
         
            -
            <p>   --header-label  
     | 
| 
      
 123 
     | 
    
         
            +
            <p>   --header-label LABEL</p>
         
     | 
| 
       124 
124 
     | 
    
         | 
| 
       125 
125 
     | 
    
         
             
            <p>   Setup custom header label. Default is "# Changelog"</p>
         
     | 
| 
       126 
126 
     | 
    
         | 
| 
       127 
     | 
    
         
            -
            <p>   --pr-label  
     | 
| 
      
 127 
     | 
    
         
            +
            <p>   --pr-label LABEL</p>
         
     | 
| 
       128 
128 
     | 
    
         | 
| 
       129 
129 
     | 
    
         
             
            <p>   Setup custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>"</p>
         
     | 
| 
       130 
130 
     | 
    
         | 
| 
         @@ -160,7 +160,7 @@ 
     | 
|
| 
       160 
160 
     | 
    
         | 
| 
       161 
161 
     | 
    
         
             
            <p>   Add to log unreleased closed issues. Default is true</p>
         
     | 
| 
       162 
162 
     | 
    
         | 
| 
       163 
     | 
    
         
            -
            <p>   --unreleased-label  
     | 
| 
      
 163 
     | 
    
         
            +
            <p>   --unreleased-label LABEL</p>
         
     | 
| 
       164 
164 
     | 
    
         | 
| 
       165 
165 
     | 
    
         
             
            <p>   Add to log unreleased closed issues. Default is true</p>
         
     | 
| 
       166 
166 
     | 
    
         | 
| 
         @@ -196,19 +196,19 @@ 
     | 
|
| 
       196 
196 
     | 
    
         | 
| 
       197 
197 
     | 
    
         
             
            <p>   Changelog will end before specified tag</p>
         
     | 
| 
       198 
198 
     | 
    
         | 
| 
       199 
     | 
    
         
            -
            <p>   --max-issues  
     | 
| 
      
 199 
     | 
    
         
            +
            <p>   --max-issues NUMBER</p>
         
     | 
| 
       200 
200 
     | 
    
         | 
| 
       201 
201 
     | 
    
         
             
            <p>   Max number of issues to fetch from GitHub. Default is unlimited</p>
         
     | 
| 
       202 
202 
     | 
    
         | 
| 
       203 
     | 
    
         
            -
            <p>   --release-url  
     | 
| 
      
 203 
     | 
    
         
            +
            <p>   --release-url URL</p>
         
     | 
| 
       204 
204 
     | 
    
         | 
| 
       205 
205 
     | 
    
         
             
            <p>   The URL to point to for release links, in printf format (with the tag as variable).</p>
         
     | 
| 
       206 
206 
     | 
    
         | 
| 
       207 
     | 
    
         
            -
            <p>   --github-site  
     | 
| 
      
 207 
     | 
    
         
            +
            <p>   --github-site URL</p>
         
     | 
| 
       208 
208 
     | 
    
         | 
| 
       209 
209 
     | 
    
         
             
            <p>   The Enterprise Github site on which your project is hosted.</p>
         
     | 
| 
       210 
210 
     | 
    
         | 
| 
       211 
     | 
    
         
            -
            <p>   --github-api  
     | 
| 
      
 211 
     | 
    
         
            +
            <p>   --github-api URL</p>
         
     | 
| 
       212 
212 
     | 
    
         | 
| 
       213 
213 
     | 
    
         
             
            <p>   The enterprise endpoint to use for your Github API.</p>
         
     | 
| 
       214 
214 
     | 
    
         | 
| 
         @@ -216,15 +216,15 @@ 
     | 
|
| 
       216 
216 
     | 
    
         | 
| 
       217 
217 
     | 
    
         
             
            <p>   Create simple list from issues and pull requests. Default is false.</p>
         
     | 
| 
       218 
218 
     | 
    
         | 
| 
       219 
     | 
    
         
            -
            <p>   --future-release  
     | 
| 
      
 219 
     | 
    
         
            +
            <p>   --future-release RELEASE-VERSION</p>
         
     | 
| 
       220 
220 
     | 
    
         | 
| 
       221 
221 
     | 
    
         
             
            <p>   Put the unreleased changes in the specified release number.</p>
         
     | 
| 
       222 
222 
     | 
    
         | 
| 
       223 
     | 
    
         
            -
            <p>   --configure-sections  
     | 
| 
      
 223 
     | 
    
         
            +
            <p>   --configure-sections HASH, STRING</p>
         
     | 
| 
       224 
224 
     | 
    
         | 
| 
       225 
225 
     | 
    
         
             
            <p>   Define your own set of sections which overrides all default sections") do |v|</p>
         
     | 
| 
       226 
226 
     | 
    
         | 
| 
       227 
     | 
    
         
            -
            <p>   --add-sections  
     | 
| 
      
 227 
     | 
    
         
            +
            <p>   --add-sections HASH, STRING</p>
         
     | 
| 
       228 
228 
     | 
    
         | 
| 
       229 
229 
     | 
    
         
             
            <p>   Add new sections but keep the default sections"</p>
         
     | 
| 
       230 
230 
     | 
    
         |