p0d is a cli based speed and HTTP performance testing tool for Linux and Darwin operating systems. Features include support for HTTP/1.1, HTTP/2, file attachments as multipart/form-data, and TLS. p0d provides realtime updates on stdout, including errors within test runs. p0d is beta grade software under active development, v0.4.0 was released 12/04/23.

brew tap simonmittag/cli && 
  brew install p0d

git clone https://github.com/simonmittag/p0d && cd p0d &&
  go install github.com/simonmittag/p0d/cmd/p0d

Run for 30 seconds with 10 concurrent connections against local server

λ p0d -d 30 -c 10 http://localhost:8080/path

Run in http/2 mode against local server and save output to log.json

λ p0d -H 2 -O log.json http://localhost:8080/path

Run with config file

λ p0d -C config_get.yml

λ p0d v0.3.9
 usage: p0d [-f flag] [URL]

 flags:
  -C string
        load configuration from yml file
  -H string
        http version to use. Values are 1.1 and 2 (which works only with TLS URLs). Defaults to 1.1 (default "1.1")
  -O string
        save detailed JSON output to file
  -c int
        maximum amount of concurrent TCP connections used (default 1)
  -d int
        time in seconds to run p0d (default 10)
  -h    
        print usage instructions
  -s 
        skip internet speed test, i.e. for local targets
  -v    
        print version

---
exec:
  mode: binary
  durationSeconds: 10
  concurrency: 1
  logsampling: 1
  spacingMillis: 10
  skipInetTest: true
req:
  method: POST
  url: http://localhost:8080/path
  headers:
    - Accept-Encoding: "identity"
  body: '
   { "your": "body" }
  '
res:
  code: 200

binary or decimal for MiB or MB units in reporting

run pod for n seconds. Defaults to 10

give up connecting to upstream resource after n seconds. Defaults to 3

use a pool of maximum n concurrent TCP connections. Defaults to 1. Make sure your OS supports sufficient open file descriptors before settings this to a very high value.

artificial spacing in milliseconds, introduced before sending each request. Defaults to 0

preferred http version. Allowable values are 1.1. and 2. Defaults to 1.1. Please note that HTTP/2 is only supported using TLS. Http version is negotiated, not absolute and HTTP/2 may fall back to HTTP/1.1

ratio between 0.0 and 1.0 of requests to keep when saving results to disk with -O Defaults to 0

skips the general internet speed test. Note this is not targetting your URL but the speedtest.net network.

http request method, usually one of GET, PUT, POST, or DELETE

upstream resource url. Must be supplied.

list of headers to include in the request. use this to inject i.e. authentication

the expected http resonse code. if not matched, request counts as failed in test summary. Defaults to 200

The p0d team welcomes all contributors. Everyone interacting with the project's codebase, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct