noop-client

This is my first attempt at working in Rust. Feedback welcome through a comment in Discussions > Feedback Discussion.

This is a (hopefully) simple method of sending http requests (kind of like curl). Either directly; or via a pipe delimited text file -- see test/test_requests.txt.

This is still in development; but to get started; run...

make test run_help

These targets will give you some ideas on how to use it.

Install

Build

cargo install --path .

# with features
cargo install --features=all --path .

Features

all: all features
json: support json scripts and/or json output
yaml: support yaml scripts

Usage

Docker example

Source: https://hub.docker.com/r/jmervine/noop-client

$ docker run --rm jmervine/noop-client:latest -e https://www.example.com/ -n 10 -s 100 -p 1

Usage - help

$ noop-client -h
This is a (hopefully) simple method of sending http requests (kind of like curl). Either directly; or via a pipe delimited text file

Usage: noop-client [OPTIONS]

Options:
  -f, --script <SCRIPT>          File path containing a list of options to be used, in place of other arguments [default: ]
  -e, --endpoint <ENDPOINT>      Target endpoint to make an http requests against [default: ]
  -m, --method <METHOD>          Method to be used when making an http requests [default: GET]
  -x, --headers <HEADERS>        Headers to be used when making an http requests [default: ]
  -n, --iterations <ITERATIONS>  Number of requests to make for each endpoint [default: 1]
  -s, --sleep <SLEEP>            Built in sleep duration (in milliseconds) to be used when making multiple requests [default: 0]
  -p, --pool-size <POOL_SIZE>    Number of parallel requests [default: 100]
  -o, --output <OUTPUT>          Output format; options: default, json, csv, (with features) yaml, json [default: default]
  -v, --verbose                  Enable verbose output
  -D, --debug                    Enable debug output
  -E, --errors                   Enable error output for requests
  -h, --help                     Print help
  -V, --version                  Print version

Usage - basic

$ noop-client  --endpoint=https://www.example.com/
requested=1 processed=1 success=1 fail=0 error=0 duration=328.080207ms

$ noop-client  --endpoint=https://www.example.com/ --output json
{"took":66,"requested":1,"processed":1,"success":1,"fail":0,"error":0}

$ noop-client  --endpoint=https://www.example.com/ --output csv
took,requested,processed,success,fail,error
53,1,1,1,0,0

Usage - script file

See example scripts files in the test directory.

Example uses https://github.com/jmervine/noop-server running in another window.

$ echo "
iterations|method|endpoint|headers|sleep
6|GET|http://localhost:3000/request1|User-Agent:noop-client;X-Test:run1|100
1|POST|http://localhost:3000/request2|User-Agent:noop-client;X-Test:run2|10
1|DELETE|http://localhost:3000/request3|User-Agent:noop-client;X-Test:run3|10
1|GET|http://localhost:3000/request4|User-Agent:noop-client;X-Test:run4|10
0||http://localhost:3000/request5||0
1|GET|bad_endpoint|X-Error:true|0
" > script.txt

noop-client --script=test/test_script.txt --verbose

output:

code=0 requested=11 processed=1 success=0 fail=0 error=1 duration=552.454µs
code=200 requested=11 processed=2 success=1 fail=0 error=1 duration=3.384794ms
code=200 requested=11 processed=3 success=2 fail=0 error=1 duration=11.218732ms
code=200 requested=11 processed=4 success=3 fail=0 error=1 duration=11.91741ms
code=200 requested=11 processed=5 success=4 fail=0 error=1 duration=11.951396ms
code=200 requested=11 processed=6 success=5 fail=0 error=1 duration=105.801674ms
code=200 requested=11 processed=7 success=6 fail=0 error=1 duration=105.827726ms
code=200 requested=11 processed=8 success=7 fail=0 error=1 duration=107.065624ms
code=200 requested=11 processed=9 success=8 fail=0 error=1 duration=108.019409ms
code=200 requested=11 processed=10 success=9 fail=0 error=1 duration=108.097017ms
code=200 requested=11 processed=11 success=10 fail=0 error=1 duration=108.215908ms