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

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: codemap-python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Local Python code analysis tool - understand architecture, dependencies, and call graphs
 Author-email: ADITYA <aditykushwaha69@gmail.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/ADITYA-kus/codemap_ai
 Project-URL: Repository, https://github.com/ADITYA-kus/codemap_ai.git
 Project-URL: Issues, https://github.com/ADITYA-kus/codemap_ai/issues
@@ -11,7 +11,6 @@ Project-URL: Documentation, https://github.com/ADITYA-kus/codemap_ai#readme
 Keywords: code-analysis,python,architecture,call-graph,cli,dashboard,local,privacy
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -159,22 +158,35 @@ codemap open --port 8000
 
 ### Cache Management
 ```bash
-# List all analyzed repositories
+# 📋 List all analyzed repositories and their cache info
 codemap cache list
 
-# Show cache details for a repository
-codemap cache info <repo_hash>
+# 📊 Show detailed cache information for a specific repository
+codemap cache info --path <repo_directory>
 
-# Clear a specific repository's cache
-codemap cache clear <repo_hash>
+# ⏱️ Set cache retention policy (automatically clean old caches)
+codemap cache retention --path <repo_directory> --days 30 --yes
 
-# Show cache retention policy
-codemap cache retention <repo_hash>
+# 🧹 Preview what would be cleaned (safe, no deletion)
+codemap cache sweep --dry-run
 
-# Sweep expired caches (auto-cleanup)
-codemap cache sweep
+# 🧹 Actually clean up expired caches (requires --yes confirmation)
+codemap cache sweep --yes
+
+# 🗑️ Clear cache for a specific repository (preview first)
+codemap cache clear --path <repo_directory> --dry-run
+
+# 🗑️ Actually delete a repository's cache (requires --yes confirmation)
+codemap cache clear --path <repo_directory> --yes
 ```
 
+**Cache Management Tips:**
+- ✅ Always use `--dry-run` first to preview changes
+- ✅ Add `--yes` flag to skip confirmation (useful in scripts)
+- ✅ Default retention is 14 days; adjust with `--days <number>`
+- ✅ Cache is stored in: `~/.codemap_cache/` (varies by OS)
+- ✅ Use `cache list` to see all cached repositories and their sizes
+
 **Get GitHub Token (for private repos):**
 1. Go to https://github.com/settings/tokens
 2. Click "Generate new token" → "Generate new token (classic)"

{codemap_python-0.1.3 → codemap_python-0.1.4}/README.md

@@ -131,22 +131,35 @@ codemap open --port 8000
 
 ### Cache Management
 ```bash
-# List all analyzed repositories
+# 📋 List all analyzed repositories and their cache info
 codemap cache list
 
-# Show cache details for a repository
-codemap cache info <repo_hash>
+# 📊 Show detailed cache information for a specific repository
+codemap cache info --path <repo_directory>
 
-# Clear a specific repository's cache
-codemap cache clear <repo_hash>
+# ⏱️ Set cache retention policy (automatically clean old caches)
+codemap cache retention --path <repo_directory> --days 30 --yes
 
-# Show cache retention policy
-codemap cache retention <repo_hash>
+# 🧹 Preview what would be cleaned (safe, no deletion)
+codemap cache sweep --dry-run
 
-# Sweep expired caches (auto-cleanup)
-codemap cache sweep
+# 🧹 Actually clean up expired caches (requires --yes confirmation)
+codemap cache sweep --yes
+
+# 🗑️ Clear cache for a specific repository (preview first)
+codemap cache clear --path <repo_directory> --dry-run
+
+# 🗑️ Actually delete a repository's cache (requires --yes confirmation)
+codemap cache clear --path <repo_directory> --yes
 ```
 
+**Cache Management Tips:**
+- ✅ Always use `--dry-run` first to preview changes
+- ✅ Add `--yes` flag to skip confirmation (useful in scripts)
+- ✅ Default retention is 14 days; adjust with `--days <number>`
+- ✅ Cache is stored in: `~/.codemap_cache/` (varies by OS)
+- ✅ Use `cache list` to see all cached repositories and their sizes
+
 **Get GitHub Token (for private repos):**
 1. Go to https://github.com/settings/tokens
 2. Click "Generate new token" → "Generate new token (classic)"

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

