Merge branch 'python3'
This commit is contained in:
commit
ebc1f38611
5
README
5
README
|
@ -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>
|
||||||
|
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue