rl337/pyiv

Build the Sphinx HTML documentation with the documented CI command: sphinx-build -b html docs <outdir>, which writes HTML pages to /tmp/pyiv-docs-probe.

cd <host-path> && ls -la && cat README* 2>/dev/null | head -200
cd <host-path> && git log -1 --format=%H 2>/dev/null; ls .github/workflows 2>/dev/null; cat pyproject.toml 2>/dev/null | head -60; echo CDP=$CDP_URL $<env-var>; python3 --version; which uv pip pipx node npm 2>&1
cd <host-path> && python3 -m venv /tmp/pyiv-venv && /tmp/pyiv-venv/bin/pip install -q -e . 2>&1 | tail -5; echo rc=$?; /tmp/pyiv-venv/bin/python -c "import pyiv;print(pyiv.__file__)"; ls pyiv scripts extras; cat Makefile | head -40
cd <host-path> && (sudo apt-get update -qq && sudo apt-get install -y -qq python3.12-venv) >/tmp/apt.log 2>&1; echo apt=$?; rm -rf /tmp/pyiv-venv && python3 -m venv /tmp/pyiv-venv && /tmp/pyiv-venv/bin/pip install -q -e . 2>&1 | tail -5; echo pip=$?; cd /tmp && /tmp/pyiv-venv/bin/python -c "import pyiv,sys;print(pyiv.__file__, pyiv.__version__ if hasattr(pyiv,'__version__') else '')"
cd <host-path> && grep -n "run:" -A3 .github/workflows/ci.yml .github/workflows/docs.yml | head -80; echo ---; head -40 generate_index.py; echo ---; grep -rn "__main__\|scripts" pyproject.toml; ls docs | head
cd <host-path> && /tmp/pyiv-venv/bin/pip install -q -e ".[docs]" 2>&1 | tail -3; echo pip=$?; ls docs/_build 2>&1; /tmp/pyiv-venv/bin/sphinx-build -b html docs /tmp/pyiv-docs-out 2>&1 | tail -15; echo rc=${PIPESTATUS[0]}
cd <host-path> && rm -rf /tmp/pyiv-docs-out && mkdir -p .coldpass && cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["/tmp/pyiv-venv/bin/sphinx-build","-b","html","docs","/tmp/pyiv-docs-probe"],"cwd":"<host-path>"}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"Build the Sphinx HTML documentation with the documented CI command: sphinx-build -b html docs <outdir>, which writes HTML pages to /tmp/pyiv-docs-probe.","operation_scope":"Covers the docs build only. Library usage (README quick start DI example) was not run as a probe because the README gives it as Python code, not a CLI command. Full pytest/run_checks.sh suites were not run per smoke-task instructions. Build reports 81 Sphinx warnings, which were not fixed.","steps":["apt-get install python3.12-venv (needed because python3 -m venv failed with ensurepip missing)","python3 -m venv /tmp/pyiv-venv","/tmp/pyiv-venv/bin/pip install -e . (README Install: 'pip install -e .' from CI workflow ci.yml)","/tmp/pyiv-venv/bin/pip install -e '.[docs]' (pyproject docs extra, per docs.yml)","/tmp/pyiv-venv/bin/sphinx-build -b html docs /tmp/pyiv-docs-out (docs.yml run step) -> build succeeded, 81 warnings"],"deviations":["python3 -m venv failed with ensurepip not available; ran apt-get install python3.12-venv, then recreated the venv.","Used CI command 'sphinx-build -b html docs docs/_build/html' from .github/workflows/docs.yml with a different output dir (/tmp/pyiv-docs-probe) to keep the workspace clean; the probe uses the absolute venv path.","Did not install pyiv-common extra (extras/pyiv-common) since it is not needed for the docs build step."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
python3 -m json.tool .coldpass/probe.json >/dev/null && python3 -m json.tool .coldpass/report.json >/dev/null && echo json-ok; <env-var>=<host-path> python3 -I <host-path> --validate; echo rc=$?