forked from extern/httpie-cli
40 lines
1.0 KiB
Markdown
40 lines
1.0 KiB
Markdown
## HTTPie: cURL for humans
|
|
|
|
HTTPie is a CLI frontend for [python-requests](http://python-requests.org).
|
|
|
|
|
|
### Installation
|
|
|
|
pip install httpie
|
|
|
|
|
|
### Usage
|
|
|
|
httpie [flags] METHOD [header:value data-field-name=value]* URL
|
|
|
|
The default request `Content-Type` in `application/json` and data fields are automatically serialized as a JSON `Object`, so this:
|
|
|
|
httpie PATCH X-API-Token:123 name=John api.example.com/person/1
|
|
|
|
Will issue the following request:
|
|
|
|
PATCH /person/1 HTTP/1.1
|
|
User-Agent: HTTPie/0.1
|
|
X-API-Token: 123
|
|
Content-Type: application/json; charset=utf-8
|
|
|
|
{"name": "John"}
|
|
|
|
You can use the `--form` flag to set `Content-Type` and serialize the data as `application/x-www-form-urlencoded`.
|
|
|
|
The data to be sent can also be passed via `stdin`:
|
|
|
|
httpie PUT X-API-Token:123 api.example.com/person/1 < person.json
|
|
|
|
Most of the flags mirror the arguments you would use with `requests.request`. See `httpie -h` for more details.
|
|
|
|
|
|
### Screenshot
|
|
|
|
|