reveal-cli 0.2.0__py3-none-any.whl

plugins/c-header.yaml

@@ -0,0 +1,89 @@
+# C/C++ Header File Plugin
+# Provides 4-level progressive disclosure for .h and .hpp files
+
+extension: [.h, .hpp, .hh]
+name: C/C++ Header
+description: C and C++ header files
+icon: 🔧
+
+levels:
+  0:
+    name: metadata
+    description: File statistics and basic info
+    breadcrumb: "File metadata"
+    analyzer: null
+    outputs:
+      - file_size
+      - line_count
+      - encoding
+      - header_guards
+      - include_count
+    next_levels: [1, 2, 3]
+
+  1:
+    name: structure
+    description: Declarations, includes, and definitions
+    breadcrumb: "Includes, defines, declarations"
+    analyzer: c_header_structure
+    outputs:
+      - includes
+      - defines
+      - typedefs
+      - struct_declarations
+      - function_declarations
+      - class_declarations  # C++
+      - namespaces  # C++
+      - template_declarations  # C++
+    next_levels: [0, 2, 3]
+    tips:
+      - "Use --grep to find specific declarations"
+      - "Level 2 shows function signatures"
+
+  2:
+    name: preview
+    description: Declarations with signatures
+    breadcrumb: "Function signatures, struct definitions"
+    analyzer: c_header_preview
+    outputs:
+      - function_signatures
+      - struct_definitions
+      - class_definitions
+      - template_definitions
+      - documentation_comments
+    next_levels: [0, 1, 3]
+    tips:
+      - "See implementation details with --level 3"
+
+  3:
+    name: full
+    description: Complete header content
+    breadcrumb: "Complete header file (paged)"
+    analyzer: null
+    outputs:
+      - full_content
+    next_levels: [0, 1, 2]
+    paging: true
+    page_size: 120
+
+features:
+  grep: true
+  context: true
+  paging: true
+  line_numbers: true
+  syntax_highlighting: true
+
+analyzer_config:
+  parse_comments: true
+  extract_doxygen: true
+  include_private: true
+  detect_extern_c: true
+
+examples:
+  - command: "reveal mylib.h"
+    description: "Show header metadata"
+  - command: "reveal mylib.h -l 1"
+    description: "Show includes and declarations"
+  - command: "reveal mylib.h -l 2 --grep 'process'"
+    description: "Preview process function signatures"
+  - command: "reveal mylib.h -l 3"
+    description: "Show complete header content"

plugins/gdscript.yaml

@@ -0,0 +1,96 @@
+# GDScript File Plugin
+# Provides 4-level progressive disclosure for Godot Engine .gd files
+
+extension: .gd
+name: GDScript
+description: Godot Engine GDScript files with structure analysis
+icon: 🎮
+
+# Hierarchical levels - each level reveals more detail
+levels:
+  0:
+    name: metadata
+    description: File statistics and basic information
+    breadcrumb: "File metadata (size, encoding, line count)"
+    analyzer: null  # Built-in metadata analyzer
+    outputs:
+      - file_size
+      - line_count
+      - encoding
+      - last_modified
+      - file_type
+    next_levels: [1, 2, 3]
+
+  1:
+    name: structure
+    description: Code structure without implementations
+    breadcrumb: "Class, signals, exports, functions (structure only)"
+    analyzer: gdscript_structure
+    outputs:
+      - extends
+      - class_name
+      - signals
+      - exports
+      - constants
+      - variables
+      - functions
+    next_levels: [0, 2, 3]
+    tips:
+      - "Use --grep 'function_name' to filter specific functions"
+      - "Add --context 2 to see surrounding context"
+
+  2:
+    name: preview
+    description: Key elements without full code
+    breadcrumb: "Extends, signals, exports, function signatures"
+    analyzer: gdscript_preview
+    outputs:
+      - class_declaration
+      - signals
+      - exports
+      - function_signatures
+      - constants
+    next_levels: [0, 1, 3]
+    tips:
+      - "See full implementation with --level 3"
+      - "Filter by element name with --grep"
+
+  3:
+    name: full
+    description: Complete source code with paging
+    breadcrumb: "Complete file contents (paged)"
+    analyzer: null  # Built-in full content reader
+    outputs:
+      - full_source
+    next_levels: [0, 1, 2]
+    paging: true
+    page_size: 120
+    tips:
+      - "Use --grep to filter lines"
+      - "Add --context N for surrounding lines"
+
+# Features available at all levels
+features:
+  grep: true
+  context: true
+  paging: true
+  line_numbers: true
+  syntax_highlighting: false
+
+# Analyzer configuration
+analyzer_config:
+  include_lifecycle_funcs: true
+  include_private_vars: true
+  parse_comments: true
+  extract_signals: true
+
+# Examples shown in help text
+examples:
+  - command: "reveal player.gd"
+    description: "Show file metadata (level 0)"
+  - command: "reveal player.gd -l 1"
+    description: "Show code structure (signals, exports, functions)"
+  - command: "reveal player.gd -l 2 --grep '_ready'"
+    description: "Preview _ready function and nearby code"
+  - command: "reveal player.gd -l 3 --grep 'func take_damage' -C 5"
+    description: "Show take_damage function with 5 lines context"

