codemap-python 0.1.1__tar.gz → 0.1.3__tar.gz

{codemap_python-0.1.1 → codemap_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codemap-python
-Version: 0.1.1
+Version: 0.1.3
 Summary: Local Python code analysis tool - understand architecture, dependencies, and call graphs
 Author-email: ADITYA <aditykushwaha69@gmail.com>
 License: MIT

{codemap_python-0.1.1 → codemap_python-0.1.3}/analysis/call_graph/call_extractor.py

@@ -1,6 +1,7 @@
 # AST Call detection
 
 import ast
+from analysis.utils.bom_handler import remove_bom
 
 class FunctionCallVisitor(ast.NodeVisitor):
     def __init__(self, file_path):
@@ -83,7 +84,11 @@ class FunctionCallVisitor(ast.NodeVisitor):
 
 def extract_function_calls(file_path):
     with open(file_path, "r", encoding="utf-8") as f:
-        tree = ast.parse(f.read())
+        source = f.read()
+    
+    # Remove BOM if present
+    source = remove_bom(source)
+    tree = ast.parse(source)
 
     visitor = FunctionCallVisitor(file_path)
     visitor.visit(tree)

codemap_python-0.1.3/analysis/core/ast_parser.py

@@ -0,0 +1,31 @@
+# AST Parser Module
+import ast
+from analysis.utils.bom_handler import remove_bom
+
+
+def parse_python_file(file_path):
+    """Parse a Python file, automatically handling UTF-8 BOM.
+    
+    This function:
+    1. Reads the file with UTF-8 encoding
+    2. Removes any BOM characters automatically
+    3. Parses the cleaned source code
+    
+    Args:
+        file_path: Path to Python file to parse
+        
+    Returns:
+        ast.Module: Parsed AST tree
+        
+    Raises:
+        SyntaxError: If source code has syntax errors
+        FileNotFoundError: If file doesn't exist
+    """
+    with open(file_path, "r", encoding="utf-8") as f:
+        source = f.read()
+
+    # Remove BOM if present (handles files from Windows editors, etc.)
+    source = remove_bom(source)
+    
+    return ast.parse(source)
+

{codemap_python-0.1.1 → codemap_python-0.1.3}/analysis/core/import_extractor.py

@@ -2,11 +2,17 @@
 # analysis/import_extractor.py
 
 import ast
+from analysis.utils.bom_handler import remove_bom
+
 
 def extract_imports(file_path):
+    """Extract imports from a Python file, handling UTF-8 BOM automatically."""
     with open(file_path, "r", encoding="utf-8") as f:
         source = f.read()
 
+    # Remove BOM if present
+    source = remove_bom(source)
+    
     tree = ast.parse(source)
     imports = []
 

{codemap_python-0.1.1 → codemap_python-0.1.3}/analysis/explain/explain_runner.py

@@ -8,6 +8,7 @@ from typing import Optional, Dict, Any
 import ast
 import json
 import os
+from analysis.utils.bom_handler import remove_bom
 
 from analysis.indexing.symbol_index import SymbolIndex, SymbolInfo
 from analysis.graph.callgraph_index import CallGraphIndex, CallSite
@@ -27,8 +28,12 @@ def collect_python_files(root_dir: str):
 
 
 def parse_ast(file_path: str) -> ast.AST:
+    """Parse a Python file, automatically handling UTF-8 BOM."""
     with open(file_path, "r", encoding="utf-8") as f:
-        return ast.parse(f.read())
+        source = f.read()
+    # Remove BOM if present
+    source = remove_bom(source)
+    return ast.parse(source)
 
 
 def file_to_module(file_path: str, repo_root: str) -> str:

{codemap_python-0.1.1 → codemap_python-0.1.3}/analysis/runners/phase4_runner.py

@@ -12,6 +12,7 @@ from analysis.call_graph.cross_file_resolver import CrossFileResolver
 from analysis.call_graph.call_extractor import extract_function_calls
 from analysis.core.import_extractor import extract_imports
 from analysis.graph.callgraph_index import build_caller_fqn
+from analysis.utils.bom_handler import remove_bom
 
 
 PROJECT_ROOT = os.path.dirname(os.path.dirname(__file__))
@@ -29,8 +30,12 @@ def collect_python_files(root_dir: str) -> List[str]:
 
 
 def parse_ast(file_path: str):
+    """Parse a Python file, automatically handling UTF-8 BOM."""
     with open(file_path, "r", encoding="utf-8") as f:
-        return ast.parse(f.read())
+        source = f.read()
+    # Remove BOM if present
+    source = remove_bom(source)
+    return ast.parse(source)
 
 
 def file_to_module(file_path: str, repo_root: str) -> str:

codemap_python-0.1.3/analysis/utils/bom_handler.py

@@ -0,0 +1,55 @@
+"""BOM (Byte Order Mark) handling utilities for CodeMap.
+
+This module provides utilities to handle UTF-8 BOM characters that are
+sometimes added to Python files by certain editors (especially on Windows).
+
+BOM (U+FEFF) is an invisible character that Python's AST parser cannot handle,
+causing: "invalid non-printable character U+FEFF"
+
+Solution: Strip BOM before parsing Python files.
+"""
+
+
+def remove_bom(source: str) -> str:
+    """Remove UTF-8 BOM (Byte Order Mark) from source code if present.
+    
+    BOM is a special character (U+FEFF) that some editors (especially Notepad
+    on Windows) add to the start of files. Python's AST parser doesn't handle it.
+    
+    This function silently removes it if present, or returns the source unchanged.
+    
+    Args:
+        source: Python source code as string
+        
+    Returns:
+        Source code with BOM removed if present
+        
+    Example:
+        >>> source_with_bom = '\\ufeffdef hello(): pass'
+        >>> clean_source = remove_bom(source_with_bom)
+        >>> print(clean_source)
+        def hello(): pass
+    """
+    if source.startswith('\ufeff'):
+        return source[1:]
+    return source
+
+
+def read_source_file(file_path: str) -> str:
+    """Read a Python file and remove BOM if present.
+    
+    This is a convenience function that combines file reading with BOM removal.
+    
+    Args:
+        file_path: Path to Python file to read
+        
+    Returns:
+        Source code with BOM removed
+        
+    Raises:
+        FileNotFoundError: If file doesn't exist
+        UnicodeDecodeError: If file encoding is not UTF-8
+    """
+    with open(file_path, "r", encoding="utf-8") as f:
+        source = f.read()
+    return remove_bom(source)

{codemap_python-0.1.1 → codemap_python-0.1.3}/codemap_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codemap-python
-Version: 0.1.1
+Version: 0.1.3
 Summary: Local Python code analysis tool - understand architecture, dependencies, and call graphs
 Author-email: ADITYA <aditykushwaha69@gmail.com>
 License: MIT

{codemap_python-0.1.1 → codemap_python-0.1.3}/codemap_python.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ analysis/runners/__init__.py
 analysis/runners/phase4_runner.py
 analysis/utils/__init__.py
 analysis/utils/ast_helpers.py
+analysis/utils/bom_handler.py
 analysis/utils/cache_manager.py
 analysis/utils/path_resolver.py
 analysis/utils/repo_fetcher.py

{codemap_python-0.1.1 → codemap_python-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codemap-python"
-version = "0.1.1"
+version = "0.1.3"
 description = "Local Python code analysis tool - understand architecture, dependencies, and call graphs"
 readme = "README.md"
 requires-python = ">=3.10"

{codemap_python-0.1.1 → codemap_python-0.1.3}/ui/app.py

@@ -36,20 +36,24 @@ from security_utils import redact_payload, redact_secrets
 
 
 # Custom cache class that doesn't cache (to avoid TypeError with unhashable Request objects)
-class NoCache:
-    """A cache implementation that doesn't cache anything.
+class NoCache(dict):
+    """A dict-like cache implementation that doesn't actually cache anything.
     
     This prevents Jinja2 from trying to cache templates with unhashable objects
-    like the Starlette Request in the context.
+    like the Starlette Request in the context. Inherits from dict to satisfy
+    Jinja2's duck-typing requirements while not actually storing anything.
     """
-    def get(self, key: Any, default: Any = None) -> Any:
-        return default
-    
-    def set(self, key: Any, value: Any, timeout: Any = None) -> None:
+    def __setitem__(self, key: Any, value: Any) -> None:
+        """Silently ignore all cache assignments."""
         pass
     
-    def clear(self) -> None:
-        pass
+    def __getitem__(self, key: Any) -> Any:
+        """Always return KeyError to indicate cache miss."""
+        raise KeyError(key)
+    
+    def get(self, key: Any, default: Any = None) -> Any:
+        """Always return the default value (cache miss)."""
+        return default
 
 
 PROJECT_ROOT = os.path.dirname(os.path.dirname(__file__))

codemap_python-0.1.1/analysis/core/ast_parser.py

@@ -1,8 +0,0 @@
-# AST Parser Module
-import ast
-def parse_python_file(file_path):
-    with open(file_path, "r", encoding="utf-8") as f:
-        source = f.read()
-
-    return ast.parse(source)
-