Adds the complete Python port of the Go latprobe tool plus diagnostic
verbose output that the Go version does not yet have.
Package (python/latprobe/):
- probe.py: raw-socket HTTP timing with CertInfo/VerboseDetail dataclasses;
TTFB loop accumulates to \r\n\r\n so headers are parseable without changing
t_first_byte semantics; captures resolved IP, TLS version/cipher/bits,
verified cert (via getpeercert()), and all response headers when verbose=True
- aggregate.py: summarize() → per-phase min/avg/max PhaseStats
- cli.py: injectable run(args,stdout,stderr)->int; argparse with injected
streams; ThreadPoolExecutor concurrency across URLs; four text-rendering
branches; JSON output; worst-exit-code accumulation; -v/--verbose flag
appends IP/TLS/cert/header block after every timing table; JSON extended
with "verbose" object (omitted when flag absent)
- duration.py: parse Go-style duration strings (10s, 500ms, 2m, bare seconds)
- Exit codes: 0 ok, 1 usage, 2 dns, 3 connect, 4 timeout, 5 tls, 6 http≥400
Tests:
- test_probe.py: 18 hermetic tests (success, 404, DNS/connect/timeout/scheme
failures, partial-phase invariants, verbose detail fields)
- test_cli.py: 38 hermetic tests (usage errors, single/aggregate/failure text,
worst-code, --fail, JSON schema/ordering/grouping, verbose text and JSON)
- test_integration.py: 45 tests against live internet services (badssl.com for
TLS errors, real cert/IP/header validation in verbose mode)
Makefile: PYTHONPATH fix, fnmatch pattern test_[!i]*.py to exclude
integration tests from py-test, new py-test-integration target
Docs: docs/usage/py-latprobe.md, python/configs/usage-latprobe.md (runnable
reference with captured output), plans for both the package and verbose feature
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Rename python/configs/usage.md → usage-simple.md so both scripts have a
parallel runnable reference file in the same directory
- Add python/configs/usage-phases.md: runnable sh commands + real expected
output for phases.py against every error-path config, including a note on
the key difference from simple.py (HTTP 4xx exits 0 in phases.py vs 1 in
simple.py because phases.py completes at the network level)
- Update doc cross-links in docs/usage/py-simple.md and py-phases.md
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Hand-drives raw sockets to time each HTTP phase individually — DNS
(getaddrinfo), TCP connect, TLS handshake (ssl.wrap_socket, https only),
TTFB (sendall → first recv), Transfer (first byte → EOF), Total.
Partial phases are preserved on failure (same invariant as Go's probe.go).
Error classification mirrors Go's priority: dns → timeout → tls → connect.
Output format matches Go's single-sample text layout.
Input: bare URL args or plain-text config file (same format as simple.py).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- python/configs/: 7 purpose-built config files, one per error class:
all-ok.txt, dns-failure.txt, connection-refused.txt, timeout.txt,
tls-errors.txt (badssl.com), http-errors.txt (real 404 paths on stable
hosts), mixed.txt (one of each, no timeout)
- python/configs/usage.md: runnable sh commands + expected output per config,
plus quick-sweep and full-sweep loops; commands written for running from
the python/ directory
- docs/custom-usage-examples.md: example 11 added (all failure classes at once)
- docs/usage/py-simple.md: added pointer to python/configs/ and corrected
limitation note (4xx/5xx are FAIL, not OK)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- python/simple.py: reads a plain-text site list (one URL/line, # comments),
issues a GET per site, prints aligned OK/FAIL + elapsed ms, exits 0/1
- Config format forward-compatible with future key=value annotations
- HTTPError caught separately from URLError so HTTP status code appears in
the FAIL message (e.g. "HTTP Error 404: Not Found")
- python/sites.txt: committed example config
- Makefile: PYTHON/PY_DIR/SITES vars; py-simple-run, py-phases-run, py-run,
py-test, py-check, py-clean targets; umbrella test/check/clean include Python
- docs/plans/2026-07-01-10-39-py-simple.md: design plan
- docs/usage/py-simple.md: flags, format, examples, limitations
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
