preproc(1)

📦 version 0.5, in epel 9, fedora 43, fedora 44

💖 preproc(1) 💖

okay so bestie, welcome to preproc — she lives in the General Commands Manual section, and she's about to make your text files do tricks. 🎀

✨ NAME ✨

preproc — the name, the moment, the icon. 👑

🌸 SYNOPSIS 🌸

preproc [-h] [--no-break-on-failure] [--debug] [-e <varname>=<value>]
[-s PATH] [-C path]

🦋 DESCRIPTION 🦋

So. preproc is a simple text preprocessor that implements a very basic templating language. That's it, that's the whole vibe. 💅

Here's the tea: you can drop {{{ <bash_code> }}} tags into a text file, then pipe that file's content into preproc. And preproc will replace each of those tags with the stdout of <bash_code> and print the final renderred result to its own stdout. Slay. ✨

okay but for real, read this twice: NOTE: you need to trust the input files that you pass to preproc. Running preproc on an unknown file is equivalent of running an unknown script on your computer. 😭 like, literally the same energy. no cap. be careful who you let in, bestie. 🫶

💜 OPTIONS 💜

  • --no-break-on-failure — normally preproc will immediately stop processing as soon as an error is encountered. This switch changes the behavior. so instead of ghosting you at the first problem, she keeps going. 🙈
  • --debug — print each encountered tag and its env during input processing. it's giving behind-the-scenes commentary, iykyk. 🔍
  • -e <varname>=<value>, --env <varname>=<value> — set a variable into macro processing environment, e.g. -e VAR=VALUE. drop it in, she'll remember it. 💖
  • -s PATH, --source PATH — sources given file into macro processing environment. May be used multiple times. so like, stack them up, the more the merrier. 🌈
  • -C path — directory to operate in. where she does her little work. 🎀

🌟 AUTHORS 🌟

preproc was written by clime <clime@fedoraproject.org>. absolute main character energy from clime, honestly. 👑

🍓 DISTRIBUTION 🍓

The latest version of preproc may be downloaded from https://pagure.io/rpkg-util/blob/master/f/preproc

go get her, she's waiting. 🧚

okay that's the whole page bestie, love that for us. 💖 this was the Manual for preproc(1) — periodt. ✨🎀🦋

📦 where this page comes from