BEAN-QUERY(1)

💖 NAME 💖

bean-query — bestie, it's an interactive shell for the Beancount Query Language ✨ (yes, this is section 1, the User Commands manual, we're fancy like that 💅)

---

✨ DESCRIPTION ✨

okay so picture this: you've got a Beancount file, and you wanna talk to it. That's her. She's an interactive command-line shell interpreter for the Beancount Query Language, and she eats. 🍓

Here's how you call her:

bean-query [-h] [--version] [-f {text,csv}] [-m] [-o OUTPUT] [-q]

       FILENAME.beancount [query ...]

No cap, that's the whole vibe. Now let's break down every single piece because we do not skip details in this house 🫶

🌸 positional arguments 🌸

• FILENAME.beancount — the Beancount input filename to load. this is the snack she's gonna read, you gotta hand it over first, no skipping 🙈
• query — a query to run directly. like, right there, immediately, no small talk. just query and go 💨

🎀 options 🎀

• -h, --help — shows this help message and then dips out (exit). iconic behaviour honestly 👑
• --version, -V — shows the program's version number and exits. she'll tell you exactly who she is, then leave. main character energy fr fr 💅
• -f {text,csv}, --format {text,csv} — output format. pick your aesthetic: text or csv, that's the menu 🌈
• -m, --numberify — numberify the output, removing the currencies. all the digits, none of the currency labels. just the numbers, raw, unbothered ✨
• -o OUTPUT, --output OUTPUT — output filename. if you don't specify one, the output goes to stdout (aka straight to your terminal, as nature intended 💖). and here's the cute part: the filename gets inspected to select a sensible default format, if one is not requested. so she's reading the vibe of your filename and matching it, periodt 🔥
• -q, --no-errors — do not report errors. the errors stay silent. she simply will not be discussing it 🤐

lowkey important: these option descriptions are exactly what the original says, so don't go reading extra behaviour into -q — it just means errors aren't reported. that's it, that's the tea 🫖

---

and that's the whole page, bestie!! go query something, you're gonna slay 💜

🌸✨ this has been bean-query 2.3.6, from April 2024 — mwah, bye 🎀🦋