Summary
Running report render commands on Linux/macOS shows a Quarto warning because _environment sets:
QUARTO_PYTHON=.venv/Scripts/python.exe
That path is Windows-specific.
Impact
This is currently a warning only (render still succeeds in local tests), but it creates noise and confusion in CI/local logs.
Reproduction
On Linux/macOS:
just render-html reports/analysis_report.qmd
# or
just render-docx reports/analysis_report.qmd
Observed warning (example):
Specified QUARTO_PYTHON '.venv/Scripts/python.exe' does not exist
No python binary found in specified QUARTO_PYTHON location
Expected behavior
No platform-mismatch warnings when rendering reports.
Suggested solution
- Keep
_environment platform-neutral (do not hard-code QUARTO_PYTHON there).
- Set
QUARTO_PYTHON per-OS in Justfile render/preview recipes.
- Windows:
.venv/Scripts/python.exe
- Linux/macOS:
.venv/bin/python3
- Optionally document this behavior in README under report rendering.
Acceptance criteria
just render-html reports/analysis_report.qmd runs without the Windows-path warning on Linux/macOS.
just render-docx reports/analysis_report.qmd runs without the Windows-path warning on Linux/macOS.
- Windows render path still uses the venv interpreter.