155 lines
5.7 KiB
Python
Executable File
155 lines
5.7 KiB
Python
Executable File
# -*- coding: utf-8 -*-
|
|
|
|
import re, os, os.path
|
|
import subprocess
|
|
import argparse
|
|
from itertools import islice
|
|
from operator import itemgetter
|
|
|
|
TEMP_RELEASE_NOTES_HEADER = [
|
|
'(note: this is a temporary file, to be added-to by anybody, and moved to\n',
|
|
'release-notes at release time)\n',
|
|
'\n',
|
|
'Notable changes\n',
|
|
'===============\n',
|
|
'\n',
|
|
]
|
|
|
|
RELEASE_NOTES_CHANGELOG_HEADING = [
|
|
'Changelog\n',
|
|
'=========\n',
|
|
'\n',
|
|
]
|
|
|
|
author_aliases = {
|
|
'Ariel': 'Ariel Gabizon',
|
|
'arielgabizon': 'Ariel Gabizon',
|
|
'bitcartel': 'Simon Liu',
|
|
'Charlie OKeefe': 'Charlie O\'Keefe',
|
|
'Duke Leto': 'Jonathan \"Duke\" Leto',
|
|
'Eirik0': 'Eirik Ogilvie-Wigley',
|
|
'EthanHeilman': 'Ethan Heilman',
|
|
'MarcoFalke': 'Marco Falke',
|
|
'mdr0id': 'Marshall Gaucher',
|
|
'paveljanik': 'Pavel Janík',
|
|
'Simon': 'Simon Liu',
|
|
'str4d': 'Jack Grigg',
|
|
'zebambam': 'Benjamin Winston'
|
|
}
|
|
|
|
def apply_author_aliases(name):
|
|
if name in author_aliases:
|
|
return author_aliases[name]
|
|
else:
|
|
return name
|
|
|
|
def parse_authors(line):
|
|
commit_search = re.search('\((\d+)\)', line)
|
|
if commit_search:
|
|
commits = commit_search.group(1)
|
|
else:
|
|
commits = 0
|
|
name = re.sub(' \(\d+\)|:|\n|\r\n$', '', line)
|
|
return name, commits
|
|
|
|
def alias_authors_in_release_notes(line):
|
|
for key in author_aliases:
|
|
if re.match(key, line):
|
|
line = line.replace(key, author_aliases[key])
|
|
break
|
|
return line
|
|
|
|
## Returns dict of {'author': #_of_commits} from a release note
|
|
def authors_in_release_notes(filename):
|
|
note = os.path.join(doc_dir, 'release-notes', filename)
|
|
with open(note, 'r') as f:
|
|
authors = {}
|
|
line = f.readline()
|
|
first_name, commits = parse_authors(line)
|
|
authors[apply_author_aliases(first_name)] = commits
|
|
for line in f:
|
|
if line in ['\n', '\r\n']:
|
|
for author in islice(f, 1):
|
|
name, commits = parse_authors(author)
|
|
authors[apply_author_aliases(name)] = commits
|
|
return authors
|
|
|
|
## Sums commits made by contributors in each Zcash release note in ./doc/release-notes and writes to authors.md
|
|
def document_authors():
|
|
print("Writing contributors documented in release-notes directory to authors.md.")
|
|
authors_file = os.path.join(doc_dir, 'authors.md')
|
|
with open(authors_file, 'w') as f:
|
|
f.write('Zcash Contributors\n==================\n\n')
|
|
total_contrib = {}
|
|
for notes in os.listdir(os.path.join(doc_dir, 'release-notes')):
|
|
# Commits are duplicated across beta, RC and final release notes,
|
|
# except for the pre-launch release notes.
|
|
if ('-beta' in notes or '-rc' in notes) and '1.0.0-' not in notes:
|
|
continue
|
|
authors = authors_in_release_notes(notes)
|
|
for author in authors:
|
|
commits = int(authors[author])
|
|
if author in total_contrib:
|
|
total_contrib[author] += commits
|
|
else:
|
|
total_contrib[author] = commits
|
|
sorted_contrib = sorted(total_contrib.items(), key=itemgetter(1, 0), reverse=True)
|
|
for n, c in sorted_contrib:
|
|
if c != 0:
|
|
f.write("{0} ({1})\n".format(n, c))
|
|
|
|
## Writes release note to ./doc/release-notes based on git shortlog when current version number is specified
|
|
def generate_release_note(version, prev, clear):
|
|
filename = 'release-notes-{0}.md'.format(version)
|
|
print("Automatically generating release notes for {0} from git shortlog. Should review {1} for accuracy.".format(version, filename))
|
|
if prev:
|
|
latest_tag = prev
|
|
else:
|
|
# fetches latest tags, so that latest_tag will be correct
|
|
subprocess.Popen(['git fetch -t'], shell=True, stdout=subprocess.PIPE).communicate()[0]
|
|
latest_tag = subprocess.Popen(['git describe --abbrev=0'], shell=True, stdout=subprocess.PIPE).communicate()[0].strip()
|
|
print("Previous release tag: ", latest_tag)
|
|
notes = subprocess.Popen(['git shortlog --no-merges {0}..HEAD'.format(latest_tag)], shell=True, stdin=subprocess.PIPE, stdout=subprocess.PIPE).communicate()[0]
|
|
lines = notes.split('\n')
|
|
lines = [alias_authors_in_release_notes(line) for line in lines]
|
|
temp_release_note = os.path.join(doc_dir, 'release-notes.md')
|
|
with open(temp_release_note, 'r') as f:
|
|
notable_changes = f.readlines()
|
|
# Assumes that all notable changes are appended to the default header
|
|
if len(notable_changes) > 6:
|
|
notable_changes = notable_changes[3:] + ['\n']
|
|
else:
|
|
notable_changes = []
|
|
release_note = os.path.join(doc_dir, 'release-notes', filename)
|
|
with open(release_note, 'w') as f:
|
|
f.writelines(notable_changes)
|
|
f.writelines(RELEASE_NOTES_CHANGELOG_HEADING)
|
|
f.writelines('\n'.join(lines))
|
|
if clear:
|
|
# Clear temporary release notes file
|
|
with open(temp_release_note, 'w') as f:
|
|
f.writelines(TEMP_RELEASE_NOTES_HEADER)
|
|
|
|
def main(version, prev, clear):
|
|
if version != None:
|
|
generate_release_note(version, prev, clear)
|
|
document_authors()
|
|
|
|
if __name__ == "__main__":
|
|
parser = argparse.ArgumentParser()
|
|
parser.add_argument('--version', help='Upcoming version, without leading v')
|
|
parser.add_argument('--prev', help='Previous version, with leading v')
|
|
parser.add_argument('--clear', help='Wipe doc/release-notes.md', action='store_true')
|
|
args = parser.parse_args()
|
|
|
|
root_dir = os.path.dirname(os.path.dirname(os.path.realpath(__file__)))
|
|
doc_dir = os.path.join(root_dir, 'doc')
|
|
version = None
|
|
prev = None
|
|
clear = False
|
|
if args.version:
|
|
version = args.version
|
|
prev = args.prev
|
|
clear = args.clear
|
|
main(version, prev, clear)
|