nexinal 1.0.2__tar.gz

nexinal-1.0.2/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: nexinal
+Version: 1.0.2
+Summary: CLI client for Nexuss Bash remote execution API
+Home-page: https://github.com/nexuss0781/Nexuss-Bash
+Author: Nexuss
+Author-email: Nexuss <nexuss@proton.me>
+License: MIT
+Project-URL: Homepage, https://github.com/nexuss0781/Nexuss-Bash
+Project-URL: Bug Reports, https://github.com/nexuss0781/Nexuss-Bash/issues
+Project-URL: Source, https://github.com/nexuss0781/Nexuss-Bash
+Keywords: cli,bash,remote,execution,api,nexuss,nexinal
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: Topic :: System :: Systems Administration
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# nexinal
+
+CLI client for the **Nexuss Bash** remote execution API. Run shell commands on a remote server directly from your terminal.
+
+## Installation
+
+```bash
+pip install nexinal
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/nexuss0781/Nexuss-Bash
+cd Nexuss-Bash/cli
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+nexinal auth YOUR_API_TOKEN
+
+# Run commands
+nexinal run "echo hello" "whoami" "ls /workspace"
+
+# Execute a YAML file
+nexinal execute runbook.yaml
+
+# Check status
+nexinal status
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `nexinal auth <token>` | Save authentication token |
+| `nexinal run <commands...>` | Run shell commands sequentially |
+| `nexinal execute <yaml_file>` | Execute commands from a YAML file |
+| `nexinal status` | Show connection and token info |
+| `nexinal history` | List past runs |
+| `nexinal health` | Quick health check |
+| `nexinal sessions` | List active sessions |
+| `nexinal packages list` | List installed packages |
+| `nexinal packages install <name>` | Install a package |
+| `nexinal config` | Show or set API URL |
+| `nexinal logout` | Remove saved token |
+
+## YAML File Format
+
+### Simple format
+
+```yaml
+commands:
+  - "echo hello"
+  - "whoami"
+  - "ls -la /workspace"
+```
+
+### Detailed format
+
+```yaml
+commands:
+  - name: "Print hello"
+    command: "echo hello"
+    timeout: 30
+    stop_on_fail: true
+  - name: "List files"
+    command: "ls -la"
+    timeout: 15
+```
+
+## Configuration
+
+Config is stored at `~/.nexinal/config.json`.
+
+```bash
+# Set custom API URL
+nexinal config set https://my-server.example.com
+
+# Show current config
+nexinal config
+```
+
+## Environment
+
+- Python 3.8+
+- Works on Linux, macOS, Windows
+
+## License
+
+MIT

nexinal-1.0.2/README.md

@@ -0,0 +1,94 @@
+# nexinal
+
+CLI client for the **Nexuss Bash** remote execution API. Run shell commands on a remote server directly from your terminal.
+
+## Installation
+
+```bash
+pip install nexinal
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/nexuss0781/Nexuss-Bash
+cd Nexuss-Bash/cli
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+nexinal auth YOUR_API_TOKEN
+
+# Run commands
+nexinal run "echo hello" "whoami" "ls /workspace"
+
+# Execute a YAML file
+nexinal execute runbook.yaml
+
+# Check status
+nexinal status
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `nexinal auth <token>` | Save authentication token |
+| `nexinal run <commands...>` | Run shell commands sequentially |
+| `nexinal execute <yaml_file>` | Execute commands from a YAML file |
+| `nexinal status` | Show connection and token info |
+| `nexinal history` | List past runs |
+| `nexinal health` | Quick health check |
+| `nexinal sessions` | List active sessions |
+| `nexinal packages list` | List installed packages |
+| `nexinal packages install <name>` | Install a package |
+| `nexinal config` | Show or set API URL |
+| `nexinal logout` | Remove saved token |
+
+## YAML File Format
+
+### Simple format
+
+```yaml
+commands:
+  - "echo hello"
+  - "whoami"
+  - "ls -la /workspace"
+```
+
+### Detailed format
+
+```yaml
+commands:
+  - name: "Print hello"
+    command: "echo hello"
+    timeout: 30
+    stop_on_fail: true
+  - name: "List files"
+    command: "ls -la"
+    timeout: 15
+```
+
+## Configuration
+
+Config is stored at `~/.nexinal/config.json`.
+
+```bash
+# Set custom API URL
+nexinal config set https://my-server.example.com
+
+# Show current config
+nexinal config
+```
+
+## Environment
+
+- Python 3.8+
+- Works on Linux, macOS, Windows
+
+## License
+
+MIT

nexinal-1.0.2/nexinal/__init__.py

@@ -0,0 +1,4 @@
+"""nexinal - CLI client for Nexuss Bash remote execution API."""
+
+__version__ = "1.0.2"
+__app_name__ = "nexinal"

