1
0
mirror of https://github.com/httpie/cli.git synced 2024-11-28 08:38:44 +02:00
httpie-cli/README.md
2012-02-25 13:52:29 +01:00

1.0 KiB

HTTPie: cURL for humans

HTTPie is a CLI frontend for python-requests.

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

httpie