httpstat

httpstat visualizes

curl(1)

It is a single file🌟 Python script that has no dependency👏 and is compatible with Python 3🍻.

Installation

There are three ways to get

httpstat

• Download the script directly:

  wget https://raw.githubusercontent.com/reorx/httpstat/master/httpstat.py

• Through pip:

  pip install httpstat

• Through homebrew (macOS only):

  brew install httpstat

For Windows users, @davecheney's Go version is suggested. → download link

Usage

Simply:

python httpstat.py httpbin.org/get

If installed through pip or brew, you can use

httpstat

httpstat httpbin.org/get

cURL Options

Because

httpstat

-w

-D

-o

-s

-S

httpstat

httpstat httpbin.org/post -X POST --data-urlencode "a=b" -v

Environment Variables

httpstat

httpstat --help

• HTTPSTATSHOWBODY

Set to

true

false

• HTTPSTATSHOWIP

By default httpstat shows remote and local IP/port address. Set to

false

true

• HTTPSTATSHOWSPEED

Set to

true

false

  HTTPSTAT_SHOW_SPEED=true httpstat http://cachefly.cachefly.net/10mb.test

  ...
  speed_download: 3193.3 KiB/s, speed_upload: 0.0 KiB/s

• HTTPSTATSAVEBODY

By default httpstat stores body in a tmp file, set to

false

true

• HTTPSTATCURLBIN

Indicate the cURL bin path to use. Default is

curl

This exampe uses brew installed cURL to make HTTP2 request:

  HTTPSTAT_CURL_BIN=/usr/local/Cellar/curl/7.50.3/bin/curl httpstat https://http2.akamai.com/ --http2

  HTTP/2 200
  ...

cURL must be compiled with nghttp2 to enable http2 feature (#12).

• HTTPSTATMETRICSONLY

If set to

true

• HTTPSTAT_DEBUG

Set to

true

false

For convenience, you can export these environments in your

.zshrc

.bashrc

export HTTPSTAT_SHOW_IP=false
export HTTPSTAT_SHOW_SPEED=true
export HTTPSTAT_SAVE_BODY=false

Related Projects

Here are some implementations in various languages:

• Go: davecheney/httpstat

This is the Go alternative of httpstat, it's written in pure Go and relies no external programs. Choose it if you like solid binary executions (actually I do).

• Go (library): tcnksm/go-httpstat

Other than being a cli tool, this project is used as library to help debugging latency of HTTP requests in Go code, very thoughtful and useful, see more in this article

• Bash: b4b4r07/httpstat

This is what exactly I want to do at the very beginning, but gave up due to not confident in my bash skill, good job!

• Node: yosuke-furukawa/httpstat

b4b4r07 mentioned this in his article, could be used as a HTTP client also.

• PHP: talhasch/php-httpstat

The PHP implementation by @talhasch

Some code blocks in

httpstat

• reorx/python-terminal-color Drop-in single file library for printing terminal color.

• reorx/getenv Environment variable definition with type.