error-translator-cli-v2 0.1.0__py3-none-any.whl

error_translator/cli.py

@@ -0,0 +1,61 @@
+import sys
+import argparse
+
+from cv2 import line
+from .core import translate_error
+
+# ANSI Color Codes for terminal formatting
+class Colors:
+    RED = '\033[91m'
+    GREEN = '\033[92m'
+    YELLOW = '\033[93m'
+    CYAN = '\033[96m'
+    BOLD = '\033[1m'
+    RESET = '\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')}\n")
+    
+    # If file and line info is available, print it
+    if "file" in result:
+        print(f"{Colors.YELLOW}📍 Location: {result['file']} (Line {result['line']}){Colors.RESET}\n")
+    else:
+        print() # Just a newline
+
+    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")
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Translate Python error messages into simple English."
+    )
+    
+    parser.add_argument(
+        "error_text", 
+        nargs="?", 
+        help="The error message or traceback string to translate."
+    )
+
+    args = parser.parse_args()
+
+    # Read from positional argument OR standard input (piping)
+    error_input = args.error_text
+
+    if not error_input and not sys.stdin.isatty():
+        # Allows usage like: cat error.log | explain-error
+        error_input = sys.stdin.read()
+
+    if not error_input:
+        parser.print_help()
+        sys.exit(1)
+
+    result = translate_error(error_input)
+    print_result(result)
+
+if __name__ == "__main__":
+    main()

error_translator/core.py

@@ -0,0 +1,46 @@
+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.
+    """
+    location_match = re.search(r'File "(.*?)", line (\d+), in (.+)', 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"
+    in_function = location_match.group(3) if location_match else "unknown function"
+    # Grab the last non-empty line of the traceback, which usually contains the actual error
+    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,
+                "function": in_function
+            }
+
+    # 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,
+        "function": in_function
+    }

error_translator/rules.py

@@ -0,0 +1,50 @@
+import re
+
+# We compile the regex patterns upfront for performance.
+ERROR_RULES = [
+    {
+        "pattern": re.compile(r"NameError: name '(.*)' is not defined"),
+        "explanation": "You tried to use a variable or function named '{0}', but Python doesn't recognize it.",
+        "fix": "Check if '{0}' is spelled correctly, or ensure you defined/imported it before using it."
+    },
+    {
+        "pattern": re.compile(r"TypeError: can only concatenate str \(not \"(.*)\"\) to str"),
+        "explanation": "You are trying to add a string to a {0}, which Python cannot do.",
+        "fix": "Convert the {0} to a string first using str() before concatenating."
+    },
+    {
+        "pattern": re.compile(r"TypeError: unsupported operand type\(s\) for \+: '(.*)' and '(.*)'"),
+        "explanation": "You are trying to add two incompatible types: a {0} and a {1}.",
+        "fix": "Ensure both sides of the '+' are the same type (e.g., both numbers or both strings)."
+    },
+    {
+        "pattern": re.compile(r"IndexError: list index out of range"),
+        "explanation": "You are trying to access an item in a list at a position that doesn't exist.",
+        "fix": "Check the length of your list using len(). Remember, Python lists start counting at 0!"
+    },
+    {
+        "pattern": re.compile(r"KeyError: '(.*)'"),
+        "explanation": "You tried to look up a key named '{0}' in a dictionary, but that key doesn't exist.",
+        "fix": "Check for typos in the key name, or use the .get('{0}') method to safely access dictionary values."
+    },
+    {
+        "pattern": re.compile(r"ZeroDivisionError: division by zero"),
+        "explanation": "You are trying to divide a number by zero, which is mathematically impossible.",
+        "fix": "Add an if-statement before the division to check if the denominator is 0."
+    },
+    {
+        "pattern": re.compile(r"ModuleNotFoundError: No module named '(.*)'"),
+        "explanation": "Python is trying to import a package named '{0}', but it isn't installed in your current environment.",
+        "fix": "Open your terminal and run: pip install {0}"
+    },
+    {
+        "pattern": re.compile(r"AttributeError: '(.*)' object has no attribute '(.*)'"),
+        "explanation": "You are trying to use a method or property named '{1}' on a {0} object, but {0}s don't have that capability.",
+        "fix": "Check the spelling of '{1}'. If it's correct, verify that your variable is actually the data type you think it is."
+    },
+]
+
+DEFAULT_ERROR = {
+    "explanation": "This is an unknown error. The tool couldn't find a specific match.",
+    "fix": "Try copying the last line of the error into a search engine or StackOverflow."
+}

error_translator_cli_v2-0.1.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: error-translator-cli-v2
+Version: 0.1.0
+Summary: A CLI tool that explains Python errors in simple human language.
+Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown

error_translator_cli_v2-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+error_translator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+error_translator/cli.py,sha256=NCDRY7r0z3s5u_WehNKH5Zm-w9KkNzrn9lQYzDobYaQ,1758
+error_translator/core.py,sha256=Yg33BfhLtVJjliU1liNttHkAIp4U70yrl7RLoGiZK6Q,1925
+error_translator/rules.py,sha256=4gld0hU6O2-DbUknxf4sAT0HLHlQng98obWrWhYf6OE,2740
+error_translator_cli_v2-0.1.0.dist-info/METADATA,sha256=QfC2hUWoPqoncPfxLDYv9S_mdPST5aC3Y5KWrH9Oa7M,277
+error_translator_cli_v2-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+error_translator_cli_v2-0.1.0.dist-info/entry_points.txt,sha256=dK43I4DoOOLLke-7ggnw9jn2SJXemb7qaJdjRlXqrb4,60
+error_translator_cli_v2-0.1.0.dist-info/top_level.txt,sha256=9owZrOU3Ww-JNl8TK3IRF_jDtTvQ6FnaWzgQOeIMv-I,17
+error_translator_cli_v2-0.1.0.dist-info/RECORD,,

error_translator_cli_v2-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

error_translator_cli_v2-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+explain-error = error_translator.cli:main

error_translator_cli_v2-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+error_translator