Skip to content

httpstat 1.0.0
Compare
Choose a tag to compare
@davecheney davecheney released this 01 Oct 23:54
· 61 commits to master since this release
v1.0.0
96d2539

httpstat 1.0.0

This project started a week ago as an attempt to replicate the visual presentation of @reorx's httpstat.py tool.

From my initial efforts a swam of contributors descended on this project and took it from a proof of concept to a capable tool that is usable across Windows, Linux, and Mac, without any external dependencies.

That's all folks!

The goal of this project was not to replicate curl(1), but to replicate the visual presentation of httpstat.py. Along the way we've picked up a lot of useful features to round out the general idea of "talk to a server and time the round trip", incorporating the httptrace package, introduced in Go 1.7.

With the 1.0.0 release, I'm confident that httpstat is a faithful imitation of @reorx's tool, and so I'm declaring this project done. I'll still be accepting bug reports and will keep this tool up to date with future releases of Go, but no new feature requests will be accepted.

This project is open sourced under a permissive licence, I encourage anyone who wants to hack on it to punch that fork button and get coding. Enjoy!

Installation

httpstat requires Go 1.7.1 or later.

% go get -u github.com/davecheney/httpstat

Usage

% httpstat
Usage: httpstat [OPTIONS] URL

OPTIONS:
  -E string
        client cert file for tls config
  -H value
        set HTTP header; repeatable: -H 'Accept: ...' -H 'Range: ...'
  -I    don't read body of request
  -L    follow 30x redirects
  -O    save body as remote filename
  -X string
        HTTP method to use (default "GET")
  -d string
        the body of a POST or PUT request
  -k    allow insecure SSL connections
  -o string
        output file for body
  -v    print version number

ENVIRONMENT:
  HTTP_PROXY    proxy for HTTP requests; complete URL or HOST[:PORT]
                used for HTTPS requests if HTTPS_PROXY undefined
  HTTPS_PROXY   proxy for HTTPS requests; complete URL or HOST[:PORT]
  NO_PROXY      comma-separated list of hosts to exclude from proxy

Features

  • Windows/BSD/Linux supported.
  • HTTP and HTTPS are supported, for self signed certificates use -k.
  • Skip timing the body of a response with -I.
  • Follow 30x redirects with -L.
  • Change HTTP method with -X METHOD.
  • Provide a PUT or POST request body with -d string. To supply the PUT or POST body as a file, use -d @filename.
  • Add extra request headers with -H 'Name: value'.
  • The response body is usually discarded, you can use -o filename to save it to a file, or -O to save it to the file name suggested by the server.
  • HTTP/HTTPS proxies supported via the usual HTTP_PROXY/HTTPS_PROXY env vars (as well as lower case variants).
  • Supply your own client side certificate with -E cert.pem.

Thanks

This project would not have been possible without the help of testers and contributors who provided feedback, feature requests, bug fixes, documentation fixes, and pull requests. Thank you to:

@amy, @ble, @BoGeM, @freeformz, @gsquire, @husobee, @imarko, @inkel, @joshi4, @jrozner, @kevinburke, @mattn, @mholt, @mibk, @moorereason, @tcnksm, @theckman, and @Xymist.

I'd like to give special recognition to the contributions of @moorereason who continually sent pull requests and bug fixes for his, and other's features. Thank you.

Assets 9
Loading