parallel-ssh 2.13.0rc1__tar.gz → 2.15.0__tar.gz

{parallel_ssh-2.13.0rc1 → parallel_ssh-2.15.0}/PKG-INFO

@@ -1,25 +1,29 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: parallel-ssh
-Version: 2.13.0rc1
+Version: 2.15.0
 Summary: Asynchronous parallel SSH library
 Home-page: https://github.com/ParallelSSH/parallel-ssh
 Author: Panos Kittenis
-Author-email: zuboci@yandex.com
-License: LGPLv2.1
+Author-email: danst@tutanota.com
+License: LGPL-2.1-only
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: System :: Shells
 Classifier: Topic :: System :: Networking
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: POSIX
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: POSIX :: BSD
 Classifier: Operating System :: Microsoft :: Windows
@@ -30,6 +34,15 @@ License-File: COPYING.LESSER
 Requires-Dist: gevent
 Requires-Dist: ssh2-python
 Requires-Dist: ssh-python
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
 
 ============
 parallel-ssh

{parallel_ssh-2.13.0rc1 → parallel_ssh-2.15.0}/parallel_ssh.egg-info/PKG-INFO

@@ -1,25 +1,29 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: parallel-ssh
-Version: 2.13.0rc1
+Version: 2.15.0
 Summary: Asynchronous parallel SSH library
 Home-page: https://github.com/ParallelSSH/parallel-ssh
 Author: Panos Kittenis
-Author-email: zuboci@yandex.com
-License: LGPLv2.1
+Author-email: danst@tutanota.com
+License: LGPL-2.1-only
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: System :: Shells
 Classifier: Topic :: System :: Networking
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: POSIX
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: POSIX :: BSD
 Classifier: Operating System :: Microsoft :: Windows
@@ -30,6 +34,15 @@ License-File: COPYING.LESSER
 Requires-Dist: gevent
 Requires-Dist: ssh2-python
 Requires-Dist: ssh-python
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
 
 ============
 parallel-ssh

parallel_ssh-2.15.0/pssh/__init__.py

@@ -0,0 +1,39 @@
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
+#
+#  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-1301  USA
+
+"""Asynchronous parallel SSH client library.
+
+Run SSH commands over many - hundreds/hundreds of thousands - number of servers
+asynchronously and with minimal system load on the client host.
+
+New users should start with `pssh.clients.ParallelSSHClient.run_command` and
+`pssh.clients.SSHClient.run_command`
+
+See also `pssh.clients.ParallelSSHClient` and pssh.clients.SSHClient`
+for class documentation.
+"""
+
+
+from logging import getLogger, NullHandler
+from . import _version
+__version__ = _version.get_versions()['version']
+del _version
+
+host_logger = getLogger('pssh.host_logger')
+logger = getLogger('pssh')
+host_logger.addHandler(NullHandler())
+logger.addHandler(NullHandler())

{parallel_ssh-2.13.0rc1 → parallel_ssh-2.15.0}/pssh/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-01-13T03:04:42+0000",
+ "date": "2025-10-12T14:04:45+0100",
  "dirty": false,
  "error": null,
