BAM(1)

✨ BAM(1) ✨

okay bestie, gather round, because this one is a whole build system and she is fast, she is flexible, and she is about to become your entire personality 💅

---

🌸 NAME 🌸

bam — the fast and flexible build system. no cap, she does builds and she does them quick 🦋

---

🎀 DESCRIPTION 🎀

here's the vibe check, the sacred invocation, the little spell you type into your terminal:

usage: bam [<options>] [<variables>=<values>] [<targets>]

so like. you can give her options, you can pass her <variables>=<values> pairs, and you can hand her <targets> to build. all of it optional, all of it iconic 👑

---

🛠️ Execution 🛠️

these are the ones that actually do the thing, bestie. main character energy fr fr.

• -a — abort the build on the first error. like, she's not gonna sit there and watch everything fall apart, she's gonna stop the second something goes wrong 🛑
• -e — executes the specified lua file and then exits. one and done, in and out, no notes ✨
• -c — clean targets 🧹
• -f — force build. no asking, just building 💪
• -d — build the targets that are dependent on the given targets
• --dry — dry run, meaning she doesn't actually run any jobs. it's giving dress rehearsal 🎭
• -j — sets the number of threads to use (default: auto, and -v will show it to you) 🔥
• -s — the script file to use (default: bam.lua) 📜

🌙 Lua 🌙

for when you want to peek behind the curtain, iykyk.

• -l — print local variables in the backtrace 🔍
• -t — print the backtrace when an error occurs. so when it goes wrong you get the receipts 😭

📢 Output 📢

• -r — build progress report format (default: s). the options are:
  • b = progress bar
  • c = use ansi colors 🌈
  • s = build steps
• -v — be verbose. tell me everything, queen, i'm listening 🗣️

🍓 Other 🍓

• -n — don't use cache. fresh start, clean slate, no memories 🫶
• -g — ignore script timestamp ⏰
• -h, --help — prints this help
• --help-debug — prints debugging options

---

also, just so you know exactly which queen you're dealing with: this is bam version 0.5.1 using Lua 5.3.3 👑

---

and that's the whole page bestie — no skips, no summarising, we keep every single detail around here. this little love letter to bam came out in October 2018, from the User Commands section of the manual, and yes she's still slaying 💖 mwah, go build something 🌟