effectualpy/effectual

Bundle a Python source directory into a single-file .pyz with the README's DIY flow (`uv run efec dist`) in a scratch project, then run the produced bundle to confirm it executes.

cd <host-path> && ls -la && cat README.md 2>/dev/null | head -200
cd <host-path> && ls -la .coldpass 2>/dev/null; echo "---"; env | grep -i -E 'CDP|PROXY' ; echo; which node npm python3 uv pip3 2>&1; cat /etc/os-release | head -3
cd <host-path> && cat taskfile.yml && echo ---- && cat pyproject.toml && echo ---- && find src -type f | head -50 && cat .python-version
(which uv || (curl -LsSf https://astral.sh/uv/install.sh | sh)) 2>&1 | tail -5; ls ~/.local/bin 2>/dev/null; which task || echo "no task"
export PATH=$HOME/.local/bin:$PATH; sudo sh -c 'curl -fsSL https://taskfile.dev/install.sh | sh -s -- -d -b /usr/local/bin' 2>&1 | tail -3; which task && task --version; cd <host-path> && task setup 2>&1 | tail -30
cd <host-path> && ls -d dist 2>/dev/null; <host-path> build 2>&1 | tail -8; ls -la dist 2>/dev/null; <host-path> --help 2>&1 | head -20
export PATH=$HOME/.local/bin:$PATH NODE_USE_ENV_PROXY=1; rm -rf /tmp/efec-demo && mkdir -p /tmp/efec-demo/src && cd /tmp/efec-demo && uv init --name efec-demo --python 3.11 2>&1 | tail -2 && uv add effectual --dev 2>&1 | tail -4 && cat >> pyproject.toml <<'EOF'

[tool.effectual]

sourceDirectory = "./src/"
outputDirectory = "./dist/"
outputFileName = "bundle.pyz"
minification = true
compressionLevel = 5
EOF
printf 'import json\nprint(json.dumps({"bundled": True, "answer": 42}))\n' > src/__main__.py && uv run efec dist 2>&1 | tail -5; ls -la dist; python3 dist/bundle.pyz 2>&1 | tail -3
cd <host-path> && mkdir -p .coldpass && cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["/tmp/efec-demo/.venv/bin/efec","dist"],"cwd":"/tmp/efec-demo"}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"Bundle a Python source directory into a single-file .pyz with the README's DIY flow (`uv run efec dist`) in a scratch project, then run the produced bundle to confirm it executes.","operation_scope":"Verified: source setup via `task setup`, package build via `uv build` (README build step, without its ruff auto-format step), and `efec dist` bundling of a demo project created with the README DIY steps. Not verified: `task build` / `task check` (lint/type/format) were not run, since ruff format/fix rewrites source and the suites are out of scope for this smoke run.","steps":["Installed uv via https://astral.sh/uv/install.sh (README: Setup > DIY, uv self update prerequisite)","Installed go-task 3.54.0 to /usr/local/bin via https://taskfile.dev/install.sh (README: Building from source > Requirements)","task setup (uv python install 3.11, uv venv, uv lock, uv sync)","uv build (README: Building from source > task build, packaging step only)","In /tmp/efec-demo: uv init, uv add effectual --dev, added [tool.effectual] config from README, wrote src/__main__.py, ran uv run efec dist; ran python3 dist/bundle.pyz which printed {\"bundled\": true, \"answer\": 42}"],"deviations":["README 'task build' runs ruff format/check --fix over the source tree; not run because it rewrites product source. Ran the packaging step 'uv build' directly instead.","Installed task via its install script because the guest lacks it; uv and task were not preinstalled."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
<env-var>=<host-path> python3 -I <host-path> --validate 2>&1 | tail -20
cd /tmp/efec-demo && /tmp/efec-demo/.venv/bin/efec dist; echo "rc=$?"