Skip to content

"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files

7.8 KB
Raw Blame
#!/usr/bin/python3
"""
Generate a markdown changelog for the rclone project
"""

import os
import sys
import re
import datetime
import subprocess
from collections import defaultdict

IGNORE_RES = [
    r"^Add .* to contributors$",
    r"^Start v\d+\.\d+(\.\d+)?-DEV development$",
    r"^Version v\d+\.\d+(\.\d+)?$",
]

IGNORE_RE = re.compile("(?:" + "|".join(IGNORE_RES) + ")")

CATEGORY = re.compile(r"(^[\w/ ]+(?:, *[\w/ ]+)*):\s*(.*)$")

backends = [ x for x in os.listdir("backend") if x != "all"]

backend_aliases = {
    "google cloud storage" : "googlecloudstorage",
    "gcs" : "googlecloudstorage",
    "azblob" : "azureblob",
    "mountlib": "mount",
    "cmount": "mount",
    "mount/cmount": "mount",
}

backend_titles = {
    "googlecloudstorage": "Google Cloud Storage",
    "azureblob": "Azure Blob",
    "ftp": "FTP",
    "sftp": "SFTP",
    "http": "HTTP",
    "webdav": "WebDAV",
}

STRIP_FIX_RE = re.compile(r"(\s+-)?\s+((fixes|addresses)\s+)?#\d+", flags=re.I)

STRIP_PATH_RE = re.compile(r"^(backend|fs)/")

IS_FIX_RE = re.compile(r"\b(fix|fixes)\b", flags=re.I)

CHERRY_PICK_RE = re.compile(r"\(cherry picked from commit ([0-9a-f]{40})\)")

STABLE_BRANCH_RE = re.compile(r"^v\d+\.\d+-stable")

VERSION_RE = re.compile(r"^v(\d+)\.(\d+)")

def git(*args):
    """Run a git command and return its output as a string"""
    return subprocess.check_output(["git"] + list(args)).decode("utf-8")

def previous_stable_branch(next_version):
    """Return the ref of the stable branch for the release before next_version, or None if it can't be found"""
    match = VERSION_RE.match(next_version)
    if not match or int(match.group(2)) == 0:
        return None
    branch = "v%s.%d-stable" % (match.group(1), int(match.group(2)) - 1)
    for ref in (branch, "origin/" + branch):
        if subprocess.call(["git", "rev-parse", "--verify", "--quiet", ref],
                           stdout=subprocess.DEVNULL) == 0:
            return ref
    return None

def released_commits(version, next_version):
    """
    Return the set of commit hashes in version..next_version which have
    already been released in a point release on the previous stable branch,
    so their changelog entries can be omitted.

    Returns the empty set when on a stable branch or when no previous
    stable branch can be found.
    """
    branch = git("rev-parse", "--abbrev-ref", "HEAD").strip()
    if STABLE_BRANCH_RE.match(branch):
        return set()
    stable_branch = previous_stable_branch(next_version)
    if stable_branch is None:
        print("Warning: previous stable branch not found - not removing already released commits", file=sys.stderr)
        return set()
    # Only consider commits up to the last release tag on the stable
    # branch - anything after it hasn't been released yet.
    stable_tag = git("describe", "--tags", "--abbrev=0", stable_branch).strip()
    released = set()
    # Hashes recorded by cherry-pick -x on the stable branch
    bodies = git("log", "--pretty=format:%b", version + ".." + stable_tag)
    released.update(CHERRY_PICK_RE.findall(bodies))
    # Commits with a patch equivalent on the stable branch (catches
    # cherry-picks made without -x)
    for line in git("cherry", stable_tag, next_version, version).splitlines():
        if line.startswith("- "):
            released.add(line[2:].strip())
    print("Removing commits already released in %s:" % stable_tag, file=sys.stderr)
    return released

