yumly 0.9.0

A cute, declarative config language with fail-fast behavior and optional type safety.

✧･ﾟ Yumly ･ﾟ✧

⚠️ Warning — subject to changes.

Yumly is a cute, declarative configuration language with fail-fast behavior and optional type safety, blending elements from many configuration formats and some ideas from my head.

⟡ Hey! New here? Check my Documentation Home for a starter guide!

---

✿ What's in Yumly?

• No indentation — blocks delimited by { } allowing flexible organization
• Optional type hints — you can declare intent UwU
• Fail-fast — syntax and validation errors are raised immediately with cute cute messages
• No overwriting — duplicate keys and bindings are not allowed.
• Native env vars — $["VAR"] and include { ".env" } are first class ;)
• Readable — it's easy to read and understand ^_^
• Extensions .yumly and .yuy (it's so cute!!)

Why i created Yumly

1. I created Yumly for fun — I had never built a parser before. I wanted something simple and special to use in my own projects.
2. Yumly mixes ideas from many formats, but initially YAML and JSON, but tries to be more explicit, safe.
3. I know the “cuteness” and personality won’t be for everyone — and that’s okay.
4. I also wanted to learn Nim and avoid going down the “Holy C” path.

✿ Syntax & Features

For the complete syntax, see:

• Grammar Overview — detailed guide
• EBNF Grammar — formal specification
• Yumyumy ♡ Format — internal AST representation
• Ylwa Format — benchmark and log format

✿ Quick Start

Python

pip install yumly

from yumly import Yumly
data = Yumly().load("config.yumly")

Hey!, check out the Python Usage Guide for more.

Nim

git clone https://github.com/Creeper011/Yumly
cd Yumly/
nimble install --path:. # not published on Nimble yet

import Yumly
let config = loadYumly("config.yumly")

Hey!, check out the Nim Usage Guide for more.

Nix / NixOS (For the Yumly CLI ✨)

nix profile add github:Creeper011/Yumly

✿ Development & Tools

• CLI ✨: Check the Yumly CLI ✨ documentation in docs/usage/yumly_cli.md
• Playground 🛝: Explore PoCs and interactive notebooks in The Playground
• VSCode: Check the extension folder for installation.
• Tests: Detailed in Test System.

✿ Additional Information:

• This is a super personal project with open code. Contributions are welcome, but theres no guarantee of support or roadmap. use it, enjoy it, and if something breaks, open an issue ♡

★ License ★

MIT — see LICENSE.