httpbin

Testing an HTTP Library can become difficult sometimes. httpbin is fantastic for testing HTTP requests, and easy to custom the response.

Installation

$ go get github.com/six-ddc/httpbin

Usage

# listen on the address, and execute 'bash -c <commands>' for each accepted HTTP request
$ httpbin <adress> -c <commands>

# listen on the address, and execute 'bash <script-file>' for each accepted HTTP request
$ httpbin <adress> <script-file>

Examples

$ httpbin :8080/hello -c 'httpbin add body world'

$ curl http://127.0.0.1:8080/hello
## world

$ httpbin :8080/ip -c 'ip=$(httpbin get ip); httpbin add body $ip'

$ curl http://127.0.0.1:8080/ip
## 127.0.0.1

$ httpbin :8080/hello -c 'sleep 5'

$ curl --max-time 3 http://127.0.0.1:8080/hello
## curl: (28) Operation timed out after 3003 milliseconds with 0 bytes received

$ httpbin :8080/github.png -c 'curl https://assets-cdn.github.com/images/modules/logos_page/GitHub-Mark.png | httpbin add body'

$ curl -O http://127.0.0.1:8080/github.png
## [github.png]

Manual

• Test HTTP request

httpbin get remote-addr
httpbin get ip
httpbin get content-length
httpbin get method
httpbin get url
httpbin get proto
httpbin get host
httpbin get header [key]
httpbin get form   [key]
httpbin get post-form [key]
httpbin get body

• Custom HTTP response

httpbin add header <key:value>
httpbin add body   [body]
httpbin add body < [body]

httpbin set code [code]