Crate perl_ast 

Perl AST library – typed syntax tree for Perl source code.

This crate defines the Abstract Syntax Tree used by perl-parser-core and downstream analysis tools. Every parsed Perl construct is represented as a Node carrying a NodeKind discriminant and a SourceLocation (byte-offset span).

Modules

• ast – The primary AST used by the current recursive-descent parser.
• v2 – Experimental second-generation AST with full position tracking for incremental parsing.

Quick start

use perl_ast::{Node, NodeKind, SourceLocation};

// Build a small AST by hand
let loc = SourceLocation { start: 0, end: 2 };
let num = Node::new(NodeKind::Number { value: "42".to_string() }, loc);

assert_eq!(num.kind.kind_name(), "Number");
assert_eq!(num.location.start, 0);
assert_eq!(num.location.end, 2);

In practice the AST is produced by the parser (requires perl-parser-core):

use perl_parser_core::Parser;
use perl_ast::NodeKind;

let mut parser = Parser::new("my $x = 42;");
let ast = parser.parse().expect("should parse");
assert!(matches!(ast.kind, NodeKind::Program { .. }));

Traversal

Node exposes to_sexp() for a tree-sitter-compatible S-expression and count_nodes() for a quick size metric. For deeper inspection, match on NodeKind variants and recurse into child nodes.

Re-exports

pub use ast::Node;

pub use ast::NodeKind;

pub use perl_ast_v2 as v2;

Modules

ast

Abstract Syntax Tree definitions for Perl within the parsing and LSP workflow.

Type Aliases

SourceLocation

Byte-offset span indicating where a node appears in source text. Type alias for backward compatibility with SourceLocation.