tree-sitter-analyzer 1.8.3__py3-none-any.whl → 1.9.0__py3-none-any.whl

tree_sitter_analyzer/utils/tree_sitter_compat.py

@@ -7,7 +7,7 @@ Supports tree-sitter 0.20+ with query.matches() method only.
 """
 
 import logging
-from typing import Any, List, Tuple, Optional
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -15,82 +15,82 @@ logger = logging.getLogger(__name__)
 class TreeSitterQueryCompat:
     """
     Tree-sitter query execution wrapper for modern API.
-    
+
     Uses only the modern tree-sitter API (query.matches()).
     """
-    
+
     @staticmethod
     def execute_query(
-        language: Any,
-        query_string: str,
-        root_node: Any
-    ) -> List[Tuple[Any, str]]:
+        language: Any, query_string: str, root_node: Any
+    ) -> list[tuple[Any, str]]:
         """
         Execute a tree-sitter query using the modern API.
-        
+
         Args:
             language: Tree-sitter language object
             query_string: Query string to execute
             root_node: Root node to query against
-            
+
         Returns:
             List of (node, capture_name) tuples
-            
+
         Raises:
             Exception: If query execution fails
         """
         try:
             import tree_sitter
+
             query = tree_sitter.Query(language, query_string)
-            
+
             # Try newest API first (tree-sitter 0.25+) with QueryCursor
-            if hasattr(tree_sitter, 'QueryCursor'):
+            if hasattr(tree_sitter, "QueryCursor"):
                 logger.debug("Using newest tree-sitter API (QueryCursor)")
                 return TreeSitterQueryCompat._execute_newest_api(query, root_node)
             # Try modern API (tree-sitter 0.20+)
-            elif hasattr(query, 'matches'):
+            elif hasattr(query, "matches"):
                 logger.debug("Using modern tree-sitter API (matches)")
                 return TreeSitterQueryCompat._execute_modern_api(query, root_node)
             # Fall back to legacy API (tree-sitter < 0.20)
-            elif hasattr(query, 'captures'):
+            elif hasattr(query, "captures"):
                 logger.debug("Using legacy tree-sitter API (captures)")
                 return TreeSitterQueryCompat._execute_legacy_api(query, root_node)
             # Try very old API with different method signature
             else:
                 logger.debug("Using very old tree-sitter API (direct query)")
                 return TreeSitterQueryCompat._execute_old_api(query, root_node)
-                
+
         except Exception as e:
             logger.error(f"Tree-sitter query execution failed: {e}")
             # Return empty result instead of raising to prevent complete failure
             logger.debug("Returning empty result due to query execution failure")
             return []
-    
+
     @staticmethod
-    def _execute_newest_api(query: Any, root_node: Any) -> List[Tuple[Any, str]]:
+    def _execute_newest_api(query: Any, root_node: Any) -> list[tuple[Any, str]]:
         """Execute query using newest API (tree-sitter 0.25+) with QueryCursor"""
         captures = []
         try:
             import tree_sitter
+
             cursor = tree_sitter.QueryCursor(query)
-            
+
             # Execute query and get matches
             matches = cursor.matches(root_node)
             # matches is a list of tuples: (pattern_index, captures_dict)
-            for pattern_index, captures_dict in matches:
+            for _pattern_index, captures_dict in matches:
                 # captures_dict is {capture_name: [node1, node2, ...]}
                 for capture_name, nodes in captures_dict.items():
                     for node in nodes:
                         captures.append((node, capture_name))
-                    
+
         except Exception as e:
             logger.error(f"Newest API execution failed: {e}")
             # Don't raise, just return empty result
-            
+
         return captures
-    
+
     @staticmethod
-    def _execute_modern_api(query: Any, root_node: Any) -> List[Tuple[Any, str]]:
+    def _execute_modern_api(query: Any, root_node: Any) -> list[tuple[Any, str]]:
         """Execute query using modern API (tree-sitter 0.20+)"""
         captures = []
         try:
@@ -103,9 +103,9 @@ class TreeSitterQueryCompat:
             logger.error(f"Modern API execution failed: {e}")
             raise
         return captures
-    
+
     @staticmethod
-    def _execute_legacy_api(query: Any, root_node: Any) -> List[Tuple[Any, str]]:
+    def _execute_legacy_api(query: Any, root_node: Any) -> list[tuple[Any, str]]:
         """Execute query using legacy API (tree-sitter < 0.20)"""
         captures = []
         try:
@@ -117,71 +117,76 @@ class TreeSitterQueryCompat:
             logger.error(f"Legacy API execution failed: {e}")
             raise
         return captures
-    
+
     @staticmethod
-    def _execute_old_api(query: Any, root_node: Any) -> List[Tuple[Any, str]]:
+    def _execute_old_api(query: Any, root_node: Any) -> list[tuple[Any, str]]:
         """Execute query using very old API (tree-sitter < 0.19)"""
         captures = []
         try:
             # Try different old API patterns
-            if hasattr(query, '__call__'):
+            if callable(query):
                 # Some very old versions had callable queries
                 query_result = query(root_node)
                 if isinstance(query_result, list):
                     for item in query_result:
                         if isinstance(item, tuple) and len(item) >= 2:
                             captures.append((item[0], str(item[1])))
-                        elif hasattr(item, 'node') and hasattr(item, 'name'):
+                        elif hasattr(item, "node") and hasattr(item, "name"):
                             captures.append((item.node, item.name))
             else:
                 # If no known API is available, return empty result
-                logger.warning("No compatible tree-sitter query API found, returning empty result")
-                
+                logger.warning(
+                    "No compatible tree-sitter query API found, returning empty result"
+                )
+
         except Exception as e:
             logger.error(f"Old API execution failed: {e}")
             # Don't raise, just return empty result
-            
+
         return captures
-    
+
     @staticmethod
     def safe_execute_query(
         language: Any,
         query_string: str,
         root_node: Any,
-        fallback_result: Optional[List[Tuple[Any, str]]] = None
-    ) -> List[Tuple[Any, str]]:
+        fallback_result: list[tuple[Any, str]] | None = None,
+    ) -> list[tuple[Any, str]]:
         """
         Safely execute a query with fallback handling.