plugins/python.yaml

@@ -0,0 +1,94 @@
+# Python Source File Plugin
+# Provides 4-level progressive disclosure for .py files
+
+extension: .py
+name: Python Source
+description: Python source files with AST-based analysis
+icon: 🐍
+
+# Hierarchical levels - each level reveals more detail
+levels:
+  0:
+    name: metadata
+    description: File statistics and basic information
+    breadcrumb: "File metadata (size, encoding, line count)"
+    analyzer: null  # Built-in metadata analyzer
+    outputs:
+      - file_size
+      - line_count
+      - encoding
+      - last_modified
+      - file_type
+    next_levels: [1, 2, 3]
+
+  1:
+    name: structure
+    description: Code structure without implementations
+    breadcrumb: "Imports, classes, functions (structure only)"
+    analyzer: python_structure
+    outputs:
+      - imports
+      - classes
+      - functions
+      - global_variables
+      - decorators
+    next_levels: [0, 2, 3]
+    tips:
+      - "Use --grep 'ClassName' to filter specific classes"
+      - "Add --context 2 to see surrounding context"
+
+  2:
+    name: preview
+    description: Signatures and docstrings without full code
+    breadcrumb: "Function signatures, docstrings, type hints"
+    analyzer: python_preview
+    outputs:
+      - function_signatures
+      - class_signatures
+      - docstrings
+      - type_hints
+      - decorators_with_args
+    next_levels: [0, 1, 3]
+    tips:
+      - "See full implementation with --level 3"
+      - "Filter by function name with --grep"
+
+  3:
+    name: full
+    description: Complete source code with paging
+    breadcrumb: "Complete file contents (paged)"
+    analyzer: null  # Built-in full content reader
+    outputs:
+      - full_source
+    next_levels: [0, 1, 2]
+    paging: true
+    page_size: 120
+    tips:
+      - "Use --grep to filter lines"
+      - "Add --context N for surrounding lines"
+
+# Features available at all levels
+features:
+  grep: true
+  context: true
+  paging: true
+  line_numbers: true
+  syntax_highlighting: true  # Future
+
+# Analyzer configuration
+analyzer_config:
+  include_private: false
+  include_magic: false
+  parse_docstrings: true
+  extract_type_hints: true
+
+# Examples shown in help text
+examples:
+  - command: "reveal app.py"
+    description: "Show file metadata (level 0)"
+  - command: "reveal app.py -l 1"
+    description: "Show code structure (imports, classes, functions)"
+  - command: "reveal app.py -l 2 --grep 'UserManager'"
+    description: "Preview UserManager class signatures"
+  - command: "reveal app.py -l 3 --grep 'def process' -C 5"
+    description: "Show process functions with 5 lines context"

plugins/yaml.yaml

@@ -0,0 +1,87 @@
+# YAML File Plugin
+# Provides 4-level progressive disclosure for .yaml and .yml files
+
+extension: [.yaml, .yml]
+name: YAML
+description: YAML configuration and data files
+icon: 📝
+
+levels:
+  0:
+    name: metadata
+    description: File statistics and YAML characteristics
+    breadcrumb: "File metadata and YAML info"
+    analyzer: null
+    outputs:
+      - file_size
+      - line_count
+      - encoding
+      - yaml_version
+      - has_anchors
+      - has_aliases
+      - document_count
+    next_levels: [1, 2, 3]
+
+  1:
+    name: structure
+    description: Top-level keys and nested structure
+    breadcrumb: "Top-level keys and nesting depth"
+    analyzer: yaml_structure
+    outputs:
+      - top_level_keys
+      - nesting_depth
+      - key_paths
+      - data_types
+      - anchors
+      - aliases
+    next_levels: [0, 2, 3]
+    tips:
+      - "Use --grep 'database' to find database config"
+      - "See full values with --level 2"
+
+  2:
+    name: preview
+    description: Keys with value summaries
+    breadcrumb: "Keys with abbreviated values"
+    analyzer: yaml_preview
+    outputs:
+      - keys_with_values
+      - value_summaries
+      - list_lengths
+      - object_keys
+    next_levels: [0, 1, 3]
+    tips:
+      - "Long values are truncated - use level 3 for full content"
+
+  3:
+    name: full
+    description: Complete YAML content
+    breadcrumb: "Complete YAML content (paged)"
+    analyzer: null
+    outputs:
+      - full_content
+    next_levels: [0, 1, 2]
+    paging: true
+    page_size: 120
+
+features:
+  grep: true
+  context: true
+  paging: true
+  line_numbers: true
+  syntax_highlighting: true
+
+analyzer_config:
+  max_value_preview_length: 80
+  show_types: true
+  expand_anchors: false
+
+examples:
+  - command: "reveal config.yaml"
+    description: "Show YAML metadata"
+  - command: "reveal config.yaml -l 1"
+    description: "Show top-level structure"
+  - command: "reveal config.yaml -l 2 --grep 'database'"
+    description: "Preview database configuration"
+  - command: "reveal config.yaml -l 3"
+    description: "Show complete YAML content"

reveal/__init__.py

@@ -0,0 +1,20 @@
+"""Reveal - Explore code semantically.
+
+A clean, simple tool for progressive code exploration.
+"""
+
+__version__ = "0.2.0"
+
+# Import base classes for external use
+from .base import FileAnalyzer, register, get_analyzer
+from .treesitter import TreeSitterAnalyzer
+
+# Import all built-in analyzers to register them
+from .analyzers import *
+
+__all__ = [
+    'FileAnalyzer',
+    'TreeSitterAnalyzer',
+    'register',
+    'get_analyzer',
+]

reveal/_archive_old_v0.1/analyzers/__init__.py

@@ -0,0 +1,39 @@
+"""Analyzers for different file types."""
+
+from .base import BaseAnalyzer
+from .yaml_analyzer import YAMLAnalyzer
+from .json_analyzer import JSONAnalyzer
+from .toml_analyzer import TOMLAnalyzer
+from .markdown_analyzer import MarkdownAnalyzer
+from .python_analyzer import PythonAnalyzer
+from .sql_analyzer import SQLAnalyzer
+from .text_analyzer import TextAnalyzer
+from .gdscript_analyzer import GDScriptAnalyzer
+
+# Tree-sitter based analyzers (optional dependency)
+try:
+    from .treesitter_base import TreeSitterAnalyzer
+    from .rust_analyzer import RustAnalyzer
+    from .csharp_analyzer import CSharpAnalyzer
+    from .go_analyzer import GoAnalyzer
+    from .javascript_analyzer import JavaScriptAnalyzer
+    from .php_analyzer import PHPAnalyzer
+    from .bash_analyzer import BashAnalyzer
+    TREESITTER_ANALYZERS = [
+        'TreeSitterAnalyzer', 'RustAnalyzer', 'CSharpAnalyzer', 'GoAnalyzer',
+        'JavaScriptAnalyzer', 'PHPAnalyzer', 'BashAnalyzer'
+    ]
+except ImportError:
+    TREESITTER_ANALYZERS = []
+
+__all__ = [
+    'BaseAnalyzer',
+    'YAMLAnalyzer',
+    'JSONAnalyzer',
+    'TOMLAnalyzer',
+    'MarkdownAnalyzer',
+    'PythonAnalyzer',
+    'SQLAnalyzer',
+    'TextAnalyzer',
+    'GDScriptAnalyzer',
+] + TREESITTER_ANALYZERS

reveal/_archive_old_v0.1/analyzers/base.py

@@ -0,0 +1,143 @@
+"""Base analyzer interface."""
+
+from abc import ABC, abstractmethod
+from typing import Dict, Any, List, Optional
+
+
+class BaseAnalyzer(ABC):
+    """Base class for file type analyzers."""
+
+    def __init__(self, lines: List[str], file_path: Optional[str] = None,
+                 focus_start: Optional[int] = None, focus_end: Optional[int] = None,
+                 **kwargs):
+        """
+        Initialize analyzer with file lines.
+
+        Args:
+            lines: List of file lines
+            file_path: Path to source file (for composable output)
+            focus_start: Optional start line for focused analysis
+            focus_end: Optional end line for focused analysis
+            **kwargs: Additional arguments for plugin-specific features
+        """
+        self.lines = lines
+        self.file_path = file_path
+        self.focus_start = focus_start
+        self.focus_end = focus_end
+
+    @abstractmethod
+    def analyze_structure(self) -> Dict[str, Any]:
+        """
+        Analyze file structure for Level 1.
+
+        Returns:
+            Dictionary with structural information
+        """
+        pass
+
+    @abstractmethod
+    def generate_preview(self) -> List[tuple[int, str]]:
+        """
+        Generate preview for Level 2.
+
+        Returns:
+            List of (line_number, content) tuples
+        """
+        pass
+
+    def format_structure(self, structure: Dict[str, Any]) -> Optional[List[str]]:
+        """
+        Format structure output for Level 1 display (optional override).
+
+        Plugins can override this to provide custom formatting without
+        modifying core reveal code. If not overridden, reveal uses
+        generic formatting based on the structure dictionary.
+
+        Args:
+            structure: The dict returned from analyze_structure()
+
+        Returns:
+            List of formatted output lines, or None to use default formatting
+        """
+        return None  # Default: use generic formatter
+
+    # Line number helpers for tool composability
+
+    def format_location(self, line_num: Optional[int]) -> str:
+        """
+        Format a line reference in a composable way.
+
+        Returns filename:line for tool integration (vim, grep, git, etc.)
+        or L0000 format if no file_path available.
+
+        Args:
+            line_num: Line number to format (1-indexed)
+
+        Returns:
+            Formatted location string (e.g., "schema.sql:32" or "L0032")
+        """
+        if line_num is None:
+            return ""
+        if self.file_path:
+            return f"{self.file_path}:{line_num}"
+        return f"L{line_num:04d}"
+
+    def with_location(self, text: str, line_num: Optional[int], width: int = 30) -> str:
+        """
+        Prepend location reference to text for aligned output.
+
+        Args:
+            text: Text to annotate
+            line_num: Line number (1-indexed)
+            width: Column width for location (default: 30)
+
+        Returns:
+            Formatted string with location prefix
+        """
+        loc = self.format_location(line_num)
+        if loc:
+            return f"{loc:<{width}}  {text}"
+        return text
+
+    def find_definition(self, identifier: str, start_line: int = 1,
+                       case_sensitive: bool = True) -> Optional[int]:
+        """
+        Find the line number where an identifier is defined.
+
+        Searches from start_line through the file for the identifier.
+        Useful for automatically annotating structure with line numbers.
+
+        Args:
+            identifier: Text to search for (e.g., table name, function name)
+            start_line: Line to start searching from (1-indexed)
+            case_sensitive: Whether to match case (default: True)
+
+        Returns:
+            Line number (1-indexed) where identifier found, or None
+        """
+        search_text = identifier if case_sensitive else identifier.lower()
+        for i, line in enumerate(self.lines[start_line - 1:], start_line):
+            compare_line = line if case_sensitive else line.lower()
+            if search_text in compare_line:
+                return i
+        return None
+
+    def in_focus_range(self, line_num: int) -> bool:
+        """
+        Check if a line number is within the focus range.
+
+        Useful when user requests specific line range (e.g., reveal file.sql:10-50)
+
+        Args:
+            line_num: Line number to check (1-indexed)
+
+        Returns:
+            True if in focus range or no focus set, False otherwise
+        """
+        if self.focus_start is None and self.focus_end is None:
+            return True
+        if self.focus_start and line_num < self.focus_start:
+            return False
+        if self.focus_end and line_num > self.focus_end:
+            return False
+        return True