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.

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

✨ Features

Simple syntax for sectioned key-value configuration
Supports:
- Strings, numbers, booleans
- Arrays
- null values
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.0"

📝 Syntax Overview

> introduces a new section
>> assigns values to keys
Supported value types:
- Strings: "text"
- Numbers: 123, 3.14
- Booleans true, false
- Arrays: [1, 2, 3], ["a", "b"]
- Null: null

🤝 Contributing