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

parallel_ssh-2.13.0rc1/MANIFEST.in

@@ -0,0 +1,14 @@
+include versioneer.py
+include pssh/_version.py
+include LICENSE
+include COPYING
+include COPYING.LESSER
+exclude .codecov.yml
+exclude .coveragerc
+exclude .git*
+exclude .pre-commit*
+exclude .readthedocs.yml
+recursive-exclude tests *
+recursive-exclude ci *
+recursive-exclude .circleci *
+recursive-exclude .github *

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/PKG-INFO

@@ -1,23 +1,22 @@
 Metadata-Version: 2.1
 Name: parallel-ssh
-Version: 2.12.0
+Version: 2.13.0rc1
 Summary: Asynchronous parallel SSH library
 Home-page: https://github.com/ParallelSSH/parallel-ssh
 Author: Panos Kittenis
 Author-email: zuboci@yandex.com
 License: LGPLv2.1
-Platform: UNKNOWN
 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.6
-Classifier: Programming Language :: Python :: 3.7
 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: Topic :: System :: Networking
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -28,6 +27,9 @@ Classifier: Operating System :: MacOS :: MacOS X
 License-File: LICENSE
 License-File: COPYING
 License-File: COPYING.LESSER
+Requires-Dist: gevent
+Requires-Dist: ssh2-python
+Requires-Dist: ssh-python
 
 ============
 parallel-ssh
@@ -56,6 +58,7 @@ Native code based clients with extremely high performance, making use of C libra
   :alt: Latest documentation
 
 .. _`read the docs`: https://parallel-ssh.readthedocs.org/en/latest/
+.. _`SFTP and SCP documentation`: https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp
 
 ************
 Installation
@@ -270,7 +273,7 @@ To copy a local file to remote hosts in parallel with SCP:
   cmds = client.scp_send('../test', 'test_dir/test')
   joinall(cmds, raise_error=True)
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
+See `SFTP and SCP documentation`_ for more examples.
 
 
 *****
@@ -306,10 +309,4 @@ In addition, per-host configurable file name functionality is provided for both
 
 Directory recursion is supported in both cases via the ``recurse`` parameter - defaults to off.
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
-
-
-.. image:: https://ga-beacon.appspot.com/UA-9132694-7/parallel-ssh/README.rst?pixel
-  :target: https://github.com/igrigorik/ga-beacon
-
-
+See `SFTP and SCP documentation`_ for more examples.

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/README.rst

@@ -25,6 +25,7 @@ Native code based clients with extremely high performance, making use of C libra
   :alt: Latest documentation
 
 .. _`read the docs`: https://parallel-ssh.readthedocs.org/en/latest/
+.. _`SFTP and SCP documentation`: https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp
 
 ************
 Installation
@@ -239,7 +240,7 @@ To copy a local file to remote hosts in parallel with SCP:
   cmds = client.scp_send('../test', 'test_dir/test')
   joinall(cmds, raise_error=True)
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
+See `SFTP and SCP documentation`_ for more examples.
 
 
 *****
@@ -275,8 +276,4 @@ In addition, per-host configurable file name functionality is provided for both
 
 Directory recursion is supported in both cases via the ``recurse`` parameter - defaults to off.
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
-
-
-.. image:: https://ga-beacon.appspot.com/UA-9132694-7/parallel-ssh/README.rst?pixel
-  :target: https://github.com/igrigorik/ga-beacon
+See `SFTP and SCP documentation`_ for more examples.

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/parallel_ssh.egg-info/PKG-INFO

@@ -1,23 +1,22 @@
 Metadata-Version: 2.1
 Name: parallel-ssh
-Version: 2.12.0
+Version: 2.13.0rc1
 Summary: Asynchronous parallel SSH library
 Home-page: https://github.com/ParallelSSH/parallel-ssh
 Author: Panos Kittenis
 Author-email: zuboci@yandex.com
 License: LGPLv2.1
-Platform: UNKNOWN
 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.6
-Classifier: Programming Language :: Python :: 3.7
 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: Topic :: System :: Networking
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -28,6 +27,9 @@ Classifier: Operating System :: MacOS :: MacOS X
 License-File: LICENSE
 License-File: COPYING
 License-File: COPYING.LESSER
+Requires-Dist: gevent
+Requires-Dist: ssh2-python
+Requires-Dist: ssh-python
 
 ============
 parallel-ssh
@@ -56,6 +58,7 @@ Native code based clients with extremely high performance, making use of C libra
   :alt: Latest documentation
 
 .. _`read the docs`: https://parallel-ssh.readthedocs.org/en/latest/
