ssh-handler 1.0.5__tar.gz → 1.0.7__tar.gz

{ssh_handler-1.0.5/ssh_handler.egg-info → ssh_handler-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.5
+Version: 1.0.7
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT
@@ -224,6 +224,25 @@ Requirements: `pip install "ssh-handler[winrm]"` (pulls in `pywinrm`; uses NTLM
 domain creds work without Kerberos), and the account must be a **local
 administrator** on the target. If SSH already works, this code path never runs.
 
+### Set up OpenSSH Server on a machine (bundled installer)
+
+Installing the package also gives you a one-command, **fully offline** setup for
+the local Windows machine. The OpenSSH ZIPs (ARM64 / Win64 / Win32) ship *inside*
+the wheel, so the installer needs **no internet and no Windows Update** — it picks
+the ZIP matching the CPU architecture, self-elevates to Administrator, installs &
+starts OpenSSH Server, and opens the firewall. (This avoids the
+`Add-WindowsCapability` hang common on locked-down corporate networks.)
+
+```powershell
+pip install ssh-handler
+ssh-handler-setup                 # offline install + start sshd + firewall (self-elevates)
+ssh-handler-setup --install-pip   # also (re)install the package as admin
+ssh-handler-setup --force         # reinstall even if sshd already exists
+# equivalent: python -m ssh_handler setup-server
+```
+
+Run it on whichever machine you want to reach over SSH (e.g. the RDP jump box).
+
 When a connection just fails, the error now self-diagnoses — it probes the SSH and
 RDP ports and tells you *why* (e.g. "Port 22 is closed but RDP (3389) is open … no
 SSH server listening"). Call `ssh.diagnose()` for a pre-flight reachability check.

{ssh_handler-1.0.5 → ssh_handler-1.0.7}/README.md

@@ -193,6 +193,25 @@ Requirements: `pip install "ssh-handler[winrm]"` (pulls in `pywinrm`; uses NTLM
 domain creds work without Kerberos), and the account must be a **local
 administrator** on the target. If SSH already works, this code path never runs.
 
+### Set up OpenSSH Server on a machine (bundled installer)
+
+Installing the package also gives you a one-command, **fully offline** setup for
+the local Windows machine. The OpenSSH ZIPs (ARM64 / Win64 / Win32) ship *inside*
+the wheel, so the installer needs **no internet and no Windows Update** — it picks
+the ZIP matching the CPU architecture, self-elevates to Administrator, installs &
+starts OpenSSH Server, and opens the firewall. (This avoids the
+`Add-WindowsCapability` hang common on locked-down corporate networks.)
+
+```powershell
+pip install ssh-handler
+ssh-handler-setup                 # offline install + start sshd + firewall (self-elevates)
+ssh-handler-setup --install-pip   # also (re)install the package as admin
+ssh-handler-setup --force         # reinstall even if sshd already exists
+# equivalent: python -m ssh_handler setup-server
+```
+
+Run it on whichever machine you want to reach over SSH (e.g. the RDP jump box).
+
 When a connection just fails, the error now self-diagnoses — it probes the SSH and
 RDP ports and tells you *why* (e.g. "Port 22 is closed but RDP (3389) is open … no
 SSH server listening"). Call `ssh.diagnose()` for a pre-flight reachability check.

{ssh_handler-1.0.5 → ssh_handler-1.0.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssh-handler"
-version = "1.0.5"
+version = "1.0.7"
 description = "Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -32,6 +32,10 @@ all = ["keyring>=23.0", "scp>=0.14", "PyQt5>=5.15", "pywinrm>=0.4.3"]
 
 [project.scripts]
 ssh-handler = "ssh_handler.cli:main"
+ssh-handler-setup = "ssh_handler.cli:setup_server_main"
 
 [tool.setuptools]
 packages = ["ssh_handler"]
+
+[tool.setuptools.package-data]
+ssh_handler = ["*.ps1", "openssh/*.zip"]

{ssh_handler-1.0.5 → ssh_handler-1.0.7}/ssh_handler/__init__.py

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

{ssh_handler-1.0.5 → ssh_handler-1.0.7}/ssh_handler/cli.py

@@ -15,9 +15,11 @@ Credentials (password never echoed, never stored in plaintext):
 
 from __future__ import annotations
 
+import os
 import sys
 import json
 import argparse
+import subprocess
 
 from .config import SSHConfig
 from .core import SSHHandler
@@ -26,6 +28,35 @@ from .exceptions import SSHError
 from .results import CommandResult, TransferResult
 
 
+def _setup_script_path() -> str:
+    """Absolute path to the bundled OpenSSH setup PowerShell script."""
+    return os.path.join(os.path.dirname(__file__), "setup_openssh_server.ps1")
+
+
+def setup_server_main(argv=None) -> int:
+    """
+    Console entry point (`ssh-handler-setup`): run the bundled PowerShell script
+    that installs & starts OpenSSH Server, opens the firewall, and optionally
+    pip-installs the package. Self-elevates to Administrator. Windows only.
+
+    Any extra args are forwarded to the script, e.g.:
+        ssh-handler-setup --InstallPip --Port 22
+    """
+    if os.name != "nt":
+        print("ssh-handler-setup only runs on Windows (it sets up OpenSSH Server).",
+              file=sys.stderr)
+        return 2
+    script = _setup_script_path()
+    if not os.path.exists(script):
+        print(f"Bundled setup script not found: {script}", file=sys.stderr)
+        return 1
+    extra = list(argv) if argv is not None else sys.argv[1:]
+    cmd = ["powershell", "-NoProfile", "-ExecutionPolicy", "Bypass",
+           "-File", script] + extra
+    print(f"Launching OpenSSH Server setup (will prompt for Administrator)...")
+    return subprocess.call(cmd)
+
+
 def _add_conn_args(p: argparse.ArgumentParser) -> None:
     p.add_argument("--host", required=True)
     p.add_argument("--port", type=int, default=22)
@@ -107,6 +138,29 @@ def main(argv=None) -> int:
     p_info = sub.add_parser("info", help="connect and report remote OS")
     _add_conn_args(p_info)
 
+    p_setup = sub.add_parser("setup-server",
+                             help="install & start OpenSSH Server on THIS Windows "
+                                  "machine (self-elevates to Administrator)")
+    p_setup.add_argument("--install-pip", action="store_true",
+                         help="also pip-install ssh-handler[winrm]")
+    p_setup.add_argument("--port", type=int, default=22)
+
+    # setup-server takes no connection args and runs the bundled PowerShell script
+    if argv is None:
+        _argv = sys.argv[1:]
+    else:
+        _argv = list(argv)
+    if _argv and _argv[0] == "setup-server":
+        forward = []
+        rest = _argv[1:]
+        if "--install-pip" in rest:
+            forward.append("-InstallPip")
+        if "--port" in rest:
+            i = rest.index("--port")
+            if i + 1 < len(rest):
+                forward += ["-Port", rest[i + 1]]
+        return setup_server_main(forward)
+
     args = parser.parse_args(argv)
 
     # store-credential is handled without a connection

ssh_handler-1.0.7/ssh_handler/setup_openssh_server.ps1

@@ -0,0 +1,170 @@
+<#
+.SYNOPSIS
+    One-shot OpenSSH Server setup for a Windows machine, fully OFFLINE.
+    Installs from the OpenSSH ZIP bundled with the ssh-handler package
+    (chosen by CPU architecture), starts sshd, opens the firewall, and
+    optionally pip-installs the package. Self-elevates to Administrator.
+
+.DESCRIPTION
+    No Windows Update / Features-on-Demand and no internet required - this
+    avoids the Add-WindowsCapability hang on locked-down corporate networks.
+    The matching ZIP (ARM64 / Win64 / Win32) ships inside the package under
+    .\openssh\ next to this script.
+
+.PARAMETER InstallPip
+    Also run `pip install -U "ssh-handler[winrm]"` (needs Python+pip on PATH).
+
+.PARAMETER Port
+    SSH port to open in the firewall (default 22).
+
+.PARAMETER ZipPath
+    Use a specific OpenSSH ZIP instead of the bundled one (override).
+
+.PARAMETER Force
+    Reinstall even if sshd already exists.
+
+.EXAMPLE
+    powershell -ExecutionPolicy Bypass -File .\setup_openssh_server.ps1
+.EXAMPLE
+    ssh-handler-setup --install-pip
+#>
+
+param(
+    [switch]$InstallPip,
+    [int]$Port = 22,
+    [string]$ZipPath,
+    [switch]$Force
+)
+
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'
+
+# --- 1. Self-elevate to Administrator -------------------------------------- #
+$isAdmin = ([Security.Principal.WindowsPrincipal]`
+    [Security.Principal.WindowsIdentity]::GetCurrent()`
+    ).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
+
+if (-not $isAdmin) {
+    Write-Host "Elevating to Administrator..." -ForegroundColor Yellow
+    $argList = "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`" -Port $Port"
+    if ($InstallPip) { $argList += " -InstallPip" }
+    if ($Force)      { $argList += " -Force" }
+    if ($ZipPath)    { $argList += " -ZipPath `"$ZipPath`"" }
+    Start-Process powershell -Verb RunAs -ArgumentList $argList
+    exit
+}
+
+Write-Host "=== OpenSSH Server setup (Administrator, offline) ===" -ForegroundColor Cyan
+
+function Test-SshdPresent {
+    return [bool](Get-Service -Name sshd -ErrorAction SilentlyContinue)
+}
+
+# --- 2. Pick the right bundled ZIP by CPU architecture --------------------- #
+function Get-OSArch {
+    try {
+        $a = [System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture.ToString()
+        if ($a) { return $a }
+    } catch {}
+    $p = $env:PROCESSOR_ARCHITEW6432
+    if (-not $p) { $p = $env:PROCESSOR_ARCHITECTURE }
+    switch ($p) {
+        'AMD64' { 'X64' } 'ARM64' { 'Arm64' } 'x86' { 'X86' } default { $p }
+    }
+}
+
+function Resolve-BundledZip {
+    $arch = Get-OSArch
+    switch -Regex ($arch) {
+        'Arm64' { $name = 'OpenSSH-ARM64.zip' }
+        'X64'   { $name = 'OpenSSH-Win64.zip' }
+        'X86'   { $name = 'OpenSSH-Win32.zip' }
+        default { throw "Unsupported architecture: $arch" }
+    }
+    Write-Host ("  Detected architecture: {0} -> {1}" -f $arch, $name)
+    return (Join-Path $PSScriptRoot ("openssh\" + $name))
+}
+
+# --- 3. Install OpenSSH Server from the ZIP -------------------------------- #
+if ((Test-SshdPresent) -and -not $Force) {
+    Write-Host "OpenSSH Server already present (use -Force to reinstall)." -ForegroundColor Green
+}
+else {
+    $zip = if ($ZipPath) { $ZipPath } else { Resolve-BundledZip }
+    if (-not (Test-Path $zip)) {
+        throw "OpenSSH ZIP not found: $zip"
+    }
+    Write-Host "Installing OpenSSH Server from: $zip"
+
+    $dest = Join-Path $env:ProgramFiles 'OpenSSH'
+    $tmp  = Join-Path $env:TEMP ("openssh_" + [guid]::NewGuid().ToString('N'))
+    try {
+        Expand-Archive -Path $zip -DestinationPath $tmp -Force
+        # the archive nests a single OpenSSH-XXX folder
+        $srcDir = Get-ChildItem $tmp -Directory | Select-Object -First 1
+        if (-not $srcDir) { $srcDir = Get-Item $tmp }
+
+        if (-not (Test-Path $dest)) {
+            New-Item -ItemType Directory -Path $dest | Out-Null
+        }
+        Copy-Item (Join-Path $srcDir.FullName '*') $dest -Recurse -Force
+        Write-Host "  Files copied to $dest"
+
+        $installer = Join-Path $dest 'install-sshd.ps1'
+        if (-not (Test-Path $installer)) { throw "install-sshd.ps1 missing in $dest" }
+        & powershell -NoProfile -ExecutionPolicy Bypass -File $installer | Out-Null
+        Write-Host "  OpenSSH Server installed." -ForegroundColor Green
+    }
+    finally {
+        if (Test-Path $tmp) { Remove-Item $tmp -Recurse -Force -ErrorAction SilentlyContinue }
+    }
+
+    # add the install dir to the machine PATH so ssh/sshd are callable
+    $machinePath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+    if ($machinePath -notlike "*$dest*") {
+        [Environment]::SetEnvironmentVariable('Path', "$machinePath;$dest", 'Machine')
+    }
+}
+
+# --- 4. Service + firewall -------------------------------------------------- #
+Write-Host "Configuring sshd service and firewall..."
+Set-Service -Name sshd -StartupType Automatic
+Start-Service sshd
+
+$ruleName = "OpenSSH-Server-In-TCP"
+if (-not (Get-NetFirewallRule -Name $ruleName -ErrorAction SilentlyContinue)) {
+    New-NetFirewallRule -Name $ruleName -DisplayName 'OpenSSH Server (sshd)' `
+        -Enabled True -Direction Inbound -Protocol TCP -Action Allow `
+        -LocalPort $Port | Out-Null
+    Write-Host "  Firewall rule added for TCP $Port." -ForegroundColor Green
+}
+else {
+    Write-Host "  Firewall rule already present." -ForegroundColor Green
+}
+
+# --- 5. Optional: pip install the package ---------------------------------- #
+if ($InstallPip) {
+    Write-Host "Installing ssh-handler (pip)..."
+    try {
+        python -m pip install --upgrade pip | Out-Null
+        python -m pip install -U "ssh-handler[winrm]"
+        Write-Host "  ssh-handler installed." -ForegroundColor Green
+    }
+    catch {
+        Write-Warning "pip install failed: $($_.Exception.Message)"
+    }
+}
+
+# --- 6. Verify -------------------------------------------------------------- #
+Write-Host "`n=== Verification ===" -ForegroundColor Cyan
+$svc = Get-Service sshd
+Write-Host ("sshd status : {0}" -f $svc.Status)
+$test = Test-NetConnection localhost -Port $Port -WarningAction SilentlyContinue
+Write-Host ("port {0} open : {1}" -f $Port, $test.TcpTestSucceeded)
+
+if ($svc.Status -eq 'Running' -and $test.TcpTestSucceeded) {
+    Write-Host "`nDone. This machine now accepts SSH on port $Port." -ForegroundColor Green
+}
+else {
+    Write-Warning "Setup finished but sshd is not listening yet - check the messages above."
+}

{ssh_handler-1.0.5 → ssh_handler-1.0.7/ssh_handler.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-handler
-Version: 1.0.5
+Version: 1.0.7
 Summary: Extensive SSH/SFTP/SCP/FTP handler built on Paramiko, for test automation, CLIs and PyQt5 tools.
 Author: ssh-handler contributors
 License-Expression: MIT
@@ -224,6 +224,25 @@ Requirements: `pip install "ssh-handler[winrm]"` (pulls in `pywinrm`; uses NTLM
 domain creds work without Kerberos), and the account must be a **local
 administrator** on the target. If SSH already works, this code path never runs.
 
+### Set up OpenSSH Server on a machine (bundled installer)
+
+Installing the package also gives you a one-command, **fully offline** setup for
+the local Windows machine. The OpenSSH ZIPs (ARM64 / Win64 / Win32) ship *inside*
+the wheel, so the installer needs **no internet and no Windows Update** — it picks
+the ZIP matching the CPU architecture, self-elevates to Administrator, installs &
+starts OpenSSH Server, and opens the firewall. (This avoids the
+`Add-WindowsCapability` hang common on locked-down corporate networks.)
+
+```powershell
+pip install ssh-handler
+ssh-handler-setup                 # offline install + start sshd + firewall (self-elevates)
+ssh-handler-setup --install-pip   # also (re)install the package as admin
+ssh-handler-setup --force         # reinstall even if sshd already exists
+# equivalent: python -m ssh_handler setup-server
+```
+
+Run it on whichever machine you want to reach over SSH (e.g. the RDP jump box).
+
 When a connection just fails, the error now self-diagnoses — it probes the SSH and
 RDP ports and tells you *why* (e.g. "Port 22 is closed but RDP (3389) is open … no
 SSH server listening"). Call `ssh.diagnose()` for a pre-flight reachability check.

{ssh_handler-1.0.5 → ssh_handler-1.0.7}/ssh_handler.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ ssh_handler/ftp.py
 ssh_handler/pool.py
 ssh_handler/pyqt_worker.py
 ssh_handler/results.py
+ssh_handler/setup_openssh_server.ps1
 ssh_handler/winrm_bootstrap.py
 ssh_handler.egg-info/PKG-INFO
 ssh_handler.egg-info/SOURCES.txt
@@ -19,4 +20,7 @@ ssh_handler.egg-info/dependency_links.txt
 ssh_handler.egg-info/entry_points.txt
 ssh_handler.egg-info/requires.txt
 ssh_handler.egg-info/top_level.txt
+ssh_handler/openssh/OpenSSH-ARM64.zip
+ssh_handler/openssh/OpenSSH-Win32.zip
+ssh_handler/openssh/OpenSSH-Win64.zip
 tests/test_offline.py

ssh_handler-1.0.7/ssh_handler.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ssh-handler = ssh_handler.cli:main
+ssh-handler-setup = ssh_handler.cli:setup_server_main

ssh_handler-1.0.5/ssh_handler.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-ssh-handler = ssh_handler.cli:main