@@ -1,7 +1,7 @@
-# AST Call detection
-
-import ast
-from analysis.utils.bom_handler import remove_bom
+# AST Call detection
+
+import ast
+from analysis.utils.bom_handler import read_source_file, parse_source_to_ast
 
 class FunctionCallVisitor(ast.NodeVisitor):
     def __init__(self, file_path):
@@ -82,13 +82,9 @@ class FunctionCallVisitor(ast.NodeVisitor):
         return None
 
 
-def extract_function_calls(file_path):
-    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)
+def extract_function_calls(file_path):
+    source = read_source_file(file_path)
+    tree = parse_source_to_ast(source, file_path=file_path)
 
     visitor = FunctionCallVisitor(file_path)
     visitor.visit(tree)

{codemap_python-0.1.3 → codemap_python-0.1.4}/analysis/core/ast_parser.py

@@ -1,13 +1,12 @@
-# AST Parser Module
-import ast
-from analysis.utils.bom_handler import remove_bom
+# AST Parser Module
+from analysis.utils.bom_handler import read_and_parse_python_file
 
 
-def parse_python_file(file_path):
-    """Parse a Python file, automatically handling UTF-8 BOM.
+def parse_python_file(file_path):
+    """Parse a Python file with automatic encoding and BOM handling.
     
     This function:
-    1. Reads the file with UTF-8 encoding
+    1. Reads the file with automatic encoding detection (UTF-8 → Latin-1)
     2. Removes any BOM characters automatically
     3. Parses the cleaned source code
     
@@ -20,12 +19,7 @@ def parse_python_file(file_path):
     Raises:
         SyntaxError: If source code has syntax errors
         FileNotFoundError: If file doesn't exist
