# Kodumaro HTTP CLI
Kodumaro HTTP CLI inspired by [HTTPie][].
## Project status
It’s still a usable work in progress (ish).
## Installation guide
### From Crates.io (release)
```sh
❯ cargo install kodumaro-http-cli
❯ upx --best --lzma ~/.cargo/bin/http
```
### From Codeberg (nightly)
```sh
❯ cargo install --git=https://codeberg.org/cacilhas/microcli.git kodumaro-http-cli
❯ upx --best --lzma ~/.cargo/bin/http
```
## Usage
```sh
❯ http -h
Kodumaro HTTP CLI inspired by HTTPie
Usage: http [OPTIONS] <VERB> <URL> [PARAMS]...
Arguments:
<VERB> HTTP method [possible values: connect, delete, get, head, options, patch, post, put, trace]
<URL> URL to be requested
[PARAMS]... header:value, querystring==value, and/or payload=value, or @file-name; `!!str value` means string; anything else is interpreted as raw payload
Options:
-f, --force force overwriting existing files [env: HTTP_FORCE=]
-d, --download download response body to file instead of stdout
-o, --output <OUTPUT> save output to file instead of stdout (implies --download)
-a, --auth <AUTH> basic authentication (user[:password]) or bearer token; starting with `!!basic ` forces to use as basic authentication, and `!!bearer ` forces bearer token [env: HTTP_AUTH=]
--etag <ETAG> weak e-Tag
-F, --follow follows Location redirects [env: HTTP_FOLLOW=]
-m, --max-redirects <MAX_REDIRECTS> when following redirects, max redirects [env: HTTP_MAX_REDIRECTS=] [default: 30]
--verify <VERIFY> set to “no” or “false” to skip checking SSL certificate [env: HTTP_VERIFY=] [default: yes]
-X, --no-verify disable SSL certificate verification (equivalent to --verify=no)
--fail fail on error status code [env: HTTP_FAIL=]
-v, --verbose Show protocol details [env: HTTP_VERBOSE=]
--dry-run dry run, do not send request (implies --verbose)
-h, --help Print help (see more with '--help')
-V, --version Print version
```
Try `--help` for long help details.
If you’re unsure whether the parameters are correct, try to run `http` with the
`--dry-run` flag.
## TODO
Look at the [issues][].
## License
- [3-Clause BSD License][]
- [`COPYING`][]
[3-Clause BSD License]: https://opensource.org/licenses/BSD-3-Clause
[`COPYING`]: https://codeberg.org/cacilhas/microcli/src/branch/master/COPYING.md
[HTTPie]: https://httpie.io/
[issues]: https://codeberg.org/cacilhas/microcli/issues?type=all&state=open&labels=456821