error-translator-cli-v2 1.1.5__tar.gz → 2.0.0__tar.gz

{error_translator_cli_v2-1.1.5 → error_translator_cli_v2-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: error-translator-cli-v2
-Version: 1.1.5
+Version: 2.0.0
 Summary: Offline Python traceback translator and error explainer CLI that converts exceptions into clear explanations and actionable fixes.
 Author-email: Gourabananda Datta <gourabanandadatta@zohomail.in>
 License: MIT License
@@ -90,6 +90,7 @@ If this project saves you debugging time, please consider starring it on GitHub:
 ## Key Features
 
 * **CLI-First Architecture**: Seamlessly process scripts, direct error strings, or piped logs via the `explain-error` command.
+* **Professional Rich Terminal UI**: Clean panels, syntax-highlighted code context, structured sections, and improved readability for day-to-day debugging.
 * **Automatic Integration Mode**: Inject the module via `import error_translator.auto` to automatically override `sys.excepthook` for graceful, translated crash reporting.
 * **Extensible API Surfaces**: Integrate natively within Python or expose the core engine over HTTP via the included FastAPI server.
 * **Deterministic Rules Engine**: High-performance, regex-based matching powered by `rules.json` guarantees offline and privacy-first translations.
@@ -137,6 +138,11 @@ explain-error --json "NameError: name 'x' is not defined"
 # {"explanation": "...", "fix": "...", "matched_error": "...", "file": "...", "line": "...", "code": "...", "ast_insight": null}
 ```
 
+Show an about screen with project metadata and quick usage examples:
+```bash
+explain-error --about
+```
+
 The `--json` flag works with every input mode (`run <script>`, raw string, piped log).
 
 ### 2. Automatic Import Hook

{error_translator_cli_v2-1.1.5 → error_translator_cli_v2-2.0.0}/README.md

@@ -25,6 +25,7 @@ If this project saves you debugging time, please consider starring it on GitHub:
 ## Key Features
 
 * **CLI-First Architecture**: Seamlessly process scripts, direct error strings, or piped logs via the `explain-error` command.
+* **Professional Rich Terminal UI**: Clean panels, syntax-highlighted code context, structured sections, and improved readability for day-to-day debugging.
 * **Automatic Integration Mode**: Inject the module via `import error_translator.auto` to automatically override `sys.excepthook` for graceful, translated crash reporting.
 * **Extensible API Surfaces**: Integrate natively within Python or expose the core engine over HTTP via the included FastAPI server.
 * **Deterministic Rules Engine**: High-performance, regex-based matching powered by `rules.json` guarantees offline and privacy-first translations.
@@ -72,6 +73,11 @@ explain-error --json "NameError: name 'x' is not defined"
 # {"explanation": "...", "fix": "...", "matched_error": "...", "file": "...", "line": "...", "code": "...", "ast_insight": null}
 ```
 
+Show an about screen with project metadata and quick usage examples:
+```bash
+explain-error --about
+```
+
 The `--json` flag works with every input mode (`run <script>`, raw string, piped log).
 
 ### 2. Automatic Import Hook

{error_translator_cli_v2-1.1.5 → error_translator_cli_v2-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "error-translator-cli-v2"
-version = "1.1.5"
+version = "2.0.0"
 description = "Offline Python traceback translator and error explainer CLI that converts exceptions into clear explanations and actionable fixes."
 readme = "README.md"
 requires-python = ">=3.9"

error_translator_cli_v2-2.0.0/src/error_translator/cli.py

@@ -0,0 +1,265 @@
+import json
+import sys
+import argparse
+from .core import translate_error
+from importlib.metadata import version, PackageNotFoundError
+
+# Import Rich UI Components
+from rich.console import Console
+from rich.panel import Panel
+from rich.syntax import Syntax
+from rich.text import Text
+from rich.table import Table
+from rich import box
+
+try:
+    VERSION = version("error-translator-cli-v2")
+except PackageNotFoundError:
+    VERSION = "unknown (not installed via pip)"
+
+# Initialize the global rich console
+console = Console()
+
+
+def _print_title_banner():
+    banner = Text()
+    banner.append("Error Translator CLI\n", style="bold bright_magenta")
+    banner.append("Translate Python tracebacks into clear, actionable guidance.", style="cyan")
+    console.print(
+        Panel(
+            banner,
+            border_style="magenta",
+            padding=(1, 2),
+            expand=False,
+        )
+    )
+
+def print_about():
+    """Prints a polished about view using rich components."""
+    _print_title_banner()
+
+    meta = Table.grid(padding=(0, 1))
+    meta.add_column(style="bold white", justify="right")
+    meta.add_column(style="green")
+    meta.add_row("Version", VERSION)
+    meta.add_row("Author", "Gourabananda Datta")
+    meta.add_row("Repository", "https://github.com/gourabanandad/error-translator-cli-v2")
+    console.print(Panel(meta, title="[bold cyan]Project[/]", border_style="cyan", expand=False))
+
+    features = Text()
+    features.append("• Offline and fast translation\n", style="white")
+    features.append("• Human-readable explanations\n", style="white")
+    features.append("• Actionable fix suggestions\n", style="white")
+    features.append("• Optional AST-level insight", style="white")
+    console.print(Panel(features, title="[bold green]Features[/]", border_style="green", expand=False))
+
+    examples = Text()
+    examples.append("explain-error run your_script.py\n", style="bold cyan")
+    examples.append("explain-error \"TypeError: ...\"\n", style="bold cyan")
+    examples.append("cat error.log | explain-error", style="bold cyan")
+    console.print(Panel(examples, title="[bold yellow]Quick Start[/]", border_style="yellow", expand=False))
+
+
+def print_result(result: dict):
+    """Print translated output in a polished, professional layout."""
+    console.print()
+
+    if result.get("error") and not result.get("matched_error"):
+        message = result.get("message", "An unexpected error occurred.")
+        console.print(
+            Panel(
+                f"[bold red]{message}[/]",
+                title="[bold red]Error[/]",
+                border_style="red",
+                box=box.ROUNDED,
+                expand=False,
+            )
+        )
+        return
+
+    error_title = result.get("matched_error", "Unknown Error")
+    console.print(
+        Panel(
+            f"[bold white]{error_title}[/]",
+            title="[bold red]Detected Error[/]",
+            border_style="red",
+            box=box.ROUNDED,
+            expand=False,
+        )
+    )
+
+    file_name = result.get("file")
+    line_no = result.get("line", "?")
+    if file_name and file_name != "Unknown File":
+        console.print(
+            Panel(
+                f"[yellow]File:[/] {file_name}\n[yellow]Line:[/] {line_no}",
+                title="[bold yellow]Location[/]",
+                border_style="yellow",
+                box=box.ROUNDED,
+                expand=False,
+            )
+        )
+
+    if result.get("code"):
+        try:
+            start_line = int(line_no)
+        except (TypeError, ValueError):
+            start_line = 1
+
+        syntax = Syntax(
+            result["code"],
+            "python",
+            theme="monokai",
+            line_numbers=True,
+            start_line=start_line,
+            word_wrap=True,
+        )
+        console.print(Panel(syntax, title="[bold blue]Code Context[/]", border_style="blue", box=box.ROUNDED))
+
+    explanation = result.get("explanation", "No explanation available.")
+    console.print(
+        Panel(
+            f"[white]{explanation}[/]",
+            title="[bold cyan]Explanation[/]",
+            title_align="left",
+            border_style="cyan",
+            box=box.ROUNDED,
+            expand=False,
+        )
+    )
+
+    fix = result.get("fix", "No suggested fix available.")
+    console.print(
+        Panel(
+            f"[bold green]{fix}[/]",
+            title="[bold green]Suggested Fix[/]",
+            title_align="left",
+            border_style="green",
+            box=box.ROUNDED,
+            expand=False,
+        )
+    )
+
+    if result.get("ast_insight"):
+        console.print(
+            Panel(
+                f"[white]{result['ast_insight']}[/]",
+                title="[bold magenta]AST Insight[/]",
+                title_align="left",
+                border_style="magenta",
+                box=box.ROUNDED,
+                expand=False,
+            )
+        )
+
+
+def print_result_json(result: dict):
+    """Prints the translated error as a single-line JSON object on stdout."""
+    print(json.dumps(result, ensure_ascii=False))
+
+
+def run_script(script_name: str, *, as_json: bool = False):
+    """Run a Python script and translate traceback output if it fails."""
+    import subprocess
+    try:
+        result = subprocess.run(
+            [sys.executable, script_name],
+            capture_output=True,
+            text=True
+        )
+
+        if result.returncode == 0:
+            print(result.stdout, end="")
+        else:
+            if result.stdout:
+                print(result.stdout, end="")
+
+            translation = translate_error(result.stderr)
+            if as_json:
+                print_result_json(translation)
+            else:
+                print_result(translation)
+
+    except FileNotFoundError:
+        if as_json:
+            print(json.dumps({
+                "error": "script_not_found",
+                "message": f"Could not find script '{script_name}'",
+            }))
+        else:
+            console.print(
+                Panel(
+                    f"[bold red]Could not find script '{script_name}'[/]",
+                    title="[bold red]Execution Error[/]",
+                    border_style="red",
+                    box=box.ROUNDED,
+                    expand=False,
+                )
+            )
+    except Exception as exc:
+        if as_json:
+            print(json.dumps({
+                "error": "runtime_failure",
+                "message": str(exc),
+            }))
+        else:
+            console.print(
+                Panel(
+                    f"[bold red]{exc}[/]",
+                    title="[bold red]Runtime Error[/]",
+                    border_style="red",
+                    box=box.ROUNDED,
+                    expand=False,
+                )
+            )
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="explain-error",
+        description="Error Translator — Turn cryptic Python tracebacks into clear, actionable advice.",
+        epilog="""
+Examples:
+  explain-error run my_script.py
+  explain-error "NameError: name 'usr_count' is not defined"
+  cat error.log | explain-error
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+
+    parser.add_argument("-a", "--about", action="store_true", help="Display information about the tool.")
+    parser.add_argument("-v", "--version", action="store_true", help="Show the current version of the tool.")
+    parser.add_argument("--json", action="store_true", dest="as_json", help="Output the translated error as a JSON object.")
+    parser.add_argument("args", nargs="*", help="Positional arguments.")
+
+    parsed_args = parser.parse_args()
+
+    if parsed_args.about:
+        print_about()
+        sys.exit(0)
+    
+    if parsed_args.version:
+        console.print(f"Error Translator CLI Version: [bold green]{VERSION}[/]")
+        sys.exit(0)
+    
+    emit = print_result_json if parsed_args.as_json else print_result
+
+    if not sys.stdin.isatty():
+        error_input = sys.stdin.read()
+        if error_input.strip():
+            emit(translate_error(error_input))
+            return
+
+    if not parsed_args.args:
+        parser.print_help()
+        sys.exit(1)
+
+    if parsed_args.args[0] == "run" and len(parsed_args.args) > 1:
+        script_name = parsed_args.args[1]
+        run_script(script_name, as_json=parsed_args.as_json)
+    else:
+        error_input = " ".join(parsed_args.args)
+        emit(translate_error(error_input))
+
+if __name__ == "__main__":
+    main()

{error_translator_cli_v2-1.1.5 → error_translator_cli_v2-2.0.0}/src/error_translator/core.py

@@ -90,7 +90,7 @@ def translate_error(traceback_text: str) -> dict:
         insight = None
         
         if handler_function and file_name != "Unknown File":
-            insight = handler_function(file_name, extracted_values)
+            insight = handler_function(file_name, line_number, extracted_values)
         
         return {
             "explanation": rule["explanation"].format(*extracted_values),

{error_translator_cli_v2-1.1.5 → error_translator_cli_v2-2.0.0}/src/error_translator_cli_v2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: error-translator-cli-v2
-Version: 1.1.5
+Version: 2.0.0
 Summary: Offline Python traceback translator and error explainer CLI that converts exceptions into clear explanations and actionable fixes.
 Author-email: Gourabananda Datta <gourabanandadatta@zohomail.in>
 License: MIT License
@@ -90,6 +90,7 @@ If this project saves you debugging time, please consider starring it on GitHub:
 ## Key Features
 
 * **CLI-First Architecture**: Seamlessly process scripts, direct error strings, or piped logs via the `explain-error` command.
+* **Professional Rich Terminal UI**: Clean panels, syntax-highlighted code context, structured sections, and improved readability for day-to-day debugging.
 * **Automatic Integration Mode**: Inject the module via `import error_translator.auto` to automatically override `sys.excepthook` for graceful, translated crash reporting.
 * **Extensible API Surfaces**: Integrate natively within Python or expose the core engine over HTTP via the included FastAPI server.
 * **Deterministic Rules Engine**: High-performance, regex-based matching powered by `rules.json` guarantees offline and privacy-first translations.
@@ -137,6 +138,11 @@ explain-error --json "NameError: name 'x' is not defined"
 # {"explanation": "...", "fix": "...", "matched_error": "...", "file": "...", "line": "...", "code": "...", "ast_insight": null}
 ```
 
+Show an about screen with project metadata and quick usage examples:
+```bash
+explain-error --about
+```
+
 The `--json` flag works with every input mode (`run <script>`, raw string, piped log).
 
 ### 2. Automatic Import Hook

error_translator_cli_v2-1.1.5/src/error_translator/cli.py

@@ -1,207 +0,0 @@
-import json
-import sys
-import argparse
-from .core import translate_error
-from importlib.metadata import version, PackageNotFoundError
-
-try:
-    VERSION = version("error-translator-cli-v2")
-except PackageNotFoundError:
-    VERSION = "unknown (not installed via pip)"  # Fallback version if package metadata is not found
-
-# ANSI Color Codes
-class Colors:
-    RED = '\033[91m'
-    GREEN = '\033[92m'
-    YELLOW = '\033[93m'
-    CYAN = '\033[96m'
-    BOLD = '\033[1m'
-    RESET = '\033[0m'
-    MAGENTA = '\033[95m'
-
-
-def print_about():
-    """Prints the about message for the tool."""
-    about_text = f"""
-ERROR TRANSLATOR CLI
-=====================
-A lightning-fast, offline tool that translates raw Python tracebacks 
-into human-readable explanations with actionable fixes.
-
-Authors: Gourabananda Datta
-Repository: https://github.com/gourabanandad/error-translator-cli-v2
-Usage:
-  1. Run a script and translate its errors:
-        explain-error run your_script.py
-    2. Translate an error message directly:
-        explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
-    3. Pipe an error log:
-        cat error.log | explain-error
-    4. Get help:
-        explain-error --help
-    5. About:
-        explain-error --about
-"""
-    print(f"\033[96m{about_text}\033[0m")
-
-
-def print_result(result: dict):
-    """Prints the translated error to the terminal with colors."""
-    print(f"\n{Colors.RED}{Colors.BOLD} Error Detected:{Colors.RESET}")
-    print(f"{result.get('matched_error', 'N/A')}")
-    
-    if "file" in result:
-        print(f"{Colors.YELLOW} Location: {result['file']} (Line {result['line']}){Colors.RESET}\n")
-        if result.get("code"):
-            print(f"{Colors.RESET}   |")
-            print(f"{Colors.RESET}   |  {Colors.RED}{result['code']}{Colors.RESET}")
-            print(f"{Colors.RESET}   |\n")
-        else:
-            print("\n")
-
-    else:
-        print()
-    
-    print(f"{Colors.CYAN}{Colors.BOLD} Explanation:{Colors.RESET}")
-    print(f"{result['explanation']}\n")
-    
-    print(f"{Colors.GREEN}{Colors.BOLD} Suggested Fix:{Colors.RESET}")
-    print(f"{result['fix']}\n")
-
-    if result.get("ast_insight"):
-        print(f"{Colors.MAGENTA}{Colors.BOLD} AST Insight:{Colors.RESET}")
-        print(f"{result['ast_insight']}\n")
-
-
-def print_result_json(result: dict):
-    """Prints the translated error as a single-line JSON object on stdout.
-
-    Useful for scripting and automation: pipe the output to `jq`, parse it
-    in another language, or store it as structured logs.
-    """
-    print(json.dumps(result, ensure_ascii=False))
-
-
-def run_script(script_name: str, *, as_json: bool = False):
-    """Runs a python script in the background and catches its errors."""
-    import subprocess
-    try:
-        # Run the script using the current Python environment
-        result = subprocess.run(
-            [sys.executable, script_name],
-            capture_output=True,
-            text=True
-        )
-
-        # If the script ran perfectly (Return Code 0), print standard output
-        if result.returncode == 0:
-            print(result.stdout, end="")
-
-        # If the script crashed, print whatever succeeded, THEN translate the error
-        else:
-            if result.stdout:
-                print(result.stdout, end="")
-
-            translation = translate_error(result.stderr)
-            if as_json:
-                print_result_json(translation)
-            else:
-                print_result(translation)
-
-    except FileNotFoundError:
-        if as_json:
-            print(json.dumps({
-                "error": "script_not_found",
-                "message": f"Could not find script '{script_name}'",
-            }))
-        else:
-            print(f"{Colors.RED}Error: Could not find script '{script_name}'{Colors.RESET}")
-
-# Entry point of the program
-def main():
-    parser = argparse.ArgumentParser(
-        prog="explain-error",
-        description="Error Translator — Turn cryptic Python tracebacks into clear, actionable advice.",
-        epilog="""
-Examples:
-  # Run a Python script and translate any unhandled errors
-  explain-error run my_script.py
-
-  # Translate a raw error string directly
-  explain-error "NameError: name 'usr_count' is not defined"
-
-  # Pipe a traceback from a log file or another command
-  cat error.log | explain-error
-
-For more information, visit: https://github.com/gourabanandad/error-translator
-        """,
-        formatter_class=argparse.RawDescriptionHelpFormatter
-    )
-
-    parser.add_argument(
-        "-a",
-        "--about",
-        action="store_true",
-        help="Display information about the tool."
-    )
-    
-    parser.add_argument(
-        "-v",
-        "--version",
-        action="store_true",
-        help="Show the current version of the tool."
-    )
-
-    parser.add_argument(
-        "--json",
-        action="store_true",
-        dest="as_json",
-        help="Output the translated error as a single JSON object on stdout (useful for scripting)."
-    )
-
-    parser.add_argument(
-        "args",
-        nargs="*",
-        help=(
-            "Positional arguments. Use 'run <script.py>' to execute a Python file, "
-            "or provide an error string to translate. If no arguments are given and "
-            "stdin is not piped, this help message is displayed."
-        )
-    )
-
-    parsed_args = parser.parse_args()
-
-    if parsed_args.about:
-        print_about()
-        sys.exit(0)
-    
-    if parsed_args.version:
-        print(f"Error Translator CLI Version: {Colors.GREEN}{VERSION}{Colors.RESET}")
-        sys.exit(0)
-    
-    emit = print_result_json if parsed_args.as_json else print_result
-
-    # 1. Handle Piped Input (e.g., cat error.log | explain-error)
-    if not sys.stdin.isatty():
-        error_input = sys.stdin.read()
-        if error_input.strip():
-            emit(translate_error(error_input))
-            return
-
-    # 2. Print help if no arguments and no piped input
-    if not parsed_args.args:
-        parser.print_help()
-        sys.exit(1)
-
-    # 3. Check if the user used the "run" command
-    if parsed_args.args[0] == "run" and len(parsed_args.args) > 1:
-        script_name = parsed_args.args[1]
-        run_script(script_name, as_json=parsed_args.as_json)
-
-    # 4. Fallback: Treat the input as a raw error string
-    else:
-        error_input = " ".join(parsed_args.args)
-        emit(translate_error(error_input))
-
-if __name__ == "__main__":
-    main()