ssh-handler 1.1.0__tar.gz → 1.2.0__tar.gz

{ssh_handler-1.1.0/ssh_handler.egg-info → ssh_handler-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.1.0
+Version: 1.2.0
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT
@@ -14,22 +14,14 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: paramiko>=3.0
-Provides-Extra: secure
-Requires-Dist: keyring>=23.0; extra == "secure"
-Provides-Extra: scp
-Requires-Dist: scp>=0.14; extra == "scp"
+Requires-Dist: scp>=0.14
+Requires-Dist: pyserial>=3.5
+Requires-Dist: keyring>=23.0
+Requires-Dist: pywinrm>=0.4.3
 Provides-Extra: gui
 Requires-Dist: PyQt5>=5.15; extra == "gui"
-Provides-Extra: winrm
-Requires-Dist: pywinrm>=0.4.3; extra == "winrm"
-Provides-Extra: serial
-Requires-Dist: pyserial>=3.5; extra == "serial"
 Provides-Extra: all
-Requires-Dist: keyring>=23.0; extra == "all"
-Requires-Dist: scp>=0.14; extra == "all"
 Requires-Dist: PyQt5>=5.15; extra == "all"
-Requires-Dist: pywinrm>=0.4.3; extra == "all"
-Requires-Dist: pyserial>=3.5; extra == "all"
 Dynamic: license-file
 
 # ssh-handler
@@ -89,15 +81,17 @@ behind one object that:
 ## Install
 
 ```bash
-pip install ssh-handler                 # core (paramiko only)
-pip install "ssh-handler[secure]"       # + keyring  (OS credential vault)
-pip install "ssh-handler[scp]"          # + scp      (SCP-protocol transfers)
-pip install "ssh-handler[gui]"          # + PyQt5    (the GUI worker)
-pip install "ssh-handler[all]"          # everything
+pip install ssh-handler           # everything: SSH, SFTP, SCP, FTP, serial,
+                                  # credential vault, WinRM bootstrap
+pip install "ssh-handler[gui]"    # also installs PyQt5 for the GUI worker
 ```
 
-`scp`, `keyring`, and `PyQt5` are optional — the core works without them, and
-those features raise a clear, actionable message if you use them without the extra.
+**Batteries included.** A plain `pip install ssh-handler` pulls in `paramiko`,
+`scp`, `pyserial`, `keyring`, and `pywinrm`, so SSH, SFTP/SCP/FTP transfers,
+serial/COM ports, confidential credential storage, and the WinRM bootstrap all
+work out of the box. Only **PyQt5** is optional (`[gui]`), because it's a large
+GUI toolkit you only need when building a GUI — forcing it would bloat headless
+and CI installs.
 
 ## Quick start
 
@@ -137,7 +131,7 @@ with SSHHandler(SSHConfig(host="10.0.0.5", username="root", password="pw")) as s
   with **live regex matching**, a per-line/per-match callback, and **tee to a
   local file**, all built in.
 
-**Serial / COM ports** (`SerialHandler`, needs the `serial` extra)
+**Serial / COM ports** (`SerialHandler`, included by default)
 - `list_serial_ports()`, `open`/`close`, `write` / `write_line`.
 - `iter_lines()` and `stream(...)` — same live streaming + match + save-to-file
   model as SSH, for device consoles.
@@ -298,8 +292,14 @@ To stop a stream from another thread (e.g. a GUI Stop button), pass a
 
 ## Serial / COM ports
 
-Same streaming + match + save model for device serial consoles (needs
-`pip install "ssh-handler[serial]"`).
+Same streaming + match + save model for device serial consoles (included by
+default — no extra install).
+
+> **Important — where the COM port physically is.** `pyserial` opens a *local*
+> port, so this runs on the machine the device is **plugged into**. If the device
+> is on your laptop, run it on your laptop. If it's on the remote/RDP machine,
+> either run the script there, or — on Linux targets — stream the device file
+> over SSH instead: `ssh.stream("cat /dev/ttyUSB0", match=..., save_to=...)`.
 
 ```python
 from ssh_handler import SerialHandler, list_serial_ports

{ssh_handler-1.1.0 → ssh_handler-1.2.0}/README.md

@@ -55,15 +55,17 @@ behind one object that:
 ## Install
 
 ```bash
-pip install ssh-handler                 # core (paramiko only)
-pip install "ssh-handler[secure]"       # + keyring  (OS credential vault)
-pip install "ssh-handler[scp]"          # + scp      (SCP-protocol transfers)
-pip install "ssh-handler[gui]"          # + PyQt5    (the GUI worker)
-pip install "ssh-handler[all]"          # everything
+pip install ssh-handler           # everything: SSH, SFTP, SCP, FTP, serial,
+                                  # credential vault, WinRM bootstrap
+pip install "ssh-handler[gui]"    # also installs PyQt5 for the GUI worker
 ```
 
-`scp`, `keyring`, and `PyQt5` are optional — the core works without them, and
-those features raise a clear, actionable message if you use them without the extra.
+**Batteries included.** A plain `pip install ssh-handler` pulls in `paramiko`,
+`scp`, `pyserial`, `keyring`, and `pywinrm`, so SSH, SFTP/SCP/FTP transfers,
+serial/COM ports, confidential credential storage, and the WinRM bootstrap all
+work out of the box. Only **PyQt5** is optional (`[gui]`), because it's a large
+GUI toolkit you only need when building a GUI — forcing it would bloat headless
+and CI installs.
 
 ## Quick start
 
@@ -103,7 +105,7 @@ with SSHHandler(SSHConfig(host="10.0.0.5", username="root", password="pw")) as s
   with **live regex matching**, a per-line/per-match callback, and **tee to a
   local file**, all built in.
 
-**Serial / COM ports** (`SerialHandler`, needs the `serial` extra)
+**Serial / COM ports** (`SerialHandler`, included by default)
 - `list_serial_ports()`, `open`/`close`, `write` / `write_line`.
 - `iter_lines()` and `stream(...)` — same live streaming + match + save-to-file
   model as SSH, for device consoles.
@@ -264,8 +266,14 @@ To stop a stream from another thread (e.g. a GUI Stop button), pass a
 
 ## Serial / COM ports
 
-Same streaming + match + save model for device serial consoles (needs
-`pip install "ssh-handler[serial]"`).
+Same streaming + match + save model for device serial consoles (included by
+default — no extra install).
+
+> **Important — where the COM port physically is.** `pyserial` opens a *local*
+> port, so this runs on the machine the device is **plugged into**. If the device
+> is on your laptop, run it on your laptop. If it's on the remote/RDP machine,
+> either run the script there, or — on Linux targets — stream the device file
+> over SSH instead: `ssh.stream("cat /dev/ttyUSB0", match=..., save_to=...)`.
 
 ```python
 from ssh_handler import SerialHandler, list_serial_ports

{ssh_handler-1.1.0 → ssh_handler-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssh-handler"
-version = "1.1.0"
+version = "1.2.0"
 description = "Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -20,16 +20,18 @@ classifiers = [
     "Intended Audience :: Developers",
 ]
 dependencies = [
-    "paramiko>=3.0",
+    "paramiko>=3.0",     # SSH / SFTP
+    "scp>=0.14",         # SCP-protocol transfers
+    "pyserial>=3.5",     # serial / COM-port handler
+    "keyring>=23.0",     # confidential password storage (OS vault)
+    "pywinrm>=0.4.3",    # WinRM bootstrap (enable sshd on Windows w/o SSH)
 ]
 
 [project.optional-dependencies]
-secure = ["keyring>=23.0"]   # OS credential vault for confidential passwords
-scp = ["scp>=0.14"]          # SCP-protocol transfers (SFTP works without it)
-gui = ["PyQt5>=5.15"]        # PyQt5 worker integration
-winrm = ["pywinrm>=0.4.3"]   # auto-enable sshd on Windows hosts that lack SSH
-serial = ["pyserial>=3.5"]   # serial / COM-port handler
-all = ["keyring>=23.0", "scp>=0.14", "PyQt5>=5.15", "pywinrm>=0.4.3", "pyserial>=3.5"]
+# Only PyQt5 stays optional: it's a large GUI toolkit you only need when
+# building a GUI, and forcing it would bloat headless/CI installs.
+gui = ["PyQt5>=5.15"]
+all = ["PyQt5>=5.15"]
 
 [project.scripts]
 ssh-handler = "ssh_handler.cli:main"

{ssh_handler-1.1.0 → ssh_handler-1.2.0}/ssh_handler/__init__.py

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

{ssh_handler-1.1.0 → ssh_handler-1.2.0/ssh_handler.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.1.0
+Version: 1.2.0
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT
@@ -14,22 +14,14 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: paramiko>=3.0
-Provides-Extra: secure
-Requires-Dist: keyring>=23.0; extra == "secure"
-Provides-Extra: scp
-Requires-Dist: scp>=0.14; extra == "scp"
+Requires-Dist: scp>=0.14
+Requires-Dist: pyserial>=3.5
+Requires-Dist: keyring>=23.0
+Requires-Dist: pywinrm>=0.4.3
 Provides-Extra: gui
 Requires-Dist: PyQt5>=5.15; extra == "gui"
-Provides-Extra: winrm
-Requires-Dist: pywinrm>=0.4.3; extra == "winrm"
-Provides-Extra: serial
-Requires-Dist: pyserial>=3.5; extra == "serial"
 Provides-Extra: all
-Requires-Dist: keyring>=23.0; extra == "all"
-Requires-Dist: scp>=0.14; extra == "all"
 Requires-Dist: PyQt5>=5.15; extra == "all"
-Requires-Dist: pywinrm>=0.4.3; extra == "all"
-Requires-Dist: pyserial>=3.5; extra == "all"
 Dynamic: license-file
 
 # ssh-handler
@@ -89,15 +81,17 @@ behind one object that:
 ## Install
 
 ```bash
-pip install ssh-handler                 # core (paramiko only)
-pip install "ssh-handler[secure]"       # + keyring  (OS credential vault)
-pip install "ssh-handler[scp]"          # + scp      (SCP-protocol transfers)
-pip install "ssh-handler[gui]"          # + PyQt5    (the GUI worker)
-pip install "ssh-handler[all]"          # everything
+pip install ssh-handler           # everything: SSH, SFTP, SCP, FTP, serial,
+                                  # credential vault, WinRM bootstrap
+pip install "ssh-handler[gui]"    # also installs PyQt5 for the GUI worker
 ```
 
-`scp`, `keyring`, and `PyQt5` are optional — the core works without them, and
-those features raise a clear, actionable message if you use them without the extra.
+**Batteries included.** A plain `pip install ssh-handler` pulls in `paramiko`,
+`scp`, `pyserial`, `keyring`, and `pywinrm`, so SSH, SFTP/SCP/FTP transfers,
+serial/COM ports, confidential credential storage, and the WinRM bootstrap all
+work out of the box. Only **PyQt5** is optional (`[gui]`), because it's a large
+GUI toolkit you only need when building a GUI — forcing it would bloat headless
+and CI installs.
 
 ## Quick start
 
@@ -137,7 +131,7 @@ with SSHHandler(SSHConfig(host="10.0.0.5", username="root", password="pw")) as s
   with **live regex matching**, a per-line/per-match callback, and **tee to a
   local file**, all built in.
 
-**Serial / COM ports** (`SerialHandler`, needs the `serial` extra)
+**Serial / COM ports** (`SerialHandler`, included by default)
 - `list_serial_ports()`, `open`/`close`, `write` / `write_line`.
 - `iter_lines()` and `stream(...)` — same live streaming + match + save-to-file
   model as SSH, for device consoles.
@@ -298,8 +292,14 @@ To stop a stream from another thread (e.g. a GUI Stop button), pass a
 
 ## Serial / COM ports
 
-Same streaming + match + save model for device serial consoles (needs
-`pip install "ssh-handler[serial]"`).
+Same streaming + match + save model for device serial consoles (included by
+default — no extra install).
+
+> **Important — where the COM port physically is.** `pyserial` opens a *local*
+> port, so this runs on the machine the device is **plugged into**. If the device
+> is on your laptop, run it on your laptop. If it's on the remote/RDP machine,
+> either run the script there, or — on Linux targets — stream the device file
+> over SSH instead: `ssh.stream("cat /dev/ttyUSB0", match=..., save_to=...)`.
 
 ```python
 from ssh_handler import SerialHandler, list_serial_ports

{ssh_handler-1.1.0 → ssh_handler-1.2.0}/ssh_handler.egg-info/requires.txt

@@ -1,23 +1,11 @@
 paramiko>=3.0
+scp>=0.14
+pyserial>=3.5
+keyring>=23.0
+pywinrm>=0.4.3
 
 [all]
-keyring>=23.0
-scp>=0.14
 PyQt5>=5.15
-pywinrm>=0.4.3
-pyserial>=3.5
 
 [gui]
 PyQt5>=5.15
-
-[scp]
-scp>=0.14
-
-[secure]
-keyring>=23.0
-
-[serial]
-pyserial>=3.5
-
-[winrm]
-pywinrm>=0.4.3