perl-semantic-analyzer 0.12.2

Semantic analysis and symbol extraction for Perl
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

# perl-semantic-analyzer

Semantic analysis for Perl source.

Use this crate when you already have an AST and need symbols, scopes, types,
declaration lookup, or dead-code signals before you get to editor features.

## Where it fits

`perl-semantic-analyzer` sits above `perl-parser-core` and next to
`perl-workspace-index`. It turns parsed trees into analysis artifacts that the
workspace, refactoring, and LSP layers can consume.

## Key entry points

- `analysis::symbol::SymbolExtractor`
- `analysis::scope_analyzer::ScopeAnalyzer`
- `analysis::type_inference::TypeInferenceEngine`
- `analysis::semantic::SemanticAnalyzer`
- `analysis::declaration::DeclarationProvider`
- `analysis::index::WorkspaceIndex`

## Example

```rust
use perl_parser_core::Parser;
use perl_semantic_analyzer::analysis::symbol::SymbolExtractor;

let mut parser = Parser::new("sub hello { my $x = 1; }");
let ast = parser.parse()?;
let _symbols = SymbolExtractor::new().extract(&ast);
```

## Typical use

Use `perl-semantic-analyzer` when you are building hover, declaration, type,
or diagnostics features from parsed Perl source. If you need cross-file lookup
or document caching, pair it with `perl-workspace-index`.