项目文件夹

文件
2026-07-13 13:26:28 +08:00

21 行
1.3 KiB
Markdown

# Reader scripts
The few standalone command-line tools a reader runs, from the repository root
(`uv run python scripts/<name>.py`). These are programs you **execute**; the
importable library code the notebooks build on lives in [`utils/`](../utils).
- **`verify_installation.py`** — run this first, right after installing: it imports
the core dependencies and reports whether CUDA, matplotlib, and Plotly are working.
- **`download_artifacts.py`** — pulls the pre-computed model predictions and backtest
results so the Chapter 11–20 case-study notebooks run without retraining from scratch.
- **`sync_notebooks.py`** — regenerates a notebook's `.ipynb` from its Jupytext `.py`
source (or the reverse); pass `--check` to only report which pairs have drifted.
- **`sanitize_notebook_paths.py`** — strips machine-specific absolute paths out of
committed notebook outputs and metadata; a CI check fails if any slip through.
- **`notebook_provenance.py`** — the pre-commit gate: it stamps each executed notebook
with the git hash of its `.py` source and blocks commits of stale or test-mode runs.
> Internal registry-maintenance tooling (backfills, schema migrations, one-off data
> repairs) is intentionally **not** in this repository — it lives in the separate
> maintainer workspace.