error-translator-cli-v2 0.1.3__tar.gz → 1.0.1__tar.gz

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: error-translator-cli-v2
-Version: 0.1.3
+Version: 1.0.1
 Summary: A CLI tool that explains Python errors in simple human language.
 Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
 Requires-Python: >=3.7
@@ -32,19 +32,37 @@ pip install error-translator-cli-v2
 
 🚀 Usage
 
-Simply pass your Python error message or traceback as a string to the explain-error command.
+You can use the Error Translator in three different ways:
 
-Example 1: NameError with Full Traceback
+### 1. Magic Import (Recommended)
+Simply add this single import at the top of your Python script. If your script crashes, it will automatically intercept and translate the error!
 
-explain-error "Traceback (most recent call last):
-  File 'script.py', line 2, in <module>
-    print(my_variable)
-NameError: name 'my_variable' is not defined"
+```python
+import error_translator.auto
 
+# Your normal code...
+math_is_broken = 10 / 0  # This crash will be automatically translated!
+```
 
-Example 2: Quick TypeError
+### 2. Run Scripts via CLI
+You can execute your python files directly through the CLI tool. It will run your program normally and intercept any crashes.
 
+```bash
+explain-error run script.py
+```
+
+### 3. Translate Raw Error Strings
+You can pass errors as a string or pipe them from another command.
+
+**Pass directly:**
+```bash
 explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+**Pipe from a file:**
+```bash
+cat error.log | explain-error
+```
 
 
 🧠 Supported Errors

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/README.md

@@ -24,19 +24,37 @@ pip install error-translator-cli-v2
 
 🚀 Usage
 
-Simply pass your Python error message or traceback as a string to the explain-error command.
+You can use the Error Translator in three different ways:
 
-Example 1: NameError with Full Traceback
+### 1. Magic Import (Recommended)
+Simply add this single import at the top of your Python script. If your script crashes, it will automatically intercept and translate the error!
 
-explain-error "Traceback (most recent call last):
-  File 'script.py', line 2, in <module>
-    print(my_variable)
-NameError: name 'my_variable' is not defined"
+```python
+import error_translator.auto
 
+# Your normal code...
+math_is_broken = 10 / 0  # This crash will be automatically translated!
+```
 
-Example 2: Quick TypeError
+### 2. Run Scripts via CLI
+You can execute your python files directly through the CLI tool. It will run your program normally and intercept any crashes.
 
+```bash
+explain-error run script.py
+```
+
+### 3. Translate Raw Error Strings
+You can pass errors as a string or pipe them from another command.
+
+**Pass directly:**
+```bash
 explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+**Pipe from a file:**
+```bash
+cat error.log | explain-error
+```
 
 
 🧠 Supported Errors

error_translator_cli_v2-1.0.1/error_translator/auto.py

@@ -0,0 +1,22 @@
+import sys
+import traceback
+from .core import translate_error
+from .cli import print_result
+
+def magic_hook(exc_type, exc_value, tb):
+    """
+    This function intercepts a Python crash right before it prints 
+    to the terminal, formats the error, and translates it.
+    """
+    # 1. Convert the raw crash data into a standard traceback string
+    tb_lines = traceback.format_exception(exc_type, exc_value, tb)
+    tb_string = "".join(tb_lines)
+    
+    # 2. Pass it through our translation engine
+    result = translate_error(tb_string)
+    
+    # 3. Print our beautiful colorized output instead of the ugly default
+    print_result(result)
+
+# The Magic Trick: Replace Python's default crash handler with ours
+sys.excepthook = magic_hook

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/error_translator/cli.py

@@ -1,6 +1,5 @@
 import sys
 import argparse
-import subprocess
 from .core import translate_error
 
 # ANSI Color Codes
@@ -14,22 +13,30 @@ class Colors:
 
 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"\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")
+        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"{Colors.CYAN}{Colors.BOLD} Explanation:{Colors.RESET}")
     print(f"{result['explanation']}\n")
     
