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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: error-translator-cli-v2
-Version: 1.0.0
+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-1.0.0 → 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.0 → error_translator_cli_v2-1.0.1}/error_translator/cli.py

@@ -18,6 +18,13 @@ def print_result(result: dict):
     
     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()
     

{error_translator_cli_v2-1.0.0 → error_translator_cli_v2-1.0.1}/error_translator/core.py

@@ -12,7 +12,8 @@ def load_rules():
         return json.load(file)
 
 def translate_error(traceback_text: str) -> dict:
-    import re # Lazy import
+    import re
+    import linecache  # <-- NEW: Lazy import the linecache module
     
     data = load_rules()
     rules = data["rules"]
@@ -24,13 +25,23 @@ def translate_error(traceback_text: str) -> dict:
     
     actual_error_line = lines[-1]
 
-    # Flexible regex to catch single or double quotes, and handle missing ones
     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:
-        # Compile the regex pattern on the fly
         pattern = re.compile(rule["pattern"])
         match = pattern.search(actual_error_line)
         
@@ -41,7 +52,8 @@ def translate_error(traceback_text: str) -> dict:
                 "fix": rule["fix"].format(*extracted_values),
                 "matched_error": actual_error_line,
                 "file": file_name,
-                "line": line_number
+                "line": line_number,
+                "code": code_context 
             }
 
     return {
@@ -49,5 +61,6 @@ def translate_error(traceback_text: str) -> dict:
         "fix": default_error["fix"],
         "matched_error": actual_error_line,
         "file": file_name,
-        "line": line_number
+        "line": line_number,
+        "code": code_context      
     }

{error_translator_cli_v2-1.0.0 → 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: 1.0.0
+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-1.0.0 → 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 = "1.0.0"
+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-1.0.0 → error_translator_cli_v2-1.0.1}/tests/test_core.py

@@ -1,4 +1,4 @@
-import error_translator.auto
+from error_translator.core import translate_error
 
 def test_name_error_translation_double_quotes():
     """Test standard traceback with double quotes around the filename."""