KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

promformat

★ 38 Open GitHub ↗

PromQL formatter

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Promformat

Promformat is a PromQL formatter written in Python. It works by building an AST from the CST provided by ANTLR4, and then using that to produce formatted code.

The result should be semantically identical to the unformatted version as promval compares the parse tree of the original and formatted expression and fails if they are not identical.

# Usage

From command line:
```text
# Format a file containing PromQL
promformat <path to file>

# No arguments enters interpreter
promformat
```

As library:
```text
from promformat import format_query
print(format_query("1+1"))
```

# Example

Given the PromQL:

```
job:request_latency_seconds:mean5m{job="myjob"} > 0.5
```

it will be formatted:

```
job:request_latency_seconds:mean5m
{
  job="myjob"
} > 0.5
```

A more complex example:

```text
(
  node_filesystem_avail_bytes * 100
) / node_filesystem_size_bytes < 10 and ON
(
  instance,
  device,
  mountpoint
)
predict_linear
(
  node_filesystem_avail_bytes
  {
    # We don't care about tmpfs
    fstype!~"tmpfs"
  } [1h],
  24 * 3600
) < 0 and ON
(
  instance,
  device,
  mountpoint
)
node_filesystem_readonly == 0
```

promformat

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README