+.. _`SFTP and SCP documentation`: https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp
 
 ************
 Installation
@@ -270,7 +273,7 @@ To copy a local file to remote hosts in parallel with SCP:
   cmds = client.scp_send('../test', 'test_dir/test')
   joinall(cmds, raise_error=True)
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
+See `SFTP and SCP documentation`_ for more examples.
 
 
 *****
@@ -306,10 +309,4 @@ In addition, per-host configurable file name functionality is provided for both
 
 Directory recursion is supported in both cases via the ``recurse`` parameter - defaults to off.
 
-See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
-
-
-.. image:: https://ga-beacon.appspot.com/UA-9132694-7/parallel-ssh/README.rst?pixel
-  :target: https://github.com/igrigorik/ga-beacon
-
-
+See `SFTP and SCP documentation`_ for more examples.

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/parallel_ssh.egg-info/requires.txt

@@ -1,3 +1,3 @@
-gevent>=1.3.0
+gevent
 ssh2-python
 ssh-python

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/__init__.py

@@ -29,9 +29,9 @@ for class documentation.
 
 
 from logging import getLogger, NullHandler
-from ._version import get_versions
-__version__ = get_versions()['version']
-del get_versions
+from . import _version
+__version__ = _version.get_versions()['version']
+del _version
 
 host_logger = getLogger('pssh.host_logger')
 logger = getLogger('pssh')

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/_version.py

@@ -1,5 +1,5 @@
 
-# This file was generated by 'versioneer.py' (0.18) from
+# This file was generated by 'versioneer.py' (0.29) from
 # revision-control system data, or from the parent directory name of an
 # unpacked source archive. Distribution tarballs contain a pre-generated copy
 # of this file.
@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2022-08-20T12:23:39+0100",
+ "date": "2025-01-13T03:04:42+0000",
  "dirty": false,
  "error": null,
- "full-revisionid": "d812ff32d828009ddb94f458fe43920c22df4c0e",
- "version": "2.12.0"
+ "full-revisionid": "f1d46fcf86c331b21dc199f5129f59da3bc1284e",
+ "version": "2.13.0rc1"
 }
 '''  # END VERSION_JSON
 

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/clients/__init__.py

@@ -1,6 +1,6 @@
 # This file is part of parallel-ssh.
 #
-# Copyright (C) 2014-2022 Panos Kittenis and contributors.
+# Copyright (C) 2014-2025 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
@@ -16,5 +16,4 @@
 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 
 # flake8: noqa: F401
-from .native.parallel import ParallelSSHClient
-from .native.single import SSHClient
+from .native import ParallelSSHClient, SSHClient

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

@@ -118,6 +118,7 @@ class BaseParallelSSHClient(object):
         self.disconnect()
 
     def disconnect(self):
+        """Disconnect all clients."""
         if not hasattr(self, '_host_clients'):
             return
         for s_client in self._host_clients.values():
@@ -126,7 +127,6 @@ class BaseParallelSSHClient(object):
             except Exception as ex:
                 logger.debug("Client disconnect failed with %s", ex)
                 pass
-            del s_client
 
     def _check_host_config(self):
         if self.host_config is None:
@@ -266,7 +266,7 @@ class BaseParallelSSHClient(object):
         :param cmds: Commands to get output for. Defaults to ``client.cmds``
         :type cmds: list(:py:class:`gevent.Greenlet`)
 
-        :rtype: dict or list
+        :rtype: list(:py:class:`pssh.output.HostOutput`)
         """
         cmds = self.cmds if cmds is None else cmds
         if cmds is None:
@@ -290,7 +290,6 @@ class BaseParallelSSHClient(object):
                 gssapi_server_identity=self.gssapi_server_identity,
                 gssapi_client_identity=self.gssapi_client_identity,
                 gssapi_delegate_credentials=self.gssapi_delegate_credentials,
-                alias=None,
             )
             return config
         config = self.host_config[host_i]

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/clients/base/single.py

@@ -68,6 +68,8 @@ class Stdin(object):
 
     def flush(self):
         """Flush pending data written to stdin."""
+        if not hasattr(self._channel, "flush"):
+            return
         return self._client._eagain(self._channel.flush)
 
 

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/clients/native/single.py

@@ -213,10 +213,12 @@ class SSHClient(BaseSSHClient):
             sleep(self._eagain(self.session.keepalive_send))
 
     def configure_keepalive(self):
+        """Configures keepalive on the server for `self.keepalive_seconds`."""
         self.session.keepalive_config(False, self.keepalive_seconds)
 
     def _init_session(self, retries=1):
         self.session = Session()
+
         if self.timeout:
             # libssh2 timeout is in ms
             self.session.set_timeout(self.timeout * 1000)
@@ -266,7 +268,10 @@ class SSHClient(BaseSSHClient):
         return chan
 
     def open_session(self):
-        """Open new channel from session"""
+        """Open new channel from session.
+
+        :rtype: :py:class:`ssh2.channel.Channel`
+        """
         try:
             chan = self._open_session()
         except Exception as ex:
@@ -662,9 +667,9 @@ class SSHClient(BaseSSHClient):
         elif remote_file.endswith('/'):
             local_filename = local_file.rsplit('/')[-1]
             remote_file += local_filename
-        self._scp_send(local_file, remote_file)
         logger.info("SCP local file %s to remote destination %s:%s",
                     local_file, self.host, remote_file)
+        self._scp_send(local_file, remote_file)
 
     def _scp_send(self, local_file, remote_file):
         fileinfo = os.stat(local_file)

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/clients/native/tunnel.py

@@ -16,9 +16,8 @@
 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 
 import logging
-
-from threading import Thread, Event
 from queue import Queue
+from threading import Thread, Event
 
 from gevent import spawn, joinall, get_hub, sleep
 from gevent.server import StreamServer
@@ -26,7 +25,6 @@ from ssh2.error_codes import LIBSSH2_ERROR_EAGAIN
 
 from ...constants import DEFAULT_RETRIES
 
-
 logger = logging.getLogger(__name__)
 
 

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/clients/reader.py

@@ -34,11 +34,13 @@ class _Eof(Event):
 class ConcurrentRWBuffer(object):
     """Concurrent reader/writer of bytes for use from multiple greenlets.
 
-    Supports both concurrent reading and writing.
+    Supports both concurrent reading and writing and combinations there of.
 
     Iterate on buffer object to read data, yielding event loop if no data exists
     until self.eof has been set.
 
+    Check if end-of-file without blocking with ``ConcurrentRWBuffer.eof.is_set()``.
+
     Writers should call ``ConcurrentRWBuffer.eof.set()`` when finished writing data via ``write``.
 
     Readers can use ``read()`` to get any available data or ``None``.

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/config.py

@@ -59,7 +59,7 @@ class HostConfig(object):
         :param allow_agent: Enable/disable SSH agent authentication.
         :type allow_agent: bool
         :param alias: Use an alias for this host.
-        :type alias: str or int
+        :type alias: str
         :param num_retries: Number of retry attempts before giving up on connection
           and SSH operations.
         :type num_retries: int

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/pssh/output.py

@@ -70,7 +70,7 @@ class HostOutput(object):
         :param stdin: Standard input buffer
         :type stdin: :py:func:`file`-like object
         :param client: `SSHClient` output is coming from.
-        :type client: :py:class:`pssh.clients.base.single.BaseSSHClient`
+        :type client: :py:class:`pssh.clients.base.single.BaseSSHClient` or `None`.
         :param alias: Host alias.
         :type alias: str
         :param exception: Exception from host if any

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/setup.cfg

@@ -1,5 +1,5 @@
 [versioneer]
-vcs = git
+VCS = git
 style = pep440
 versionfile_source = pssh/_version.py
 tag_prefix = ''

{parallel-ssh-2.12.0 → parallel_ssh-2.13.0rc1}/setup.py

@@ -35,7 +35,7 @@ setup(name='parallel-ssh',
                         '*.tests', '*.tests.*')
       ),
       install_requires=[
-          'gevent>=1.3.0', 'ssh2-python', 'ssh-python'],
+          'gevent', 'ssh2-python', 'ssh-python'],
       classifiers=[
           'Development Status :: 5 - Production/Stable',
           'License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)',
@@ -43,11 +43,11 @@ setup(name='parallel-ssh',
           'Operating System :: OS Independent',
           'Programming Language :: Python',
           'Programming Language :: Python :: 3',
-          'Programming Language :: Python :: 3.6',
-          'Programming Language :: Python :: 3.7',
           'Programming Language :: Python :: 3.8',
           'Programming Language :: Python :: 3.9',
           'Programming Language :: Python :: 3.10',
+          'Programming Language :: Python :: 3.11',
+          'Programming Language :: Python :: 3.12',
           'Topic :: System :: Networking',
           'Topic :: Software Development :: Libraries',
           'Topic :: Software Development :: Libraries :: Python Modules',