From 39f458c834def3c217a3bd2eb62cc92032e20975 Mon Sep 17 00:00:00 2001 From: Jeff Forcier Date: Mon, 9 Jan 2023 17:32:18 -0500 Subject: Tidy up requires/entrypoints/install docs - Realized at this date that _moving_ Ed25519 deps behind an entrypoint is going the wrong direction, that key type should be used _more_ now, not _less_. I no longer even remember why folks were pissy about pynacl/bcrypt exactly. - We can in fact just use ed25519 from cryptography itself now, so no more pynacl anyways (but still bcrypt) - Twiddle install language a bit re: invoke used in more places, and again removing the notes about ed25519 being special --- sites/www/installing.rst | 24 ++++++++---------------- 1 file changed, 8 insertions(+), 16 deletions(-) (limited to 'sites') diff --git a/sites/www/installing.rst b/sites/www/installing.rst index b50efc4b..98c0655a 100644 --- a/sites/www/installing.rst +++ b/sites/www/installing.rst @@ -19,34 +19,26 @@ via `pip `_:: $ pip install paramiko -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. +We currently support **Python 3.6+ only**. Users on older interpreter versions +are urged to upgrade. 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; -- `bcrypt `_, for Ed25519 key support; -- `pynacl `_, also for Ed25519 key support. +- `bcrypt `_ and `pynacl + `_ for Ed25519 key support. -There are also a number of **optional dependencies** you may install using +There are also a handful of **optional dependencies** you may install using `setuptools 'extras' `_: -.. TODO 3.0: tweak the invoke line to mention proxycommand too -.. TODO 3.0: tweak the ed25519 line to remove the caveat - - If you want all optional dependencies at once, use ``paramiko[all]``. -- For ``Match exec`` config support, use ``paramiko[invoke]`` (which installs - `Invoke `_). +- For ``Match exec`` config support and/or ``ProxyCommand`` feature support, + use ``paramiko[invoke]`` (which installs `Invoke + `_). - 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: -- cgit v1.2.1