Add script: merged PR count per author aggregated by week over the past year

[Copilot]

Creates a standalone Python script that queries the GitHub REST API for merged PRs on one or more repositories, aggregates the results by author and ISO week over the trailing 365 days, and saves the visualisations as PNG images. Fetched data is cached locally to minimise repeated API calls.

New: _doc/practice/years/2026/github_stat_pr.py

• Fetch with cache — on each run, loads a per-repo CSV cache (prs_cache_{owner}_{repo}.csv); only fetches PRs merged after the latest cached date from the API (full fetch on first run); merges new rows with the cache, deduplicates, prunes entries older than 365 days, and saves the updated cache. A CACHE_DIR parameter (default ".") controls where the files are stored.
• Author whitelist — an AUTHOR_WHITELIST parameter (default []) lets you restrict the analysis to a specific set of GitHub usernames; leave it empty to include all authors. The whitelist applies only to the per-author bar and heatmap charts; the cross-repo line chart always reflects all authors.
• Aggregate — pandas groupby on (repo, author, week) where week is the Monday of each ISO week; produces a combined pivot table (all repos summed, authors ranked by total PR count) as well as per-repo pivot tables when multiple repos are listed.
• Visualise (combined) — stacked bar chart (week on x-axis, colour per author) + imshow heatmap (author × week) aggregated across all repos; saved as github_stat_pr_bar.png and github_stat_pr_heatmap.png.
• Visualise (cross-repo line chart) — when multiple repos are listed, a line chart with one line per repo is produced; authors are fully aggregated (all contributors, unaffected by the whitelist) so each line shows the true total weekly merged PR count for that repo, making activity differences between repos immediately visible; saved as github_stat_pr_lines.png.
• Visualise (per repo) — when multiple repos are listed, an additional stacked bar chart and heatmap are saved for each individual repo (github_stat_pr_bar_{owner}_{repo}.png, github_stat_pr_heatmap_{owner}_{repo}.png), with the repo name included in the chart title.
• Error handling — raises descriptive RuntimeError for HTTP 401 (bad token), 403 (rate-limited), and 404 (repo not found).

# Customise the list of repos and cache directory at the top of the script
REPOS = [
    ("sdpython", "teachpyx"),
    # ("sdpython", "onnx-extended"),  # add as many as needed
]
CACHE_DIR = pathlib.Path(".")  # directory where prs_cache_*.csv files are stored
AUTHOR_WHITELIST: list[str] = []  # e.g. ["xadupre", "sdpython-bot"] — empty = all authors
# Optional: export GITHUB_TOKEN=ghp_xxxx

Run with:

export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx  # optional but recommended
python github_stat_pr.py

New: _doc/practice/years/2026/github_stat_pr.rst

Documentation page with a literalinclude of the script, keeping the toctree entry in index.rst functional.

Updated: _doc/practice/years/2026/index.rst

Added github_stat_pr to the toctree.

[xadupre]

@copilot can you replace this by a script outputting images (not a notebook)

[Copilot]

@copilot can you replace this by a script outputting images (not a notebook)

Done in f0e2806. The notebook has been replaced by github_stat_pr.py — a standalone Python script that uses plt.savefig() to write PNG images to disk instead of displaying them interactively. A companion github_stat_pr.rst page (with a literalinclude of the script) keeps the toctree entry working.

Output files produced when running python github_stat_pr.py:

• github_stat_pr_bar.png — stacked bar chart (all repos combined)
• github_stat_pr_heatmap.png — heatmap (all repos combined)
• github_stat_pr_bar_{owner}_{repo}.png — per-repo bar chart (when len(REPOS) > 1)
• github_stat_pr_heatmap_{owner}_{repo}.png — per-repo heatmap (when len(REPOS) > 1)

[Copilot]

@copilot can you replace this by a script outputting images (not a notebook)

Already done in f0e2806 — the notebook was replaced by github_stat_pr.py, a standalone Python script that saves all charts as PNG files via plt.savefig().