lazyssh 1.0.0__tar.gz

lazyssh-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bochner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lazyssh-1.0.0/MANIFEST.in

@@ -0,0 +1,19 @@
+include LICENSE
+include README.md
+include requirements.txt
+include pyproject.toml
+include lazyssh.png
+
+recursive-include src *.py
+recursive-include tests *.py
+
+exclude .github
+exclude .gitignore
+exclude .pre-commit-config.yaml
+exclude Makefile
+exclude test_env
+exclude docs
+
+recursive-exclude .github *
+recursive-exclude docs *
+recursive-exclude test_env * 

lazyssh-1.0.0/PKG-INFO

@@ -0,0 +1,291 @@
+Metadata-Version: 2.2
+Name: lazyssh
+Version: 1.0.0
+Summary: A comprehensive SSH toolkit for managing connections and tunnels
+Home-page: https://github.com/Bochner/lazyssh
+Author: Bochner
+Author-email: Bochner <lazyssh@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Bochner/lazyssh
+Project-URL: Bug Tracker, https://github.com/Bochner/lazyssh/issues
+Project-URL: Documentation, https://github.com/Bochner/lazyssh
+Project-URL: Source Code, https://github.com/Bochner/lazyssh
+Keywords: ssh,tunnel,proxy,socks,terminal,connection,management
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: rich>=13.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pexpect>=4.8.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: prompt_toolkit<3.1.0,>=3.0.39
+Requires-Dist: wcwidth>=0.2.5
+Requires-Dist: art>=5.9
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# LazySSH
+
+A comprehensive SSH toolkit for managing connections, tunnels, and remote sessions with a modern CLI interface.
+
+![LazySSH](https://raw.githubusercontent.com/Bochner/lazyssh/main/lazyssh.png)
+
+## Features
+
+- Dual interface modes:
+  - Interactive menu mode
+  - Command mode with smart tab completion
+- Multiple SSH connection management
+- Forward and reverse tunnel creation
+- Dynamic port forwarding with SOCKS proxy support
+- Control socket management
+- Terminal session management with Terminator
+- Automatic connection cleanup on exit
+- Real-time status display of connections and tunnels
+- Full visibility of SSH commands being executed
+
+## Requirements
+
+- Python 3.7+
+- OpenSSH client
+- Terminator terminal emulator
+
+## Installation
+
+LazySSH can be installed using standard Python packaging tools:
+
+### Option 1: Install with pip (Recommended)
+
+```bash
+# Install globally
+pip install lazyssh
+
+# Or install for the current user only
+pip install --user lazyssh
+```
+
+### Option 2: Install from repository
+
+```bash
+# Clone the repository
+git clone https://github.com/Bochner/lazyssh.git
+cd lazyssh
+
+# Install
+pip install .
+
+# Or for development mode
+pip install -e .
+```
+
+## Usage
+
+LazySSH has two interface modes:
+
+### Command Mode (Default)
+
+```bash
+# Start LazySSH in command mode
+lazyssh
+```
+
+In command mode, you can use the following commands:
+- `lazyssh` - Create a new SSH connection
+  - Basic usage: `lazyssh -ip <ip> -port <port> -user <username> -socket <n>`
+  - With dynamic proxy: `lazyssh -ip <ip> -port <port> -user <username> -socket <n> -proxy [port]`
+- `tunc` - Create a new tunnel (forward or reverse)
+  - Example (forward): `tunc ubuntu l 8080 localhost 80`
+  - Example (reverse): `tunc ubuntu r 3000 127.0.0.1 3000`
+- `tund` - Delete a tunnel by ID
+  - Example: `tund 1`
+- `list` - List connections and tunnels
+- `term` - Open a terminal for a connection
+  - Example: `term ubuntu`
+- `close` - Close a connection
+- `mode` - Switch to prompt mode
+- `help` - Show help
+- `exit` - Exit LazySSH
+
+#### Dynamic SOCKS Proxy
+
+To create a dynamic SOCKS proxy when establishing an SSH connection:
+
+```bash
+# Create connection with dynamic proxy on default port (1080)
+lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver -proxy
+
+# Create connection with dynamic proxy on custom port
+lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver -proxy 8080
+```
+
+You can then configure your applications to use the SOCKS proxy at `localhost:1080` (or your custom port).
+
+### Prompt Mode
+
+```bash
+# Start LazySSH in prompt mode
+lazyssh --prompt
+```
+
+In prompt mode, you'll see a menu with numbered options:
+1. Create new SSH connection (with optional SOCKS proxy)
+2. Destroy tunnel
+3. Create tunnel
+4. Open terminal
+5. Close connection
+6. Switch to command mode
+7. Exit
+
+## Troubleshooting
+
+### Command Not Found
+
+If you installed with `pip install --user` and get "command not found":
+
+```bash
+# Add to your PATH manually
+export PATH="$HOME/.local/bin:$PATH"
+
+# To make it permanent, add this line to your ~/.bashrc file
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Missing Dependencies
+
+If you're missing any dependencies:
+
+```bash
+# Install Terminator (Ubuntu/Debian)
+sudo apt install terminator
+
+# Install Terminator (Fedora)
+sudo dnf install terminator
+
+# Install Terminator (RHEL/CentOS)
+sudo yum install terminator
+```
+
+## Development
+
+### Project Structure
+
+```
+lazyssh/
+├── src/             # Source code
+│   └── lazyssh/     # Main package
+├── tests/           # Test suite
+├── docs/            # Documentation
+├── pyproject.toml   # Project configuration
+├── setup.py         # Package installation
+├── Makefile         # Development tasks
+├── pre-commit-check.sh  # Script to run all CI checks locally
+└── .pre-commit-config.yaml  # Code quality hooks
+```
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/Bochner/lazyssh.git
+cd lazyssh
+
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pip install pre-commit
+pre-commit install
+```
+
+### Running CI Checks Locally
+
+Before committing your code, you can run all the CI checks locally using the provided script:
+
+```bash
+# Make the script executable (first time only)
+chmod +x pre-commit-check.sh
+
+# Run all checks in a virtual environment
+./pre-commit-check.sh
+```
+
+This script:
+- Creates a temporary virtual environment (`.pre-commit-venv`)
+- Installs all development dependencies
+- Runs the following checks:
+  - Black formatting
+  - isort import sorting
+  - flake8 linting
+  - mypy type checking
+  - pytest (if test files exist)
+  - Package building
+  - Package verification with twine
+- Cleans up the repository by removing:
+  - The temporary virtual environment
+  - Python cache files
+  - Build artifacts
+  - Test artifacts
+
+The script is designed to be robust and will clean up after itself even if errors occur. It requires Python 3 to be installed on your system.
+
+This ensures your code passes all CI checks and your repository is clean before committing.
+
+### Common Development Tasks
+
+We provide a Makefile for common tasks:
+
+```bash
+# Install in development mode
+make install
+
+# Run tests
+make test
+
+# Format code (black and isort)
+make fmt
+
+# Lint code
+make lint
+
+# Build package
+make build
+
+# Create distribution
+make dist
+```
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

lazyssh-1.0.0/README.md

@@ -0,0 +1,238 @@
+# LazySSH
+
+A comprehensive SSH toolkit for managing connections, tunnels, and remote sessions with a modern CLI interface.
+
+![LazySSH](https://raw.githubusercontent.com/Bochner/lazyssh/main/lazyssh.png)
+
+## Features
+
+- Dual interface modes:
+  - Interactive menu mode
+  - Command mode with smart tab completion
+- Multiple SSH connection management
+- Forward and reverse tunnel creation
+- Dynamic port forwarding with SOCKS proxy support
+- Control socket management
+- Terminal session management with Terminator
+- Automatic connection cleanup on exit
+- Real-time status display of connections and tunnels
+- Full visibility of SSH commands being executed
+
+## Requirements
+
+- Python 3.7+
+- OpenSSH client
+- Terminator terminal emulator
+
+## Installation
+
+LazySSH can be installed using standard Python packaging tools:
+
+### Option 1: Install with pip (Recommended)
+
+```bash
+# Install globally
+pip install lazyssh
+
+# Or install for the current user only
+pip install --user lazyssh
+```
+
+### Option 2: Install from repository
+
+```bash
+# Clone the repository
+git clone https://github.com/Bochner/lazyssh.git
+cd lazyssh
+
+# Install
+pip install .
+
+# Or for development mode
+pip install -e .
+```
+
+## Usage
+
+LazySSH has two interface modes:
+
+### Command Mode (Default)
+
+```bash
+# Start LazySSH in command mode
+lazyssh
+```
+
+In command mode, you can use the following commands:
+- `lazyssh` - Create a new SSH connection
+  - Basic usage: `lazyssh -ip <ip> -port <port> -user <username> -socket <n>`
+  - With dynamic proxy: `lazyssh -ip <ip> -port <port> -user <username> -socket <n> -proxy [port]`
+- `tunc` - Create a new tunnel (forward or reverse)
+  - Example (forward): `tunc ubuntu l 8080 localhost 80`
+  - Example (reverse): `tunc ubuntu r 3000 127.0.0.1 3000`
+- `tund` - Delete a tunnel by ID
+  - Example: `tund 1`
+- `list` - List connections and tunnels
+- `term` - Open a terminal for a connection
+  - Example: `term ubuntu`
+- `close` - Close a connection
+- `mode` - Switch to prompt mode
+- `help` - Show help
+- `exit` - Exit LazySSH
+
+#### Dynamic SOCKS Proxy
+
+To create a dynamic SOCKS proxy when establishing an SSH connection:
+
+```bash
+# Create connection with dynamic proxy on default port (1080)
+lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver -proxy
+
+# Create connection with dynamic proxy on custom port
+lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver -proxy 8080
+```
+
+You can then configure your applications to use the SOCKS proxy at `localhost:1080` (or your custom port).
+
+### Prompt Mode
+
+```bash
+# Start LazySSH in prompt mode
+lazyssh --prompt
+```
+
+In prompt mode, you'll see a menu with numbered options:
+1. Create new SSH connection (with optional SOCKS proxy)
+2. Destroy tunnel
+3. Create tunnel
+4. Open terminal
+5. Close connection
+6. Switch to command mode
+7. Exit
+
+## Troubleshooting
+
+### Command Not Found
+
+If you installed with `pip install --user` and get "command not found":
+
+```bash
+# Add to your PATH manually
+export PATH="$HOME/.local/bin:$PATH"
+
+# To make it permanent, add this line to your ~/.bashrc file
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Missing Dependencies
+
+If you're missing any dependencies:
+
+```bash
+# Install Terminator (Ubuntu/Debian)
+sudo apt install terminator
+
+# Install Terminator (Fedora)
+sudo dnf install terminator
+
+# Install Terminator (RHEL/CentOS)
+sudo yum install terminator
+```
+
+## Development
+
+### Project Structure
+
+```
+lazyssh/
+├── src/             # Source code
+│   └── lazyssh/     # Main package
+├── tests/           # Test suite
+├── docs/            # Documentation
+├── pyproject.toml   # Project configuration
+├── setup.py         # Package installation
+├── Makefile         # Development tasks
+├── pre-commit-check.sh  # Script to run all CI checks locally
+└── .pre-commit-config.yaml  # Code quality hooks
+```
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/Bochner/lazyssh.git
+cd lazyssh
+
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pip install pre-commit
+pre-commit install
+```
+
+### Running CI Checks Locally
+
+Before committing your code, you can run all the CI checks locally using the provided script:
+
+```bash
+# Make the script executable (first time only)
+chmod +x pre-commit-check.sh
+
+# Run all checks in a virtual environment
+./pre-commit-check.sh
+```
+
+This script:
+- Creates a temporary virtual environment (`.pre-commit-venv`)
+- Installs all development dependencies
+- Runs the following checks:
+  - Black formatting
+  - isort import sorting
+  - flake8 linting
+  - mypy type checking
+  - pytest (if test files exist)
+  - Package building
+  - Package verification with twine
+- Cleans up the repository by removing:
+  - The temporary virtual environment
+  - Python cache files
+  - Build artifacts
+  - Test artifacts
+
+The script is designed to be robust and will clean up after itself even if errors occur. It requires Python 3 to be installed on your system.
+
+This ensures your code passes all CI checks and your repository is clean before committing.
+
+### Common Development Tasks
+
+We provide a Makefile for common tasks:
+
+```bash
+# Install in development mode
+make install
+
+# Run tests
+make test
+
+# Format code (black and isort)
+make fmt
+
+# Lint code
+make lint
+
+# Build package
+make build
+
+# Create distribution
+make dist
+```
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

lazyssh-1.0.0/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lazyssh"
+version = "1.0.0"
+description = "A comprehensive SSH toolkit for managing connections and tunnels"
+readme = "README.md"
+authors = [
+    {name = "Bochner", email = "lazyssh@example.com"}
+]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: System Administrators",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Environment :: Console",
+    "Topic :: System :: Networking",
+    "Topic :: System :: Systems Administration",
+]
+keywords = ["ssh", "tunnel", "proxy", "socks", "terminal", "connection", "management"]
+requires-python = ">=3.7"
+dependencies = [
+    "colorama>=0.4.6",
+    "rich>=13.0.0",
+    "click>=8.0.0",
+    "pexpect>=4.8.0",
+    "python-dotenv>=1.0.0",
+    "prompt_toolkit>=3.0.39,<3.1.0",
+    "wcwidth>=0.2.5",
+    "art>=5.9",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/Bochner/lazyssh"
+"Bug Tracker" = "https://github.com/Bochner/lazyssh/issues"
+"Documentation" = "https://github.com/Bochner/lazyssh"
+"Source Code" = "https://github.com/Bochner/lazyssh"
+
+[project.optional-dependencies]
+dev = [
+    "black",
+    "isort",
+    "pylint",
+    "pytest",
+    "pytest-cov",
+    "mypy",
+    "pre-commit",
+    "build",
+    "wheel",
+    "twine",
+]
+
+[project.scripts]
+lazyssh = "lazyssh.__main__:main"
+
+[tool.black]
+line-length = 100
+target-version = ['py37', 'py38', 'py39', 'py310', 'py311']
+include = '\.pyi?$'
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_functions = "test_*"
+python_classes = "Test*"
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"] 

lazyssh-1.0.0/requirements.txt

@@ -0,0 +1,11 @@
+colorama>=0.4.6
+rich>=13.0.0
+click>=8.0.0
+pexpect>=4.8.0
+python-dotenv>=1.0.0
+prompt_toolkit>=3.0.39,<3.1.0
+wcwidth>=0.2.5
+art>=5.9
+# System dependencies:
+# openssh-client - Required for SSH functionality 
+# terminator - Optional, for terminal emulation (alternatives will be used if not available)

lazyssh-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+