KPEG(1)

📦
version 1.3.3 · 3 versions
, in ubuntu resolute, ubuntu stonking

✨ KPEG — the manual page, but make it a group chat 💅

okay bestie, buckle up, we're talking about kpeg from the User command section, and honestly? it's giving parser-generator royalty 👑

🌸 NAME 🌸

kpeg — a ruby parser generator that builds your parser straight out of a PEG grammar. no cap. 🦋

🎀 SYNOPSIS 🎀

 kpeg [ options ]

that's it, that's the whole vibe. you just run it with whatever options you want and let it cook 🔥

💖 DESCRIPTION 💖

so like, here's the tea 🍓: kpeg generates a ruby parser from a PEG (parsing expression grammar) file. you write the grammar, it hands you back a parser. iconic behaviour, truly. ✨

the grammar syntax is described on the kpeg home page, which lives right here:

<https://github.com/evanphx/kpeg>

literally go read it, iykyk 📚

✨ OPTIONS ✨

okay this is the part where we get into the flags, and there are exactly eight of them, so let's go one by one like the organized queen you are 👑

  • -t, --test — just syntax check the file, nothing else. it's the "am i doing this right?" button 🙈
  • --reformat — reformat your grammar and write it right back out. glow-up for your grammar file 💅
  • -o, --output FILE — tells it where the output should go. FILE is your destination, bestie 📍
  • -n, --name NAME — the class name to use for the parser. NAME it and claim it 🎀
  • -f, --force — overwrite the output if it already exists. consent matters, so this is the explicit yes ✅
  • -s, --stand-alone — write the parser so it can run standalone. independent main character energy fr fr 👑
  • -v, --[no-]verbose — run verbosely. yes, the [no-] is real — you can turn it off too. talkative or mysterious, your call 🗣️
  • -d, --debug — debug the parsing of the file. for when it's not giving what it's supposed to give 😭
heads up bestie: -f, --force is the one that overwrites things. if your output file already exists and you didn't pass it, that's a whole situation. be careful out there 🫶

🌈 AUTHOR 🌈

this manual page was written by Dominique Dumont <dod@debian.org>, for the Debian GNU/Linux system (but may be used by others). absolute legend, we stan 🌟

🦋 SEE ALSO 🦋

and that's the whole page, babe 🧚 this was kpeg, dated 2024-09-24, and it's a KPEG(1) situation — so go forth, write your grammar, and generate something beautiful. periodt. 💖✨🎀

📦 where this page comes from