httpie-cli/README.md
2012-02-25 20:37:33 +01:00

1.0 KiB

HTTPie: cURL for humans

HTTPie is a CLI frontend for python-requests.

httpie

Installation

pip install httpie

Usage

httpie [flags] METHOD URL [header:value | data-field-name=value]*

The default request Content-Type is application/json and data fields are automatically serialized as a JSON Object, so this:

httpie PATCH api.example.com/person/1 X-API-Token:123 name=John

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 api.example.com/person/1 X-API-Token:123 < person.json

Most of the flags mirror the arguments you would use with requests.request. See httpie -h for more details.