-        
+
         Args:
             language: Tree-sitter language object
             query_string: Query string to execute
             root_node: Root node to query against
             fallback_result: Result to return if query fails
-            
+
         Returns:
             List of (node, capture_name) tuples or fallback_result
         """
         try:
-            return TreeSitterQueryCompat.execute_query(language, query_string, root_node)
+            return TreeSitterQueryCompat.execute_query(
+                language, query_string, root_node
+            )
         except Exception as e:
             logger.debug(f"Query execution failed, using fallback: {e}")
             return fallback_result or []
 
 
-def create_query_safely(language: Any, query_string: str) -> Optional[Any]:
+def create_query_safely(language: Any, query_string: str) -> Any | None:
     """
     Safely create a tree-sitter query object.
-    
+
     Args:
         language: Tree-sitter language object
         query_string: Query string
-        
+
     Returns:
         Query object or None if creation fails
     """
     try:
         import tree_sitter
+
         return tree_sitter.Query(language, query_string)
     except Exception as e:
         logger.debug(f"Query creation failed: {e}")
@@ -191,37 +196,39 @@ def create_query_safely(language: Any, query_string: str) -> Optional[Any]:
 def get_node_text_safe(node: Any, source_code: str, encoding: str = "utf-8") -> str:
     """
     Safely extract text from a tree-sitter node.
-    
+
     Args:
         node: Tree-sitter node
         source_code: Source code string
         encoding: Text encoding
