2014-11-06 13:51:15 +00:00
|
|
|
#!/usr/bin/env ruby
|
|
|
|
|
|
|
|
require 'github_api'
|
|
|
|
require 'json'
|
|
|
|
require 'httparty'
|
2014-11-12 15:59:40 +00:00
|
|
|
require 'colorize'
|
2014-11-06 14:11:45 +00:00
|
|
|
require_relative 'github_changelog_generator/parser'
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
module GitHubChangelogGenerator
|
|
|
|
class ChangelogGenerator
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
attr_accessor :options, :all_tags, :github
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def initialize()
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
@options = Parser.parse_options
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
github_token
|
2014-11-12 15:59:40 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @github_token.nil?
|
|
|
|
@github = Github.new
|
|
|
|
else
|
|
|
|
@github = Github.new oauth_token: @github_token
|
|
|
|
end
|
2014-11-12 15:59:40 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
@all_tags = self.get_all_tags
|
|
|
|
@pull_requests = self.get_all_closed_pull_requests
|
|
|
|
@issues = self.get_all_issues
|
2014-11-12 15:59:40 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
@tag_times_hash = {}
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def print_json(json)
|
|
|
|
puts JSON.pretty_generate(json)
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def exec_command(cmd)
|
|
|
|
exec_cmd = "cd #{$project_path} && #{cmd}"
|
|
|
|
%x[#{exec_cmd}]
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def get_all_closed_pull_requests
|
|
|
|
response = @github.pull_requests.list @options[:user], @options[:project], :state => 'closed'
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests = []
|
|
|
|
response.each_page do |page|
|
|
|
|
pull_requests.concat(page)
|
|
|
|
end
|
2014-11-17 14:53:47 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Receive all pull requests: #{pull_requests.count}"
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests
|
2014-11-06 13:51:15 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def compund_changelog
|
|
|
|
if @options[:verbose]
|
|
|
|
puts 'Generating changelog:'
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
log = "# Changelog\n\n"
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:last]
|
|
|
|
log += self.generate_log_between_tags(self.all_tags[0], self.all_tags[1])
|
|
|
|
elsif @options[:tag1] && @options[:tag2]
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
tag1 = @options[:tag1]
|
|
|
|
tag2 = @options[:tag2]
|
|
|
|
tags_strings = []
|
|
|
|
self.all_tags.each { |x| tags_strings.push(x['name']) }
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if tags_strings.include?(tag1)
|
|
|
|
if tags_strings.include?(tag2)
|
|
|
|
hash = Hash[tags_strings.map.with_index.to_a]
|
|
|
|
index1 = hash[tag1]
|
|
|
|
index2 = hash[tag2]
|
|
|
|
log += self.generate_log_between_tags(self.all_tags[index1], self.all_tags[index2])
|
|
|
|
else
|
|
|
|
puts "Can't find tag #{tag2} -> exit"
|
|
|
|
exit
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
else
|
2014-11-17 15:54:13 +00:00
|
|
|
puts "Can't find tag #{tag1} -> exit"
|
2014-11-06 13:51:15 +00:00
|
|
|
exit
|
|
|
|
end
|
|
|
|
else
|
2014-11-17 15:54:13 +00:00
|
|
|
log += self.generate_log_for_all_tags
|
2014-11-06 13:51:15 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
log += "\n\n\\* *This changelog was generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*"
|
2014-11-07 09:25:09 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
output_filename = "#{@options[:output]}"
|
|
|
|
File.open(output_filename, 'w') { |file| file.write(log) }
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
puts "Done! Generated log placed in #{output_filename}"
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def generate_log_for_all_tags
|
|
|
|
log = ''
|
|
|
|
@all_tags.each { |tag| self.get_time_of_tag(tag) }
|
2014-11-17 15:43:37 +00:00
|
|
|
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Sorting tags.."
|
|
|
|
end
|
2014-11-17 15:43:37 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
@all_tags.sort_by! { |x| self.get_time_of_tag(x) }.reverse!
|
2014-11-17 15:43:37 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Generating log.."
|
|
|
|
end
|
|
|
|
|
|
|
|
for index in 1 ... self.all_tags.size
|
|
|
|
log += self.generate_log_between_tags(self.all_tags[index], self.all_tags[index-1])
|
|
|
|
end
|
2014-11-17 15:43:37 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
log += self.generate_log_before_tag(self.all_tags.last)
|
|
|
|
|
|
|
|
log
|
2014-11-06 13:51:15 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def is_megred(number)
|
|
|
|
@github.pull_requests.merged? @options[:user], @options[:project], number
|
|
|
|
end
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def get_all_tags
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
url = "https://api.github.com/repos/#{@options[:user]}/#{@options[:project]}/tags"
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
puts "Receive tags for repo #{url}"
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
response = @github.repos.tags @options[:user], @options[:project]
|
2014-11-12 15:23:16 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
tags = []
|
|
|
|
response.each_page do |page|
|
|
|
|
tags.concat(page)
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Found #{tags.count} tags"
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
tags
|
2014-11-17 14:53:47 +00:00
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def github_token
|
|
|
|
if @options[:token]
|
|
|
|
return @github_token ||= @options[:token]
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
env_var = ENV.fetch 'CHANGELOG_GITHUB_TOKEN', nil
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
unless env_var
|
|
|
|
puts "Warning: No token provided (-t option) and variable $CHANGELOG_GITHUB_TOKEN was not found.".yellow
|
|
|
|
puts "This script can make only 50 requests to GitHub API per hour without token!".yellow
|
|
|
|
end
|
2014-11-12 15:59:40 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
@github_token ||= env_var
|
2014-11-12 15:59:40 +00:00
|
|
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def generate_log_between_tags(older_tag, newer_tag)
|
|
|
|
older_tag_time = self.get_time_of_tag(older_tag)
|
|
|
|
newer_tag_time = self.get_time_of_tag(newer_tag)
|
2014-11-12 15:59:40 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
# if we mix up tags order - lits fix it!
|
|
|
|
# if older_tag_time < newer_tag_time
|
|
|
|
# older_tag, newer_tag = newer_tag, older_tag
|
|
|
|
# older_tag_time, newer_tag_time = newer_tag_time, older_tag_time
|
|
|
|
# puts "Swap tags!"
|
|
|
|
# end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
newer_tag_name = newer_tag['name']
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests = Array.new(@pull_requests)
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests.delete_if { |req|
|
|
|
|
if req[:merged_at]
|
|
|
|
t = Time.parse(req[:merged_at]).utc
|
|
|
|
tag_is_older_of_older = t > older_tag_time
|
|
|
|
tag_is_newer_than_new = t <= newer_tag_time
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
tag_not_in_range = (tag_is_older_of_older) && (tag_is_newer_than_new)
|
|
|
|
!tag_not_in_range
|
|
|
|
else
|
|
|
|
true
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
}
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
issues = Array.new(@issues)
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
issues.delete_if { |issue|
|
|
|
|
if issue[:closed_at]
|
|
|
|
t = Time.parse(issue[:closed_at]).utc
|
|
|
|
tag_is_later_since = t > older_tag_time
|
|
|
|
tag_is_before_till = t <= newer_tag_time
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
in_range = (tag_is_later_since) && (tag_is_before_till)
|
|
|
|
!in_range
|
|
|
|
else
|
|
|
|
true
|
|
|
|
end
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
}
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
self.create_log(pull_requests, issues, newer_tag_name, newer_tag_time)
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def generate_log_before_tag(tag)
|
|
|
|
tag_time = self.get_time_of_tag(tag)
|
|
|
|
tag_name = tag['name']
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests = Array.new(@pull_requests)
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
pull_requests.delete_if { |req|
|
|
|
|
if req[:merged_at]
|
|
|
|
t = Time.parse(req[:merged_at]).utc
|
|
|
|
t > tag_time
|
|
|
|
else
|
|
|
|
true
|
|
|
|
end
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
}
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
issues = Array.new(@issues)
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
issues.delete_if { |issue|
|
|
|
|
if issue[:closed_at]
|
|
|
|
t = Time.parse(issue[:closed_at]).utc
|
|
|
|
t > tag_time
|
|
|
|
else
|
|
|
|
true
|
|
|
|
end
|
|
|
|
}
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
self.create_log(pull_requests, issues, tag_name, tag_time)
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
end
|
2014-11-07 09:45:01 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def create_log(pull_requests, issues, tag_name, tag_time)
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
# Generate tag name and link
|
|
|
|
trimmed_tag = tag_name.tr('v', '')
|
|
|
|
log = "## [#{trimmed_tag}] (https://github.com/#{@options[:user]}/#{@options[:project]}/tree/#{tag_name})\n"
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
#Generate date string:
|
|
|
|
time_string = tag_time.strftime @options[:format]
|
|
|
|
log += "#### #{time_string}\n"
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:pulls]
|
|
|
|
# Generate pull requests:
|
|
|
|
if pull_requests
|
|
|
|
pull_requests.each { |dict|
|
|
|
|
merge = "#{@options[:merge_prefix]}#{dict[:title]} [\\##{dict[:number]}](#{dict.html_url})\n\n"
|
|
|
|
log += "- #{merge}"
|
|
|
|
}
|
|
|
|
end
|
2014-11-07 15:45:35 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:issues]
|
|
|
|
# Generate issues:
|
|
|
|
if issues
|
|
|
|
issues.sort! { |x, y|
|
|
|
|
if x.labels.any? && y.labels.any?
|
|
|
|
x.labels[0].name <=> y.labels[0].name
|
2014-11-10 14:13:34 +00:00
|
|
|
else
|
2014-11-17 15:54:13 +00:00
|
|
|
if x.labels.any?
|
|
|
|
1
|
2014-11-10 14:13:34 +00:00
|
|
|
else
|
2014-11-17 15:54:13 +00:00
|
|
|
if y.labels.any?
|
|
|
|
-1
|
|
|
|
else
|
|
|
|
0
|
|
|
|
end
|
2014-11-10 14:13:34 +00:00
|
|
|
end
|
2014-11-07 16:14:26 +00:00
|
|
|
end
|
2014-11-17 15:54:13 +00:00
|
|
|
}.reverse!
|
|
|
|
end
|
|
|
|
issues.each { |dict|
|
|
|
|
is_bug = false
|
|
|
|
is_enhancement = false
|
|
|
|
dict.labels.each { |label|
|
|
|
|
if label.name == 'bug'
|
|
|
|
is_bug = true
|
|
|
|
end
|
|
|
|
if label.name == 'enhancement'
|
|
|
|
is_enhancement = true
|
|
|
|
end
|
|
|
|
}
|
|
|
|
|
|
|
|
intro = 'Closed issue'
|
|
|
|
if is_bug
|
|
|
|
intro = 'Fixed bug'
|
2014-11-07 16:14:26 +00:00
|
|
|
end
|
2014-11-17 15:54:13 +00:00
|
|
|
|
|
|
|
if is_enhancement
|
|
|
|
intro = 'Implemented enhancement'
|
2014-11-07 16:14:26 +00:00
|
|
|
end
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
merge = "*#{intro}:* #{dict[:title]} [\\##{dict[:number]}](#{dict.html_url})\n\n"
|
|
|
|
log += "- #{merge}"
|
|
|
|
}
|
|
|
|
end
|
|
|
|
log
|
|
|
|
end
|
2014-11-10 14:13:34 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def get_time_of_tag(prev_tag)
|
2014-11-07 15:45:35 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @tag_times_hash[prev_tag['name']]
|
|
|
|
return @tag_times_hash[prev_tag['name']]
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Getting time for tag #{prev_tag['name']}"
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
github_git_data_commits_get = @github.git_data.commits.get @options[:user], @options[:project], prev_tag['commit']['sha']
|
|
|
|
time_string = github_git_data_commits_get['committer']['date']
|
|
|
|
Time.parse(time_string)
|
|
|
|
@tag_times_hash[prev_tag['name']] = Time.parse(time_string)
|
2014-11-06 13:51:15 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
def get_all_issues
|
|
|
|
response = @github.issues.list user: @options[:user], repo: @options[:project], state: 'closed', filter: 'all', labels: nil
|
2014-11-06 13:51:15 +00:00
|
|
|
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
issues = []
|
|
|
|
response.each_page do |page|
|
|
|
|
issues.concat(page)
|
|
|
|
end
|
2014-11-10 13:32:06 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
# remove pull request from issues:
|
|
|
|
issues.select! { |x|
|
|
|
|
x.pull_request == nil
|
|
|
|
}
|
2014-11-17 14:53:47 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Receive all closed issues: #{issues.count}"
|
|
|
|
end
|
2014-11-17 14:53:47 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
filtered_issues = issues.select { |issue|
|
|
|
|
#compare is there any labels from @options[:labels] array
|
|
|
|
(issue.labels.map { |label| label.name } & @options[:labels]).any?
|
|
|
|
}
|
2014-11-17 14:53:47 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:add_issues_wo_labels]
|
|
|
|
issues_wo_labels = issues.select {
|
|
|
|
# add issues without any labels
|
|
|
|
|issue| !issue.labels.map { |label| label.name }.any?
|
|
|
|
}
|
|
|
|
filtered_issues.concat(issues_wo_labels)
|
|
|
|
end
|
2014-11-17 14:53:47 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if @options[:verbose]
|
|
|
|
puts "Filter issues with labels #{@options[:labels]}#{@options[:add_issues_wo_labels] ? ' and w/o labels' : ''}: #{filtered_issues.count} issues"
|
|
|
|
end
|
2014-11-10 13:32:06 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
filtered_issues
|
2014-11-10 13:32:06 +00:00
|
|
|
|
2014-11-07 15:45:35 +00:00
|
|
|
end
|
|
|
|
|
2014-11-07 15:04:03 +00:00
|
|
|
end
|
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
if __FILE__ == $0
|
|
|
|
changelog_generator = ChangelogGenerator.new
|
|
|
|
changelog_generator.compund_changelog
|
|
|
|
end
|
2014-11-06 13:51:15 +00:00
|
|
|
|
2014-11-17 15:54:13 +00:00
|
|
|
end
|