Skip to content

README.md

Latest commit

 

History

History
45 lines (28 loc) · 1.45 KB

README.md

File metadata and controls

45 lines (28 loc) · 1.45 KB

Generating open source commit statistics for the VEDA ODD team

Setting up a fine-grained personal access token

  1. Navigate to https://github.com/settings/personal-access-tokens/new
  2. Select public repositories
  3. Add new token as the environment variable GH_ODD_PAT

Configuration

The config.py file contains:

  • TIME_RANGE: Start and end dates for commit analysis
  • OBJECTIVES: Quarterly objectives with repos and contributors per objective

Regenerating objectives from GitHub

To fetch the latest objectives from GitHub issues:

uv run generate_config.py

This generates objectives_config.py with objectives and contributors from issues labeled pi-*-objective. You'll need to manually add repos to each objective, then copy to config.py.

Generating data

  1. Run uv run main.py (uses 10 parallel workers by default)
  2. Run uv run plot.py

TIME_RANGE is automatically set to the current fiscal quarter (Q1: Oct-Dec, Q2: Jan-Mar, Q3: Apr-Jun, Q4: Jul-Sep).

The generated chart colors bars by PI objective (see objectives page for details).

Regenerating docs/objectives.md

To regenerate the objectives documentation page from config:

uv run generate_docs.py

Performance

  • generate_config.py: Uses GitHub search API to fetch only objective issues (~2-3 seconds)
  • main.py: Parallelizes API calls with ThreadPoolExecutor (10x faster than sequential)