-        
+
     Returns:
         Node text or empty string if extraction fails
     """
     try:
         # Try byte-based extraction first
-        if hasattr(node, 'start_byte') and hasattr(node, 'end_byte'):
+        if hasattr(node, "start_byte") and hasattr(node, "end_byte"):
             start_byte = node.start_byte
             end_byte = node.end_byte
             source_bytes = source_code.encode(encoding)
             if start_byte <= end_byte <= len(source_bytes):
-                return source_bytes[start_byte:end_byte].decode(encoding, errors='replace')
-        
+                return source_bytes[start_byte:end_byte].decode(
+                    encoding, errors="replace"
+                )
+
         # Fall back to node.text if available
-        if hasattr(node, 'text') and node.text:
+        if hasattr(node, "text") and node.text:
             if isinstance(node.text, bytes):
-                return node.text.decode(encoding, errors='replace')
+                return node.text.decode(encoding, errors="replace")
             else:
                 return str(node.text)
-        
+
         # Fall back to point-based extraction
-        if hasattr(node, 'start_point') and hasattr(node, 'end_point'):
+        if hasattr(node, "start_point") and hasattr(node, "end_point"):
             start_point = node.start_point
             end_point = node.end_point
-            lines = source_code.split('\n')
-            
+            lines = source_code.split("\n")
+
             if start_point[0] < len(lines) and end_point[0] < len(lines):
                 if start_point[0] == end_point[0]:
                     # Single line
@@ -242,10 +249,10 @@ def get_node_text_safe(node: Any, source_code: str, encoding: str = "utf-8") ->
                             result_lines.append(line[:end_col])
                         else:
                             result_lines.append(line)
-                    return '\n'.join(result_lines)
-        
+                    return "\n".join(result_lines)
+
         return ""
-        
+
     except Exception as e:
         logger.debug(f"Node text extraction failed: {e}")
         return ""
@@ -255,28 +262,28 @@ def log_api_info():
     """Log information about available tree-sitter APIs."""
     try:
         import tree_sitter
+
         logger.debug("Tree-sitter library available")
-        
+
         # Check available APIs
         try:
             # Create a dummy query to test available methods
-            dummy_lang = None
-            dummy_query_str = "(identifier) @name"
-            
+            # We can't actually test without a language, so just check the class
+
             # We can't actually test without a language, so just check the class
             query_class = tree_sitter.Query
-            has_matches = 'matches' in dir(query_class)
-            has_captures = 'captures' in dir(query_class)
-            
+            has_matches = "matches" in dir(query_class)
+            has_captures = "captures" in dir(query_class)
+
             if has_matches:
                 logger.debug("Tree-sitter modern API (matches) available")
             elif has_captures:
                 logger.debug("Tree-sitter legacy API (captures) available")
             else:
                 logger.warning("No compatible tree-sitter API found")
-                
+
         except Exception as e:
             logger.debug(f"API detection failed: {e}")
-            
+
     except ImportError:
-        logger.debug("Tree-sitter library not available")
+        logger.debug("Tree-sitter library not available")

tree_sitter_analyzer/utils.py

@@ -9,7 +9,9 @@ import atexit
 import logging
 import os
 import sys
+import tempfile
 from functools import wraps
+from pathlib import Path
 from typing import Any
 
 
@@ -31,7 +33,7 @@ def setup_logger(
             level = logging.ERROR
         else:
             level = logging.WARNING  # Default fallback
-    
+
     # Get log level from environment variable (only if set and not empty)
     env_level = os.environ.get("LOG_LEVEL", "").upper()
     if env_level and env_level in ["DEBUG", "INFO", "WARNING", "ERROR"]:
@@ -46,11 +48,17 @@ def setup_logger(
     # If env_level is empty or not recognized, use the passed level parameter
 
     logger = logging.getLogger(name)
-    
+
     # Clear existing handlers if this is a test logger to ensure clean state
     if name.startswith("test_"):
         logger.handlers.clear()
 
+    # Initialize file logging variables at function scope
+    enable_file_log = (
+        os.environ.get("TREE_SITTER_ANALYZER_ENABLE_FILE_LOG", "").lower() == "true"
+    )
+    file_log_level = level  # Default to main logger level
+
     if not logger.handlers:  # Avoid duplicate handlers
         # Create a safe handler that writes to stderr to avoid breaking MCP stdio
         handler = SafeStreamHandler()
@@ -60,28 +68,78 @@ def setup_logger(
         handler.setFormatter(formatter)
         logger.addHandler(handler)
 
-        # Also log to a local file for debugging when launched by clients (e.g., Cursor)
+        # Optional file logging for debugging when launched by clients (e.g., Cursor)
         # This helps diagnose cases where stdio is captured by the client and logs are hidden.
-        try:
-            file_handler = logging.FileHandler(
-                "cursor_mcp_server.log", encoding="utf-8"
-            )
-            file_handler.setFormatter(formatter)
-            logger.addHandler(file_handler)
-        except Exception as e:
-            # Never let logging configuration break runtime behavior; log to stderr if possible
-            if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
-                try:
-                    sys.stderr.write(
-                        f"[logging_setup] file handler init skipped: {e}\n"
-                    )
-                except Exception:
-                    ...
+        # Only enabled when TREE_SITTER_ANALYZER_ENABLE_FILE_LOG is set to 'true'
+        if enable_file_log:
+            try:
+                # Determine log directory
+                log_dir = os.environ.get("TREE_SITTER_ANALYZER_LOG_DIR")
+                if log_dir:
+                    # Use specified directory
+                    log_path = Path(log_dir) / "tree_sitter_analyzer.log"
+                    # Ensure directory exists
+                    Path(log_dir).mkdir(parents=True, exist_ok=True)
+                else:
+                    # Use system temporary directory
+                    temp_dir = tempfile.gettempdir()
+                    log_path = Path(temp_dir) / "tree_sitter_analyzer.log"
+
+                # Determine file log level
+                file_log_level_str = os.environ.get(
+                    "TREE_SITTER_ANALYZER_FILE_LOG_LEVEL", ""
+                ).upper()
+                if file_log_level_str and file_log_level_str in [
+                    "DEBUG",
+                    "INFO",
+                    "WARNING",
+                    "ERROR",
+                ]:
+                    if file_log_level_str == "DEBUG":
+                        file_log_level = logging.DEBUG
+                    elif file_log_level_str == "INFO":
+                        file_log_level = logging.INFO
+                    elif file_log_level_str == "WARNING":
+                        file_log_level = logging.WARNING
+                    elif file_log_level_str == "ERROR":
+                        file_log_level = logging.ERROR
+                else:
+                    # Use same level as main logger
+                    file_log_level = level
+
+                file_handler = logging.FileHandler(str(log_path), encoding="utf-8")
+                file_handler.setFormatter(formatter)
+                file_handler.setLevel(file_log_level)
+                logger.addHandler(file_handler)
+
+                # Log the file location for debugging purposes
+                if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
+                    try:
+                        sys.stderr.write(
+                            f"[logging_setup] File logging enabled: {log_path}\n"
+                        )
+                    except Exception:
+                        ...
+
+            except Exception as e:
+                # Never let logging configuration break runtime behavior; log to stderr if possible
+                if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
+                    try:
+                        sys.stderr.write(
+                            f"[logging_setup] file handler init skipped: {e}\n"
+                        )
+                    except Exception:
+                        ...
+
+    # Set the logger level to the minimum of main level and file log level
+    # This ensures that all messages that should go to any handler are processed
+    final_level = level
+    if enable_file_log:
+        # Use the minimum level to ensure all messages reach their intended handlers
+        final_level = min(level, file_log_level)
+
+    logger.setLevel(final_level)
 
-    # Always set the level, even if handlers already exist
-    # Ensure the level is properly set, not inherited
-    logger.setLevel(level)
-    
     # For test loggers, ensure they don't inherit from parent and force level
     if logger.name.startswith("test_"):
         logger.propagate = False
@@ -115,8 +173,8 @@ class SafeStreamHandler(logging.StreamHandler):
 
             # Special handling for pytest capture scenarios
             # Check if this is a pytest capture stream that might be problematic
-            stream_name = getattr(self.stream, 'name', '')
-            if stream_name is None or 'pytest' in str(type(self.stream)).lower():
+            stream_name = getattr(self.stream, "name", "")
+            if stream_name is None or "pytest" in str(type(self.stream)).lower():
                 # For pytest streams, be extra cautious
                 try:
                     # Just try to emit without any pre-checks
@@ -295,7 +353,7 @@ def safe_print(message: str | None, level: str = "info", quiet: bool = False) ->
 
     # Handle None message by converting to string - always call log function even for None
     msg = str(message) if message is not None else "None"
-    
+
     # Use dynamic lookup to support mocking
     level_lower = level.lower()
     if level_lower == "info":

{tree_sitter_analyzer-1.8.3.dist-info → tree_sitter_analyzer-1.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.8.3
+Version: 1.9.0
 Summary: AI-era enterprise-grade code analysis tool with comprehensive HTML/CSS support, dynamic plugin architecture, and MCP integration
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -198,11 +198,11 @@ Description-Content-Type: text/markdown
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-3361%20passed-brightgreen.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3380%20passed-brightgreen.svg)](#quality-assurance)
 [![Coverage](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
 [![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality-assurance)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
-[![Version](https://img.shields.io/badge/version-1.8.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.8.4-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/aimasteracc/tree-sitter-analyzer)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
@@ -255,7 +255,7 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 | **Go** | Basic Support | Basic syntax parsing |
 
 ### 🏆 Production Ready
-- **3,361 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **3,380 Tests** - 100% pass rate, enterprise-grade quality assurance
 - **High Coverage** - Comprehensive test coverage
 - **Cross-platform Support** - Compatible with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
@@ -373,6 +373,7 @@ rg --version
 - **Roo Code**: Supports MCP protocol, use the same configuration format
 - **Other MCP-compatible clients**: Use the same server configuration
 
+
 ---
 
 ### 3.2 💻 CLI Users (Command Line Tools)
@@ -640,6 +641,19 @@ Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants
 | **📁 Resource Access** | Code file resources | URI code file access | File content access via URI identification |
 | | Project statistics resources | Project statistics data access | Project analysis data and statistical information |
 
+### 🆕 v1.8.4 New Feature: Configurable File Logging
+
+Revolutionary environment variable-controlled file logging system:
+
+- **🔧 Environment Variable Control**: Flexible file logging behavior control through environment variables
+  - `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`: Enable/disable file logging
+  - `TREE_SITTER_ANALYZER_LOG_DIR`: Custom log directory path
+  - `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`: Control file log level
+- **🛡️ Improved Default Behavior**: File logging disabled by default to prevent user project pollution
+- **📁 Smart Directory Selection**: Uses system temp directory when enabled, keeping projects clean
+- **🔄 Backward Compatibility**: Maintains all existing functionality unchanged
+- **📚 Complete Documentation Support**: Includes debugging guides and troubleshooting documentation
+
 ### 🆕 v1.8.3 New Feature: MCP Tools Design Consistency Enhancement
 
 Comprehensive MCP tools unification and design consistency improvements:
@@ -859,7 +873,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,361 tests** - 100% pass rate ✅
+- **3,380 tests** - 100% pass rate ✅
 - **High code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux