perl-module-import 0.12.2

Parse and classify single-line Perl use/require import heads
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

# perl-module-import

Parse the leading shape of `use` and `require` lines.

This crate turns a single source line into a structured import head with stable
byte offsets and dispatch semantics. Use it when you need to know what the
statement is before you decide how to rewrite or inspect it.

## Pipeline

- `perl-module-token-core` handles token spans.
- `perl-module-import` classifies the leading statement and token.
- `perl-module-import-match` gives you a boolean line check when you do not
  need the full parse.
- `perl-module-reference` and `perl-module-rename` use the parse result to find
  or rewrite imports.

## Key API

- `LoadTiming`
- `ImportBehavior`
- `DispatchSemantics`
- `RequireForm`
- `ModuleImportKind`
- `ModuleImportHead`
- `parse_module_import_head`

## Example

```rust
use perl_module_import::{ModuleImportKind, parse_module_import_head};

let head = parse_module_import_head("use parent 'Foo::Bar';");
assert!(matches!(head.as_ref().map(|h| h.kind), Some(ModuleImportKind::UseParent)));
assert_eq!(head.as_ref().map(|h| h.token), Some("parent"));
```