From 4a95e1f88b0996c937c98d31c94a51a450984019 Mon Sep 17 00:00:00 2001 From: Jeff Forcier Date: Tue, 8 Oct 2019 11:29:38 -0400 Subject: Add additional setuptools extras_require flavors --- sites/www/installing.rst | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) (limited to 'sites/www/installing.rst') diff --git a/sites/www/installing.rst b/sites/www/installing.rst index cffdba5f..26637e16 100644 --- a/sites/www/installing.rst +++ b/sites/www/installing.rst @@ -22,15 +22,28 @@ via `pip `_:: We currently support **Python 2.7, 3.4+, and PyPy**. Users on Python 2.6 or older (or 3.3 or older) are urged to upgrade. -Paramiko has only a few direct dependencies: +Paramiko has only a few **direct dependencies**: - The big one, with its own sub-dependencies, is Cryptography; see :ref:`its - specific note below ` for more details. + specific note below ` for more details; - `bcrypt `_, for Ed25519 key support; - `pynacl `_, also for Ed25519 key support. -If you need GSS-API / SSPI support, see :ref:`the below subsection on it -` for details on its optional dependencies. +There are also a number of **optional dependencies** you may install using +`setuptools 'extras' +`_: + +.. TODO 3.0: tweak the ed25519 line to remove the caveat + +- If you want all optional dependencies at once, use ``paramiko[everything]``. +- For GSS-API / SSPI support, use ``paramiko[gssapi]``, though also see + :ref:`the below subsection on it ` for details. +- ``paramiko[ed25519]`` references the dependencies for Ed25519 key support. + + - As of Paramiko 2.x this doesn't technically do anything, as those + dependencies are core installation requirements. + - However, you should use this for forwards compatibility; 3.0 will drop + those dependencies from core, leaving them purely optional. .. _release-lines: @@ -116,6 +129,9 @@ optional Python package requirements by changing your installation to refer to (Or update your ``requirements.txt``, or etc.) + +.. TODO: just axe this once legacy gssapi support is gone, no point reiterating + Manual dependency installation ------------------------------ -- cgit v1.2.3