Added ssh options and exceptions implementation.

Updated definition file.
Added basic tests and embedded server.

Author: Pan

ssh/c_ssh.pxd

@@ -532,7 +532,7 @@ cdef extern from "libssh/libssh.h" nogil:
     ssh_string ssh_string_new(size_t size)
     const char *ssh_string_get_char(ssh_string str)
     char *ssh_string_to_char(ssh_string str)
-    ssh_string_free_char(char *s)
+    void ssh_string_free_char(char *s)
 
     int ssh_getpass(const char *prompt, char *buf, size_t len, int echo,
                     int verify)

ssh/exceptions.pyx

@@ -0,0 +1,35 @@
+# This file is part of ssh-python.
+# Copyright (C) 2018 Panos Kittenis
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation, version 2.1.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-130
+
+
+class OptionError(Exception):
+    """Raised on errors getting/setting options"""
+
+
+class BaseSSHError(Exception):
+    """Base class for all errors produced by libssh"""
+
+
+class RequestDenied(BaseSSHError):
+    """Raised on request denied by server errors"""
+
+
+class FatalError(BaseSSHError):
+    """Raised on unrecoverable errors"""
+
+
+class OtherError(BaseSSHError):
+    """Raised on other non-specific fatal errors"""

ssh/options.pxd

@@ -0,0 +1,64 @@
+# This file is part of ssh-python.
+# Copyright (C) 2018 Panos Kittenis
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation, version 2.1.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-130
+
+from c_ssh cimport ssh_options_e
+
+
+cdef class Option:
+    cdef ssh_options_e _option
+
+    @staticmethod
+    cdef object from_option(ssh_options_e option)
+
+
+# cdef ssh_options_e HOST
+# cdef ssh_options_e USER
+# cdef ssh_options_e PORT
+# cdef ssh_options_e PORT_STR
+# cdef ssh_options_e FD
+# cdef ssh_options_e USER
+# cdef ssh_options_e SSH_DIR
+# cdef ssh_options_e IDENTITY
+# cdef ssh_options_e ADD_IDENTITY
+# cdef ssh_options_e KNOWNHOSTS
+# cdef ssh_options_e TIMEOUT
+# cdef ssh_options_e TIMEOUT_USEC
+# cdef ssh_options_e SSH1
+# cdef ssh_options_e SSH2
+# cdef ssh_options_e LOG_VERBOSITY
+# cdef ssh_options_e LOG_VERBOSITY_STR
+# cdef ssh_options_e CIPHERS_C_S
+# cdef ssh_options_e CIPHERS_S_C
+# cdef ssh_options_e COMPRESSION_C_S
+# cdef ssh_options_e COMPRESSION_S_C
+# cdef ssh_options_e PROXYCOMMAND
+# cdef ssh_options_e BINDADDR
+# cdef ssh_options_e STRICTHOSTKEYCHECK
+# cdef ssh_options_e COMPRESSION
+# cdef ssh_options_e COMPRESSION_LEVEL
+# cdef ssh_options_e KEY_EXCHANGE
+# cdef ssh_options_e HOSTKEYS
+# cdef ssh_options_e GSSAPI_SERVER_IDENTITY
+# cdef ssh_options_e GSSAPI_CLIENT_IDENTITY
+# cdef ssh_options_e GSSAPI_DELEGATE_CREDENTIALS
+# cdef ssh_options_e HMAC_C_S
+# cdef ssh_options_e HMAC_S_C
+# cdef ssh_options_e PASSWORD_AUTH
+# cdef ssh_options_e PUBKEY_AUTH
+# cdef ssh_options_e KBDINT_AUTH
+# cdef ssh_options_e GSSAPI_AUTH
+# cdef ssh_options_e GLOBAL_KNOWNHOSTS
+# cdef ssh_options_e NODELAY

ssh/options.pyx

