Finding numbers for your resume bullets

# Reads one honest scope line out of a project's version history. It builds an invented repository, the canteen queue
# app of three students, with real Git commits (fixed names and times, so every run makes the same history), then runs
# the two commands you would run on your own project and adds up what they print for one person.
#
# Git runs in a new folder below this one, which is also its home folder, so your own Git settings change nothing and
# GIT_CONFIG_NOSYSTEM=1 skips the computer's system-wide settings. Every person and file is invented.
import os
import re
import shutil
import subprocess
from pathlib import Path

HOME = Path("learner").resolve()
REPO = HOME / "canteen-queue"
START = 1767240000  # one fixed moment, in seconds since 1970; commits follow one day apart (dates are never shown)
PEOPLE = {
    "Meera": ("Meera Iyer", "meera@example.com"),
    "Rohan": ("Rohan Das", "rohan@example.com"),
    "Imran": ("Imran Khan", "imran@example.com"),
}
# Each commit: who, the message, and what it does to files: add n lines, change the last n, or drop the last n.
COMMITS = [
    ("Meera", "Start the canteen queue app", [("app.py", "add", 20), ("README.md", "add", 8), ("requirements.txt", "add", 2)]),
    ("Meera", "Add the token table", [("schema.sql", "add", 14), ("app.py", "add", 10)]),
    ("Rohan", "Add the counter page", [("templates/counter.html", "add", 30), ("static/style.css", "add", 25)]),
    ("Meera", "Issue tokens in order", [("queue.py", "add", 40), ("app.py", "add", 6)]),
    ("Meera", "Test the token order", [("tests/test_queue.py", "add", 35)]),
    ("Imran", "Add a menu page", [("templates/menu.html", "add", 28)]),
    ("Meera", "Call the next token", [("queue.py", "add", 22), ("templates/counter.html", "add", 6)]),
    ("Rohan", "Style the token display", [("static/style.css", "add", 30)]),
    ("Meera", "Log the time each token is served", [("queue.py", "add", 18), ("schema.sql", "add", 4)]),
    ("Meera", "Test serving times", [("tests/test_queue.py", "add", 30)]),
    ("Rohan", "Show how many are waiting", [("templates/counter.html", "add", 12)]),
    ("Meera", "Skip tokens nobody collects in 5 minutes", [("queue.py", "add", 26)]),
    ("Imran", "Add prices to the menu", [("templates/menu.html", "add", 14)]),
    ("Meera", "Test skipped tokens", [("tests/test_queue.py", "add", 28)]),
    ("Meera", "Export the day's serving times as CSV", [("export.py", "add", 32)]),
    ("Rohan", "Fit the counter page on phones", [("static/style.css", "add", 18)]),
    ("Meera", "Fix the token number reset at midnight", [("queue.py", "change", 4), ("queue.py", "add", 2)]),
    ("Meera", "Test the midnight reset", [("tests/test_queue.py", "add", 16)]),
    ("Imran", "Fix menu typos", [("templates/menu.html", "change", 2)]),
    ("Rohan", "Add a large-print mode", [("static/style.css", "add", 12)]),
    ("Meera", "Document how to run it", [("README.md", "add", 24)]),
    ("Rohan", "Tidy the templates", [("templates/counter.html", "change", 4), ("templates/counter.html", "drop", 2)]),
    ("Meera", "Add the setup script", [("setup.sh", "add", 15)]),
]


def git_env(when):
    env = {
        "PATH": os.environ.get("PATH", "/usr/bin:/bin"), "HOME": str(HOME), "XDG_CONFIG_HOME": str(HOME / ".config"),
        "GIT_CONFIG_NOSYSTEM": "1", "GIT_CEILING_DIRECTORIES": str(HOME.parent), "LANG": "C", "LC_ALL": "C",
        "TZ": "UTC", "GIT_AUTHOR_DATE": f"@{when} +0530", "GIT_COMMITTER_DATE": f"@{when} +0530",
    }
    if "TMPDIR" in os.environ:
        env["TMPDIR"] = os.environ["TMPDIR"]
    return env


def git(*args, when=START):
    done = subprocess.run(["git", *args], cwd=REPO, env=git_env(when), capture_output=True, text=True, check=True)
    return done.stdout


def build():
    shutil.rmtree(HOME, ignore_errors=True)
    REPO.mkdir(parents=True)
    git("init", "-q", "-b", "main")
    files, made = {}, 0
    for n, (who, message, edits) in enumerate(COMMITS):
        for path, how, count in edits:
            lines = files.setdefault(path, [])
            if how == "add":
                lines += [f"{path}: line {made + i}" for i in range(count)]
            elif how == "change":
                lines[-count:] = [f"{path}: line {made + i}, changed" for i in range(count)]
            else:
                del lines[-count:]
            made += count
            target = REPO / path
            target.parent.mkdir(parents=True, exist_ok=True)
            target.write_text("\n".join(lines) + "\n")
        name, email = PEOPLE[who]
        git("add", "-A")
        git("-c", f"user.name={name}", "-c", f"user.email={email}", "commit", "-q", "-m", message, when=START + n * 86400)


build()
print("An invented project: the canteen queue app of three students, with 23 commits.")
print()
print("$ git shortlog -sn HEAD")
print(git("shortlog", "-sn", "HEAD"), end="")
print()
print('$ git log --author="Meera Iyer" --shortstat --format=')
stats = git("log", "--author=Meera Iyer", "--shortstat", "--format=")
print("\n".join(line for line in stats.splitlines() if line.strip()))
print()
added = sum(int(x) for x in re.findall(r"(\d+) insertions?", stats))
deleted = sum(int(x) for x in re.findall(r"(\d+) deletions?", stats))
mine = int(git("rev-list", "--count", "--author=Meera Iyer", "HEAD"))
total = int(git("rev-list", "--count", "HEAD"))
touched = set(git("log", "--author=Meera Iyer", "--name-only", "--format=").split())
every = set(git("ls-files").split())
print("Meera's share, added up:")
print(f"  commits: {mine} of {total} ({mine * 100 // total} %)")
print(f"  files she changed: {len(touched)} of the {len(every)} in the project")
print(f"  lines: {added} added, {deleted} deleted")
print()
print("A scope line these records support:")
print(f"  Wrote {mine} of the {total} commits of a three-person canteen queue app in Flask and SQLite,")
print("  including the token queue, its tests and the CSV export of serving times.")

An invented project: the canteen queue app of three students, with 23 commits.

$ git shortlog -sn HEAD
    14	Meera Iyer
     6	Rohan Das
     3	Imran Khan

$ git log --author="Meera Iyer" --shortstat --format=
 1 file changed, 15 insertions(+)
 1 file changed, 24 insertions(+)
 1 file changed, 16 insertions(+)
 1 file changed, 6 insertions(+), 4 deletions(-)
 1 file changed, 32 insertions(+)
 1 file changed, 28 insertions(+)
 1 file changed, 26 insertions(+)
 1 file changed, 30 insertions(+)
 2 files changed, 22 insertions(+)
 2 files changed, 28 insertions(+)
 1 file changed, 35 insertions(+)
 2 files changed, 46 insertions(+)
 2 files changed, 24 insertions(+)
 3 files changed, 30 insertions(+)

Meera's share, added up:
  commits: 14 of 23 (60 %)
  files she changed: 9 of the 11 in the project
  lines: 362 added, 4 deleted

A scope line these records support:
  Wrote 14 of the 23 commits of a three-person canteen queue app in Flask and SQLite,
  including the token queue, its tests and the CSV export of serving times.