hython-cli 0.1.0__tar.gz → 0.1.1__tar.gz

{hython_cli-0.1.0 → hython_cli-0.1.1}/Cargo.lock

@@ -348,7 +348,7 @@ dependencies = [
 
 [[package]]
 name = "hython"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "clap",
  "colored",

{hython_cli-0.1.0 → hython_cli-0.1.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "hython"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2021"
 readme = "README.md"
 

{hython_cli-0.1.0 → hython_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hython-cli
-Version: 0.1.0
+Version: 0.1.1
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: 3
@@ -18,14 +18,14 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 > **"Don't ask the developer to fix something that Hython can safely fix itself.  
 > And after fixing it: Tell the developer what happened, without making them participate in the process."**
 
-Hython is an automation-first Python environment orchestrator written in **Rust**. It eliminates the friction of managing virtual environments, installing missing dependencies, matching Python versions, and typing routine answers to `[Y/n]` prompts.
+Hython is an automation-first Python environment orchestrator. It eliminates the friction of managing virtual environments, installing missing dependencies, matching Python versions, configuring IDE settings, and answering routine `[Y/n]` prompts.
 
 ---
 
 ## The Mental Model
 
 ```text
-Developer intent (`hython` or `hython run script.py`)
+Developer intent (`hython` or `hython app.py`)
        ↓
 Hython inspects project & requirements
        ↓
@@ -43,37 +43,25 @@ The developer should think:
 
 ---
 
-## Key Features
-
-- 🚫 **No Routine Prompts:** Never stops execution for safe, deterministic actions like creating `.venv` or installing missing dependencies.
-- 🩺 **Self-Healing Environments:** If `.venv` is missing, damaged, or out-of-sync, Hython recreates or synchronizes it seamlessly.
-- 🧠 **Automatic IDE & Framework IntelliSense:** Instantly writes `.vscode/settings.json` and `pyrightconfig.json` so editors lock onto the environment. Automatically provisions framework type stubs (e.g. `django-stubs`, `django-stubs-ext`, `pandas-stubs`) so Django ORM autocompletion and hover documentation work out-of-the-box with zero configuration.
-- 📦 **Dynamic Import Healing:** Intercepts `ModuleNotFoundError` during both pre-flight static analysis and runtime execution. It maps module names to PyPI packages (e.g. `yaml` → `PyYAML`, `dateutil` → `python-dateutil`, `PIL` → `Pillow`, `psycopg2` → `psycopg2-binary`) and installs them automatically.
-- 🎯 **Intelligent Runtime Selection:** Parses `requires-python` (e.g. `>=3.12, <3.14`). If your default interpreter is Python 3.14, Hython discovers or auto-provisions Python 3.13 without manual setup.
-- 🤫 **Quiet & Instant When Warm:** Once an environment is ready and synchronized, `hython` introduces near-zero overhead and runs completely silently.
-- 📊 **Calm Post-Action Summary:** Reports what was detected, selected, installed, and executed only when actions took place.
-
----
-
-## Quick Start
+## Installation
 
-### Installation
-
-**Via pip (Recommended):**
 ```bash
 pip install hython-cli
 ```
+*(Or use `pipx install hython-cli`)*
 
-**Via Cargo:**
-```bash
-cargo install --path .
-```
+---
 
-**Build from Source:**
-```bash
-cargo build --release
-# Standalone binary located at target/release/hython
-```
+## Key Features
+
+- 🚫 **No Routine Prompts:** Never stops execution for safe, deterministic actions like creating `.venv` or installing missing dependencies.
+- 🩺 **Self-Healing Environments:** If `.venv` is missing, corrupted, or out-of-sync, Hython recreates or synchronizes it seamlessly.
+- 📦 **Dynamic Import Healing:** Intercepts `ModuleNotFoundError` during both pre-flight static analysis and runtime execution. It maps module names to PyPI packages (e.g. `yaml` → `PyYAML`, `dateutil` → `python-dateutil`, `PIL` → `Pillow`, `psycopg2` → `psycopg2-binary`) and installs them automatically.
+- 🎯 **Intelligent Runtime Selection:** Parses `requires-python` (e.g. `>=3.12, <3.14`). If your default interpreter is Python 3.14, Hython discovers or auto-provisions a compatible Python runtime without manual setup.
+- 🧠 **Automatic IDE & Framework IntelliSense:** Instantly writes `.vscode/settings.json` and `pyrightconfig.json` so editors lock onto the environment. Automatically provisions framework type stubs (e.g. `django-stubs`, `django-stubs-ext`, `pandas-stubs`) so Django ORM autocompletion and hover documentation work out-of-the-box.
+- 🎨 **Automated Code Formatting:** Includes `hython fmt` and configures format-on-save in your editor, enforcing official PEP 8, Black, isort, and framework conventions automatically.
+- 🤫 **Quiet & Instant When Warm:** Once an environment is ready and synchronized, `hython` introduces near-zero overhead and runs completely silently.
+- 📊 **Calm Post-Action Summary:** Reports what was detected, selected, installed, and executed only when actions took place.
 
 ---
 
@@ -84,9 +72,9 @@ In any project folder (Django, FastAPI, Flask, or script-based):
 ```bash
 hython
 ```
-- If Django is detected (`manage.py`): runs `manage.py runserver`.
-- If FastAPI is detected (`main.py` with `FastAPI()`): ensures `uvicorn` and runs `uvicorn main:app --reload`.
-- If standard entrypoint (`main.py`, `app.py`, `run.py`): executes with project environment.
+- **Django:** If `manage.py` is detected, runs `manage.py runserver`.
+- **FastAPI:** If `FastAPI()` is detected in `main.py` or `app.py`, ensures `uvicorn` and runs `uvicorn main:app --reload`.
+- **Standard scripts:** Automatically finds `main.py`, `app.py`, or `run.py` and executes within the isolated environment.
 
 ### 2. Run Any Script with Self-Healing
 ```bash
@@ -107,7 +95,13 @@ hython add requests
 ```
 Updates `pyproject.toml` or `requirements.txt` and synchronizes the environment immediately.
 
-### 5. Explicit Synchronization & Status
+### 5. Format Code
+```bash
+hython fmt
+```
+Automatically cleans, formats, and sorts imports according to PEP 8 and framework rules.
+
+### 6. Explicit Synchronization & Status
 ```bash
 hython sync      # Reconciles environment and dependencies
 hython status    # Inspects detected project root, manifest, and runtime
@@ -115,22 +109,7 @@ hython status    # Inspects detected project root, manifest, and runtime
 
 ---
 
-## Architecture
-
-| Module | Responsibility |
-| :--- | :--- |
-| [`src/main.rs`](file:///Volumes/harsha's%20SSD/Hython/src/main.rs) | CLI entrypoint, argument dispatch, zero-argument project auto-detection |
-| [`src/manifest.rs`](file:///Volumes/harsha's%20SSD/Hython/src/manifest.rs) | Inspects `pyproject.toml`, `requirements.txt`, `.python-version`, entry points |
-| [`src/runtime.rs`](file:///Volumes/harsha's%20SSD/Hython/src/runtime.rs) | SemVer constraint matching, local Python discovery, standalone runtime provisioning |
-| [`src/env.rs`](file:///Volumes/harsha's%20SSD/Hython/src/env.rs) | `.venv` lifecycle, state hashing (`.venv/.hython-state.json`), dependency synchronization |
-| [`src/scanner.rs`](file:///Volumes/harsha's%20SSD/Hython/src/scanner.rs) | Fast static AST/regex import scanning for pre-flight missing package detection |
-| [`src/resolver.rs`](file:///Volumes/harsha's%20SSD/Hython/src/resolver.rs) | Standard library filter and module-to-PyPI package name mapping |
-| [`src/runner.rs`](file:///Volumes/harsha's%20SSD/Hython/src/runner.rs) | Execution supervisor with dynamic runtime `ModuleNotFoundError` interception & self-healing |
-| [`src/reporter.rs`](file:///Volumes/harsha's%20SSD/Hython/src/reporter.rs) | Transparent, non-intrusive post-action summary formatter |
-
----
-
 ## License
 
-MIT
+MIT License — Hython Labs
 

{hython_cli-0.1.0 → hython_cli-0.1.1}/README.md

@@ -4,14 +4,14 @@
 > **"Don't ask the developer to fix something that Hython can safely fix itself.  
 > And after fixing it: Tell the developer what happened, without making them participate in the process."**
 
-Hython is an automation-first Python environment orchestrator written in **Rust**. It eliminates the friction of managing virtual environments, installing missing dependencies, matching Python versions, and typing routine answers to `[Y/n]` prompts.
+Hython is an automation-first Python environment orchestrator. It eliminates the friction of managing virtual environments, installing missing dependencies, matching Python versions, configuring IDE settings, and answering routine `[Y/n]` prompts.
 
 ---
 
 ## The Mental Model
 
 ```text
-Developer intent (`hython` or `hython run script.py`)
+Developer intent (`hython` or `hython app.py`)
        ↓
 Hython inspects project & requirements
        ↓
@@ -29,37 +29,25 @@ The developer should think:
 
 ---
 
-## Key Features
-
-- 🚫 **No Routine Prompts:** Never stops execution for safe, deterministic actions like creating `.venv` or installing missing dependencies.
-- 🩺 **Self-Healing Environments:** If `.venv` is missing, damaged, or out-of-sync, Hython recreates or synchronizes it seamlessly.
-- 🧠 **Automatic IDE & Framework IntelliSense:** Instantly writes `.vscode/settings.json` and `pyrightconfig.json` so editors lock onto the environment. Automatically provisions framework type stubs (e.g. `django-stubs`, `django-stubs-ext`, `pandas-stubs`) so Django ORM autocompletion and hover documentation work out-of-the-box with zero configuration.
-- 📦 **Dynamic Import Healing:** Intercepts `ModuleNotFoundError` during both pre-flight static analysis and runtime execution. It maps module names to PyPI packages (e.g. `yaml` → `PyYAML`, `dateutil` → `python-dateutil`, `PIL` → `Pillow`, `psycopg2` → `psycopg2-binary`) and installs them automatically.
-- 🎯 **Intelligent Runtime Selection:** Parses `requires-python` (e.g. `>=3.12, <3.14`). If your default interpreter is Python 3.14, Hython discovers or auto-provisions Python 3.13 without manual setup.
-- 🤫 **Quiet & Instant When Warm:** Once an environment is ready and synchronized, `hython` introduces near-zero overhead and runs completely silently.
-- 📊 **Calm Post-Action Summary:** Reports what was detected, selected, installed, and executed only when actions took place.
-
----
-
-## Quick Start
+## Installation
 
-### Installation
-
-**Via pip (Recommended):**
 ```bash
 pip install hython-cli
 ```
+*(Or use `pipx install hython-cli`)*
 
-**Via Cargo:**
-```bash
-cargo install --path .
-```
+---
 
-**Build from Source:**
-```bash
-cargo build --release
-# Standalone binary located at target/release/hython
-```
+## Key Features
+
+- 🚫 **No Routine Prompts:** Never stops execution for safe, deterministic actions like creating `.venv` or installing missing dependencies.
+- 🩺 **Self-Healing Environments:** If `.venv` is missing, corrupted, or out-of-sync, Hython recreates or synchronizes it seamlessly.
+- 📦 **Dynamic Import Healing:** Intercepts `ModuleNotFoundError` during both pre-flight static analysis and runtime execution. It maps module names to PyPI packages (e.g. `yaml` → `PyYAML`, `dateutil` → `python-dateutil`, `PIL` → `Pillow`, `psycopg2` → `psycopg2-binary`) and installs them automatically.
+- 🎯 **Intelligent Runtime Selection:** Parses `requires-python` (e.g. `>=3.12, <3.14`). If your default interpreter is Python 3.14, Hython discovers or auto-provisions a compatible Python runtime without manual setup.
+- 🧠 **Automatic IDE & Framework IntelliSense:** Instantly writes `.vscode/settings.json` and `pyrightconfig.json` so editors lock onto the environment. Automatically provisions framework type stubs (e.g. `django-stubs`, `django-stubs-ext`, `pandas-stubs`) so Django ORM autocompletion and hover documentation work out-of-the-box.
+- 🎨 **Automated Code Formatting:** Includes `hython fmt` and configures format-on-save in your editor, enforcing official PEP 8, Black, isort, and framework conventions automatically.
+- 🤫 **Quiet & Instant When Warm:** Once an environment is ready and synchronized, `hython` introduces near-zero overhead and runs completely silently.
+- 📊 **Calm Post-Action Summary:** Reports what was detected, selected, installed, and executed only when actions took place.
 
 ---
 
@@ -70,9 +58,9 @@ In any project folder (Django, FastAPI, Flask, or script-based):
 ```bash
 hython
 ```
-- If Django is detected (`manage.py`): runs `manage.py runserver`.
-- If FastAPI is detected (`main.py` with `FastAPI()`): ensures `uvicorn` and runs `uvicorn main:app --reload`.
-- If standard entrypoint (`main.py`, `app.py`, `run.py`): executes with project environment.
+- **Django:** If `manage.py` is detected, runs `manage.py runserver`.
+- **FastAPI:** If `FastAPI()` is detected in `main.py` or `app.py`, ensures `uvicorn` and runs `uvicorn main:app --reload`.
+- **Standard scripts:** Automatically finds `main.py`, `app.py`, or `run.py` and executes within the isolated environment.
 
 ### 2. Run Any Script with Self-Healing
 ```bash
@@ -93,7 +81,13 @@ hython add requests
 ```
 Updates `pyproject.toml` or `requirements.txt` and synchronizes the environment immediately.
 
-### 5. Explicit Synchronization & Status
+### 5. Format Code
+```bash
+hython fmt
+```
+Automatically cleans, formats, and sorts imports according to PEP 8 and framework rules.
+
+### 6. Explicit Synchronization & Status
 ```bash
 hython sync      # Reconciles environment and dependencies
 hython status    # Inspects detected project root, manifest, and runtime
@@ -101,21 +95,6 @@ hython status    # Inspects detected project root, manifest, and runtime
 
 ---
 
-## Architecture
-
-| Module | Responsibility |
-| :--- | :--- |
-| [`src/main.rs`](file:///Volumes/harsha's%20SSD/Hython/src/main.rs) | CLI entrypoint, argument dispatch, zero-argument project auto-detection |
-| [`src/manifest.rs`](file:///Volumes/harsha's%20SSD/Hython/src/manifest.rs) | Inspects `pyproject.toml`, `requirements.txt`, `.python-version`, entry points |
-| [`src/runtime.rs`](file:///Volumes/harsha's%20SSD/Hython/src/runtime.rs) | SemVer constraint matching, local Python discovery, standalone runtime provisioning |
-| [`src/env.rs`](file:///Volumes/harsha's%20SSD/Hython/src/env.rs) | `.venv` lifecycle, state hashing (`.venv/.hython-state.json`), dependency synchronization |
-| [`src/scanner.rs`](file:///Volumes/harsha's%20SSD/Hython/src/scanner.rs) | Fast static AST/regex import scanning for pre-flight missing package detection |
-| [`src/resolver.rs`](file:///Volumes/harsha's%20SSD/Hython/src/resolver.rs) | Standard library filter and module-to-PyPI package name mapping |
-| [`src/runner.rs`](file:///Volumes/harsha's%20SSD/Hython/src/runner.rs) | Execution supervisor with dynamic runtime `ModuleNotFoundError` interception & self-healing |
-| [`src/reporter.rs`](file:///Volumes/harsha's%20SSD/Hython/src/reporter.rs) | Transparent, non-intrusive post-action summary formatter |
-
----
-
 ## License
 
-MIT
+MIT License — Hython Labs

{hython_cli-0.1.0 → hython_cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "hython-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Zero-Interruption Python Automation Engine"
 readme = "README.md"
 requires-python = ">=3.8"

hython_cli-0.1.1/tests/live_pypi_sandbox_test.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+set -e
+
+SANDBOX_DIR="$(mktemp -d -t hython_live_pypi_XXXXXX)"
+
+echo "=========================================================="
+echo "🌐 RUNNING LIVE PYPI INSTALLATION & END-TO-END VERIFICATION"
+echo "Sandbox Directory: $SANDBOX_DIR"
+echo "=========================================================="
+
+cleanup() {
+    rm -rf "$SANDBOX_DIR"
+}
+trap cleanup EXIT
+
+# Step 1: Create fresh virtual environment (simulating a clean user laptop)
+echo "1. Creating fresh sandbox environment..."
+python3 -m venv "$SANDBOX_DIR/user_env"
+ENV_PIP="$SANDBOX_DIR/user_env/bin/pip"
+ENV_HYTHON="$SANDBOX_DIR/user_env/bin/hython"
+
+# Step 2: Install hython-cli directly from PyPI
+echo "2. Installing 'hython-cli' from official PyPI..."
+"$ENV_PIP" install --no-cache-dir hython-cli
+
+# Step 3: Verify hython binary was installed into the user's PATH
+echo -n "3. Verifying hython binary execution... "
+HYTHON_VER=$("$ENV_HYTHON" --version)
+echo "✅ Installed: $HYTHON_VER"
+
+# Step 4: Test Self-Healing Missing Dependency
+echo -n "4. Testing Self-Healing with missing dependency (requests)... "
+PROJECT_DIR="$SANDBOX_DIR/my_project"
+mkdir -p "$PROJECT_DIR"
+cat << 'EOF' > "$PROJECT_DIR/app.py"
+import requests
+resp = requests.get("https://httpbin.org/get")
+print(f"LIVE_TEST_STATUS:{resp.status_code}")
+EOF
+
+OUTPUT_APP=$(cd "$PROJECT_DIR" && "$ENV_HYTHON" app.py 2>&1)
+if echo "$OUTPUT_APP" | grep -q "LIVE_TEST_STATUS:200" && echo "$OUTPUT_APP" | grep -q "Installed 1 missing dependency"; then
+    echo "✅ PASSED (Self-healed missing package & ran successfully)"
+else
+    echo "❌ FAILED"
+    echo "$OUTPUT_APP"
+    exit 1
+fi
+
+# Step 5: Test Dynamic Import Interception
+echo -n "5. Testing Dynamic Import Interception ('yaml' -> 'PyYAML')... "
+cat << 'EOF' > "$PROJECT_DIR/dynamic.py"
+def load_data():
+    import yaml
+    return yaml.safe_load("product: Hython-CLI\nstatus: Verified")
+
+print(load_data()["product"])
+EOF
+
+OUTPUT_DYN=$(cd "$PROJECT_DIR" && "$ENV_HYTHON" dynamic.py 2>&1)
+if echo "$OUTPUT_DYN" | grep -q "Hython-CLI"; then
+    echo "✅ PASSED (Intercepted runtime missing module & resolved PyPI package)"
+else
+    echo "❌ FAILED"
+    echo "$OUTPUT_DYN"
+    exit 1
+fi
+
+# Step 6: Test Code Formatting (hython fmt)
+echo -n "6. Testing Code Formatting (hython fmt)... "
+cat << 'EOF' > "$PROJECT_DIR/messy.py"
+def dirty_func( x,y,   z ):
+    a = [ 1,  2,3 ]
+    return {"x":x,"y":y,"z":z}
+EOF
+
+(cd "$PROJECT_DIR" && "$ENV_HYTHON" fmt > /dev/null 2>&1)
+if grep -q "def dirty_func(x, y, z):" "$PROJECT_DIR/messy.py"; then
+    echo "✅ PASSED (PEP 8 auto-formatting applied cleanly)"
+else
+    echo "❌ FAILED"
+    cat "$PROJECT_DIR/messy.py"
+    exit 1
+fi
+
+# Step 7: Test IDE IntelliSense Auto-Generation
+echo -n "7. Testing IDE IntelliSense Auto-Configuration... "
+cat << 'EOF' > "$PROJECT_DIR/manage.py"
+# DJANGO_SETTINGS_MODULE = "test.settings"
+print("Django ready")
+EOF
+
+(cd "$PROJECT_DIR" && "$ENV_HYTHON" sync > /dev/null 2>&1)
+if [ -f "$PROJECT_DIR/.vscode/settings.json" ] && [ -f "$PROJECT_DIR/pyrightconfig.json" ]; then
+    echo "✅ PASSED (Created .vscode/settings.json and pyrightconfig.json)"
+else
+    echo "❌ FAILED (IntelliSense configs not generated)"
+    exit 1
+fi
+
+echo "=========================================================="
+echo "🎉 ALL LIVE PYPI INSTALLATION & VERIFICATION TESTS PASSED!"
+echo "=========================================================="