-    print(f"{Colors.GREEN}{Colors.BOLD}🛠️  Suggested Fix:{Colors.RESET}")
+    print(f"{Colors.GREEN}{Colors.BOLD} Suggested Fix:{Colors.RESET}")
     print(f"{result['fix']}\n")
 
 def run_script(script_name: str):
     """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(

error_translator_cli_v2-1.0.1/error_translator/core.py

@@ -0,0 +1,66 @@
+import json
+import os
+
+def load_rules():
+    """Loads the error rules from the JSON file."""
+    # Find the absolute path to the json file next to this script
+    # current_dir = os.path.dirname(data\rules.json)
+    current_dir = 'data/'
+    json_path = os.path.join(current_dir, 'rules.json')
+    
+    with open(json_path, 'r') as file:
+        return json.load(file)
+
+def translate_error(traceback_text: str) -> dict:
+    import re
+    import linecache  # <-- NEW: Lazy import the linecache module
+    
+    data = load_rules()
+    rules = data["rules"]
+    default_error = data["default"]
+
+    lines = [line.strip() for line in traceback_text.strip().split('\n') if line.strip()]
+    if not lines:
+        return {"explanation": "No error text provided.", "fix": "Provide a valid Python error."}
+    
+    actual_error_line = lines[-1]
+
+    location_match = re.search(r'File\s+[\'"]?(.*?)[\'"]?,\s+line\s+(\d+)', traceback_text)
+    file_name = location_match.group(1) if location_match else "Unknown File"
+    line_number = location_match.group(2) if location_match else "Unknown Line"
+
+    # --- NEW CONTEXT ENGINE LOGIC ---
+    code_context = ""
+    if file_name != "Unknown File" and line_number != "Unknown Line":
+        try:
+            # linecache safely fetches the exact line of code as a string
+            raw_line = linecache.getline(file_name, int(line_number))
+            if raw_line:
+                code_context = raw_line.strip() # Remove extra spaces/newlines
+        except Exception:
+            pass # If the file can't be read for any reason, fail silently
+    # --------------------------------
+
+    for rule in rules:
+        pattern = re.compile(rule["pattern"])
+        match = pattern.search(actual_error_line)
+        
+        if match:
+            extracted_values = match.groups()
+            return {
+                "explanation": rule["explanation"].format(*extracted_values),
+                "fix": rule["fix"].format(*extracted_values),
+                "matched_error": actual_error_line,
+                "file": file_name,
+                "line": line_number,
+                "code": code_context 
+            }
+
+    return {
+        "explanation": default_error["explanation"],
+        "fix": default_error["fix"],
+        "matched_error": actual_error_line,
+        "file": file_name,
+        "line": line_number,
+        "code": code_context      
+    }

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/error_translator_cli_v2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: error-translator-cli-v2
-Version: 0.1.3
+Version: 1.0.1
 Summary: A CLI tool that explains Python errors in simple human language.
 Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
 Requires-Python: >=3.7
@@ -32,19 +32,37 @@ pip install error-translator-cli-v2
 
 🚀 Usage
 
-Simply pass your Python error message or traceback as a string to the explain-error command.
+You can use the Error Translator in three different ways:
 
-Example 1: NameError with Full Traceback
+### 1. Magic Import (Recommended)
+Simply add this single import at the top of your Python script. If your script crashes, it will automatically intercept and translate the error!
 
-explain-error "Traceback (most recent call last):
-  File 'script.py', line 2, in <module>
-    print(my_variable)
-NameError: name 'my_variable' is not defined"
+```python
+import error_translator.auto
 
+# Your normal code...
+math_is_broken = 10 / 0  # This crash will be automatically translated!
+```
 
-Example 2: Quick TypeError
+### 2. Run Scripts via CLI
+You can execute your python files directly through the CLI tool. It will run your program normally and intercept any crashes.
 
+```bash
+explain-error run script.py
+```
+
+### 3. Translate Raw Error Strings
+You can pass errors as a string or pipe them from another command.
+
+**Pass directly:**
+```bash
 explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+**Pipe from a file:**
+```bash
+cat error.log | explain-error
+```
 
 
 🧠 Supported Errors

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/error_translator_cli_v2.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 README.md
 pyproject.toml
 error_translator/__init__.py
+error_translator/auto.py
 error_translator/cli.py
 error_translator/core.py
 error_translator/rules.py

{error_translator_cli_v2-0.1.3 → error_translator_cli_v2-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "error-translator-cli-v2"
-version = "0.1.3"
+version = "1.0.1"
 description = "A CLI tool that explains Python errors in simple human language."
 readme = "README.md"
 requires-python = ">=3.7"

error_translator_cli_v2-0.1.3/error_translator/core.py

@@ -1,45 +0,0 @@
-from .rules import ERROR_RULES, DEFAULT_ERROR
-import re
-
-def translate_error(traceback_text: str) -> dict:
-    """
-    Parses traceback text and returns a human-readable explanation and fix.
-    """
-# Update this line inside your translate_error function:
-    location_match = re.search(r'File\s+[\'"]?(.*?)[\'"]?,\s+line\s+(\d+)', traceback_text)    
-    file_name = location_match.group(1) if location_match else "unknown file"
-    line_number = location_match.group(2) if location_match else "unknown line"
-    # Grab the last non-empty line of the traceback, which usually contains the actual error
-    # print(f"\n--- DEBUG RAW INPUT ---\n{repr(traceback_text)}\n-----------------------\n")
-    lines = [line.strip() for line in traceback_text.strip().split('\n') if line.strip()]
-    if not lines:
-        return {"explanation": "No error text provided.", "fix": "Provide a valid Python error."}
-    
-    actual_error_line = lines[-1]
-
-    for rule in ERROR_RULES:
-        match = rule["pattern"].search(actual_error_line)
-        if match:
-            # Extract the captured regex groups (e.g., the variable name)
-            extracted_values = match.groups()
-            
-            # Format the explanation and fix using the extracted values
-            explanation = rule["explanation"].format(*extracted_values)
-            fix = rule["fix"].format(*extracted_values)
-            
-            return {
-                "explanation": explanation,
-                "fix": fix,
-                "matched_error": actual_error_line,
-                "file": file_name,
-                "line": line_number,
-            }
-
-    # If no rules match, return the default payload
-    return {
-        "explanation": DEFAULT_ERROR["explanation"],
-        "fix": DEFAULT_ERROR["fix"],
-        "matched_error": actual_error_line,
-        "file": file_name,
-        "line": line_number,
-    }