perl-incremental-parsing 0.12.2

Incremental parsing support for Perl with subtree reuse and LSP integration
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! Incremental parsing support for Perl.
//!
//! This crate provides efficient incremental parsing capabilities for Perl code,
//! enabling Language Server Protocol features to respond quickly to document edits
//! by reusing portions of the previous parse tree.
//!
//! # Overview
//!
//! The incremental parser minimizes re-parsing overhead when documents change by:
//! - Identifying which portions of the AST are affected by an edit
//! - Reusing unaffected subtrees from the previous parse
//! - Only re-parsing the modified regions and their dependent nodes
//!
//! # Usage
//!
//! ```no_run
//! use perl_incremental_parsing::incremental;
//! use perl_parser_core::Parser;
//!
//! // Initial parse
//! let source = "sub foo { return 42; }";
//! let mut parser = Parser::new(source);
//! let ast = parser.parse();
//!
//! // After edit, incrementally reparse only affected portions
//! // (specific APIs depend on incremental module implementation)
//! ```

#![deny(unsafe_code)]
#![deny(unreachable_pub)]
#![cfg_attr(test, allow(clippy::panic, clippy::unwrap_used, clippy::expect_used))]
#![warn(rust_2018_idioms)]
#![warn(missing_docs)]
#![warn(clippy::all)]
#![allow(
    clippy::too_many_lines,
    clippy::module_name_repetitions,
    clippy::cast_possible_truncation,
    clippy::cast_sign_loss,
    clippy::cast_precision_loss,
    clippy::cast_possible_wrap,
    clippy::must_use_candidate,
    clippy::missing_errors_doc,
    clippy::missing_panics_doc,
    clippy::wildcard_imports,
    clippy::enum_glob_use,
    clippy::match_same_arms,
    clippy::if_not_else,
    clippy::struct_excessive_bools,
    clippy::items_after_statements,
    clippy::return_self_not_must_use,
    clippy::unused_self,
    clippy::collapsible_match,
    clippy::collapsible_if,
    clippy::only_used_in_recursion,
    clippy::items_after_test_module,
    clippy::while_let_loop,
    clippy::single_range_in_vec_init,
    clippy::arc_with_non_send_sync,
    clippy::needless_range_loop,
    clippy::result_large_err,
    clippy::if_same_then_else,
    clippy::should_implement_trait,
    clippy::manual_flatten,
    clippy::needless_raw_string_hashes,
    clippy::single_char_pattern,
    clippy::uninlined_format_args
)]

pub use perl_edit as edit;
pub use perl_parser_core::{Node, NodeKind, SourceLocation};
pub use perl_parser_core::{Parser, ast, error, parser, position};

/// Incremental parsing implementation and helpers.
pub mod incremental;
pub use incremental::*;