From 2b0e6428424af581fd1663252d5c2212e31b2ce6 Mon Sep 17 00:00:00 2001 From: Jakub Roztocil Date: Sat, 2 Jul 2016 11:07:46 +0200 Subject: [PATCH] Document preference for Python 3 Also mention that the Homebrew formula depends on Python 3 starting with HTTPie 0.9.4. --- CHANGELOG.rst | 4 ++++ README.rst | 15 +++++++++++++-- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index fa1f8769..ca4b970c 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -9,6 +9,10 @@ This project adheres to `Semantic Versioning `_. `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) --------------------- diff --git a/README.rst b/README.rst index afacd452..e6e46ce9 100644 --- a/README.rst +++ b/README.rst @@ -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: