diff --git a/README.rst b/README.rst index 9e47c910..28366534 100644 --- a/README.rst +++ b/README.rst @@ -2,7 +2,7 @@ HTTPie: cURL for humans ======================= -`☞ README for stable version`_ +☞ `README for stable version`_ **HTTPie is a CLI HTTP utility** built out of frustration with existing tools. Its goal is to make CLI interaction with HTTP-based services as @@ -26,19 +26,22 @@ Installation The latest **stable version** of HTTPie can always be installed or updated to via `pip`_ (prefered) -or ``easy_install``:: +or ``easy_install``: + +.. code-block:: shell pip install -U httpie # easy_install httpie + Or, you can install the **development version** directly from GitHub: .. image:: https://secure.travis-ci.org/jkbr/httpie.png :target: http://travis-ci.org/jkbr/httpie :alt: Build Status of the master branch -:: +.. code-block:: shell pip install -U https://github.com/jkbr/httpie/tarball/master @@ -100,11 +103,14 @@ separator used. Examples -------- -:: + +.. code-block:: shell http PATCH api.example.com/person/1 X-API-Token:123 name=John email=john@example.org age:=29 -The following request is issued:: +The following request is issued: + +.. code-block:: javascript PATCH /person/1 HTTP/1.1 User-Agent: HTTPie/0.1 @@ -125,12 +131,16 @@ It can easily be changed to a **form** request using the ``-f`` It is also possible to send ``multipart/form-data`` requests, i.e., to simulate a **file upload form** submission. It is done using the -``--form`` / ``-f`` flag and passing one or more file fields:: +``--form`` / ``-f`` flag and passing one or more file fields: + +.. code-block:: shell http -f POST example.com/jobs name=John cv@~/Documents/cv.pdf The above will send the same request as if the following HTML form were -submitted:: +submitted: + +.. code-block:: html