Summary

reorx/httpstat provides a simple, single-file Python script for visualizing curl statistics, offering clear, beautiful terminal output and structured JSON for HTTP performance diagnostics. It targets developers and engineers needing to quickly understand request timings and identify bottlenecks, enhancing debugging workflows with actionable insights.

How It Works

This project is a lightweight wrapper around the curl command-line tool. It parses curl's output to present a detailed breakdown of network timings, including DNS resolution, TCP connection, TLS handshake, server processing, and content transfer. Its core advantage lies in its single-file, dependency-free nature (beyond curl itself) and its ability to render this complex data into easily digestible formats, enhancing clarity and speed of analysis.

Quick Start & Requirements

• Installation: Download httpstat.py directly, pip install httpstat, or brew install httpstat (macOS).
• Prerequisites: Python 3. curl must be installed and in the system's PATH. For HTTP/2 support, curl must be compiled with nghttp2.
• Agent Skill: Install via npx skills add reorx/httpstat for AI assistant integration.
• Windows: A Go version by @davecheney is suggested.
• Links: httpstat.py

Highlighted Details

• Beautiful Terminal Output: Visualizes timing breakdown (DNS, TCP, TLS, server, transfer).
• Structured JSON/JSONL Output: Stable v1 schema for machine consumption.
• SLO Threshold Checking: Exits with code 4 on Service Level Objective violations (e.g., total=500ms).
• NO_COLOR Support: Adheres to the NO_COLOR convention for disabling ANSI escape codes.
• Agent Skill: Integrates with AI coding assistants for automated diagnostics and suggestions.

Maintenance & Community

No specific details on maintainers, community channels (like Discord/Slack), or roadmap were found in the provided README snippet.

Licensing & Compatibility

The README does not explicitly state a software license. This absence requires clarification for commercial use or integration into proprietary projects.

Limitations & Caveats

The project suggests a Go alternative for Windows users, potentially indicating a less seamless experience on that platform. HTTP/2 functionality is contingent on a specific curl build. The lack of a stated license is a significant adoption blocker.