ssh-auto-forward 0.0.1__tar.gz

ssh_auto_forward-0.0.1/.github/workflows/test.yml

@@ -0,0 +1,18 @@
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install uv
+      - run: uv sync
+      - run: uv run pytest

ssh_auto_forward-0.0.1/.gitignore

@@ -0,0 +1,31 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pytest_cache/
+.coverage
+htmlcov/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+uv.lock

ssh_auto_forward-0.0.1/.python-version

@@ -0,0 +1 @@
+3.10

ssh_auto_forward-0.0.1/Makefile

@@ -0,0 +1,28 @@
+.PHONY: test setup shell coverage publish-build publish-test publish publish-clean run
+
+test:
+	uv run pytest
+
+setup:
+	uv sync --dev
+
+shell:
+	uv shell
+
+coverage:
+	uv run pytest --cov=ssh_auto_forward --cov-report=term-missing
+
+publish-build:
+	uv run hatch build
+
+publish-test:
+	uv run hatch publish --repo test
+
+publish:
+	uv run hatch publish
+
+publish-clean:
+	rm -r dist/
+
+run:
+	uv run python -m ssh_auto_forward.cli hetzner

ssh_auto_forward-0.0.1/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: ssh-auto-forward
+Version: 0.0.1
+Summary: Auto-forward SSH ports
+Author: alexe
+License: WTFPL
+Keywords: port-forwarding,remote-development,ssh,tunnel
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: paramiko>=3.4.0
+Description-Content-Type: text/markdown
+
+# SSH Auto Port Forwarder
+
+Automatically detect and forward ports from a remote SSH server to your local machine. Similar to VS Code's port forwarding feature, but fully automatic.
+
+## Features
+
+- Automatically discovers listening ports on the remote server
+- Shows process names for each forwarded port
+- Forwards ports to your local machine via SSH tunneling
+- Handles port conflicts by finding alternative local ports
+- Auto-detects new ports and starts forwarding
+- Auto-detects closed ports and stops forwarding
+- Terminal title shows tunnel count
+- Runs in the background with status updates
+- Reads connection details from your SSH config
+- Skips well-known ports (< 1000) by default
+
+## Installation
+
+### With uv (recommended):
+
+```bash
+uvx ssh-auto-forward hetzner
+```
+
+### Install locally:
+
+```bash
+cd portforwards
+uv sync
+```
+
+This installs the `ssh-auto-forward` command.
+
+### Local development:
+
+```bash
+make run ARGS=hetzner
+make run ARGS="hetzner -v"
+```
+
+## Usage
+
+### Basic usage - uses host from your SSH config:
+
+```bash
+ssh-auto-forward hetzner
+```
+
+### Options:
+
+```
+-v, --verbose           Enable verbose logging
+-i, --interval SECS     Scan interval in seconds (default: 5)
+-p, --port-range MIN:MAX Local port range for remapping (default: 3000:10000)
+-s, --skip PORTS        Comma-separated ports to skip (default: all ports < 1000)
+-c, --config PATH       Path to SSH config file
+--version               Show version and exit
+```
+
+### Examples:
+
+```bash
+# Scan every 3 seconds
+ssh-auto-forward hetzner -i 3
+
+# Use specific port range
+ssh-auto-forward hetzner -p 4000:9000
+
+# Skip specific ports
+ssh-auto-forward hetzner -s 22,80,443
+
+# Verbose mode
+ssh-auto-forward hetzner -v
+```
+
+## How it works
+
+1. Connects to your remote server using your SSH config
+2. Runs `ss -tlnp` on the remote to find listening ports
+3. Creates SSH tunnels for each discovered port
+4. Continuously monitors for new/closed ports
+5. Handles port conflicts on your local machine
+
+## Status messages
+
+```
+✓ Connected!
+✓ Forwarding port 2999 (python3)
+✓ Forwarding port 7681 (ttyd)
+✓ Forwarding remote port 19840 -> local port 3000 (node)
+✗ Remote port 2999 is no longer listening, stopping tunnel
+```
+
+The terminal title also updates to show: `ssh-auto-forward: hetzner (18 tunnels active)`
+
+## Testing
+
+Start a test server on your remote machine:
+
+```bash
+ssh hetzner "python3 -m http.server 9999 --bind 127.0.0.1 &"
+```
+
+Then run `ssh-auto-forward hetzner` and you should see:
+
+```
+✓ Forwarding remote port 9999 -> local port 3003 (python3)
+```
+
+Access it locally:
+
+```bash
+curl http://localhost:3003/
+```
+
+## Stopping
+
+Press `Ctrl+C` to stop the forwarder and close all tunnels.
+
+## Requirements
+
+- Python 3.10+
+- paramiko
+- Remote server must have `ss` or `netstat` command available
+
+## Tests
+
+### Unit tests (run locally, no SSH required):
+
+```bash
+make test
+# or
+uv run pytest tests/ -v
+```
+
+### Integration tests (require SSH access):
+
+```bash
+SSH_AUTO_FORWARD_TEST_HOST=hetzner uv run pytest tests_integration/ -v
+```
+
+The integration tests:
+- Test that remote ports are forwarded to the same local port when available
+- Test that ports increment by 1 when the local port is busy
+- Test auto-detection of new ports
+- Test auto-cleanup when remote ports close

