codemap-python 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

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)

analysis/core/ast_parser.py

@@ -1,8 +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)
 

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 = []
 

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:

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:

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.dist-info → codemap_python-0.1.3.dist-info}/METADATA

@@ -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.dist-info → codemap_python-0.1.3.dist-info}/RECORD

@@ -7,7 +7,7 @@ analysis/architecture/architecture_engine.py,sha256=8aWqfvdGHP9gIf03VdLrkn1vF670
 analysis/architecture/dependency_cycles.py,sha256=fu1kQY1N4jmAdCdh2V2g9e8aZRoC17WtGEy6rPStDbI,3342
 analysis/architecture/risk_radar.py,sha256=3nCxjH96cicb_UQ67T4Hk63cIWWgG5syQhlaoFsoWEA,8681
 analysis/call_graph/__init__.py,sha256=w0foWNOGbFJTxtZUs08tnR3MM5mRTfA0xz6DtGRNGOk,22
-analysis/call_graph/call_extractor.py,sha256=ePYwybRNn5U6dZ21wiovtnVzCskaohNMINvaM_zOEaU,2673
+analysis/call_graph/call_extractor.py,sha256=SZEFMYh0GtqyLiXNOZyGH8xd0Nr7kGbwXky_m0amIes,2813
 analysis/call_graph/call_graph_builder.py,sha256=h3D2SzvNmyPtVEBvwGTHM2LVsUwxq9MBLEMhkMi8gGc,29
 analysis/call_graph/call_resolver.py,sha256=gdSAy_042xxXby65FfSIMGBYI3yU4-jT-zMvpajHdF8,1600
 analysis/call_graph/context_models.py,sha256=pYCvdJOEdR35p-BO42BtXoJIFdieF6CEp-f_rSFbd0Q,29
@@ -17,13 +17,13 @@ analysis/call_graph/flow_builder.py,sha256=B029swJPLTaB6MazmHfK-XS9rLpg7HSTwiEj1
 analysis/call_graph/models.py,sha256=bj3YVEVIKhSNrYdczUewhckocjYp9qrdQzV65ICPJvQ,23
 analysis/core/__init__.py,sha256=Sl3CBLE_4V96jffhhcEY6C_-grRWDCQyoB-LVtNnP_A,39
 analysis/core/ast_context.py,sha256=kQZB3jM4Mnqy8VtnlT5Towdo5Rfg6sr2hF-eVxjQY6Q,29
-analysis/core/ast_parser.py,sha256=JKmnMu9jmTj3gktRXamzPp94OjAlPCLCkQ20Xfa9IOE,184
+analysis/core/ast_parser.py,sha256=Rq7wxM_3U2lR3t6ewDfCRnfAX5BrciWOvwbrjH0bRWg,834
 analysis/core/class_extractor.py,sha256=YJctW3TigWa7gra02qgZJXoVboDDTikkIyPzEDfNiI8,1039
 analysis/core/function_extractor.py,sha256=5y0teAJ8vzGTZ8Te80m9i0ihP8g2jgR2FEcddxIvhwc,436
-analysis/core/import_extractor.py,sha256=hefburHlOhvfHneADTk7Nxi1pAlp29KH7EirLhOjPK0,1262
+analysis/core/import_extractor.py,sha256=WnrljYmpVxbQky2j48pXBXXGnw4GMwZIhgQ8SZpYg4M,1464
 analysis/explain/__init__.py,sha256=2FsKrvLP_OgFFTuoFToaXRs6lM3lmz6lpEqjy5Agko8,55
 analysis/explain/docstring_extractor.py,sha256=9AO1ITf48KMg5ezZm_GYJzTlFi8sOBYih3uXlyectWM,1449
-analysis/explain/explain_runner.py,sha256=bgB7PFUidR_aRBr8TdWr3KWNMWsy5o1H_-0IzNQli7M,5587
+analysis/explain/explain_runner.py,sha256=onnN00D9Nb2oFS3m0q0OFMFlQuFZW64KjJpQ8hpShTE,5787
 analysis/explain/repo_summary_generator.py,sha256=eCNve4-eHG0d2XLJttFA-Bh5suZIvKack_jBRaMHrHc,6474
 analysis/explain/return_analyzer.py,sha256=KjHj7SHWTUMQAzLUi0A8BL5cv5tCxr5XeAw2VG-uyYg,3100
 analysis/explain/risk_flags.py,sha256=QNV101q4PMMIJ_LKv80EwX6uaAysiZC-aGyYTSbwPb8,39
