ssh-handler 1.0.2__tar.gz → 1.0.4__tar.gz

{ssh_handler-1.0.2/ssh_handler.egg-info → ssh_handler-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.2
+Version: 1.0.4
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT

{ssh_handler-1.0.2 → ssh_handler-1.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssh-handler"
-version = "1.0.2"
+version = "1.0.4"
 description = "Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools."
 readme = "README.md"
 requires-python = ">=3.8"

{ssh_handler-1.0.2 → ssh_handler-1.0.4}/ssh_handler/__init__.py

@@ -22,7 +22,7 @@ dependencies (PyQt5 / scp) don't break the core package.
 
 from __future__ import annotations
 
-__version__ = "1.0.2"
+__version__ = "1.0.4"
 
 from .config import SSHConfig, FTPConfig
 from .core import SSHHandler, ShellSession

{ssh_handler-1.0.2 → ssh_handler-1.0.4}/ssh_handler/core.py

@@ -118,10 +118,17 @@ class SSHHandler:
         log_callback: Optional[Callable[[str], None]] = None,
         logger: Optional[logging.Logger] = None,
         safe: bool = False,
+        quiet: bool = False,
     ):
+        """
+        :param quiet: when True, suppress the INFO narration (connect/command
+                      lines) and emit only warnings and errors. Command results
+                      are returned in CommandResult.stdout regardless.
+        """
         self.config = config
         self._safe_default = safe
         self._log_callback = log_callback
+        self._quiet = quiet
         self.log = logger or self._build_logger()
 
         self._client: Optional[paramiko.SSHClient] = None
@@ -143,7 +150,9 @@ class SSHHandler:
                 logging.Formatter("%(asctime)s [%(levelname)s] %(name)s: %(message)s")
             )
             logger.addHandler(handler)
-            logger.setLevel(logging.INFO)
+        # set the level every time so quiet= is honored even if the per-host
+        # logger was created by an earlier handler instance
+        logger.setLevel(logging.WARNING if self._quiet else logging.INFO)
         return logger
 
     def _secrets(self) -> list:
@@ -269,7 +278,12 @@ class SSHHandler:
         if cfg.passwordless:
             kwargs["allow_agent"] = True
             kwargs["look_for_keys"] = True
-        elif empty_password:
+        elif empty_password or pw == "":
+            # Explicit empty-password authentication. An empty string means
+            # "log in with a blank password" (PermitEmptyPasswords hosts) - send
+            # it directly and don't waste the first attempt probing keys/agent,
+            # which would otherwise fail with "No authentication methods
+            # available" before the empty password is ever tried.
             kwargs["password"] = ""
             kwargs["look_for_keys"] = False
             kwargs["allow_agent"] = False
@@ -308,9 +322,28 @@ class SSHHandler:
                 last_auth = exc
                 client.close()
                 self._emit(logging.DEBUG, f"Auth strategy '{label}' rejected.")
-            except (paramiko.SSHException, OSError) as exc:
+            except paramiko.SSHException as exc:
                 client.close()
+                # "No authentication methods available" means paramiko had no
+                # credential the server would accept (no password/key/agent).
+                # That's an auth problem, not a transport one - try the next
+                # strategy, and if none are left raise a clear, guided error.
+                if "no authentication methods" in str(exc).lower():
+                    last_auth = exc
+                    self._emit(logging.DEBUG,
+                               f"Auth strategy '{label}': {exc}")
+                    continue
                 raise exc
+            except OSError as exc:
+                client.close()
+                raise exc
+        if last_auth and "no authentication methods" in str(last_auth).lower():
+            raise SSHAuthenticationError(
+                f"No usable credentials for {cfg.auth_username}@{cfg.host}. "
+                f"Provide one of: password=..., key_filename=..., "
+                f"passwordless=True (use your SSH key/agent), or password='' for a "
+                f"blank-password account (the server must allow PermitEmptyPasswords)."
+            )
         raise SSHAuthenticationError(
             f"All authentication strategies failed for "
             f"{cfg.auth_username}@{cfg.host}: {last_auth}"

{ssh_handler-1.0.2 → ssh_handler-1.0.4/ssh_handler.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.2
+Version: 1.0.4
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT

{ssh_handler-1.0.2 → ssh_handler-1.0.4}/tests/test_offline.py

@@ -38,6 +38,17 @@ kw2 = h._build_connect_kwargs(empty_password=True, sock=None)
 assert kw2["password"] == "" and kw2["allow_agent"] is False
 print("empty-password strategy OK")
 
+# explicit password="" must send a blank password on the PRIMARY attempt
+# (regression guard: previously the primary probed keys and failed with
+# "No authentication methods available" before the empty password was tried)
+hp = SSHHandler.__new__(SSHHandler)
+hp.config = SSHConfig(host="t", username="u", password="")
+hp._jump = None; hp.log = logging.getLogger("x2"); hp._log_callback = None
+kw3 = hp._build_connect_kwargs(empty_password=False, sock=None)
+assert kw3["password"] == "" and kw3["allow_agent"] is False \
+    and kw3["look_for_keys"] is False
+print("explicit empty-password (primary) OK")
+
 # TransferResult math
 tr = TransferResult("a", "b", "push", "sftp", 1048576, 2.0, 1)
 assert abs(tr.speed_bps - 524288) < 1 and tr.human_size == "1.0MB"