extras/scripts/list_api_changes.py

#!/usr/bin/env python3
from __future__ import print_function
import fnmatch
import os
import subprocess

starttag = "v19.08-rc0"
endtag = "HEAD"
emit_md = True
apifiles = []

for root, dirnames, filenames in os.walk("."):
    for filename in fnmatch.filter(filenames, "*.api"):
        apifiles.append(os.path.join(root, filename))

for f in apifiles:
    commits = subprocess.check_output(
        ["git", "log", "--oneline", starttag + ".." + endtag, f]
    )
    if commits:
        if f[0:2] == "./":
            f = f[2:]
        if emit_md:
            print("| @c %s ||" % f)
            print("| ------- | ------- |")
            for line in commits.splitlines():
                parts = line.strip().split()
                commit = parts[0]
                message = b" ".join(parts[1:]).decode().replace("|", r"\|")
                print(
                    "| [%s](https://gerrit.fd.io/r/gitweb?"
                    "p=vpp.git;a=commit;h=%s) | %s |" % (commit, commit, message)
                )
            print()
        else:
            print(f)
            print(commits)