;doc:bin: ft/tt updates

This commit is contained in:
Simon Michael 2023-07-06 08:15:13 -10:00
parent 8088fa714e
commit 27e5739de5
2 changed files with 64 additions and 4 deletions

View File

@ -63,14 +63,75 @@ $ fin # list the scripts available
### ft
[`ft`](https://github.com/simonmichael/hledger/blob/master/bin/ft)
is a way to organise small finance-related reports and scripts using standard bash.
(I alias this to `f`.)
is a way to organise your finance-related reports and scripts using standard bash.
```shell
$ alias f=~/src/hledger/bin/ft
$ f
--------------------------------------------------------------------------------"; }
ft - finance tool: run financial reports and finance-related scripts
Usage: ft [COMMAND [ARGS]]
Commands:
help show this help
get-csv download auto-downloadable CSVs (paypal)
import-dry import new downloaded transactions to the journal, dry run
import import new downloaded transactions to the journal, logging and not printing errors
get-rewards show ada staking rewards pages at pooltool for manual download
import-rewards-dry import new ada rewards transactions, dry run
import-rewards import new ada rewards transactions
rewards show ada staking rewards pages, wait for download, then import
get-prices [PRICEHISTFETCHOPTS] - download prices for main commodities (default: today's)
bs show balance sheet
is show income statement
a show assets
r show revenues
x show expenses
ab show assets bar chart
rb show revenues bar chart
xb show expenses bar chart
al show assets line chart
rl show revenues line chart
xl show expenses line chart
forecast print transactions predicted by forecast rules from last week on
household show a draft month-end household adjustment transaction for last month
consulting show consulting revenue
bin [PAT] show all scripts in $DIR/bin/[bashrc] (default: ~/finance/)
OTHERCMD [ARGS] run other hledger commands on the default journal
Add hledger options to customise reports.
```
### tt
[`tt`](https://github.com/simonmichael/hledger/blob/master/bin/ft)
is a similar bash multi-script for time reports.
(I alias this to `t`.)
```shell
$ alias t=~/src/hledger/bin/tt
$ t
--------------------------------------------------------------------------------
tt - time tool: run time reports and time-related scripts
Usage: tt [COMMAND [ARGS]]
Commands:
help show this help
dash show time dashboard, redisplaying when timelog files change
status show current time status
what what happened ? Show largest balances first, today and depth 1 by default
dots print line of N dots, grouped in 4s (suitable for timedot)
x horizontal time summary this year, monthly by default
y vertical time summary this year, monthly by default
rweeks recent weeks' time budgets
weeks this and last week's time budgets
unused unused & undeclared account names
unusedcat unused & undeclared account names by category
budgets show monthly time budget performance this year
budgetsy show monthly time budget performance this year, vertically
budgetsw show weekly time budget performance this year
budgetswx show weekly time budget performance this year, horizontally
addacc add declarations for all undeclared accounts
hours show a bar chart of daily hours
OTHERCMD [ARGS] run other hledger commands on $TIMELOG
```
### watchaccounts

1
bin/tt
View File

@ -18,7 +18,6 @@ sed=$(if [ "$(builtin type -p gsed)" ]; then echo gsed; else echo sed; fi)
stat=$(if [ "$(builtin type -p gstat)" ]; then echo gstat; else echo stat; fi)
help() { # show this help
line
cat <<EOF
--------------------------------------------------------------------------------
tt - time tool: run time reports and time-related scripts