9 releases

0.4.0 May 20, 2024
0.3.1 Nov 10, 2023
0.3.0 Aug 12, 2023
0.2.0 Jul 21, 2023
0.1.0 Feb 14, 2023

#2 in #query-parser

Download history 678/week @ 2024-03-16 561/week @ 2024-03-23 767/week @ 2024-03-30 611/week @ 2024-04-06 781/week @ 2024-04-13 703/week @ 2024-04-20 582/week @ 2024-04-27 1280/week @ 2024-05-04 1639/week @ 2024-05-11 1717/week @ 2024-05-18 1882/week @ 2024-05-25 1996/week @ 2024-06-01 1471/week @ 2024-06-08 1743/week @ 2024-06-15 2559/week @ 2024-06-22 885/week @ 2024-06-29

6,915 downloads per month



License Build Status Version codecov

PromQL Lexer and Parser

The goal of this project is to build a PromQL lexer and parser capable of parsing PromQL that conforms with Prometheus Query.


To parse a simple instant vector selector expression:

use promql_parser::parser;

let promql = r#"
    } offset 5m

match parser::parse(promql) {
    Ok(expr) => {
        println!("Prettify:\n\n{}", expr.prettify());
    Err(info) => println!("Err: {info:?}"),

or you can directly run examples under this repo:

cargo run --example parser

This outputs:

http_requests_total{environment=~"staging|testing|development",method!="GET"} offset 5m

VectorSelector(VectorSelector { name: Some("http_requests_total"), matchers: Matchers { matchers: [Matcher { op: Re(staging|testing|development), name: "environment", value: "staging|testing|development" }, Matcher { op: NotEqual, name: "method", value: "GET" }] }, offset: Some(Pos(300s)), at: None })

PromQL compliance

This crate declares compatible with prometheus v2.45.0, which is released at 2023-06-23. Any revision on PromQL after this commit is not guaranteed.

Community Extensions

There are a number of community projects that extend promql-parser or provide integrations with other systems.

Language Bindings

Known Uses

Here are some of the projects known to use promql-parser:

  • GreptimeDB Open Source & Cloud Native Distributed Time Series Database

If your project is using promql-parser, feel free to make a PR to add it to this list.


Contributions are highly encouraged!

Pull requests that add support for or fix a bug in a feature in the PromQL will likely be accepted after review.


All code in this repository is licensed under the Apache License 2.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.


~163K SLoC