hledger-fmt(1)

🌸 NAME 🌸

Okay bestie, this is the hledger-fmt(1) page from the General Commands Manual, and it’s literally about an opinionated hledger's journal files formatter. That’s the whole vibe: hledger journal files go in, formatted journal files come out, and the tool has opinions. 💅

✨ SYNOPSIS ✨

hledger-fmt [--fix] [--no-diff] [--exit-zero-on-changes] [-h|--help]
[-V|--version] [FILES]

💅 DESCRIPTION 💅

An opinionated hledger's journal files formatter. No cap, that’s the description — it formats hledger’s journal files and it is opinionated about it. ✨

🎀 OPTIONS 🎀

Here’s the full menu, bestie — no skips, no summaries, every flag gets its moment:

• --fix — Fix the files in place. WARNING: this is highkey important: this is a potentially destructive operation, make sure to make a backup of your files or print the diff first. If not passed, hledger-fmt will print the diff between the original and the formatted file. 😭
• --no-diff — Don't print diff between original and formatted files, but formatted content instead. So instead of the before/after tea, you get the formatted content. 🫶
• --exit-zero-on-changes — Exit with code 0, even if files have been formatted. It’s giving “no drama, exit code zero” energy. 😌
• -h, --help — Print help. 🆘
• -V, --version — Print version. 🏷️
• [FILES] — Paths of files to format. To read from STDIN pass '-'.

If not defined, hledger-fmt will search for hledger files in the current directory and its subdirectories (those that have the extensions '.journal', '.hledger' or '.j'). If the paths passed are directories, hledger-fmt will search for hledger files in those directories and their subdirectories. 🌸

🌈 EXTRA 🌈

To disable colors in the output, set the environment variable NO_COLOR. That’s it — NO_COLOR is the anti-rainbow switch. 🚫🌈

👑 VERSION 👑

v0.3.9

💖 That’s the tea from the hledger-fmt(1) manual — source/version: hledger-fmt 0.3.9. Stay formatted, bestie! 💅