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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
//! # Rusty PromQL Parser
//!
//! A Rust parser for the Prometheus Query Language (PromQL) using the
//! [nom](https://github.com/rust-bakery/nom) parser combinator library.
//!
//! This crate provides a complete parser for PromQL expressions, producing an
//! Abstract Syntax Tree (AST) that can be used for analysis, transformation,
//! or evaluation.
//!
//! ## Quick Start
//!
//! The main entry point is the [`expr()`] function, which parses a PromQL expression
//! and returns the remaining input along with the parsed AST:
//!
//! ```rust
//! use rusty_promql_parser::expr;
//!
//! let input = r#"http_requests_total{job="api"}"#;
//! let (rest, ast) = expr(input).expect("failed to parse");
//! assert!(rest.is_empty());
//! println!("{:#?}", ast);
//! ```
//!
//! ## Examples
//!
//! ### Parsing a metric with label filtering
//!
//! ```rust
//! use rusty_promql_parser::expr;
//!
//! let input = r#"go_gc_duration_seconds{instance="localhost:9090", job="alertmanager"}"#;
//! let (rest, ast) = expr(input).expect("failed to parse");
//! assert!(rest.is_empty());
//! ```
//!
//! ### Parsing aggregation operators
//!
//! ```rust
//! use rusty_promql_parser::expr;
//!
//! let input = r#"sum by (app, proc) (
//! instance_memory_limit_bytes - instance_memory_usage_bytes
//! ) / 1024 / 1024"#;
//! let (rest, ast) = expr(input).expect("failed to parse");
//! assert!(rest.is_empty());
//! ```
//!
//! ### Parsing rate queries
//!
//! ```rust
//! use rusty_promql_parser::expr;
//!
//! let input = "rate(http_requests_total[5m])";
//! let (rest, ast) = expr(input).expect("failed to parse");
//! assert!(rest.is_empty());
//! ```
//!
//! ## AST Types
//!
//! The parser produces an [`Expr`] enum which can be one of:
//!
//! - [`Expr::Number`] - Numeric literals (`42`, `3.14`, `Inf`, `NaN`)
//! - [`Expr::String`] - String literals (`"hello"`, `'world'`)
//! - [`Expr::VectorSelector`] - Instant vector selectors (`metric{label="value"}`)
//! - [`Expr::MatrixSelector`] - Range vector selectors (`metric[5m]`)
//! - [`Expr::Call`] - Function calls (`rate(...)`, `histogram_quantile(...)`)
//! - [`Expr::Aggregation`] - Aggregation expressions (`sum by (job) (...)`)
//! - [`Expr::Binary`] - Binary operations (`a + b`, `foo and bar`)
//! - [`Expr::Unary`] - Unary operations (`-metric`)
//! - [`Expr::Paren`] - Parenthesized expressions (`(a + b)`)
//! - [`Expr::Subquery`] - Subqueries (`metric[5m:1m]`)
//!
//! ## Modules
//!
//! - [`ast`] - Abstract Syntax Tree type definitions
//! - [`lexer`] - Low-level token parsers (numbers, strings, durations, identifiers)
//! - [`parser`] - Expression and statement parsers
//!
//! ## Display
//!
//! All AST types implement [`std::fmt::Display`], allowing you to convert parsed
//! expressions back to PromQL strings:
//!
//! ```rust
//! use rusty_promql_parser::expr;
//!
//! let (_, ast) = expr("1 + 2 * 3").unwrap();
//! assert_eq!(ast.to_string(), "1 + 2 * 3");
//! ```
// Re-export commonly used types and parsers
pub use ;
pub use number;
pub use ;
pub use expr;
pub use ;