+        ValueError: If file encoding cannot be determined
     """
-    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)
+    return read_and_parse_python_file(file_path)
 

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

@@ -1,19 +1,15 @@
 # Import Extractor Module
 # analysis/import_extractor.py
 
-import ast
-from analysis.utils.bom_handler import remove_bom
+import ast
+from analysis.utils.bom_handler import read_source_file, parse_source_to_ast
 
 
-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)
+def extract_imports(file_path):
+    """Extract imports from a Python file with automatic encoding and BOM handling."""
+    source = read_source_file(file_path)
+    tree = parse_source_to_ast(source, file_path=file_path)
     
-    tree = ast.parse(source)
     imports = []
 
     for node in ast.walk(tree):

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

@@ -5,10 +5,8 @@ from __future__ import annotations
 
 from typing import Optional, Dict, Any
 
-import ast
-import json
-import os
-from analysis.utils.bom_handler import remove_bom
+import json
+import os
 
 from analysis.indexing.symbol_index import SymbolIndex, SymbolInfo
 from analysis.graph.callgraph_index import CallGraphIndex, CallSite
@@ -27,13 +25,10 @@ def collect_python_files(root_dir: str):
     return py_files
 
 
-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:
-        source = f.read()
-    # Remove BOM if present
-    source = remove_bom(source)
-    return ast.parse(source)
+def parse_ast(file_path: str):
+    """Parse a Python file with automatic encoding and BOM handling."""
+    from analysis.utils.bom_handler import read_and_parse_python_file
+    return read_and_parse_python_file(file_path)
 
 
 def file_to_module(file_path: str, repo_root: str) -> str:

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

@@ -3,16 +3,14 @@ from __future__ import annotations
 
 from typing import Optional, Dict, Any, List
 
-import os
-import ast
-import json
+import os
+import json
 from analysis.indexing.symbol_index import SymbolIndex
 from analysis.indexing.import_resolver import ImportResolver
 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,13 +27,10 @@ def collect_python_files(root_dir: str) -> List[str]:
     return py_files
 
 
-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:
-        source = f.read()
-    # Remove BOM if present
-    source = remove_bom(source)
-    return ast.parse(source)
+def parse_ast(file_path: str):
+    """Parse a Python file, automatically handling encoding and UTF-8 BOM."""
+    from analysis.utils.bom_handler import read_and_parse_python_file
+    return read_and_parse_python_file(file_path)
 
 
 def file_to_module(file_path: str, repo_root: str) -> str:

codemap_python-0.1.4/analysis/utils/bom_handler.py

@@ -0,0 +1,119 @@
+"""BOM (Byte Order Mark), encoding, and AST parsing utilities for CodeMap.
+
+This module provides utilities to handle:
+1. UTF-8 BOM (Byte Order Mark) characters added by certain editors
+2. Non-UTF-8 encoded files (e.g., Latin-1, Windows-1252)
+
+Issues handled:
+- BOM (U+FEFF): invisible character causing "invalid non-printable character U+FEFF"
+- Non-UTF-8: files with different encodings causing UnicodeDecodeError
+
+Solution: Detect encoding with fallback chain, strip BOM, and parse quietly.
+"""
+
+import ast
+import warnings
+from typing import Tuple
+
+
+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 detect_encoding(file_path: str) -> Tuple[str, bool]:
+    """Detect file encoding by trying multiple decodings.
+    
+    Tries encodings in this order:
+    1. UTF-8 (most common for Python files)
+    2. System default encoding
+    3. Latin-1 / ISO-8859-1 (accepts any byte sequence)
+    
+    Args:
+        file_path: Path to file to detect encoding for
+        
+    Returns:
+        Tuple of (encoding_name: str, is_fallback: bool)
+        is_fallback=True means file uses non-standard encoding
+        
+    Raises:
+        FileNotFoundError: If file doesn't exist
+    """
+    import sys
+    
+    encodings_to_try = [
+        ('utf-8', False),
+        (sys.getdefaultencoding(), False),
+        ('latin-1', True),  # Latin-1 accepts any byte sequence
+    ]
+    
+    for encoding, is_fallback in encodings_to_try:
+        try:
+            with open(file_path, 'rb') as f:
+                f.read().decode(encoding)
+            return (encoding, is_fallback)
+        except (UnicodeDecodeError, LookupError):
+            continue
+    
+    # Should never reach here since Latin-1 accepts all bytes
+    return ('latin-1', True)
+
+
+def read_source_file(file_path: str) -> str:
+    """Read a Python file with automatic encoding detection and BOM removal.
+    
+    Handles files with different encodings gracefully by trying multiple
+    decodings in order of likelihood, then falling back to Latin-1.
+    
+    Args:
+        file_path: Path to Python file to read
+        
+    Returns:
+        Source code with BOM removed
+        
+    Raises:
+        FileNotFoundError: If file doesn't exist
+    """
+    encoding, _is_fallback = detect_encoding(file_path)
+    with open(file_path, 'r', encoding=encoding, errors='replace') as f:
+        source = f.read()
+    return remove_bom(source)
+
+
+def parse_source_to_ast(source: str, file_path: str = "<unknown>") -> ast.AST:
+    """Parse source code while suppressing noisy invalid-escape warnings.
+
+    Some user repositories contain regular string literals like ``"\\S"`` or
+    ``"\\["``. Python can emit ``SyntaxWarning: invalid escape sequence`` while
+    parsing those files even though analysis can continue normally. For CodeMap,
+    these warnings are implementation noise, so we suppress them here.
+    """
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=SyntaxWarning)
+        return ast.parse(source, filename=file_path)
+
+
+def read_and_parse_python_file(file_path: str) -> ast.AST:
+    """Read a Python file with encoding/BOM handling and return its AST."""
+    source = read_source_file(file_path)
+    return parse_source_to_ast(source, file_path=file_path)

codemap_python-0.1.4/analysis/utils/progress_spinner.py

@@ -0,0 +1,85 @@
+"""Simple progress spinner for terminal output."""
+
+import sys
+import time
+from threading import Thread
+from typing import Optional
+
+
+class ProgressSpinner:
+    """A simple terminal progress spinner with rotating animation.
+    
+    Shows a rotating spinner animation while a long-running operation is in progress.
+    Useful for giving users feedback that the program is still working.
+    
+    Example:
+        spinner = ProgressSpinner("Analyzing repository...")
+        spinner.start()
+        time.sleep(5)  # Long operation
+        spinner.stop()
+    """
+    
+    FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+    # Fallback for terminals that don't support Unicode
+    FRAMES_ASCII = ['|', '/', '-', '\\']
+    
+    def __init__(self, message: str = "Processing..."):
+        """Initialize the spinner.
+        
+        Args:
+            message: Text to display next to the spinner
+        """
+        self.message = message
+        self.running = False
+        self.thread: Optional[Thread] = None
+        self.frame_index = 0
+        self._use_unicode = True
+        
+    def _animate(self) -> None:
+        """Animation loop for the spinner."""
+        frames = self.FRAMES if self._use_unicode else self.FRAMES_ASCII
+        
+        while self.running:
+            frame = frames[self.frame_index % len(frames)]
+            # Use \r to return to start of line, overwrite previous output
+            sys.stderr.write(f"\r{frame} {self.message}")
+            sys.stderr.flush()
+            
+            self.frame_index += 1
+            time.sleep(0.1)  # Smooth animation at ~10 FPS
+    
+    def start(self) -> None:
+        """Start the spinner animation."""
+        if not self.running:
+            self.running = True
+            self.frame_index = 0
+            self.thread = Thread(target=self._animate, daemon=True)
+            self.thread.start()
+    
+    def stop(self) -> None:
+        """Stop the spinner and clear the line."""
+        if self.running:
+            self.running = False
+            if self.thread:
+                self.thread.join(timeout=1)
+            # Clear the spinner line
+            sys.stderr.write("\r" + " " * (len(self.message) + 4) + "\r")
+            sys.stderr.flush()
+    
+    def update(self, message: str) -> None:
+        """Update the message displayed with the spinner.
+        
+        Args:
+            message: New message text
+        """
+        self.message = message
+    
+    def __enter__(self):
+        """Context manager entry."""
+        self.start()
+        return self
+    
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """Context manager exit."""
+        self.stop()
+        return False

{codemap_python-0.1.3 → codemap_python-0.1.4}/cli.py

@@ -1112,6 +1112,7 @@ def api_analyze(args) -> int:
     from analysis.architecture.dependency_cycles import compute_dependency_cycle_metrics
     from analysis.architecture.risk_radar import compute_risk_radar
     from analysis.utils.repo_fetcher import fetch_public_repo, fetch_public_repo_zip
+    from analysis.utils.progress_spinner import ProgressSpinner
     from analysis.utils.cache_manager import (
         build_manifest,
         collect_fingerprints,
@@ -1282,6 +1283,10 @@ def api_analyze(args) -> int:
     r2 = {}
     metrics = {}
 
+    # Start progress spinner for large repositories
+    spinner = ProgressSpinner("Analyzing repository...")
+    spinner.start()
+
     try:
         if rebuild_required:
             r1 = run_phase4(
@@ -1399,9 +1404,11 @@ def api_analyze(args) -> int:
         )
         touch_last_accessed(repo_hash)
     except Exception as e:
+        spinner.stop()
         print_json({"ok": False, "error": "ANALYZE_FAILED", "message": redact_secrets(str(e))})
         return 1
 
+    spinner.stop()
     print_json({
         "ok": True,
         "source": source,

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: codemap-python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Local Python code analysis tool - understand architecture, dependencies, and call graphs
 Author-email: ADITYA <aditykushwaha69@gmail.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/ADITYA-kus/codemap_ai
 Project-URL: Repository, https://github.com/ADITYA-kus/codemap_ai.git
 Project-URL: Issues, https://github.com/ADITYA-kus/codemap_ai/issues
@@ -11,7 +11,6 @@ Project-URL: Documentation, https://github.com/ADITYA-kus/codemap_ai#readme
 Keywords: code-analysis,python,architecture,call-graph,cli,dashboard,local,privacy
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -159,22 +158,35 @@ codemap open --port 8000
 
 ### Cache Management
 ```bash
-# List all analyzed repositories
+# 📋 List all analyzed repositories and their cache info
 codemap cache list
 
-# Show cache details for a repository
-codemap cache info <repo_hash>
+# 📊 Show detailed cache information for a specific repository
+codemap cache info --path <repo_directory>
 
-# Clear a specific repository's cache
-codemap cache clear <repo_hash>
+# ⏱️ Set cache retention policy (automatically clean old caches)
+codemap cache retention --path <repo_directory> --days 30 --yes
 
-# Show cache retention policy
-codemap cache retention <repo_hash>
+# 🧹 Preview what would be cleaned (safe, no deletion)
+codemap cache sweep --dry-run
 
-# Sweep expired caches (auto-cleanup)
-codemap cache sweep
+# 🧹 Actually clean up expired caches (requires --yes confirmation)
+codemap cache sweep --yes
+
+# 🗑️ Clear cache for a specific repository (preview first)
+codemap cache clear --path <repo_directory> --dry-run
+
+# 🗑️ Actually delete a repository's cache (requires --yes confirmation)
+codemap cache clear --path <repo_directory> --yes
 ```
 
+**Cache Management Tips:**
+- ✅ Always use `--dry-run` first to preview changes
+- ✅ Add `--yes` flag to skip confirmation (useful in scripts)
+- ✅ Default retention is 14 days; adjust with `--days <number>`
+- ✅ Cache is stored in: `~/.codemap_cache/` (varies by OS)
+- ✅ Use `cache list` to see all cached repositories and their sizes
+
 **Get GitHub Token (for private repos):**
 1. Go to https://github.com/settings/tokens
 2. Click "Generate new token" → "Generate new token (classic)"

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

@@ -45,6 +45,7 @@ analysis/utils/ast_helpers.py
 analysis/utils/bom_handler.py
 analysis/utils/cache_manager.py
 analysis/utils/path_resolver.py
+analysis/utils/progress_spinner.py
 analysis/utils/repo_fetcher.py
 codemap_python.egg-info/PKG-INFO
 codemap_python.egg-info/SOURCES.txt
@@ -54,6 +55,7 @@ codemap_python.egg-info/requires.txt
 codemap_python.egg-info/top_level.txt
 tests/test_cache_cli_commands.py
 tests/test_cache_retention.py
+tests/test_cli_invalid_escape_warnings.py
 tests/test_no_key_persistence.py
 tests/test_registry_session_mode.py
 tests/test_security_cli_integration.py

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

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codemap-python"
-version = "0.1.3"
+version = "0.1.4"
 description = "Local Python code analysis tool - understand architecture, dependencies, and call graphs"
 readme = "README.md"
 requires-python = ">=3.10"
-license = {text = "MIT"}
+license = "MIT"
 authors = [
   {name = "ADITYA", email = "aditykushwaha69@gmail.com"}
 ]
@@ -25,7 +25,6 @@ keywords = [
 classifiers = [
   "Development Status :: 4 - Beta",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",

codemap_python-0.1.4/tests/test_cli_invalid_escape_warnings.py

@@ -0,0 +1,35 @@
+import os
+import shutil
+import subprocess
+import sys
+import unittest
+
+
+PROJECT_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+
+
+class TestCliInvalidEscapeWarnings(unittest.TestCase):
+    def test_analyze_suppresses_invalid_escape_syntax_warnings(self):
+        repo_dir = os.path.join(PROJECT_ROOT, "tests", "_tmp_invalid_escape_repo")
+        shutil.rmtree(repo_dir, ignore_errors=True)
+        try:
+            os.makedirs(repo_dir, exist_ok=True)
+            with open(os.path.join(repo_dir, "warns.py"), "w", encoding="utf-8") as f:
+                f.write(
+                    'PATTERNS = ["\\\\S", "\\\\[", "\\\\:", "\\\\d"]\n'
+                    "def read_patterns():\n"
+                    "    return PATTERNS\n"
+                )
+
+            cmd = [sys.executable, os.path.join(PROJECT_ROOT, "cli.py"), "analyze", "--path", repo_dir]
+            proc = subprocess.run(cmd, cwd=PROJECT_ROOT, capture_output=True, text=True, check=False)
+
+            self.assertEqual(proc.returncode, 0, msg=proc.stderr or proc.stdout)
+            self.assertNotIn("SyntaxWarning", proc.stderr)
+            self.assertNotIn("invalid escape sequence", proc.stderr)
+        finally:
+            shutil.rmtree(repo_dir, ignore_errors=True)
+
+
+if __name__ == "__main__":
+    unittest.main()

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

@@ -893,7 +893,11 @@ def _push_recent(items: List[str], value: str, limit: int = 20) -> List[str]:
 
 @app.get("/", response_class=HTMLResponse)
 def index(request: Request):
-    return templates.TemplateResponse("index.html", {"request": request, "default_repo": DEFAULT_REPO})
+    return templates.TemplateResponse(
+        request=request,
+        name="index.html",
+        context={"request": request, "default_repo": DEFAULT_REPO}
+    )
 
 
 @app.get("/api/workspace")

{codemap_python-0.1.3 → codemap_python-0.1.4}/ui/static/app.js

@@ -98,6 +98,15 @@
   let graphDataCache = new Map();
   let impactDataCache = new Map();
   let architectureCache = null;
+  
+  // Track which tabs have been loaded (for lazy loading optimization)
+  let tabsLoaded = {
+    details: true,    // Details tab loads on symbol selection
+    graph: false,     // Lazy load when clicked
+    impact: false,    // Lazy load when clicked
+    architecture: false  // Lazy load when clicked
+  };
+  
   let repoSummary = null;
   let repoSummaryUpdatedAt = "";
   let repoSummaryStatus = "idle"; // idle|loading|ready|missing|error
@@ -523,26 +532,61 @@
     const isImpact = activeTab === "impact";
     const isGraph = activeTab === "graph";
     const isArchitecture = activeTab === "architecture";
+    
+    // Update tab button states
     if (tabDetailsEl) tabDetailsEl.classList.toggle("active", activeTab === "details");
     if (tabImpactEl) tabImpactEl.classList.toggle("active", isImpact);
     if (tabGraphEl) tabGraphEl.classList.toggle("active", isGraph);
     if (tabArchitectureEl) tabArchitectureEl.classList.toggle("active", isArchitecture);
+    
+    // Show/hide tab content
     if (symbolViewEl) symbolViewEl.classList.toggle("hidden", activeTab !== "details");
     if (impactViewEl) impactViewEl.classList.toggle("hidden", !isImpact);
     if (graphViewEl) graphViewEl.classList.toggle("hidden", !isGraph);
     if (architectureViewEl) architectureViewEl.classList.toggle("hidden", !isArchitecture);
     if (graphControlsEl) graphControlsEl.classList.toggle("hidden", !isGraph);
     if (impactControlsEl) impactControlsEl.classList.toggle("hidden", !isImpact);
-    if (isGraph) {
+    
+    // Lazy loading: Only load data if not already loaded
+    // This prevents repeated API calls and speed up tab switching
+    if (isGraph && !tabsLoaded.graph) {
+      showLoadingIndicator(graphViewEl, "Loading call graph...");
       loadGraph();
-    }
-    if (isImpact) {
+      tabsLoaded.graph = true;
+    } else if (isGraph && tabsLoaded.graph) {
+      // Already loaded, just make sure content is visible
+      if (graphViewEl) graphViewEl.classList.remove("hidden");
+    }
+    
+    if (isImpact && !tabsLoaded.impact) {
+      showLoadingIndicator(impactViewEl, "Loading impact analysis...");
       loadImpact();
+      tabsLoaded.impact = true;
+    } else if (isImpact && tabsLoaded.impact) {
+      if (impactViewEl) impactViewEl.classList.remove("hidden");
     }
-    if (isArchitecture) {
+    
+    if (isArchitecture && !tabsLoaded.architecture) {
+      showLoadingIndicator(architectureViewEl, "Loading architecture insights...");
       loadArchitecture();
+      tabsLoaded.architecture = true;
+    } else if (isArchitecture && tabsLoaded.architecture) {
+      if (architectureViewEl) architectureViewEl.classList.remove("hidden");
     }
   }
+  
+  // Show loading indicator in a view element
+  function showLoadingIndicator(el, message) {
+    if (!el) return;
+    el.classList.remove("muted", "hidden");
+    el.innerHTML = `<div class="card" style="padding: 20px; text-align: center;">
+      <div style="display: inline-block; width: 24px; height: 24px; border: 3px solid #ccc; border-top-color: var(--accent); border-radius: 50%; animation: spin 0.8s linear infinite; margin-right: 10px;"></div>
+      <span>${esc(message)}</span>
+    </div>
+    <style>
+      @keyframes spin { to { transform: rotate(360deg); } }
+    </style>`;
+  }
 
   function shortLabel(fqn) {
     const parts = String(fqn || "").split(".");
@@ -2585,6 +2629,12 @@
     highlightActiveSymbol();
     graphDataCache.clear();
     impactDataCache.clear();
+    
+    // Allow graph and impact tabs to be reloaded for the new symbol
+    // (Keep details: true since we're loading it now)
+    tabsLoaded.graph = false;
+    tabsLoaded.impact = false;
+    
     showSymbolLoading();
     try {
       const symbolPromise = (async () => {
@@ -2716,6 +2766,15 @@
     riskRadarUpdatedAt = "";
     riskRadarStatus = "idle";
     riskRadarError = "";
+    
+    // Reset tab loading state for new repo (enables lazy loading again)
+    tabsLoaded = {
+      details: true,
+      graph: false,
+      impact: false,
+      architecture: false
+    };
+    
     await loadRepoRegistry();
     const okMeta = await loadMeta();
     await loadDataPrivacy();

codemap_python-0.1.3/analysis/utils/bom_handler.py

@@ -1,55 +0,0 @@
-"""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)