@@ -0,0 +1,77 @@
+# This file is part of ssh-python.
+# Copyright (C) 2018 Panos Kittenis
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation, version 2.1.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-130
+
+from c_ssh cimport ssh_options_e
+
+
+cdef class Option:
+    """Class for representing an SSH option."""
+
+    @staticmethod
+    cdef object from_option(ssh_options_e option):
+        cdef Option _option = Option.__new__(Option)
+        _option._option = option
+        return _option
+
+    @property
+    def value(self):
+        return self._option
+
+    def __str__(self):
+        return str(self._option)
+
+    def __repr__(self):
+        return self.__str__()
+
+
+HOST = Option.from_option(ssh_options_e.SSH_OPTIONS_HOST)
+USER = Option.from_option(ssh_options_e.SSH_OPTIONS_USER)
+PORT = Option.from_option(ssh_options_e.SSH_OPTIONS_PORT)
+PORT_STR = Option.from_option(ssh_options_e.SSH_OPTIONS_PORT_STR)
+FD = Option.from_option(ssh_options_e.SSH_OPTIONS_FD)
+USER = Option.from_option(ssh_options_e.SSH_OPTIONS_USER)
+SSH_DIR = Option.from_option(ssh_options_e.SSH_OPTIONS_SSH_DIR)
+IDENTITY = Option.from_option(ssh_options_e.SSH_OPTIONS_IDENTITY)
+ADD_IDENTITY = Option.from_option(ssh_options_e.SSH_OPTIONS_ADD_IDENTITY)
+KNOWNHOSTS = Option.from_option(ssh_options_e.SSH_OPTIONS_KNOWNHOSTS)
+TIMEOUT = Option.from_option(ssh_options_e.SSH_OPTIONS_TIMEOUT)
+TIMEOUT_USEC = Option.from_option(ssh_options_e.SSH_OPTIONS_TIMEOUT_USEC)
+SSH1 = Option.from_option(ssh_options_e.SSH_OPTIONS_SSH1)
+SSH2 = Option.from_option(ssh_options_e.SSH_OPTIONS_SSH2)
+LOG_VERBOSITY = Option.from_option(ssh_options_e.SSH_OPTIONS_LOG_VERBOSITY)
+LOG_VERBOSITY_STR = Option.from_option(ssh_options_e.SSH_OPTIONS_LOG_VERBOSITY_STR)
+CIPHERS_C_S = Option.from_option(ssh_options_e.SSH_OPTIONS_CIPHERS_C_S)
+CIPHERS_S_C = Option.from_option(ssh_options_e.SSH_OPTIONS_CIPHERS_S_C)
+COMPRESSION_C_S = Option.from_option(ssh_options_e.SSH_OPTIONS_COMPRESSION_C_S)
+COMPRESSION_S_C = Option.from_option(ssh_options_e.SSH_OPTIONS_COMPRESSION_S_C)
+PROXYCOMMAND = Option.from_option(ssh_options_e.SSH_OPTIONS_PROXYCOMMAND)
+BINDADDR = Option.from_option(ssh_options_e.SSH_OPTIONS_BINDADDR)
+STRICTHOSTKEYCHECK = Option.from_option(ssh_options_e.SSH_OPTIONS_STRICTHOSTKEYCHECK)
+COMPRESSION = Option.from_option(ssh_options_e.SSH_OPTIONS_COMPRESSION)
+COMPRESSION_LEVEL = Option.from_option(ssh_options_e.SSH_OPTIONS_COMPRESSION_LEVEL)
+KEY_EXCHANGE = Option.from_option(ssh_options_e.SSH_OPTIONS_KEY_EXCHANGE)
+HOSTKEYS = Option.from_option(ssh_options_e.SSH_OPTIONS_HOSTKEYS)
+GSSAPI_SERVER_IDENTITY = Option.from_option(ssh_options_e.SSH_OPTIONS_GSSAPI_SERVER_IDENTITY)
+GSSAPI_CLIENT_IDENTITY = Option.from_option(ssh_options_e.SSH_OPTIONS_GSSAPI_CLIENT_IDENTITY)
+GSSAPI_DELEGATE_CREDENTIALS = Option.from_option(ssh_options_e.SSH_OPTIONS_GSSAPI_DELEGATE_CREDENTIALS)
+HMAC_C_S = Option.from_option(ssh_options_e.SSH_OPTIONS_HMAC_C_S)
+HMAC_S_C = Option.from_option(ssh_options_e.SSH_OPTIONS_HMAC_S_C)
+PASSWORD_AUTH = Option.from_option(ssh_options_e.SSH_OPTIONS_PASSWORD_AUTH)
+PUBKEY_AUTH = Option.from_option(ssh_options_e.SSH_OPTIONS_PUBKEY_AUTH)
+KBDINT_AUTH = Option.from_option(ssh_options_e.SSH_OPTIONS_KBDINT_AUTH)
+GSSAPI_AUTH = Option.from_option(ssh_options_e.SSH_OPTIONS_GSSAPI_AUTH)
+GLOBAL_KNOWNHOSTS = Option.from_option(ssh_options_e.SSH_OPTIONS_GLOBAL_KNOWNHOSTS)
+NODELAY = Option.from_option(ssh_options_e.SSH_OPTIONS_NODELAY)