app riposte

On-demand http status code response

3 releases

0.1.2 Apr 17, 2023
0.1.1 Apr 17, 2023
0.1.0 Apr 17, 2023

#712 in HTTP server

32 downloads per month

MIT license

9KB
74 lines

Riposte

A server that allows clients to specify the response code that the server will return.

This could be useful for testing the logic of a client for rare or difficult to set up status code.

Instalation

Currently only linux is supported.

  1. Download the latest version from the releases page.
  2. Give executable permision to the binary chmod u+x path/to/riposte

Or build from source

  1. Instal cargo (the rust package manager)
  2. cargo install riposte

The binary will be on .cargo/bin/riposte.

Usage

Start the server (the port number can be specified, default is 8080)

riposte -p 8000

Make a request to the server which includes the header riposte-request: <code status>

Only http1.1 is currently supported

The request method can be anything and the path can also be anything

The code status must be in the range 100-999

The server will respond with that status code and the response will have the header riposte-response: <the status code specified>

Examples

Request:

GET / HTTP/1.1
Host: 127.0.0.1:8080
riposte-request: 418

Response:

HTTP/1.1 418 I'm a teapot
riposte-renspose: 418
content-length: 0

Request:

POST /baz HTTP/1.1
Host: foo.bar
Content-Type: application/x-www-form-urlencoded
Content-Length: 27
riposte-response: 502

field1=val1&field2=val2

Response:

HTTP/1.1 502 Bad Gateway
riposte-response: 502
content-lenght: 0

Dependencies

~5–14MB
~169K SLoC