Struct Parse 

pub struct Parse<T> { /* private fields */ }

The result of parsing: a syntax tree and a collection of errors.

This type is designed to be stored in Salsa databases as it contains the thread-safe GreenNode instead of the non-thread-safe SyntaxNode.

Implementations

impl Parse<Makefile>

pub fn apply_edit(&self, old_text: &str, edit: &TextEdit) -> (Self, String)

Apply an incremental text edit and reparse only the affected region.

This is more efficient than a full reparse for large files, as it reuses the green tree nodes for unaffected top-level items.

Arguments

• old_text - The full text before the edit
• edit - The edit to apply

Returns

A new Parse<Makefile> with the edit applied, and the new full text.

Example

use makefile_lossless::{Makefile, Parse, TextEdit, TextRange};

let old_text = "VAR1 = old\nVAR2 = value\n";
let parse = Parse::<Makefile>::parse_makefile(old_text);

// Change "old" to "new" in VAR1
let edit = TextEdit::new(
    TextRange::new(7.into(), 10.into()),
    "new".to_string(),
);
let (new_parse, new_text) = parse.apply_edit(old_text, &edit);
assert_eq!(new_text, "VAR1 = new\nVAR2 = value\n");

let makefile: Makefile = new_parse.tree();
let vars: Vec<_> = makefile.variable_definitions().collect();
assert_eq!(vars.len(), 2);
assert_eq!(vars[0].raw_value(), Some("new".to_string()));
assert_eq!(vars[1].raw_value(), Some("value".to_string()));

impl<T> Parse<T>

pub fn new( green: GreenNode, errors: Vec<ErrorInfo>, positioned_errors: Vec<PositionedParseError>, ) -> Self

Create a new Parse result from a GreenNode, errors, and positioned errors

pub fn green(&self) -> &GreenNode

Get the green node (thread-safe representation)

pub fn errors(&self) -> &[ErrorInfo]

Get the syntax errors

pub fn positioned_errors(&self) -> &[PositionedParseError]

Get parse errors with position information

pub fn ok(&self) -> bool

Check if there are any errors

pub fn to_result(self) -> Result<T, Error>

where T: AstNode<Language = Lang>,

Convert to a Result, returning the tree if there are no errors

pub fn tree(&self) -> T

where T: AstNode<Language = Lang>,

Get the parsed syntax tree

Returns the tree even if there are parse errors. Use errors(), positioned_errors(), or ok() to check for errors separately if needed. This allows for error-resilient tooling that can work with partial/invalid input.

pub fn syntax_node(&self) -> SyntaxNode<Lang>

Get the syntax node

impl Parse<Makefile>

pub fn parse_makefile(text: &str) -> Self

Parse makefile text, returning a Parse result

impl Parse<Rule>

pub fn parse_rule(text: &str) -> Self

Parse rule text, returning a Parse result

pub fn to_rule_result(self) -> Result<Rule, Error>

Convert to a Result, extracting a single rule from the makefile

Trait Implementations

impl<T: Clone> Clone for Parse<T>

fn clone(&self) -> Parse<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Parse<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Parse<T>

fn eq(&self, other: &Parse<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Eq> Eq for Parse<T>

impl<T> Send for Parse<T>

impl<T> StructuralPartialEq for Parse<T>

impl<T> Sync for Parse<T>