verify

name	verify
description	How to build and drive the real hotin CLI for verification (not tests).

Verifying hotin

hotin is a stdlib-only Python CLI (pyproject.toml entry point hotin = "hotin.cli:main"). Zero-key core (github, trends, hn, npm) hits real public APIs with no config.

Build a handle

python3 -m venv /tmp/hotin_verify_venv
source /tmp/hotin_verify_venv/bin/activate
pip install --quiet -e .
export XDG_DATA_HOME=/tmp/hotin_verify_xdg   # isolates the sqlite cache from ~/.local/share

hotin is now a real binary on PATH. Config lives at ~/.config/hotin/.env (XDG_CONFIG_HOME, not XDG_DATA_HOME) — setup --check reads it directly, unaffected by the cache override above.

Drive it

• hotin about / hotin setup --check — no network, sanity check the install.
• hotin hn --limit 3 — one real live call, fast, good smoke test of the free-text GitHub-reference extraction (hn/reddit/youtube share this mechanism).
• hotin hot --limit N --json — the real end-to-end surface: fetch_all() across all 8 adapters concurrently, cache, merge, rank. Takes ~25s (the fetch_all timeout ceiling) if any source is slow/failing — see gotcha below. Re-running within 300s (default TTL) should make previously-successful sources report "served from cache" and skip the network.
• hotin search <query> --json, hotin show <owner/repo> --json — cache-only, instant, exercise the merge/score path without any network.
• Probe error paths: search with no query (exit 2), negative --limit (exit 2), on an uncached repo (clean JSON , exit 0).