Added cython based libssh2 bindings, error codes and initial session extension class implementation with exceptions

Author: Pan

.gitignore

@@ -0,0 +1,6 @@
+*.egg-info
+*.pyc
+dist
+build
+*~
+*.so

MANIFEST.in

@@ -0,0 +1,2 @@
+include libssh2/*.c
+include libssh2/*.h

README.rst

@@ -0,0 +1,63 @@
+from __future__ import print_function
+
+import platform
+import os
+import sys
+import glob
+
+# import versioneer
+from setuptools import setup, find_packages, Extension
+
+cpython = platform.python_implementation() == 'CPython'
+
+try:
+    from Cython.Build import cythonize
+except ImportError:
+    USING_CYTHON = False
+else:
+    USING_CYTHON = True
+
+ext = 'pyx' if USING_CYTHON else 'c'
+
+sources = glob.glob("ssh2/*.%s" % (ext,))
+
+extensions = [
+    Extension("ssh2.ssh2",
+              sources=sources,
+              libraries=['ssh2'],
+              # extra_compile_args=["-O3"],
+          ),
+]
+
+if USING_CYTHON:
+    extensions = cythonize(
+        extensions,
+        compiler_directives={'embedsignature': True,
+                             'optimize.use_switch': True,
+                             # 'boundscheck': False,
+                             'wraparound': False,
+                         })
+
+setup(
+    name='libssh2-python',
+    # version=versioneer.get_version(),
+    version='0.1a0',
+    url='https://github.com/ParallelSSH/libssh2_python',
+    license='LGPLv2',
+    author='Panos Kittenis',
+    author_email='22e889d8@opayq.com',
+    description=('Python bindings for libssh2 based on Cython'),
+    long_description=open('README.rst').read(),
+    packages=find_packages('.'),
+    zip_safe=False,
+    include_package_data=True,
+    platforms='any',
+    classifiers=[
+        'Intended Audience :: Developers',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 3',
+    ],
+    ext_modules=extensions,
+)

setup.py

@@ -0,0 +1 @@
+from .ssh2 import Session, Channel

ssh2/__init__.py

@@ -0,0 +1,53 @@
+cdef extern from "libssh2.h" nogil:
+    # Error Codes (defined by libssh2)
+    # The library once used -1 as a generic error return value on numerous
+    # places through the code, which subsequently was converted to
+    # LIBSSH2_ERROR_SOCKET_NONE uses over time. As this is a generic error code,
+    # the goal is to never ever return this code but instead make sure that a
+    # more accurate and descriptive error code is used.
+    enum:
+        _LIBSSH2_ERROR_NONE "LIBSSH2_ERROR_NONE"
+        _LIBSSH2_ERROR_SOCKET_NONE "LIBSSH2_ERROR_SOCKET_NONE"
+        _LIBSSH2_ERROR_BANNER_RECV "LIBSSH2_ERROR_BANNER_RECV"
+        _LIBSSH2_ERROR_BANNER_SEND "LIBSSH2_ERROR_BANNER_SEND"
+        _LIBSSH2_ERROR_KEY_EXCHANGE_FAILURE "LIBSSH2_ERROR_KEY_EXCHANGE_FAILURE"
+        _LIBSSH2_ERROR_TIMEOUT "LIBSSH2_ERROR_TIMEOUT"
+        _LIBSSH2_ERROR_HOSTKEY_INIT "LIBSSH2_ERROR_HOSTKEY_INIT"
+        _LIBSSH2_ERROR_HOSTKEY_SIGN "LIBSSH2_ERROR_HOSTKEY_SIGN"
+        _LIBSSH2_ERROR_DECRYPT "LIBSSH2_ERROR_DECRYPT"
+        _LIBSSH2_ERROR_SOCKET_DISCONNECT "LIBSSH2_ERROR_SOCKET_DISCONNECT"
+        _LIBSSH2_ERROR_PROTO "LIBSSH2_ERROR_PROTO"
+        _LIBSSH2_ERROR_PASSWORD_EXPIRED "LIBSSH2_ERROR_PASSWORD_EXPIRED"
+        _LIBSSH2_ERROR_FILE "LIBSSH2_ERROR_FILE"
+        _LIBSSH2_ERROR_METHOD_NONE "LIBSSH2_ERROR_METHOD_NONE"
+        _LIBSSH2_ERROR_AUTHENTICATION_FAILED "LIBSSH2_ERROR_AUTHENTICATION_FAILED"
+        _LIBSSH2_ERROR_PUBLICKEY_UNRECOGNIZED "LIBSSH2_ERROR_AUTHENTICATION_FAILED"
+        _LIBSSH2_ERROR_PUBLICKEY_UNVERIFIED "LIBSSH2_ERROR_PUBLICKEY_UNVERIFIED"
+        _LIBSSH2_ERROR_CHANNEL_OUTOFORDER "LIBSSH2_ERROR_CHANNEL_OUTOFORDER"
+        _LIBSSH2_ERROR_CHANNEL_FAILURE "LIBSSH2_ERROR_CHANNEL_FAILURE"
+        _LIBSSH2_ERROR_CHANNEL_REQUEST_DENIED "LIBSSH2_ERROR_CHANNEL_REQUEST_DENIED"
+        _LIBSSH2_ERROR_CHANNEL_UNKNOWN "LIBSSH2_ERROR_CHANNEL_UNKNOWN"
+        _LIBSSH2_ERROR_CHANNEL_WINDOW_EXCEEDED "LIBSSH2_ERROR_CHANNEL_WINDOW_EXCEEDED"
+        _LIBSSH2_ERROR_CHANNEL_PACKET_EXCEEDED "LIBSSH2_ERROR_CHANNEL_PACKET_EXCEEDED"
+        _LIBSSH2_ERROR_CHANNEL_CLOSED "LIBSSH2_ERROR_CHANNEL_CLOSED"
+        _LIBSSH2_ERROR_CHANNEL_EOF_SENT "LIBSSH2_ERROR_CHANNEL_EOF_SENT"
+        _LIBSSH2_ERROR_SCP_PROTOCOL "LIBSSH2_ERROR_SCP_PROTOCOL"
+        _LIBSSH2_ERROR_ZLIB "LIBSSH2_ERROR_ZLIB"
+        _LIBSSH2_ERROR_SOCKET_TIMEOUT "LIBSSH2_ERROR_SOCKET_TIMEOUT"
+        _LIBSSH2_ERROR_SFTP_PROTOCOL "LIBSSH2_ERROR_SFTP_PROTOCOL"
+        _LIBSSH2_ERROR_REQUEST_DENIED "LIBSSH2_ERROR_REQUEST_DENIED"
+        _LIBSSH2_ERROR_METHOD_NOT_SUPPORTED "LIBSSH2_ERROR_METHOD_NOT_SUPPORTED"
+        _LIBSSH2_ERROR_INVAL "LIBSSH2_ERROR_INVAL"
+        _LIBSSH2_ERROR_INVALID_POLL_TYPE "LIBSSH2_ERROR_INVALID_POLL_TYPE"
+        _LIBSSH2_ERROR_PUBLICKEY_PROTOCOL "LIBSSH2_ERROR_PUBLICKEY_PROTOCOL"
+        _LIBSSH2_ERROR_EAGAIN "LIBSSH2_ERROR_EAGAIN"
+        _LIBSSH2CHANNEL_EAGAIN "LIBSSH2_ERROR_EAGAIN"
+        _LIBSSH2_ERROR_BUFFER_TOO_SMALL "LIBSSH2_ERROR_BUFFER_TOO_SMALL"
+        _LIBSSH2_ERROR_BAD_USE "LIBSSH2_ERROR_BAD_USE"
+        _LIBSSH2_ERROR_COMPRESS "LIBSSH2_ERROR_COMPRESS"
+        _LIBSSH2_ERROR_OUT_OF_BOUNDARY "LIBSSH2_ERROR_OUT_OF_BOUNDARY"
+        _LIBSSH2_ERROR_AGENT_PROTOCOL "LIBSSH2_ERROR_AGENT_PROTOCOL"
+        _LIBSSH2_ERROR_SOCKET_RECV "LIBSSH2_ERROR_SOCKET_RECV"
+        _LIBSSH2_ERROR_ENCRYPT "LIBSSH2_ERROR_ENCRYPT"
+        _LIBSSH2_ERROR_BAD_SOCKET "LIBSSH2_ERROR_BAD_SOCKET"
+        _LIBSSH2_ERROR_KNOWN_HOSTS "LIBSSH2_ERROR_KNOWN_HOSTS"