Module import 

use/require import modeling and utilities. Single-line Perl import head parsing and literal require/import extraction.

Parse a single source line that starts with use or require and return the first import token with stable byte offsets.

Also provides extract_require_import_symbols, a text-level extractor that recognises the literal require Module; Module->import(...) adjacency pattern in multi-line source without requiring AST construction.

Structs

DispatchSemantics

Semantic description of a use/require dispatch form.

ModuleImportHead

Parsed leading import token from a use/require line.

RequireImportEntry

A single symbol extracted from a literal require Module; Module->import(...) pair.

Enums

ImportBehavior

Whether the module’s import method is called after loading.

ImportListForm

How a use statement spells its import list.

LoadTiming

When a module is loaded relative to program execution.

ModuleImportKind

Classifies the import statement form for a parsed line.

RequireForm

Distinguishes the two syntactic forms of require.

Functions

extract_require_import_symbols

Extract symbols from literal require Module; Module->import(...) patterns found anywhere in source.

parse_module_import_head

Parse the leading import token of a single Perl source line.

resolve_known_export_tag

Resolve a known export tag to its symbol list for a specific module.