Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gonetx/httpit

A rapid http(s) benchmark tool written in Go
https://github.com/gonetx/httpit

benchmark fast go golang gonetx http http-loader https load-test performance pipeline

Last synced: 13 days ago
JSON representation

A rapid http(s) benchmark tool written in Go

Host: GitHub
URL: https://github.com/gonetx/httpit
Owner: gonetx
License: mit
Created: 2021-02-27T03:10:51.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2023-03-16T02:57:25.000Z (over 1 year ago)
Last Synced: 2024-08-10T05:09:22.978Z (4 months ago)
Topics: benchmark, fast, go, golang, gonetx, http, http-loader, https, load-test, performance, pipeline
Language: Go
Homepage:
Size: 3.82 MB
Stars: 228
Watchers: 2
Forks: 8
Open Issues: 8
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

charm-in-the-wild - httpit - A rapid http(s) benchmark tool. (_built with Bubble Tea_) (Applications / Development Tools)

README

# gonetx/httpit

`httpit` is a rapid http(s) benchmark tool which on top of [fasthttp](https://github.com/valyala/fasthttp). Also thanks to [cobra](https://github.com/spf13/cobra) and [bubbletea](https://github.com/charmbracelet/bubbletea).

## Installation
Get binaries from [releases](https://github.com/gonetx/httpit/releases) or via

```
// go1.16+
go install github.com/gonetx/httpit@latest
```

```
// before go1.16
go get -u github.com/gonetx/httpit
```

## Usage
```bash
Usage:
httpit [url|:port|/path] [k:v|k:=v ...] [flags]

Examples:
httpit https://www.google.com -c1 -n5 => httpit -X GET https://www.google.com -c1 -n5
httpit :3000 -c1 -n5 => httpit -X GET http://localhost:3000 -c1 -n5
httpit /foo -c1 -n5 => httpit -X GET http://localhost/foo -c1 -n5
httpit :3000 -c1 -n5 foo:=bar => httpit -X GET http://localhost:3000 -c1 -n5 -H "Content-Type: application/json" -b='{"foo":"bar"}'
httpit :3000 -c1 -n5 foo=bar => httpit -X POST http://localhost:3000 -c1 -n5 -H "Content-Type: application/x-www-form-urlencoded" -b="foo=bar"

Flags:
-c, --connections int Maximum number of concurrent connections (default 128)
-n, --requests int Number of requests(if specified, then ignore the --duration)
--qps int Highest qps value for a fixed benchmark (if specified, then ignore the -n|--requests)
-d, --duration duration Duration of test (default 10s)
-t, --timeout duration Socket/request timeout (default 3s)
-X, --method string Http request method (default "GET")
-H, --header strings HTTP request header with format "K: V", can be repeated
Examples:
-H "k1: v1" -H k2:v2
-H "k3: v3, k4: v4"
--host string Override request host
-a, --disableKeepAlives Disable HTTP keep-alive, if true, will set header Connection: close
-b, --body string Http request body string
-f, --file string Read http request body from file path
-s, --stream Use stream body to reduce memory usage
-J, --json Send json request by setting the Content-Type header to application/json
-F, --form Send form request by setting the Content-Type header to application/x-www-form-urlencoded
-k, --insecure Controls whether a client verifies the server's certificate chain and host name
--cert string Path to the client's TLS Certificate
--key string Path to the client's TLS Certificate Private Key
--httpProxy string Http proxy address
--socksProxy string Socks proxy address
-p, --pipeline Use fasthttp pipeline client
--follow Follow 30x Location redirects for debug mode
--maxRedirects int Max redirect count of following 30x, default is 30 (work with --follow)
-D, --debug Send request once and show request and response detail
-h, --help help for httpit
-v, --version version for httpit
```

### Override host
Use `--host` to override `Host` header for the use case like `curl "http://127.0.0.1" -H "Host: www.example.com"` to bypass DNS resolving.

### Proxy
Use `--httpProxy` and `--socksProxy` to specific proxies for some rare cases.

### Pipeline
Use `-p|--pipeline` to specific fasthttp pipeline client.

### Debug
Use `-D|--debug` to send a request once and view the whole info.
```bash
httpit "http://httpbin.org/get" -JD
Connected to httpbin.org(54.91.118.50:80)

GET /get HTTP/1.1
User-Agent: fasthttp
Host: httpbin.org
Content-Type: application/json

HTTP/1.1 200 OK
Server: gunicorn/19.9.0
Date: Wed, 17 Mar 2021 04:33:00 GMT
Content-Type: application/json
Content-Length: 269
Connection: keep-alive
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true

{
"args": {},
"headers": {
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "fasthttp",
"X-Amzn-Trace-Id": "Root=1-6051867c-7effb4170f5e3057666ecb86"
},
"origin": "54.91.118.50",
"url": "http://httpbin.org/get"
}
```

## Examples
### Use duration
`httpit -X GET "http://httpbin.org/get" -H "accept: application/json" -c2 -d3s`

![duration](capture/duration.gif)

### Use count
`httpit -X GET "http://httpbin.org/get" -H "accept: application/json" -c2 -n15`

![count](capture/count.gif)

## Donate

If you use and love httpit, please consider sending some Satoshi to `3AJ3wgRP1mCxiFD8mqKkDZaCahwgDj3gSh`.

In case you want to be mentioned as a sponsor, please let me know!

![Donate Bitcoin](imgs/btc.jpg)

## Support
[![Jet Brains](imgs/jetbrains.svg)](https://www.jetbrains.com/?from=httpit)