tree-sitter-analyzer 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

tree_sitter_analyzer-0.1.2.dist-info/METADATA

@@ -1,444 +0,0 @@
-Metadata-Version: 2.4
-Name: tree-sitter-analyzer
-Version: 0.1.2
-Summary: Extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture
-Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
-Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
-Project-URL: Repository, https://github.com/aimasteracc/tree-sitter-analyzer.git
-Project-URL: Issues, https://github.com/aimasteracc/tree-sitter-analyzer/issues
-Project-URL: Changelog, https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/CHANGELOG.md
-Project-URL: Bug Reports, https://github.com/aimasteracc/tree-sitter-analyzer/issues
-Project-URL: Source Code, https://github.com/aimasteracc/tree-sitter-analyzer
-Author-email: "aisheng.yu" <aimasteracc@gmail.com>
-Maintainer-email: "aisheng.yu" <aimasteracc@gmail.com>
-License: MIT
-Keywords: ai-tools,ast,code-analysis,mcp,mcp-server,model-context-protocol,multi-language,parsing,static-analysis,tree-sitter
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: AsyncIO
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Communications
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Text Processing :: Linguistic
-Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Requires-Dist: cachetools>=5.0.0
-Requires-Dist: chardet>=5.0.0
-Requires-Dist: tree-sitter-cpp>=0.23.4
-Requires-Dist: tree-sitter-java>=0.23.5
-Requires-Dist: tree-sitter>=0.20.0
-Provides-Extra: all-languages
-Requires-Dist: tree-sitter-c>=0.20.0; extra == 'all-languages'
-Requires-Dist: tree-sitter-cpp>=0.23.4; extra == 'all-languages'
-Requires-Dist: tree-sitter-go>=0.20.0; extra == 'all-languages'
-Requires-Dist: tree-sitter-java>=0.23.5; extra == 'all-languages'
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'all-languages'
-Requires-Dist: tree-sitter-python>=0.23.0; extra == 'all-languages'
-Requires-Dist: tree-sitter-rust>=0.20.0; extra == 'all-languages'
-Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'all-languages'
-Provides-Extra: c
-Requires-Dist: tree-sitter-c>=0.20.0; extra == 'c'
-Provides-Extra: cpp
-Requires-Dist: tree-sitter-cpp>=0.23.4; extra == 'cpp'
-Provides-Extra: dev
-Requires-Dist: black>=24.0.0; extra == 'dev'
-Requires-Dist: flake8>=7.0.0; extra == 'dev'
-Requires-Dist: isort>=5.13.0; extra == 'dev'
-Requires-Dist: memory-profiler>=0.61.0; extra == 'dev'
-Requires-Dist: mypy>=1.17.0; extra == 'dev'
-Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
-Requires-Dist: psutil>=7.0.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=1.1.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'dev'
-Requires-Dist: pytest>=8.4.1; extra == 'dev'
-Requires-Dist: types-psutil>=5.9.0; extra == 'dev'
-Provides-Extra: full
-Requires-Dist: anyio>=4.9.0; extra == 'full'
-Requires-Dist: black>=24.0.0; extra == 'full'
-Requires-Dist: flake8>=7.0.0; extra == 'full'
-Requires-Dist: httpx>=0.28.1; extra == 'full'
-Requires-Dist: isort>=5.13.0; extra == 'full'
-Requires-Dist: mcp>=1.12.2; extra == 'full'
-Requires-Dist: memory-profiler>=0.61.0; extra == 'full'
-Requires-Dist: mypy>=1.17.0; extra == 'full'
-Requires-Dist: pre-commit>=3.0.0; extra == 'full'
-Requires-Dist: psutil>=7.0.0; extra == 'full'
-Requires-Dist: pydantic-settings>=2.10.1; extra == 'full'
-Requires-Dist: pydantic>=2.11.7; extra == 'full'
-Requires-Dist: pytest-asyncio>=1.1.0; extra == 'full'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'full'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'full'
-Requires-Dist: pytest>=8.4.1; extra == 'full'
-Requires-Dist: tree-sitter-c>=0.20.0; extra == 'full'
-Requires-Dist: tree-sitter-cpp>=0.23.4; extra == 'full'
-Requires-Dist: tree-sitter-go>=0.20.0; extra == 'full'
-Requires-Dist: tree-sitter-java>=0.23.5; extra == 'full'
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'full'
-Requires-Dist: tree-sitter-python>=0.23.0; extra == 'full'
-Requires-Dist: tree-sitter-rust>=0.20.0; extra == 'full'
-Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'full'
-Requires-Dist: types-psutil>=5.9.0; extra == 'full'
-Provides-Extra: go
-Requires-Dist: tree-sitter-go>=0.20.0; extra == 'go'
-Provides-Extra: java
-Requires-Dist: tree-sitter-java>=0.23.5; extra == 'java'
-Provides-Extra: javascript
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'javascript'
-Provides-Extra: mcp
-Requires-Dist: anyio>=4.9.0; extra == 'mcp'
-Requires-Dist: httpx>=0.28.1; extra == 'mcp'
-Requires-Dist: mcp>=1.12.2; extra == 'mcp'
-Requires-Dist: pydantic-settings>=2.10.1; extra == 'mcp'
-Requires-Dist: pydantic>=2.11.7; extra == 'mcp'
-Provides-Extra: popular
-Requires-Dist: tree-sitter-java>=0.23.5; extra == 'popular'
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'popular'
-Requires-Dist: tree-sitter-python>=0.23.0; extra == 'popular'
-Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'popular'
-Provides-Extra: python
-Requires-Dist: tree-sitter-python>=0.23.0; extra == 'python'
-Provides-Extra: rust
-Requires-Dist: tree-sitter-rust>=0.20.0; extra == 'rust'
-Provides-Extra: systems
-Requires-Dist: tree-sitter-c>=0.20.0; extra == 'systems'
-Requires-Dist: tree-sitter-cpp>=0.23.4; extra == 'systems'
-Requires-Dist: tree-sitter-go>=0.20.0; extra == 'systems'
-Requires-Dist: tree-sitter-rust>=0.20.0; extra == 'systems'
-Provides-Extra: test
-Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'test'
-Requires-Dist: pytest>=8.4.1; extra == 'test'
-Requires-Dist: tree-sitter-cpp>=0.23.4; extra == 'test'
-Requires-Dist: tree-sitter-java>=0.23.5; extra == 'test'
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'test'
-Requires-Dist: tree-sitter-python>=0.23.0; extra == 'test'
-Provides-Extra: typescript
-Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'typescript'
-Provides-Extra: web
-Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'web'
-Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'web'
-Description-Content-Type: text/markdown
-
-# Tree-sitter Analyzer
-
-[![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-1251%20passed-brightgreen.svg)](#测试)
-
-An extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture, designed to solve the problem of large code files exceeding LLM single-pass token limits.
-
-**Available as both CLI tool and MCP server.**
-
-## Core Features
-
-1. **Code Scale Analysis** - Get overall structure without reading complete files
-2. **Targeted Code Extraction** - Extract specific line ranges efficiently  
-3. **Code Position Information** - Get detailed position data for precise extraction
-
-## Installation
-
-### Prerequisites
-
-First, install uv (a fast Python package manager):
-
-```bash
-# On macOS and Linux
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# On Windows
-powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
-
-# Or using pip
-pip install uv
-```
-
-### Install from GitHub
-
-```bash
-# Basic installation with Java support
-# Clone and install the project
-git clone https://github.com/aimasteracc/tree-sitter-analyzer.git
-cd tree-sitter-analyzer
-
-# Install with Java support
-uv sync
-
-# With popular languages (Java, Python, JavaScript, TypeScript)
-uv sync --extra popular
-
-# With MCP server support
-uv sync --extra mcp
-
-# Full installation with all features
-uv sync --extra all --extra mcp
-```
-
-## Usage
-
-### CLI Commands
-
-```bash
-# Code scale analysis
-uv run python -m tree_sitter_analyzer examples/Sample.java --advanced --output-format=text
-
-# Partial code extraction
-uv run python -m tree_sitter_analyzer examples/Sample.java --partial-read --start-line 84 --end-line 86
-
-# Position information table
-uv run python -m tree_sitter_analyzer examples/Sample.java --table=full
-```
-
-#### CLI Output Examples
-
-**Code Scale Analysis (`--advanced --output-format=text`):**
-
->```
->PS C:\git-public\tree-sitter-analyzer> uv run python -m tree_sitter_analyzer examples/Sample.java --advanced --output-format=text
->2025-07-30 16:57:47,827 - tree_sitter_analyzer - INFO - Successfully loaded 3 language plugins: java, javascript, python
->2025-07-30 16:57:47,916 - tree_sitter_analyzer - INFO - CacheService initialized: L1=100, L2=1000, L3=10000, TTL=3600s
->2025-07-30 16:57:47,917 - tree_sitter_analyzer - INFO - Loading plugins...
->2025-07-30 16:57:47,920 - tree_sitter_analyzer - INFO - Plugin registered for language: java
->2025-07-30 16:57:47,920 - tree_sitter_analyzer - INFO - Plugin registered for language: javascript
->2025-07-30 16:57:47,922 - tree_sitter_analyzer - INFO - Plugin registered for language: python
->2025-07-30 16:57:47,922 - tree_sitter_analyzer - INFO - Successfully loaded 3 language plugins: java, javascript, python     
->2025-07-30 16:57:47,923 - tree_sitter_analyzer - INFO - UnifiedAnalysisEngine initialized
->INFO: 拡張子から言語を自動判定しました: java
->2025-07-30 16:57:47,925 - tree_sitter_analyzer - INFO - Starting analysis for examples/Sample.java
->2025-07-30 16:57:47,945 - tree_sitter_analyzer.core.parser - INFO - Parser initialized successfully
->2025-07-30 16:57:47,951 - PERF - analyze_java: 0.0253s - Operation completed
->2025-07-30 16:57:47,951 - tree_sitter_analyzer.performance - INFO - analyze_java: 0.0253s - Operation completed
->2025-07-30 16:57:47,958 - PERF - unified_analysis: 0.0253s - Analyzed examples/Sample.java (java)
->2025-07-30 16:57:47,958 - tree_sitter_analyzer.performance - INFO - unified_analysis: 0.0253s - Analyzed examples/Sample.java (java)
->
->--- 高度な解析結果 ---
->"ファイル: examples/Sample.java"
->"パッケージ: (default)"
->"行数: 178"
->"\nクラス数: 8"
->"メソッド数: 24"
->"フィールド数: 5"
->"インポート数: 2"
->"アノテーション数: 0"
->```
-
-**Partial Code Extraction (`--partial-read`):**
->```
->PS C:\git-public\tree-sitter-analyzer> uv run python -m tree_sitter_analyzer examples/Sample.java --partial-read --start-line 84 --end-line 86
->2025-07-30 16:58:22,948 - tree_sitter_analyzer - INFO - Successfully loaded 3 language plugins: java, javascript, python
->2025-07-30 16:58:23,056 - tree_sitter_analyzer - INFO - Successfully read partial file examples/Sample.java: lines 84-86
->{
->  "file_path": "examples/Sample.java",
->  "range": {
->    "start_line": 84,
->    "end_line": 86,
->    "start_column": null,
->    "end_column": null
->  },
->  "content": "        public void innerMethod() {\n            System.out.println(\"Inner class method, value: \" + value);\n        }\n",
->  "content_length": 117
->}
->```
-
-**Table Format Analysis (`--table=full`):**
-
-The `--table=full` command produces detailed analysis tables:
-
-
-># Sample.java
->
->## Imports
->```java
->java.util.List
->java.util.ArrayList
->```
->
->## Classes
->| Class | Type | Visibility | Lines | Methods | Fields |
->|-------|------|------------|-------|---------|--------|
->| AbstractParentClass | class | public | 7-15 | 2 | 0 |
->| ParentClass | class | public | 18-45 | 4 | 2 |
->| TestInterface | class | public | 48-64 | 3 | 0 |
->| AnotherInterface | class | public | 67-69 | 1 | 0 |
->| Test | class | public | 72-159 | 14 | 3 |
->| InnerClass | class | public | 83-87 | 1 | 0 |
->| StaticNestedClass | class | public | 90-94 | 1 | 0 |
->| TestEnum | class | public | 162-178 | 0 | 0 |
->
->## Fields
->| Name | Type | Vis | Modifiers | Line | Doc |
->|------|------|-----|-----------|------|-----|
->| CONSTANT | String | ~ | static,final | 20 | - |
->| parentField | String | # | protected | 23 | - |
->| value | int | - | private | 74 | - |
->| staticValue | int | + | public,static | 77 | - |
->| finalField | String | - | private,final | 80 | - |
->
->## Constructor
->| Method | Signature | Vis | Lines | Cols | Cx | Doc |
->|--------|-----------|-----|-------|------|----|----|
->| ParentClass | ():void | + | 26-28 | 5-6 | 1 | - |
->| Test | (value:int):void | + | 97-100 | 5-6 | 1 | - |
->| Test | ():void | + | 103-105 | 5-6 | 1 | - |
->
->## Public Methods
->| Method | Signature | Vis | Lines | Cols | Cx | Doc |
->|--------|-----------|-----|-------|------|----|----|
->| innerMethod | ():void | + | 84-86 | 5-6 | 1 | - |
->| nestedMethod | ():void | + | 91-93 | 5-6 | 1 | - |
->| getValue | ():String | + | 108-110 | 5-6 | 1 | - |
->| staticMethod | ():void [static] | + | 128-130 | 5-6 | 1 | - |
->| finalMethod | ():void | + | 133-135 | 5-6 | 1 | - |
->| doSomething | ():void | + | 138-141 | 5-6 | 1 | - |
->| anotherMethod | ():void | + | 143-146 | 5-6 | 1 | - |
->| genericMethod | (input:T):void | + | 149-151 | 5-6 | 1 | - |
->| createList | (item:T):List<T> | + | 154-158 | 5-6 | 1 | - |
->
->## Private Methods
->| Method | Signature | Vis | Lines | Cols | Cx | Doc |
->|--------|-----------|-----|-------|------|----|----|
->| privateMethod | ():void | - | 123-125 | 5-6 | 1 | - |
-
-
-### MCP Server
-
-The Tree-sitter Analyzer provides an MCP (Model Context Protocol) server that enables AI assistants to analyze code files directly.
-
-
-#### MCP Configuration
-
-Add to your Claude Desktop config file:
-
-```json
-{
-  "mcpServers": {
-    "tree-sitter-analyzer": {
-      "command": "uv",
-      "args": [
-        "run", 
-        "--with", 
-        "tree-sitter-analyzer[mcp]",
-        "python", 
-        "-m", 
-        "tree_sitter_analyzer.mcp.server"
-      ]
-    }
-  }
-}
-```
-
-#### Available MCP Tools
-
-1. **analyze_code_scale** - Get code scale and complexity metrics
-2. **format_table** - Generate table-formatted analysis (equivalent to CLI `--table=full`)
-3. **read_code_partial** - Extract specific line ranges from files
-4. **analyze_code_universal** - Universal code analysis with automatic language detection
-
-#### MCP Usage Examples
-
-**Code Scale Analysis:**
-```json
-{
-  "tool": "analyze_code_scale",
-  "arguments": {
-    "file_path": "examples/Sample.java",
-    "include_complexity": true,
-    "include_details": true
-  }
-}
-```
-
->```json
->{
->  "file_path": "examples/Sample.java",
->  "language": "java",
->  "analyzer_type": "advanced",
->  "analysis_type": "basic",
->  "metrics": {
->    "lines_total": 178,
->    "lines_code": 0,
->    "lines_comment": 0,
->    "lines_blank": 0,
->    "elements": {
->      "classes": 8,
->      "methods": 24,
->      "fields": 5,
->      "imports": 2,
->      "annotations": 0
->    }
->  }
->}
->```
-
-**Table Format Analysis:**
-```json
-{
-  "tool": "format_table",
-  "arguments": {
-    "file_path": "examples/Sample.java",
-    "format_type": "full"
-  }
-}
-```
->```json
->{
->  "table_output": "# Sample.java\n\n## Imports\n```java\njava.util.List\njava.util.ArrayList\n```\n\n## Classes\n| Class | Type | >Visibility | Lines | Methods | Fields |\n|-------|------|------------|-------|---------|--------|\n| AbstractParentClass | class | public | >7-15 | 2 | 0 |\n| ParentClass | class | public | 18-45 | 4 | 2 |\n| TestInterface | interface | public | 48-64 | 3 | 0 |\n| >AnotherInterface | interface | public | 67-69 | 1 | 0 |\n| Test | class | public | 72-159 | 14 | 3 |\n| InnerClass | class | public | >83-87 | 1 | 0 |\n| StaticNestedClass | class | public | 90-94 | 1 | 0 |\n| TestEnum | enum | public | 162-178 | 0 | 0 |\n\n## Fields\n| >Name | Type | Vis | Modifiers | Line | Doc |\n|------|------|-----|-----------|------|-----|\n| CONSTANT | String | ~ | static,final | 20 | >- |\n| parentField | String | # | protected | 23 | - |\n| value | int | - | private | 74 | - |\n| staticValue | int | + | public,static | >77 | - |\n| finalField | String | - | private,final | 80 | - |\n\n## Constructor\n| Method | Signature | Vis | Lines | Cols | Cx | Doc |\n|>--------|-----------|-----|-------|------|----|----|\n| ParentClass | ():void | + | 26-28 | 5-6 | 1 | - |\n| Test | (value:int):void | + | >97-100 | 5-6 | 1 | - |\n| Test | ():void | + | 103-105 | 5-6 | 1 | - |\n\n## Public Methods\n| Method | Signature | Vis | Lines | Cols | >Cx | Doc |\n|--------|-----------|-----|-------|------|----|----|\n| innerMethod | ():void | + | 84-86 | 5-6 | 1 | - |\n| nestedMethod | ()>:void | + | 91-93 | 5-6 | 1 | - |\n| getValue | ():String | + | 108-110 | 5-6 | 1 | - |\n| staticMethod | ():void [static] | + | 128-130 | >5-6 | 1 | - |\n| finalMethod | ():void | + | 133-135 | 5-6 | 1 | - |\n| doSomething | ():void | + | 138-141 | 5-6 | 1 | - |\n| >anotherMethod | ():void | + | 143-146 | 5-6 | 1 | - |\n| genericMethod | (input:T):void | + | 149-151 | 5-6 | 1 | - |\n| createList | >(item:T):List<T> | + | 154-158 | 5-6 | 1 | - |\n\n## Private Methods\n| Method | Signature | Vis | Lines | Cols | Cx | Doc |\n|--------|>-----------|-----|-------|------|----|----|\n| privateMethod | ():void | - | 123-125 | 5-6 | 1 | - |",
->  "format_type": "full",
->  "file_path": "examples/Sample.java",
->  "language": "java",
->  "metadata": {
->    "classes_count": 8,
->    "methods_count": 24,
->    "fields_count": 5,
->    "total_lines": 178
->  }
->}
->```
-
-
-**Partial Code Reading:**
-```json
-{
-  "tool": "read_code_partial",
-  "arguments": {
-    "file_path": "examples/Sample.java",
-    "start_line": 84,
-    "end_line": 86
-  }
-}
-```
->```json
->{
->  "partial_content_result": "--- 部分読み込み結果 ---\nファイル: examples/Sample.java\n範囲: 行 84-86\n読み込み文字数: 117\n{\n  \"file_path\": >\"examples/Sample.java\",\n  \"range\": {\n    \"start_line\": 84,\n    \"end_line\": 86,\n    \"start_column\": null,\n    \"end_column\": >null\n  },\n  \"content\": \"        public void innerMethod() {\\n            System.out.println(\\\"Inner class method, value: \\\" + >value);\\n        }\\n\",\n  \"content_length\": 117\n}"
->}
-
-
-## Development
-
-For developers and contributors:
-
-```bash
-# Clone the repository
-git clone https://github.com/aimasteracc/tree-sitter-analyzer.git
-cd tree-sitter-analyzer
-
-# Install development dependencies
-uv sync
-
-# Run tests
-pytest tests/ -v
-```
-
-## License
-
-MIT License