sshreader 6.2.0__py3-none-any.whl → 6.3.0__py3-none-any.whl

sshreader/__init__.py

@@ -1,6 +1,6 @@
 """A Python Package for parallelizing ssh connections via threading and multiprocessing.
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by

sshreader/customtypes.py

@@ -1,6 +1,6 @@
 """ Typing module for sshreader
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by

sshreader/scripts/__init__.py

@@ -1,6 +1,6 @@
 """ Scripts portion of sshreader package
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by

sshreader/scripts/pydsh.py

@@ -1,6 +1,6 @@
 """ A Pythonic implementation of pdsh powered by sshreader
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by
@@ -162,10 +162,11 @@ def cli(**kwargs):
     if kwargs['file']:
         mkpath = click.Path(exists=True, dir_okay=False)
         script_path = mkpath(kwargs['cmd'])
-        script_name = os.path.split(script_path)[1]
+        # Ensure script_path is a str for os.path functions (type-checker safe)
+        script_name = os.path.basename(str(script_path))
         log.info('Creating copy_script prehook for: ' + script_name)
         prehook = sshreader.Hook(copy_script, args=[script_path], ssh_established=True)
-        with open(script_path) as s:
+        with open(str(script_path)) as s:
             script = s.readline()
         if script.startswith('#!') is False:
             raise click.UsageError('Script must start with #!')
@@ -196,7 +197,7 @@ def cli(**kwargs):
                 kwargs['keyfile'] = sshenv.dsa_key
                 log.info('Using DSA private key file')
         else:
-            if len(sshenv.agent_keys) == 0:
+            if sshenv.agent_keys is None or len(sshenv.agent_keys) == 0:
                 if not all((kwargs['username'], kwargs['password'])):
                     raise click.ClickException('Unable to find ssh key to use and password not supplied.')
             else:
@@ -214,7 +215,7 @@ def cli(**kwargs):
     # If you specify a password or prompt for one it overrides the ssh key
     if not kwargs['password']:
         if not kwargs['prompt']:
-            if not kwargs['keyfile'] and len(sshenv.agent_keys) == 0:
+            if not kwargs['keyfile'] and (sshenv.agent_keys is None or len(sshenv.agent_keys) == 0):
                 raise click.ClickException('Unable to find ssh key to use and password not supplied or prompt enabled.')
         else:
             log.info('Prompting for password and disabling discovered SSH keyfiles')

sshreader/ssh.py

@@ -1,6 +1,6 @@
 """A wrapper for Paramiko that attempts to make ssh sessions easier to work with.
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by
@@ -173,7 +173,7 @@ class SSH:
                 else:
                     result = Command(cmd=command, stdout=stdout.read().strip(), stderr=None,
                                      return_code=stdout.channel.recv_exit_status())
-            except (paramiko.buffered_pipe.PipeTimeout, socket.timeout):
+            except (paramiko.buffered_pipe.PipeTimeout, socket.timeout):  # ty:ignore[possibly-missing-submodule]
                 result = Command(cmd=command, stdout='command timed out', stderr=None, return_code=124)
         else:
             try:
@@ -184,7 +184,7 @@ class SSH:
                 else:
                     result = Command(cmd=command, stdout=stdout.read().strip(), stderr=stderr.read().strip(),
                                      return_code=stdout.channel.recv_exit_status())
-            except (paramiko.buffered_pipe.PipeTimeout, socket.timeout):
+            except (paramiko.buffered_pipe.PipeTimeout, socket.timeout):  # ty:ignore[possibly-missing-submodule]
                 result = Command(cmd=command, stdout='', stderr='command timed out', return_code=124)
         return result
 
@@ -226,7 +226,7 @@ class SSH:
         """
         if self.__alive():
             raise paramiko.SSHException(f"connection to {self.host} already established")
-        paramiko.util.logging.getLogger().setLevel(logging.CRITICAL)  # Keeping paramiko from logging errors to stdout
+        paramiko.util.logging.getLogger().setLevel(logging.CRITICAL)  # Keeping paramiko from logging errors to stdout  # ty:ignore[possibly-missing-submodule]
         if not self.keyfile and len(paramiko.Agent().get_keys()) == 0 and not all((self.username, self.password)):
             paramiko.SSHException('username and password or keyfile not provided')
         if self.keyfile:

sshreader/utils.py

@@ -1,6 +1,6 @@
 """ All the classes and functions that make sshreader tick
 """
-# Copyright (C) 2015-2025 Jesse Almanrode
+# Copyright (C) 2015-2026 Jesse Almanrode
 #
 #     This program is free software: you can redistribute it and/or modify
 #     it under the terms of the GNU Lesser General Public License as published by
@@ -175,8 +175,8 @@ class ServerJob:
             self.ssh_timeout = timeout[0]
             self.cmd_timeout = timeout[1]
         else:
-            self.ssh_timeout = timeout
-            self.cmd_timeout = timeout
+            self.ssh_timeout = timeout if timeout is not None else 0.5
+            self.cmd_timeout = timeout if timeout is not None else 0.5
         if pre_hook:
             if isinstance(pre_hook, Hook):
                 self.pre_hook = pre_hook
@@ -220,8 +220,8 @@ class ServerJob:
                 log.debug(f'{self.name}: running prehook')
                 self.pre_hook.run(self)
             try:
-                self._conn = SSH(self.name, username=self.username, password=self.password, keyfile=self.key,
-                                 port=self.ssh_port, connect=False, rsa_sha2=self.rsa_sha2)
+                self._conn = SSH(self.name, username=self.username or '', password=self.password or '', keyfile=self.key,
+                                 port=self.ssh_port, connect=False, rsa_sha2=self.rsa_sha2 or True)
                 self._conn.connect(timeout=self.ssh_timeout)
                 log.debug(f'{self.name}: ssh connection established')
             except Exception as errorMsg:
@@ -354,7 +354,7 @@ def sshread(serverjobs: list, pcount: Optional[int] = None, tcount: Optional[int
 
     if pcount is None:
         # Limit the number of threads to spawn
-        if tcount == 0:
+        if tcount == 0 or tcount is None:
             tcount = int(min(totaljobs, cpu_limit()))
         else:
             tcount = int(min(tcount, totaljobs))
@@ -399,10 +399,10 @@ def sshread(serverjobs: list, pcount: Optional[int] = None, tcount: Optional[int
     log.debug(f'main waiting for {totaljobs} ServerJobs to finish')
     while result_queue.full() is False:
         if progress_bar:
-            bar.update(item_counter.value)
+            bar.update(item_counter.value)  # ty:ignore[unresolved-attribute]
         time.sleep(1)
     if progress_bar:
-        bar.finish()
+        bar.finish()  # ty:ignore[unresolved-attribute]
 
     if len(threads) > 0:
         log.info(f'joining {len(threads)} threads')

{sshreader-6.2.0.dist-info → sshreader-6.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sshreader
-Version: 6.2.0
+Version: 6.3.0
 Summary: Multi-threading/processing wrapper for Paramiko
 Author-Email: Jesse Almanrode <jesse@almanrode.com>
 License: LGPL-3.0-or-later
@@ -14,6 +14,7 @@ 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: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Project-URL: homepage, http://sshreader.readthedocs.io/
@@ -28,6 +29,8 @@ Description-Content-Type: text/markdown
 
 ![logo](./logo.png)
 
+[![Python Tests](https://github.com/isaiah1112/sshreader/actions/workflows/lint_and_test.yml/badge.svg)](https://github.com/isaiah1112/sshreader/actions/workflows/lint_and_test.yml)
+
 A Python Module for multiprocessing/threading ssh connections in order to make ssh operations
 across multiple servers parallel.  It utilizes the [Paramiko](http://www.paramiko.org/) module 
 for its ssh client.
@@ -62,14 +65,13 @@ The documentation for [SSHreader][] can be found at [ReadTheDocs.](https://sshre
 
 Comments and enhancements are very welcome.
 
-Report any issues or feature requests on the [BitBucket bug
-tracker](https://bitbucket.org/isaiah1112/sshreader/issues?status=new&status=open). Please include a minimal
-not-working example which reproduces the bug and, if appropriate, the
+Report any issues or feature requests on the [GitHub Issue Tracker](https://github.com/isaiah1112/sshreader/issues). 
+Please include a minimal not-working example which reproduces the bug and, if appropriate, the
 traceback information.  Please do not request features already being worked
 towards.
 
-Code contributions are encouraged: please feel free to [fork the
-project](https://bitbucket.org/isaiah1112/sshreader) and submit pull requests to the develop branch.
+Code contributions are encouraged: please feel free to [fork the project](https://github.com/isaiah1112/sshreader) 
+and submit pull requests to the develop branch.
 
 ## Extras
 
@@ -83,4 +85,4 @@ to process.
 
 [GNU Lesser General Public License v3.0]: http://choosealicense.com/licenses/lgpl-3.0/ "LGPL v3"
 
-[sshreader]: https://bitbucket.org/isaiah1112/sshreader "SSHreader Package"
+[sshreader]: https://github.com/isaiah1112/sshreader "SSHreader Package"

sshreader-6.3.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+sshreader-6.3.0.dist-info/METADATA,sha256=rb29O02Udv-7Lw44KoBBBVOQGTjxnjWzGxpmWIIF4kw,3537
+sshreader-6.3.0.dist-info/WHEEL,sha256=VP-D4TPS230sME9Z3vb3INXvo1yt0924YRm5AOsk_dE,90
+sshreader-6.3.0.dist-info/entry_points.txt,sha256=5sY9LSL2Kye-5-JPL7AxOg0rzO54pJlleg8egd6mCVI,70
+sshreader-6.3.0.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+sshreader-6.3.0.dist-info/licenses/LICENSE.lesser,sha256=2n6rt7r999OuXp8iOqW9we7ORaxWncIbOwN1ILRGR2g,7651
+sshreader/__init__.py,sha256=mmg2iie23DpPGkRK6IWwaps3WuAQSJbn4yNp0yrRHDY,1451
+sshreader/customtypes.py,sha256=Q08Ot2aMWxOcLhCLMnWlrwYhOQZ1qAlz6D71E1Ek2nw,1205
+sshreader/scripts/__init__.py,sha256=r94LFIDjlTYga-MaX2nVBBIM11v0lTd5xtA-Gcm6QMk,858
+sshreader/scripts/pydsh.py,sha256=f230Znuqx5acE88gvU5nsKzd8G1tqR2WhKyFN7PJcV8,11177
+sshreader/ssh.py,sha256=dPrZjYHrupgbqhng9uCJq8do0R6mqDePYFIjwUboXJE,11158
+sshreader/utils.py,sha256=NYeXRXkYq6w4jgc0_It6hPUcRUXG3RMdoBLgrnjo_nM,18830
+sshreader-6.3.0.dist-info/RECORD,,

{sshreader-6.2.0.dist-info → sshreader-6.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: pdm-backend (2.4.5)
+Generator: pdm-backend (2.4.9)
 Root-Is-Purelib: true
 Tag: py3-none-any

sshreader-6.2.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-sshreader-6.2.0.dist-info/METADATA,sha256=SRoUSuMSWnLZu5V2yzrcFzYJJ4t1Z7YHtX3LQ59Mz9A,3334
-sshreader-6.2.0.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-sshreader-6.2.0.dist-info/entry_points.txt,sha256=5sY9LSL2Kye-5-JPL7AxOg0rzO54pJlleg8egd6mCVI,70
-sshreader-6.2.0.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-sshreader-6.2.0.dist-info/licenses/LICENSE.lesser,sha256=2n6rt7r999OuXp8iOqW9we7ORaxWncIbOwN1ILRGR2g,7651
-sshreader/__init__.py,sha256=lbM35O7ANOPaSbJzPA8DuXJQDCyBGTmkysQPtARD6j4,1451
-sshreader/customtypes.py,sha256=kNNT5_NaSl_dBOdQ1ucHy_1Wm_H8-CUy_HT0RdWwFX8,1205
-sshreader/scripts/__init__.py,sha256=XJmUL-cn63rXHtkLoF5jY3z0gL5qEF0b50JdkgO8Nhs,858
-sshreader/scripts/pydsh.py,sha256=rbXinOe89rq6rK0XSS227mwegl1esssX_LT5etz92Qc,11027
-sshreader/ssh.py,sha256=K7uYXn4AFsPH_suCCOGu9m2BBaThAiXW4Do8BN0d8fQ,11035
-sshreader/utils.py,sha256=TR_G_ndN5WiKxUv7d-KfNwbgg1LzPxVgWWDknqzqqvU,18658
-sshreader-6.2.0.dist-info/RECORD,,