# dummyhttp [![CI](https://github.com/svenstaro/dummyhttp/workflows/CI/badge.svg)](https://github.com/svenstaro/dummyhttp/actions) [![Docker Hub](https://img.shields.io/docker/pulls/svenstaro/dummyhttp)](https://cloud.docker.com/repository/docker/svenstaro/dummyhttp/) [![Crates.io](https://img.shields.io/crates/v/dummyhttp.svg)](https://crates.io/crates/dummyhttp) [![license](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/svenstaro/dummyhttp/blob/master/LICENSE) [![Lines of Code](https://tokei.rs/b1/github/svenstaro/dummyhttp)](https://github.com/svenstaro/dummyhttp) **A super simple HTTP server that replies with a fixed body and a fixed response code** This is a simple, small, self-contained, cross-platform CLI tool for debugging and testing. It allows you to return arbitrary HTTP responses and log incoming request data. HTTP/2 support included. ## How to use ### Log all incoming request data Running `dummyhttp -vv` results in this neat output: ![Pretty log](pretty_log.png) ### Running with no arguments always returns 200 on all interfaces at port 8080 dummyhttp curl -v localhost:8080 # < HTTP/1.1 200 OK # < content-length: 10 # < date: Sat, 09 Jun 2018 13:56:14 GMT # < # dummyhttp ### Always emit 400 Bad Request dummyhttp -c 400 curl -v localhost:8080 # < HTTP/1.1 400 Bad Request # < content-length: 10 # < date: Sat, 09 Jun 2018 13:57:53 GMT # < # dummyhttp ### Always return a certain string dummyhttp -b "Hello World" curl -v localhost:8080 # < HTTP/1.1 200 OK # < content-length: 12 # < date: Sat, 09 Jun 2018 13:58:57 GMT # < # Hello World ### Return a specific header dummyhttp -b '{"Hello": "World"}' -H "content-type:application/json" curl -v localhost:8080 # < HTTP/1.1 200 OK # < content-type: application/json # < date: Wed, 24 Aug 2022 00:55:35 +0200 # < content-length: 18 # < # {"Hello": "World"} ## How to install **Static builds**: These offered for **Linux**, **OSX**, and **Windows** in various architectures over at the [the releases page](https://github.com/svenstaro/dummyhttp/releases). Grab a binary corresponding to your architecture. On Linux and OSX, you need to run `chmod +x` on the binary to be able to run it. For example: chmod +x dummyhttp-1.0.2-x86_64-unknown-linux-musl Afterwards, you can run it: ./dummyhttp-1.0.2-x86_64-unknown-linux-musl **With Cargo**: If you have a somewhat recent version of Rust and Cargo installed, you can run cargo install dummyhttp dummyhttp ## Full options Super simple HTTP server that replies with a fixed body and a fixed response code Usage: dummyhttp [OPTIONS] Options: -q, --quiet Be quiet (log nothing) -v, --verbose... Be verbose (log data of incoming and outgoing requests). If given twice it will also log the body data -p, --port Port on which to listen [default: 8080] -H, --headers Headers to send (format: key:value) -c, --code


              HTTP status code to send

              [default: 200]

      -b, --body 
              HTTP body to send

              Supports Tera-based templating (https://tera.netlify.app/docs/) with a few additional
              functions over the default built-ins:

              uuid() - generate a random UUID
              lorem(words) - generate `words` lorem ipsum words

              Example: dummyhttp -b "Hello {{ uuid() }}, it's {{ now() | date(format="%Y") }} {{ lorem(words=5)}}"

              [default: dummyhttp]

      -i, --interface 
              Interface to bind to

              [default: 0.0.0.0]

          --print-completions 
              Generate completion file for a shell

              [possible values: bash, elvish, fish, powershell, zsh]

          --print-manpage
              Generate man page

          --tls-cert 
              TLS certificate to use

          --tls-key 
              TLS private key to use

      -h, --help
              Print help (see a summary with '-h')

      -V, --version
              Print version

## Releasing

This is mostly a note for me on how to release this thing:

- Make sure `CHANGELOG.md` is up to date.
- `cargo release `
- `cargo release --execute `
- Releases will automatically be deployed by GitHub Actions.
- Update Arch package.