Merge branch 'python3'

This commit is contained in:
Jeff Forcier 2014-03-15 15:00:20 -07:00
commit ebc1f38611
3 changed files with 7 additions and 34 deletions

5
README
View File

@ -5,7 +5,7 @@ paramiko
:Paramiko: Python SSH module :Paramiko: Python SSH module
:Copyright: Copyright (c) 2003-2009 Robey Pointer <robeypointer@gmail.com> :Copyright: Copyright (c) 2003-2009 Robey Pointer <robeypointer@gmail.com>
:Copyright: Copyright (c) 2014 Jeff Forcier <jeff@bitprophet.org> :Copyright: Copyright (c) 2013-2014 Jeff Forcier <jeff@bitprophet.org>
:License: LGPL :License: LGPL
:Homepage: https://github.com/paramiko/paramiko/ :Homepage: https://github.com/paramiko/paramiko/
:API docs: http://docs.paramiko.org :API docs: http://docs.paramiko.org
@ -34,7 +34,8 @@ that should have come with this archive.
Requirements Requirements
------------ ------------
- python 2.6 or better <http://www.python.org/> - Python 2.6 or better <http://www.python.org/> - this includes Python
3.3 and higher as well.
- pycrypto 2.1 or better <https://www.dlitz.net/software/pycrypto/> - pycrypto 2.1 or better <https://www.dlitz.net/software/pycrypto/>
- ecdsa 0.9 or better <https://pypi.python.org/pypi/ecdsa> - ecdsa 0.9 or better <https://pypi.python.org/pypi/ecdsa>

View File

@ -1,7 +1,7 @@
Welcome to Paramiko! Welcome to Paramiko!
==================== ====================
Paramiko is a Python (2.5+) implementation of the SSHv2 protocol [#]_, Paramiko is a Python (2.6+, 3.3+) implementation of the SSHv2 protocol [#]_,
providing both client and server functionality. While it leverages a Python C providing both client and server functionality. While it leverages a Python C
extension for low level cryptography (`PyCrypto <http://pycrypto.org>`_), extension for low level cryptography (`PyCrypto <http://pycrypto.org>`_),
Paramiko itself is a pure Python interface around SSH networking concepts. Paramiko itself is a pure Python interface around SSH networking concepts.

View File

@ -14,9 +14,9 @@ via `pip <http://pip-installer.org>`_::
Users who want the bleeding edge can install the development version via Users who want the bleeding edge can install the development version via
``pip install paramiko==dev``. ``pip install paramiko==dev``.
We currently support **Python 2.5/2.6/2.7**, with support for Python 3 coming We currently support **Python 2.6, 2.7 and 3.3** (Python **3.2** should also
soon. Users on Python 2.4 or older are urged to upgrade. Paramiko *may* work on work but has a less-strong compatibility guarantee from us.) Users on Python
Python 2.4 still, but there is no longer any support guarantee. 2.5 or older are urged to upgrade.
Paramiko has two dependencies: the pure-Python ECDSA module `ecdsa`, and the Paramiko has two dependencies: the pure-Python ECDSA module `ecdsa`, and the
PyCrypto C extension. `ecdsa` is easily installable from wherever you PyCrypto C extension. `ecdsa` is easily installable from wherever you
@ -31,34 +31,6 @@ PyCrypto
are a couple gotchas associated with installing PyCrypto: its compatibility are a couple gotchas associated with installing PyCrypto: its compatibility
with Python's package tools, and the fact that it is a C-based extension. with Python's package tools, and the fact that it is a C-based extension.
.. _pycrypto-and-pip:
Possible gotcha on older Python and/or pip versions
---------------------------------------------------
We strongly recommend using ``pip`` to as it is newer and generally better than
``easy_install``. However, a combination of bugs in specific (now rather old)
versions of Python, ``pip`` and PyCrypto can prevent installation of PyCrypto.
Specifically:
* Python = 2.5.x
* PyCrypto >= 2.1 (required for most modern versions of Paramiko)
* ``pip`` < 0.8.1
When all three criteria are met, you may encounter ``No such file or
directory`` IOErrors when trying to ``pip install paramiko`` or ``pip install
PyCrypto``.
The fix is to make sure at least one of the above criteria is not met, by doing
the following (in order of preference):
* Upgrade to ``pip`` 0.8.1 or above, e.g. by running ``pip install -U pip``.
* Upgrade to Python 2.6 or above.
* Downgrade to Paramiko 1.7.6 or 1.7.7, which do not require PyCrypto >= 2.1,
and install PyCrypto 2.0.1 (the oldest version on PyPI which works with
Paramiko 1.7.6/1.7.7)
C extension C extension
----------- -----------