This commit is contained in:
Jakub Roztocil 2015-02-15 12:53:57 +01:00
parent 5760b780a0
commit 868baaba4e

View File

@ -1,16 +1,17 @@
**************************************** ****************************************
HTTPie: a CLI, cURL-like tool for humans HTTPie: a CLI, cURL-like tool for humans
**************************************** ****************************************
|pypi| |unix_build| |windows_build| |coverage|
HTTPie (pronounced *aych-tee-tee-pie*) is a **command line HTTP client**. Its HTTPie (pronounced *aych-tee-tee-pie*) is a **command line HTTP client**. Its
goal is to make CLI interaction with web services as **human-friendly** as goal is to make CLI interaction with web services as **human-friendly** as
possible. It provides a simple ``http`` command that allows for sending possible. It provides a simple ``http`` command that allows for sending
arbitrary HTTP requests using a simple and natural syntax, and displays arbitrary HTTP requests using a simple and natural syntax, and displays
colorized responses. HTTPie can be used for **testing, debugging**, and colorized output. HTTPie can be used for **testing, debugging**, and
generally **interacting** with HTTP servers. generally **interacting** with HTTP servers.
@ -25,7 +26,16 @@ HTTPie is written in Python, and under the hood it uses the excellent
`Requests`_ and `Pygments`_ libraries. `Requests`_ and `Pygments`_ libraries.
**Table of Contents** -----
|pypi| |unix_build| |windows_build| |coverage|
-----
=================
Table of Contents
=================
.. contents:: .. contents::
@ -71,9 +81,16 @@ On **Mac OS X**, HTTPie can be installed via `Homebrew <http://brew.sh/>`_:
$ brew install httpie $ brew install httpie
Most **Linux** distributions provide a package that can be installed via Most **Linux** distributions provide a package that can be installed using the
system package manager, e.g. ``yum install httpie`` or ``apt-get install httpie``. the system package manager, e.g.:
Note that the package might include a slightly older version of HTTPie.
.. code-block:: bash
# Debian-based distributions such as Ubuntu:
$ apt-get install httpie
# RPM-based distributions:
$ yum install httpie
A **universal installation method** (that works on **Windows**, Mac OS X, Linux, …, A **universal installation method** (that works on **Windows**, Mac OS X, Linux, …,
@ -82,12 +99,14 @@ and provides the latest version) is to use `pip`_:
.. code-block:: bash .. code-block:: bash
# Make sure we have an up-to-date version of pip and setuptools:
$ pip install --upgrade pip setuptools
$ pip install --upgrade httpie $ pip install --upgrade httpie
If the above fails, please use ``easy_install`` instead (``$ easy_install httpie``). (If ``pip`` installation fails for some reason, you can try
``easy_install httpie`` as a fallback.)
------------------- -------------------