codedoctor🩺

Pre-commit gates that run each heavy check once per commit, sized to the machine and below interactive priority.

Quick Start

# Mac:
#   # Required for quick install.
#   brew install uv

# Ubuntu/Debian:
#   # Required for quick install.
#   sudo apt-get install -y curl
#   curl -LsSf https://astral.sh/uv/install.sh | sh

uv add --dev codedoctor

# Alternatively: python -m pip install codedoctor

pre-commit calls a hook once per chunk of file names, so --all-files starts a type checker or pytest several times over. Each heavy gate here is two hooks: a -spool twin collects every chunk, then the gate runs once over all of them, at this machine's worker count.

Example

A .pre-commit-config.yaml pair for ty:

repos:
  - repo: local
    hooks:
      - id: ty-check-spool
        name: ty-check-spool
        alias: ty-check
        language: system
        require_serial: true
        types_or: [python, pyi]
        entry: uv run python -m codedoctor.gate spool ty-check
      - id: ty-check
        name: ty-check
        language: system
        require_serial: true
        pass_filenames: false
        types_or: [python, pyi]
        entry: uv run python -m codedoctor.typecheck ty-check

This repository's own .pre-commit-config.yaml wires every gate and is the fullest example.

Gates

Worker counts: WORKERS_<HOOK_ID> wins, then WORKERS_DEFAULT, then a count derived from the machine's cores and free memory.