github_changelog_generator 1.15.0 → 1.15.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +26 -50
- data/lib/github_changelog_generator/octo_fetcher.rb +4 -2
- data/lib/github_changelog_generator/version.rb +1 -1
- metadata +4 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 96d97ec2074cb54d75216a93b42f41a6216a418c1b0e926ab55a0cb9cb32a09b
|
4
|
+
data.tar.gz: 75faf09151502f8f2d3cd4a15da37b26648ed504d42e3829ad95d1d7c71a9268
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9f6adfd28ffcb632837a9d037b0677f6527b03d6a8c787ab9f65b2981b740e1bd478d0f0b64b76f8fab93d00d101b9b5fb80cb86ba7d722c98b0728534485cfc
|
7
|
+
data.tar.gz: 81ee9e88cd5efa0c8acc60ce9f2a1571ea72fb9d9b096af07236477ff560e7561bd3eef31a3c9b26a5bdd6edba2656fe18b32509a7fbe8e40325f4974a94651a
|
data/README.md
CHANGED
@@ -5,11 +5,6 @@
|
|
5
5
|
|
6
6
|
# github-changelog-generator ![GitHub Logo](../master/images/logo.jpg)
|
7
7
|
|
8
|
-
#### Update:
|
9
|
-
|
10
|
-
🖖 Keep it alive: We need more Collaborators to github-changelog-generator [#727](https://github.com/github-changelog-generator/github-changelog-generator/issues/727)
|
11
|
-
|
12
|
-
---
|
13
8
|
<!--
|
14
9
|
To update TOC, please run:
|
15
10
|
> doctoc ./README.md --github
|
@@ -72,16 +67,34 @@ Install the gem like:
|
|
72
67
|
Depending on your system, you _may_ need to run the shell as an Administrator (Windows),
|
73
68
|
or use `sudo gem install github_changelog_generator` (Linux).
|
74
69
|
|
75
|
-
## Running with Docker
|
76
70
|
|
77
|
-
|
71
|
+
## Usage
|
72
|
+
|
73
|
+
|
74
|
+
### Running with CLI:
|
78
75
|
|
79
|
-
|
76
|
+
github_changelog_generator -u github_username -p github_project
|
77
|
+
|
78
|
+
|
79
|
+
### Running with Docker
|
80
|
+
|
81
|
+
Using [Docker](https://www.docker.com/products/docker-desktop) is an alternative to installing Ruby and the gem.
|
80
82
|
|
81
83
|
Example invocation:
|
82
84
|
|
83
85
|
$ docker run -it --rm -v "$(pwd)":/usr/local/src/your-app ferrarimarco/github-changelog-generator
|
84
86
|
|
87
|
+
|
88
|
+
|
89
|
+
- For Github Enterprise repos, specify *both* `--github-site` and `--github-api` options:
|
90
|
+
|
91
|
+
$ github_changelog_generator --github-site="https://github.yoursite.com" \
|
92
|
+
--github-api="https://github.yoursite.com/api/v3/"
|
93
|
+
|
94
|
+
|
95
|
+
This generates a `CHANGELOG.md`, with pretty Markdown formatting.
|
96
|
+
|
97
|
+
|
85
98
|
## Output example
|
86
99
|
|
87
100
|
- Look at **[CHANGELOG.md](https://github.com/github-changelog-generator/Github-Changelog-Generator/blob/master/CHANGELOG.md)** for this project
|
@@ -109,25 +122,6 @@ Example invocation:
|
|
109
122
|
>
|
110
123
|
> - support enterprise github via command line options [\#42](https://github.com/github-changelog-generator/Github-Changelog-Generator/pull/42) ([glenlovett](https://github.com/glenlovett))
|
111
124
|
|
112
|
-
|
113
|
-
## Usage
|
114
|
-
|
115
|
-
- Run this:
|
116
|
-
|
117
|
-
$ github_changelog_generator -u github_username -p github_project
|
118
|
-
|
119
|
-
or, on the 1.14.x (current stable release)
|
120
|
-
|
121
|
-
$ github_changelog_generator github_username/github_project
|
122
|
-
|
123
|
-
|
124
|
-
- For Github Enterprise repos, specify *both* `--github-site` and `--github-api` options:
|
125
|
-
|
126
|
-
$ github_changelog_generator --github-site="https://github.yoursite.com" \
|
127
|
-
--github-api="https://github.yoursite.com/api/v3/"
|
128
|
-
|
129
|
-
This generates a `CHANGELOG.md`, with pretty Markdown formatting.
|
130
|
-
|
131
125
|
### Params
|
132
126
|
|
133
127
|
Print help for all command-line options to learn more details:
|
@@ -150,7 +144,7 @@ since-tag=1.0.0
|
|
150
144
|
|
151
145
|
### GitHub token
|
152
146
|
|
153
|
-
GitHub only allows 50 unauthenticated requests per hour
|
147
|
+
GitHub only allows **50 unauthenticated requests per hour**.
|
154
148
|
|
155
149
|
Therefore, it's recommended to run this script with authentication by using a **token**.
|
156
150
|
|
@@ -161,7 +155,7 @@ Here's how:
|
|
161
155
|
- Run the script with `--token <your-40-digit-token>`; **OR**
|
162
156
|
- Set the `CHANGELOG_GITHUB_TOKEN` environment variable to your 40 digit token
|
163
157
|
|
164
|
-
You can set an environment variable by running the following command at the prompt, or by adding it to your shell profile (e.g., `~/.bash_profile
|
158
|
+
You can set an environment variable by running the following command at the prompt, or by adding it to your shell profile (e.g., `.env`, `~/.bash_profile`, `~/.zshrc`, etc):
|
165
159
|
|
166
160
|
export CHANGELOG_GITHUB_TOKEN="«your-40-digit-github-token»"
|
167
161
|
|
@@ -290,27 +284,6 @@ I'm not trying to compare the quality of handwritten and auto-generated logs. Th
|
|
290
284
|
|
291
285
|
An auto-generated changelog really helps, even if you manually fill in the release notes!
|
292
286
|
|
293
|
-
For example:
|
294
|
-
|
295
|
-
When you find a closed bug, it is very useful to know which release fixed it.
|
296
|
-
So that you can easily find the issue by \# in `CHANGELOG.md`.
|
297
|
-
|
298
|
-
- It's not quite as easy to find this in handwritten releases notes.
|
299
|
-
- A generated file saves you the trouble of remembering everything;
|
300
|
-
sometimes people forget to add things to a handwritten file.
|
301
|
-
|
302
|
-
Ultimately, I think GitHub Releases are ideal for end-users.
|
303
|
-
Meanwhile, `CHANGELOG.md` lives right in the repository, with its detailed list of changes, which is handy for developers.
|
304
|
-
Finally, there's nothing wrong with using GitHub Releases alongside `CHANGELOG.md` in this combination.
|
305
|
-
|
306
|
-
- ***I got an "API rate limit exceeded" error message. What does this mean?***
|
307
|
-
|
308
|
-
GitHub [limits the number of API requests](https://developer.github.com/v3/#rate-limiting) you can make in an hour. You can make up to 5,000 requests per hour. For unauthenticated requests, the rate limit is only up to 60 requests per hour. Unauthenticated requests are associated with your IP address (not the user making requests).
|
309
|
-
|
310
|
-
If you're seeing this warning, please do the following:
|
311
|
-
|
312
|
-
1. Make sure you're providing an OAuth token, so you're not making requests anonymously. Using an OAuth token increases your hourly request maximum from 60 to 5000.
|
313
|
-
2. If you have a large repo with lots of issues/PRs, you can use `--max-issues NUM` to limit the number of issues that are pulled back. For example: `--max-issues 1000`
|
314
287
|
|
315
288
|
- ***My Ruby version is very old, can I use this?***
|
316
289
|
|
@@ -349,6 +322,9 @@ We have collected notes on how to contribute to this project in [CONTRIBUTING.md
|
|
349
322
|
|
350
323
|
[CONTRIBUTING.md]: CONTRIBUTING.md
|
351
324
|
|
325
|
+
## Contact us
|
326
|
+
[Join the chat at gitter : github-changelog-generator](https://gitter.im/github-changelog-generator/chat?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
327
|
+
|
352
328
|
## License
|
353
329
|
|
354
330
|
Github Changelog Generator is released under the [MIT License](http://www.opensource.org/licenses/MIT).
|
@@ -16,7 +16,7 @@ module GitHubChangelogGenerator
|
|
16
16
|
GH_RATE_LIMIT_EXCEEDED_MSG = "Warning: Can't finish operation: GitHub API rate limit exceeded, changelog may be " \
|
17
17
|
"missing some issues. You can limit the number of issues fetched using the `--max-issues NUM` argument."
|
18
18
|
NO_TOKEN_PROVIDED = "Warning: No token provided (-t option) and variable $CHANGELOG_GITHUB_TOKEN was not found. " \
|
19
|
-
"This script can make only 50 requests to GitHub API per hour without token!"
|
19
|
+
"This script can make only 50 requests to GitHub API per hour without a token!"
|
20
20
|
|
21
21
|
# @param options [Hash] Options passed in
|
22
22
|
# @option options [String] :user GitHub username
|
@@ -187,12 +187,14 @@ Make sure, that you push tags to remote repo via 'git push --tags'"
|
|
187
187
|
def fetch_events_async(issues)
|
188
188
|
i = 0
|
189
189
|
threads = []
|
190
|
+
# Add accept option explicitly for disabling the warning of preview API.
|
191
|
+
preview = { accept: Octokit::Preview::PREVIEW_TYPES[:project_card_events] }
|
190
192
|
|
191
193
|
issues.each_slice(MAX_THREAD_NUMBER) do |issues_slice|
|
192
194
|
issues_slice.each do |issue|
|
193
195
|
threads << Thread.new do
|
194
196
|
issue["events"] = []
|
195
|
-
iterate_pages(@client, "issue_events", issue["number"]) do |new_event|
|
197
|
+
iterate_pages(@client, "issue_events", issue["number"], preview) do |new_event|
|
196
198
|
issue["events"].concat(new_event)
|
197
199
|
end
|
198
200
|
issue["events"] = issue["events"].map { |event| stringify_keys_deep(event.to_hash) }
|
metadata
CHANGED
@@ -1,15 +1,16 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: github_changelog_generator
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.15.
|
4
|
+
version: 1.15.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Petr Korolev
|
8
8
|
- Olle Jonsson
|
9
|
+
- Marco Ferrari
|
9
10
|
autorequire:
|
10
11
|
bindir: bin
|
11
12
|
cert_chain: []
|
12
|
-
date:
|
13
|
+
date: 2020-04-07 00:00:00.000000000 Z
|
13
14
|
dependencies:
|
14
15
|
- !ruby/object:Gem::Dependency
|
15
16
|
name: activesupport
|
@@ -198,7 +199,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
198
199
|
- !ruby/object:Gem::Version
|
199
200
|
version: '0'
|
200
201
|
requirements: []
|
201
|
-
rubygems_version: 3.
|
202
|
+
rubygems_version: 3.1.2
|
202
203
|
signing_key:
|
203
204
|
specification_version: 4
|
204
205
|
summary: Script, that automatically generate changelog from your tags, issues, labels
|