nexinal-1.0.2/nexinal/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running nexinal as a module: python -m nexinal."""
+
+from nexinal.cli import main
+
+if __name__ == "__main__":
+    main()

nexinal-1.0.2/nexinal/api.py

@@ -0,0 +1,149 @@
+"""API client for Nexuss Bash."""
+
+import json
+from typing import Optional, Any
+
+import requests
+from requests.exceptions import ConnectionError, HTTPError, RequestException, Timeout
+
+from nexinal.config import get_api_url, get_token
+
+
+class APIError(Exception):
+    def __init__(self, message: str, status_code: Optional[int] = None):
+        self.message = message
+        self.status_code = status_code
+        super().__init__(self.message)
+
+
+class AuthError(APIError):
+    pass
+
+
+class ConnectionError_(APIError):
+    pass
+
+
+def _build_headers() -> dict:
+    headers = {"Content-Type": "application/json"}
+    token = get_token()
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+def _build_url(path: str) -> str:
+    base = get_api_url().rstrip("/")
+    path = path.lstrip("/")
+    return f"{base}/{path}"
+
+
+def api_get(path: str) -> dict:
+    url = _build_url(path)
+    try:
+        resp = requests.get(url, headers=_build_headers(), timeout=30)
+        resp.raise_for_status()
+        return resp.json()
+    except HTTPError as e:
+        status = e.response.status_code if e.response is not None else None
+        if status == 401:
+            raise AuthError("Authentication failed. Run: nexinal auth <token>", status)
+        if status == 404:
+            raise APIError(f"Not found: {path}", status)
+        raise APIError(f"HTTP {status}: {e}", status)
+    except ConnectionError:
+        raise ConnectionError_(f"Cannot connect to {url}. Check your network and API URL.")
+    except Timeout:
+        raise APIError(f"Request timed out: {url}")
+    except RequestException as e:
+        raise APIError(f"Request failed: {e}")
+    except json.JSONDecodeError:
+        raise APIError("Invalid JSON response from server")
+
+
+def api_post(path: str, data: Optional[dict] = None) -> dict:
+    url = _build_url(path)
+    try:
+        resp = requests.post(url, headers=_build_headers(), json=data or {}, timeout=30)
+        resp.raise_for_status()
+        return resp.json()
+    except HTTPError as e:
+        status = e.response.status_code if e.response is not None else None
+        if status == 401:
+            raise AuthError("Authentication failed. Run: nexinal auth <token>", status)
+        if status == 404:
+            raise APIError(f"Not found: {path}", status)
+        body = ""
+        if e.response is not None:
+            try:
+                body = e.response.json().get("detail", e.response.text)
+            except Exception:
+                body = e.response.text
+        raise APIError(f"HTTP {status}: {body}", status)
+    except ConnectionError:
+        raise ConnectionError_(f"Cannot connect to {url}. Check your network and API URL.")
+    except Timeout:
+        raise APIError(f"Request timed out: {url}")
+    except RequestException as e:
+        raise APIError(f"Request failed: {e}")
+    except json.JSONDecodeError:
+        raise APIError("Invalid JSON response from server")
+
+
+def api_post_file(path: str, file_path: str) -> dict:
+    url = _build_url(path)
+    token = get_token()
+    headers = {}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    try:
+        with open(file_path, "rb") as f:
+            files = {"file": (file_path.split("/")[-1], f)}
+            resp = requests.post(url, headers=headers, files=files, timeout=60)
+        resp.raise_for_status()
+        return resp.json()
+    except HTTPError as e:
+        status = e.response.status_code if e.response is not None else None
+        if status == 401:
+            raise AuthError("Authentication failed. Run: nexinal auth <token>", status)
+        raise APIError(f"HTTP {status}: {e}", status)
+    except ConnectionError:
+        raise ConnectionError_(f"Cannot connect to {url}. Check your network and API URL.")
+    except Timeout:
+        raise APIError(f"Request timed out: {url}")
+    except RequestException as e:
+        raise APIError(f"Request failed: {e}")
+    except FileNotFoundError:
+        raise APIError(f"File not found: {file_path}")
+    except json.JSONDecodeError:
+        raise APIError("Invalid JSON response from server")
+
+
+def api_delete(path: str) -> dict:
+    url = _build_url(path)
+    try:
+        resp = requests.delete(url, headers=_build_headers(), timeout=30)
+        resp.raise_for_status()
+        return resp.json()
+    except HTTPError as e:
+        status = e.response.status_code if e.response is not None else None
+        if status == 401:
+            raise AuthError("Authentication failed. Run: nexinal auth <token>", status)
+        raise APIError(f"HTTP {status}: {e}", status)
+    except ConnectionError:
+        raise ConnectionError_(f"Cannot connect to {url}. Check your network and API URL.")
+    except Timeout:
+        raise APIError(f"Request timed out: {url}")
+    except RequestException as e:
+        raise APIError(f"Request failed: {e}")
+    except json.JSONDecodeError:
+        raise APIError("Invalid JSON response from server")
+
+
+def test_connection() -> bool:
+    try:
+        url = _build_url("/health")
+        resp = requests.get(url, timeout=10)
+        return resp.status_code == 200
+    except Exception:
+        return False