sellstock-cli(1)

πŸ’– sellstock-cli πŸ’–

okay bestie, welcome to sellstock-cli from the General Commands Manual β€” she's the one who records FIFO stock or commodity sales, and she is lowkey a queen for it πŸ‘‘


✨ NAME ✨

sellstock-cli β€” record FIFO stock or commodity sales πŸ’…


🌸 SYNOPSIS 🌸

sellstock-cli

no args, no flags, she just is πŸ¦‹


πŸ’œ DESCRIPTION πŸ’œ

so sellstock-cli is a text program for quickly recording commodity sales in a ledger file. that's the whole vibe. fast little data entry bestie πŸŽ€

here's the little journey she takes you on:

  • first, the program prompts you for the account in which the commodity was stored, the account for commissions, and the account to credit for gains and losses β€” plus the amount and name of the sold commodity, its sale price, and the commission. yes that's a lot of prompts, she's thorough, she's an overachiever, we love her for it ✨
  • then, the program invokes ledger to list the dates and prices at which each commodity was purchased, lists them, subtracts the requested amount, and shows the result. math? done. by someone else. iconic πŸ”₯
  • finally, the resulting transaction is shown, asking for a confirmation to save it to the journal. your finger, the enter key, the moment of commitment 🫢
⚠️ important bestie: the program must be supplied with the location of the ledger file to work with. like, no ledger file, no sale, no nothing.

the location of the file is determined using the following mechanisms, in this order. the first mechanism which yields a result, wins. first come first served, periodt πŸ’…


🌈 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 πŸ‘‘

the whole little friend group, go say hi πŸ’–


and that's the page, bestie!! this manual came from the General Commands Manual, version sellstock-cli(1), dated November 14 2022 β€” yes she's been slaying since 2022 and she's not stopping πŸŒΈπŸ’…βœ¨ go record those FIFO sales, you've got this πŸ¦‹
πŸ“¦ where this page comes from