def make_out(data, indent=""):
    """Return a out, lines the first being a function for output into the second"""
    out_lines = []
    def out(category, title=None):
        if title == None:
            title = category
        lines = data.get(category)
        if not lines:
            return
        del(data[category])
        if indent != "" and len(lines) == 1:
            out_lines.append(indent+"- " + title+": " + lines[0])
            return
        out_lines.append(indent+"- " + title)
        for line in lines:
            out_lines.append(indent+"  - " + line)
    return out, out_lines


def process_log(log, released=frozenset()):
    """Process the incoming log into a category dict of lists, skipping commits whose hash is in released"""
    by_category = defaultdict(list)
    for log_line in reversed(log.split("\n")):
        log_line = log_line.strip()
        hash, author, timestamp, message = log_line.split("|", 3)
        message = message.strip()
        if hash in released:
            print("  " + message, file=sys.stderr)
            continue
        if IGNORE_RE.search(message):
            continue
        match = CATEGORY.search(message)
        categories = "UNKNOWN"
        if match:
            categories = match.group(1).lower()
            message = match.group(2)
        message = STRIP_FIX_RE.sub("", message)
        message = message +" ("+author+")"
        message = message[0].upper()+message[1:]
        seen = set()
        for category in categories.split(","):
            category = category.strip()
            category = STRIP_PATH_RE.sub("", category)
            category = backend_aliases.get(category, category)
            if category in seen:
                continue
            by_category[category].append(message)
            seen.add(category)
            #print category, hash, author, timestamp, message
    return by_category

def main():
    if len(sys.argv) != 3:
        print("Syntax: %s vX.XX vX.XY" % sys.argv[0], file=sys.stderr)
        sys.exit(1)
    version, next_version = sys.argv[1], sys.argv[2]
    log = git("log", '''--pretty=format:%H|%an|%aI|%s''', version+".."+next_version)
    by_category = process_log(log, released_commits(version, next_version))

    # Output backends first so remaining in by_category are core items
    out, backend_lines = make_out(by_category)
    out("mount", title="Mount")
    out("vfs", title="VFS")
    out("local", title="Local")
    out("cache", title="Cache")
    out("crypt", title="Crypt")
    backend_names = sorted(x for x in list(by_category.keys()) if x in backends)
    for backend_name in backend_names:
        if backend_name in backend_titles:
            backend_title = backend_titles[backend_name]
        else:
            backend_title = backend_name.title()
        out(backend_name, title=backend_title)

    # Split remaining in by_category into new features and fixes
    new_features = defaultdict(list)
    bugfixes = defaultdict(list)
    for name, messages in by_category.items():
        for message in messages:
            if IS_FIX_RE.search(message):
                bugfixes[name].append(message)
            else:
                new_features[name].append(message)

    # Output new features
    out, new_features_lines = make_out(new_features, indent="  ")
    for name in sorted(new_features.keys()):
        out(name)

    # Output bugfixes
    out, bugfix_lines = make_out(bugfixes, indent="  ")
    for name in sorted(bugfixes.keys()):
        out(name)

    # Read old changelog and split
    with open("docs/content/changelog.md") as fd:
        old_changelog = fd.read()
    heading = "# Changelog"
    i = old_changelog.find(heading)
    if i < 0:
        raise AssertionError("Couldn't find heading in old changelog")
    i += len(heading)
    old_head, old_tail = old_changelog[:i], old_changelog[i:]

    # Update the build date
    old_head = re.sub(r"\d\d\d\d-\d\d-\d\d", str(datetime.date.today()), old_head)

    # Output combined changelog with new part
    sys.stdout.write(old_head)
    today = datetime.date.today()
    new_features = "\n".join(new_features_lines)
    bugfixes = "\n".join(bugfix_lines)
    backend_changes = "\n".join(backend_lines)
    sys.stdout.write("""

## %(next_version)s - %(today)s

[See commits](https://github.com/rclone/rclone/compare/%(version)s...%(next_version)s)

- New backends
- New commands
- New Features
%(new_features)s
- Bug Fixes
%(bugfixes)s
%(backend_changes)s""" % locals())
    sys.stdout.write(old_tail)


if __name__ == "__main__":
    main()