- "full-revisionid": "f1d46fcf86c331b21dc199f5129f59da3bc1284e",
- "version": "2.13.0rc1"
+ "full-revisionid": "8fa5a91bbfb7cd87148a566cc3772006ec2ba989",
+ "version": "2.15.0"
 }
 '''  # END VERSION_JSON
 

parallel_ssh-2.15.0/pssh/clients/__init__.py

@@ -0,0 +1,19 @@
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
+#
+#  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-1301  USA
+
+# flake8: noqa: F401
+from .native import ParallelSSHClient, SSHClient

parallel_ssh-2.15.0/pssh/clients/base/__init__.py

@@ -0,0 +1,16 @@
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
+#
+#  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-1301  USA

{parallel_ssh-2.13.0rc1 → parallel_ssh-2.15.0}/pssh/clients/base/parallel.py

@@ -1,19 +1,19 @@
-# This file is part of parallel-ssh.
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
 #
-# Copyright (C) 2014-2022 Panos Kittenis and contributors.
+#  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 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.
 #
-# 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-1301  USA
+#  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-1301  USA
 
 """Abstract parallel SSH client package"""
 
@@ -23,7 +23,7 @@ import gevent.pool
 from gevent import joinall, spawn, Timeout as GTimeout
 from gevent.hub import Hub
 
-from ..common import _validate_pkey_path, _validate_pkey
+from ..common import _validate_pkey_path, _validate_pkey, _validate_api
 from ...config import HostConfig
 from ...constants import DEFAULT_RETRIES, RETRY_DELAY
 from ...exceptions import HostArgumentError, Timeout, ShellError, HostConfigError
@@ -55,6 +55,8 @@ class BaseParallelSSHClient(object):
                  gssapi_client_identity=None,
                  gssapi_delegate_credentials=False,
                  forward_ssh_agent=False,
+                 compress=False,
+                 keyboard_interactive=False,
                  _auth_thread_pool=True,
                  ):
         self.allow_agent = allow_agent
@@ -86,6 +88,9 @@ class BaseParallelSSHClient(object):
         self.gssapi_server_identity = gssapi_server_identity
         self.gssapi_client_identity = gssapi_client_identity
         self.gssapi_delegate_credentials = gssapi_delegate_credentials
+        self.compress = compress
+        self.keyboard_interactive = keyboard_interactive
+        _validate_api(self.keyboard_interactive, self.password)
         self._auth_thread_pool = _auth_thread_pool
         self._check_host_config()
 
@@ -114,20 +119,6 @@ class BaseParallelSSHClient(object):
             self._host_clients.pop((i, host), None)
         self._hosts = _hosts
 
-    def __del__(self):
-        self.disconnect()
-
-    def disconnect(self):
-        """Disconnect all clients."""
-        if not hasattr(self, '_host_clients'):
-            return
-        for s_client in self._host_clients.values():
-            try:
-                s_client.disconnect()
-            except Exception as ex:
-                logger.debug("Client disconnect failed with %s", ex)
-                pass
-
     def _check_host_config(self):
         if self.host_config is None:
             return

{parallel_ssh-2.13.0rc1 → parallel_ssh-2.15.0}/pssh/clients/base/single.py

@@ -1,33 +1,36 @@
-# This file is part of parallel-ssh.
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
 #
-# Copyright (C) 2014-2022 Panos Kittenis and contributors.
+#  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 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.
 #
-# 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-1301  USA
+#  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-1301  USA
 
 import logging
 import os
 from getpass import getuser
 from socket import gaierror as sock_gaierror, error as sock_error
+from warnings import warn
 
 from gevent import sleep, socket, Timeout as GTimeout
 from gevent.hub import Hub
+from gevent.pool import Pool
 from gevent.select import poll, POLLIN, POLLOUT
+from gevent.socket import SHUT_RDWR
 from ssh2.exceptions import AgentConnectionError, AgentListIdentitiesError, \
     AgentAuthenticationError, AgentGetIdentityError
 from ssh2.utils import find_eol
 
-from ..common import _validate_pkey
+from ..common import _validate_pkey, _validate_api
 from ..reader import ConcurrentRWBuffer
 from ...constants import DEFAULT_RETRIES, RETRY_DELAY
 from ...exceptions import UnknownHostError, AuthenticationError, \
@@ -39,6 +42,61 @@ host_logger = logging.getLogger('pssh.host_logger')
 logger = logging.getLogger(__name__)
 
 
+class PollMixIn(object):
+    """MixIn for co-operative socket polling functionality.
+
+    """
+    __slots__ = ('sock',)
+
+    def __init__(self, sock=None):
+        self.sock = sock
+
+    def poll(self, timeout=None):
+        raise NotImplementedError
+
+    def eagain(self, func, *args, **kwargs):
+        raise NotImplementedError
+
+    def eagain_write(self, write_func, data):
+        raise NotImplementedError
+
+    def _poll_errcodes(self, directions_func, inbound, outbound):
+        directions = directions_func()
+        if directions == 0:
+            return
+        events = 0
+        if directions & inbound:
+            events = POLLIN
+        if directions & outbound:
+            events |= POLLOUT
+        self._poll_socket(events)
+
+    def _poll_socket(self, events):
+        if self.sock is None:
+            return
+        poller = poll()
+        poller.register(self.sock, eventmask=events)
+        poller.poll(timeout=1)
+
+    def _eagain_errcode(self, func, eagain, *args, **kwargs):
+        ret = func(*args, **kwargs)
+        while ret == eagain:
+            self.poll()
+            ret = func(*args, **kwargs)
+            sleep()
+        return ret
+
+    def _eagain_write_errcode(self, write_func, data, eagain):
+        data_len = len(data)
+        total_written = 0
+        while total_written < data_len:
+            rc, bytes_written = write_func(data[total_written:])
+            total_written += bytes_written
+            if rc == eagain:
+                self.poll()
+            sleep()
+
+
 class Stdin(object):
     """Stdin stream for a channel.
 
@@ -64,13 +122,13 @@ class Stdin(object):
         :param data: Data to write.
         :type data: str
         """
-        return self._client._eagain(self._channel.write, data)
+        return self._client.eagain(self._channel.write, data)
 
     def flush(self):
         """Flush pending data written to stdin."""
         if not hasattr(self._channel, "flush"):
             return
-        return self._client._eagain(self._channel.flush)
+        return self._client.eagain(self._channel.flush)
 
 
 class InteractiveShell(object):
@@ -132,7 +190,7 @@ class InteractiveShell(object):
         """Wait for shell to finish executing and close channel."""
         if self._chan is None:
             return
-        self._client._eagain(self._chan.send_eof)
+        self._client.eagain(self._chan.send_eof)
         self._client.wait_finished(self.output)
         return self
 
@@ -144,10 +202,10 @@ class InteractiveShell(object):
         :type cmd: str
         """
         cmd = cmd.encode(self._encoding) + self._EOL
-        self._client._eagain_write(self._chan.write, cmd)
+        self._client.eagain_write(self._chan.write, cmd)
 
 
-class BaseSSHClient(object):
+class BaseSSHClient(PollMixIn):
 
     IDENTITIES = (
         os.path.expanduser('~/.ssh/id_rsa'),
@@ -168,15 +226,18 @@ class BaseSSHClient(object):
                  _auth_thread_pool=True,
                  identity_auth=True,
                  ipv6_only=False,
+                 compress=False,
+                 keyboard_interactive=False,
                  ):
+        super(PollMixIn, self).__init__()
         self._auth_thread_pool = _auth_thread_pool
         self.host = host
         self.alias = alias
         self.user = user if user else getuser()
         self.password = password
+        self.keyboard_interactive = keyboard_interactive
         self.port = port if port else 22
         self.num_retries = num_retries
-        self.sock = None
         self.timeout = timeout if timeout else None
         self.retry_delay = retry_delay
         self.allow_agent = allow_agent
@@ -187,6 +248,10 @@ class BaseSSHClient(object):
         self.identity_auth = identity_auth
         self._keepalive_greenlet = None
         self.ipv6_only = ipv6_only
+        self.compress = compress
+        self.keyboard_interactive = keyboard_interactive
+        _validate_api(self.keyboard_interactive, self.password)
+        self._pool = Pool()
         self._init()
 
     def _pkey_from_memory(self, pkey_data):
@@ -212,11 +277,15 @@ class BaseSSHClient(object):
             raise AuthenticationError(msg, self.host, self.port, ex, retries, self.num_retries)
 
     def disconnect(self):
+        """Deprecated and a no-op. Disconnections handled by client de-allocation."""
+        warn("Deprecated and a no-op - to be removed in future releases.", DeprecationWarning)
+
+    def _disconnect(self):
         raise NotImplementedError
 
     def __del__(self):
         try:
-            self.disconnect()
+            self._disconnect()
         except Exception:
             pass
 
@@ -224,7 +293,7 @@ class BaseSSHClient(object):
         return self
 
     def __exit__(self, *args):
-        self.disconnect()
+        self._disconnect()
 
     def open_shell(self, encoding='utf-8', read_timeout=None):
         """Open interactive shell on new channel.
@@ -244,7 +313,8 @@ class BaseSSHClient(object):
         raise NotImplementedError
 
     def _disconnect_eagain(self):
-        self._eagain(self.session.disconnect)
+        if self.session is not None and self.sock is not None and not self.sock.closed:
+            self.eagain(self.session.disconnect)
 
     def _connect_init_session_retry(self, retries):
         try:
@@ -254,9 +324,11 @@ class BaseSSHClient(object):
         self.session = None
         if not self.sock.closed:
             try:
-                self.sock.close()
+                self.sock.shutdown(SHUT_RDWR)
+                self.sock.detach()
             except Exception:
                 pass
+        self.sock = None
         sleep(self.retry_delay)
         self._connect(self._host, self._port, retries=retries)
         return self._init_session(retries=retries)
@@ -371,7 +443,7 @@ class BaseSSHClient(object):
             msg = "No remaining authentication methods"
             logger.error(msg)
             raise AuthenticationError(msg)
-        logger.debug("Private key auth failed, trying password")
+        logger.debug("Private key auth failed or not enabled, trying password")
         self._password_auth()
 
     def _agent_auth(self):
@@ -420,6 +492,13 @@ class BaseSSHClient(object):
         raise NotImplementedError
 
     def execute(self, cmd, use_pty=False, channel=None):
+        """
+        Deprecated - use ``run_command`` instead which returns a ``HostOutput`` object.
+        """
+        warn("Deprecated - use run_command instead.", DeprecationWarning)
+        return self._execute(cmd, use_pty=use_pty, channel=channel)
+
+    def _execute(self, cmd, use_pty=False, channel=None):
         raise NotImplementedError
 
     def read_stderr(self, stderr_buffer, timeout=None):
@@ -554,37 +633,11 @@ class BaseSSHClient(object):
             _command += "%s '%s'" % (_shell, command,)
         _command = _command.encode(encoding)
         with GTimeout(seconds=self.timeout):
-            channel = self.execute(_command, use_pty=use_pty)
+            channel = self._execute(_command, use_pty=use_pty)
         _timeout = read_timeout if read_timeout else timeout
         host_out = self._make_host_output(channel, encoding, _timeout)
         return host_out
 
-    def _eagain_write_errcode(self, write_func, data, eagain):
-        data_len = len(data)
-        total_written = 0
-        while total_written < data_len:
-            rc, bytes_written = write_func(data[total_written:])
-            total_written += bytes_written
-            if rc == eagain:
-                self.poll()
-            sleep()
-
-    def _eagain_errcode(self, func, eagain, *args, **kwargs):
-        timeout = kwargs.pop('timeout', self.timeout)
-        with GTimeout(seconds=timeout, exception=Timeout):
-            ret = func(*args, **kwargs)
-            while ret == eagain:
-                self.poll()
-                ret = func(*args, **kwargs)
-                sleep()
-            return ret
-
-    def _eagain_write(self, write_func, data):
-        raise NotImplementedError
-
-    def _eagain(self, func, *args, **kwargs):
-        raise NotImplementedError
-
     def _make_sftp(self):
         raise NotImplementedError
 
@@ -692,24 +745,3 @@ class BaseSSHClient(object):
         _sep = file_path.rfind('/')
         if _sep > 0:
             return file_path[:_sep]
-
-    def poll(self):
-        raise NotImplementedError
-
-    def _poll_socket(self, events):
-        if self.sock is None:
-            return
-        poller = poll()
-        poller.register(self.sock, eventmask=events)
-        poller.poll(timeout=1)
-
-    def _poll_errcodes(self, directions_func, inbound, outbound):
-        directions = directions_func()
-        if directions == 0:
-            return
-        events = 0
-        if directions & inbound:
-            events = POLLIN
-        if directions & outbound:
-            events |= POLLOUT
-        self._poll_socket(events)

parallel_ssh-2.15.0/pssh/clients/common.py

@@ -0,0 +1,51 @@
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
+#
+#  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-1301  USA
+
+import logging
+import os
+
+from ..exceptions import PKeyFileError, InvalidAPIUseError
+
+logger = logging.getLogger('pssh')
+
+
+def _validate_pkey_path(pkey):
+    if pkey is None:
+        return
+    pkey = os.path.normpath(os.path.expanduser(pkey))
+    if not os.path.exists(pkey):
+        msg = "File %s does not exist. " \
+              "Please use either absolute or relative to user directory " \
+              "paths like '~/.ssh/my_key' for pkey parameter"
+        ex = PKeyFileError(msg, pkey)
+        raise ex
+    return pkey
+
+
+def _validate_pkey(pkey):
+    if pkey is None:
+        return
+    if isinstance(pkey, str):
+        return _validate_pkey_path(pkey)
+    return pkey
+
+
+def _validate_api(keyboard_interactive, password):
+    if keyboard_interactive and not password:
+        msg = "Keyboard interactive authentication is enabled but no password is provided - cannot continue"
+        logger.error(msg)
+        raise InvalidAPIUseError(msg)

parallel_ssh-2.15.0/pssh/clients/native/__init__.py

@@ -0,0 +1,20 @@
+#  This file is part of parallel-ssh.
+#  Copyright (C) 2014-2025 Panos Kittenis.
+#  Copyright (C) 2014-2025 parallel-ssh Contributors.
+#
+#  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-1301  USA
+
+# flake8: noqa: F401
+from .parallel import ParallelSSHClient
+from .single import SSHClient, logger