lqf 🪶

lqf is a lightweight configuration format featuring a clean, sectioned syntax centered around the use of the > symbol — designed to be easy to read, easy to write, and dead simple to parse. The official lqf specification can be found in github.com/smit4k/lqf-spec

This Rust crate provides a parser for .lqf files using pest.rs, ready for use in config-heavy projects or DSL exploration.

What does lqf stand for? It stands for Lightweight Quick Format

You can find a full example of an lqf file in example.lqf

✨ Features & Syntax

• Simple syntax for sectioned key-value configuration
  • Section header: >
  • Assignment: >>
• Supports:
  • Strings: "text"
  • Numbers: 123, 3.14
  • Booleans: true, false
  • Arrays: [1, 2, 3], ["a", "b"]
  • Null: null
  • Comments: #
• Built with pest — robust and expressive PEG-based parser

🧪 Example

Given this .lqf file:

> database
host >> "localhost"
port >> 5432

> features
enabled >> ["search", "logging", "metrics"]

You can parse it like this in Rust:

use lqf::parse_lqf;
fn main() {
    let input = r#"
        > database
        host >> "localhost"
        port >> 5432

        > features
        enabled >> ["search", "logging", "metrics"]
    "#;

    let parsed = parse_lqf(input).expect("failed to parse LQF");
    println!("{:#?}", parsed);
}

Output:

{
    "database": {
        "host": String("localhost"),
        "port": Number(5432.0),
    },
    "features": {
        "enabled": Array([
            String("search"),
            String("logging"),
            String("metrics"),
        ])
    }
}

📦 Installation

Add this to your Cargo.toml

[dependencies]
lqf = "0.1.1"

🤝 Contributing

Contributions are welcome! Feel free to open issues, submit pull requests, or discuss ideas.