Skip to content

Quarto warning on Linux/macOS from Windows-only QUARTO_PYTHON path in _environment #59

@gitlastoniagent

Description

@gitlastoniagent

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

  1. Keep _environment platform-neutral (do not hard-code QUARTO_PYTHON there).
  2. Set QUARTO_PYTHON per-OS in Justfile render/preview recipes.
    • Windows: .venv/Scripts/python.exe
    • Linux/macOS: .venv/bin/python3
  3. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions