sorttrans-cli(1)

💖 sorttrans-cli — the manual, but make it make sense 💖

okay bestie, so sorttrans-cli lives in section 1 of the General Commands Manual, and it does exactly one iconic thing: it sorts a ledger file in chronological order. that's it. that's the whole vibe. ✨

---

🌸 NAME 🌸

sorttrans-cli — sorts a ledger file in chronological order 🗂️✨

---

🦋 SYNOPSIS 🦋

sorttrans-cli [options]

no positional args, no drama. it's all flags, babes. 💅

---

💜 OPTIONS 💜

• -y — write the file back immediately, no diff, no preview, no "wait let me look at it first". just yeet and go. 😭
• -h, --help — show the help message and dip out. classic. 🫶
• --file FILE — tell it the path to the ledger file you wanna work with. 📁
• --price-db PRICEDB — tell it the path to the ledger price database you wanna work with. 💰
• --debug — turns on debugging output. may be useful for developers 👀 (iykyk, if you're not a dev you probably don't need this one)

---

✨ DESCRIPTION ✨

so sorttrans-cli is a text program, right? and its whole personality is sorting a ledger into chronological order. chronological, as in, time order. the timeline. the correct order. ⏳

here's the tea on how it works: the program loads the ledger file and sorts the transactions in memory. 🧠 then, depending on which command-line options you gave it, it does one of two things:

• it either writes the sorted file back 📝
• or it invokes meld with the original and the sorted version shown side by side, so you can do interactive editing like the little editor gremlin you are 👑🖥️

now listen carefully, bestie, because this part is not optional: the program must be supplied with the location of the ledger file to work with. no file, no sorting. periodt.

if you didn't hand it over with the command-line option --file, then the location of the file gets determined using the following mechanisms, in this order. the first mechanism which yields a result wins. 🏆 (yes, first one to show up takes the crown, the rest don't even get a turn)

---

🌈 ENVIRONMENT 🌈

the following environment variable is recognized by this program:

• LEDGER_FILE — path to ledger file to work with. 🌱

---

🎀 FILES 🎀

the config file for ledger(1) — namely the file .ledgerrc in the user's home directory 🏠 — is scanned, looking for the following option:

• --file FILE — path to ledger file to work with. 📂

---

🔥 SEE ALSO 🔥

ledger(1), meld(1), addtrans(1), cleartrans-cli(1), sellstock-cli(1), withdraw-cli(1). 💫

---

and that's the whole page, babe — this one's from the General Commands Manual, sorttrans-cli(1), dated November 14 2022. go forth and sort chronologically, you absolute main character. 💅💖🦋