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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.2
+Version: 1.0.3
 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.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssh-handler"
-version = "1.0.2"
+version = "1.0.3"
 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.3}/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.3"
 
 from .config import SSHConfig, FTPConfig
 from .core import SSHHandler, ShellSession

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

@@ -269,7 +269,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 +313,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.3/ssh_handler.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.2
+Version: 1.0.3
 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.3}/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"