ssh_auto_forward-0.0.1/README.md

@@ -0,0 +1,147 @@
+# SSH Auto Port Forwarder
+
+Automatically detect and forward ports from a remote SSH server to your local machine. Similar to VS Code's port forwarding feature, but fully automatic.
+
+## Features
+
+- Automatically discovers listening ports on the remote server
+- Shows process names for each forwarded port
+- Forwards ports to your local machine via SSH tunneling
+- Handles port conflicts by finding alternative local ports
+- Auto-detects new ports and starts forwarding
+- Auto-detects closed ports and stops forwarding
+- Terminal title shows tunnel count
+- Runs in the background with status updates
+- Reads connection details from your SSH config
+- Skips well-known ports (< 1000) by default
+
+## Installation
+
+### With uv (recommended):
+
+```bash
+uvx ssh-auto-forward hetzner
+```
+
+### Install locally:
+
+```bash
+cd portforwards
+uv sync
+```
+
+This installs the `ssh-auto-forward` command.
+
+### Local development:
+
+```bash
+make run ARGS=hetzner
+make run ARGS="hetzner -v"
+```
+
+## Usage
+
+### Basic usage - uses host from your SSH config:
+
+```bash
+ssh-auto-forward hetzner
+```
+
+### Options:
+
+```
+-v, --verbose           Enable verbose logging
+-i, --interval SECS     Scan interval in seconds (default: 5)
+-p, --port-range MIN:MAX Local port range for remapping (default: 3000:10000)
+-s, --skip PORTS        Comma-separated ports to skip (default: all ports < 1000)
+-c, --config PATH       Path to SSH config file
+--version               Show version and exit
+```
+
+### Examples:
+
+```bash
+# Scan every 3 seconds
+ssh-auto-forward hetzner -i 3
+
+# Use specific port range
+ssh-auto-forward hetzner -p 4000:9000
+
+# Skip specific ports
+ssh-auto-forward hetzner -s 22,80,443
+
+# Verbose mode
+ssh-auto-forward hetzner -v
+```
+
+## How it works
+
+1. Connects to your remote server using your SSH config
+2. Runs `ss -tlnp` on the remote to find listening ports
+3. Creates SSH tunnels for each discovered port
+4. Continuously monitors for new/closed ports
+5. Handles port conflicts on your local machine
+
+## Status messages
+
+```
+✓ Connected!
+✓ Forwarding port 2999 (python3)
+✓ Forwarding port 7681 (ttyd)
+✓ Forwarding remote port 19840 -> local port 3000 (node)
+✗ Remote port 2999 is no longer listening, stopping tunnel
+```
+
+The terminal title also updates to show: `ssh-auto-forward: hetzner (18 tunnels active)`
+
+## Testing
+
+Start a test server on your remote machine:
+
+```bash
+ssh hetzner "python3 -m http.server 9999 --bind 127.0.0.1 &"
+```
+
+Then run `ssh-auto-forward hetzner` and you should see:
+
+```
+✓ Forwarding remote port 9999 -> local port 3003 (python3)
+```
+
+Access it locally:
+
+```bash
+curl http://localhost:3003/
+```
+
+## Stopping
+
+Press `Ctrl+C` to stop the forwarder and close all tunnels.
+
+## Requirements
+
+- Python 3.10+
+- paramiko
+- Remote server must have `ss` or `netstat` command available
+
+## Tests
+
+### Unit tests (run locally, no SSH required):
+
+```bash
+make test
+# or
+uv run pytest tests/ -v
+```
+
+### Integration tests (require SSH access):
+
+```bash
+SSH_AUTO_FORWARD_TEST_HOST=hetzner uv run pytest tests_integration/ -v
+```
+
+The integration tests:
+- Test that remote ports are forwarded to the same local port when available
+- Test that ports increment by 1 when the local port is busy
+- Test auto-detection of new ports
+- Test auto-cleanup when remote ports close

ssh_auto_forward-0.0.1/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ssh-auto-forward"
+description = "Auto-forward SSH ports"
+readme = "README.md"
+license = {text = "WTFPL"}
+requires-python = ">=3.10"
+dynamic = ["version"]
+
+dependencies = [
+    "paramiko>=3.4.0",
+]
+
+authors = [
+    {name = "alexe"}
+]
+
+keywords = ["ssh", "port-forwarding", "tunnel", "remote-development"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[project.scripts]
+ssh-auto-forward = "ssh_auto_forward.cli:main"
+
+[dependency-groups]
+dev = [
+    "hatch",
+    "pytest",
+    "pytest-cov",
+    "ruff",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["ssh_auto_forward"]
+
+[tool.hatch.version]
+path = "ssh_auto_forward/__version__.py"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

ssh_auto_forward-0.0.1/ssh_auto_forward/__init__.py

@@ -0,0 +1,5 @@
+"""SSH Auto Port Forwarder - Automatically forward ports from remote SSH servers."""
+
+from ssh_auto_forward.__version__ import __version__
+
+__all__ = ["__version__"]

ssh_auto_forward-0.0.1/ssh_auto_forward/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"