@@ -37,22 +37,23 @@ analysis/indexing/__init__.py,sha256=eiE_smnnd-0xjpMBKDQilIypx5oiLA9N_40xBxDQSe4
 analysis/indexing/import_resolver.py,sha256=ZkTyx3RdzrEwdHMVax0uM5D4AjJNEo1FoXAD1rsx5QY,4697
 analysis/indexing/symbol_index.py,sha256=RoBsehau9u0tYB8hUEvN5K4dINgtiGH07qV0vznKAhA,5491
 analysis/runners/__init__.py,sha256=4caStudxQFG1nCXBGpoyV7DvxN5ySfwVm4ENQc46w6s,21
-analysis/runners/phase4_runner.py,sha256=HASv0IsVye7TdxwZ2TQfVjShJ8Q4b533IZ8Hd1CVTWU,4875
+analysis/runners/phase4_runner.py,sha256=RUu-LlBGbfeZBi6oduISzHJo_5hlDVunhjVwMbOsTvs,5075
 analysis/utils/__init__.py,sha256=sJCGmNWVjSiFK21dDvTzQFMUPyQYNP3b4-Lj42DNA-s,17
 analysis/utils/ast_helpers.py,sha256=qMny-x6kvMt7F1b9Q8HtR2o0nen6bR-MyQsClBzLNpI,20
+analysis/utils/bom_handler.py,sha256=fh1xYQ5P9Y7YCtur4coPx59hL5OUL-43ZQG5AZgidIM,1768
 analysis/utils/cache_manager.py,sha256=FUuZOO_CSHP_A2cFO4Kk8WQc34AYfqTol2w6n7DmTBE,24579
 analysis/utils/path_resolver.py,sha256=NprapbBX8E1c_5jp2R1OLIYMeqrFeNfaxnmIlwqs9hI,27
 analysis/utils/repo_fetcher.py,sha256=bCUBG0qUypcXXgQPAAdJAaRoQSc75Nd53B7HD72Euno,15105
 ui/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-ui/app.py,sha256=BDjfHMRzBWBwFuRrMYen-KKFfeotn7RdXHG20gu5_4c,81661
+ui/app.py,sha256=BUUM55EpHSPYKwog7tcbHI4gVfnQllnAbf6abO05p7g,81986
 ui/device_id.py,sha256=gAan8gMnSY_lDpDSllafK27CSskFT-_OdFw2m8y2QUA,708
 ui/static/app.js,sha256=Nmfgs6pqMkS6Q44CtSBpEV9uW_xks2mS8BIxW7WqAXg,115957
 ui/static/styles.css,sha256=B_QkNK8zziUDl-m8HzcpyO1FFujYf-DdO05Ly7JZbB8,23639
 ui/templates/index.html,sha256=x8isBJyxzt8UdkLJK4NDqBlEjn_FbXdFc1O_llti-R0,11945
 ui/utils/__init__.py,sha256=8Bo3TpyB49uJs6QpQMTWpUR2hJhqEpbkK_E_GW7tYpU,5
 ui/utils/registry_manager.py,sha256=jEhWMQJ3H1ZtyUP2ObneqFOVDTdDqiBvUh-46-rGFDw,6730
-codemap_python-0.1.1.dist-info/METADATA,sha256=gd2H56fRIsVq-dtcHVFkHMVyU-Ws7dWGlTGgULwMcCE,10382
-codemap_python-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-codemap_python-0.1.1.dist-info/entry_points.txt,sha256=71TCgwo56CPxSfh-YSmofpNwq4-kSsjmBL_qzJ5kfmk,45
-codemap_python-0.1.1.dist-info/top_level.txt,sha256=JOu1LG-DyeBXc4u2Cn7KznNz-bZExhsf1CB7fV4r-t8,43
-codemap_python-0.1.1.dist-info/RECORD,,
+codemap_python-0.1.3.dist-info/METADATA,sha256=P-5de7a2Ja2t8s_ZNwbgad7Fy6JjbslJ9t9FHwp-M7M,10382
+codemap_python-0.1.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codemap_python-0.1.3.dist-info/entry_points.txt,sha256=71TCgwo56CPxSfh-YSmofpNwq4-kSsjmBL_qzJ5kfmk,45
+codemap_python-0.1.3.dist-info/top_level.txt,sha256=JOu1LG-DyeBXc4u2Cn7KznNz-bZExhsf1CB7fV4r-t8,43
+codemap_python-0.1.3.dist-info/RECORD,,

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__))