Document preference for Python 3

Also mention that the Homebrew formula depends on Python 3 starting with HTTPie 0.9.4.
This commit is contained in:
Jakub Roztocil 2016-07-02 11:07:46 +02:00
parent e25948f6a0
commit 2b0e642842
2 changed files with 17 additions and 2 deletions

View File

@ -9,6 +9,10 @@ This project adheres to `Semantic Versioning <http://semver.org/>`_.
`1.0.0-dev`_ (Unreleased)
-------------------------
* Added Python 3 as a dependency for Homebrew installations
to ensure some of the newer HTTP features work out of the box
for macOS users (starting with HTTPie 0.9.4.).
`0.9.4`_ (2016-07-01)
---------------------

View File

@ -117,6 +117,17 @@ The **latest development version** can be installed directly from GitHub:
$ pip install --upgrade https://github.com/jkbrzt/httpie/archive/master.tar.gz
--------------
Python version
--------------
Although Python 2.6 and 2.7 are supported as well, it is recommended to install
HTTPie against the latest Python 3.x whenever possible. That will ensure that
some of the newer HTTP features, such as `SNI (Server Name Indication)`_,
work out of the box.
Python 3 is the default for Homebrew installs starting version 0.9.4.
To see which version HTTPie uses, run ``http --debug``.
=====
Usage
@ -750,8 +761,8 @@ available set of protocols may vary depending on your OpenSSL installation.)
SNI (Server Name Indication)
----------------------------
If you use HTTPie with Python < 2.7.9
(can be verified with ``python --version``) and need to talk to servers that
If you use HTTPie with `Python version`_ lower than 2.7.9
(can be verified with ``http --debug``) and need to talk to servers that
use **SNI (Server Name Indication)** you need to install some additional
dependencies: