perl-parser 0.13.3

Native Perl parser (v3) — recursive descent with Tree-sitter-compatible AST, semantic analysis, and LSP provider engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! LSP compatibility layer for Perl parser
//!
//! This module provides comprehensive Language Server Protocol (LSP) compatibility
//! for Perl development tools, implementing the full spectrum of LSP features
//! with enterprise-grade performance and reliability.
//!
//! # Architecture
//!
//! The LSP compatibility layer is organized into feature-specific providers:
//! - **completion**: Intelligent code completion with context awareness
//! - **diagnostics**: Comprehensive error detection and reporting
//! - **references**: Cross-file reference finding and navigation
//! - **rename**: Safe symbol renaming with conflict detection
//! - **code_actions**: Intelligent refactoring and quick fixes
//! - **semantic_tokens**: Semantic highlighting with type awareness
//! - **workspace_symbols**: Workspace-wide symbol search
//! - **inlay_hints**: Contextual hints and annotations
//! - **type_hierarchy**: Type inheritance and relationship analysis
//!
//! # Performance Characteristics
//!
//! - **Response times**: <50ms for typical LSP operations
//! - **Memory efficiency**: Optimized for large workspaces (50K+ files)
//! - **Incremental updates**: <1ms for single-character changes
//! - **Concurrent safety**: Thread-safe for parallel LSP requests
//!
//! # Usage Examples
//!
//! ```rust
//! use perl_parser::ide::lsp_compat::{
//!     completion::CompletionProvider,
//!     diagnostics::DiagnosticProvider,
//! };
//! use lsp_types::*;
//! use url::Url;
//!
//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
//! // Initialize providers
//! let completion_provider = CompletionProvider::new();
//! let diagnostic_provider = DiagnosticProvider::new();
//!
//! // LSP completion request
//! let completion_params = CompletionParams {
//!     text_document_position: TextDocumentPositionParams {
//!         text_document: TextDocumentIdentifier { 
//!             uri: Url::parse("file:///example.pl")? 
//!         },
//!         position: Position::new(0, 10),
//!     },
//!     work_done_progress_params: Default::default(),
//!     partial_result_params: Default::default(),
//!     context: None,
//! };
//!
//! let completions = completion_provider.complete(completion_params);
//!
//! // LSP diagnostic generation
//! // (requires parse result from parser)
//!
//! # Ok(())
//! # }
//! ```

pub mod code_actions;
pub mod completion;
pub mod diagnostics;
pub mod inlay_hints;
pub mod references;
pub mod rename;
pub mod semantic_tokens;
pub mod type_hierarchy;
pub mod workspace_symbols;

// Re-export commonly used types for convenience
pub use code_actions::{CodeActionProvider, CodeActionConfig};
pub use completion::{CompletionProvider, CompletionConfig};
pub use diagnostics::{DiagnosticProvider, DiagnosticConfig};
pub use inlay_hints::{InlayHintsProvider, InlayHintsConfig};
pub use references::{ReferenceProvider};
pub use rename::{RenameProvider, RenameConfig};
pub use semantic_tokens::{SemanticTokensProvider, SemanticTokensConfig};
pub use type_hierarchy::{TypeHierarchyProvider, TypeHierarchyConfig};
pub use workspace_symbols::{WorkspaceSymbolProvider, WorkspaceSymbolConfig};