55 lines
1.8 KiB
Plaintext
55 lines
1.8 KiB
Plaintext
accounts
|
|
|
|
Show account names.
|
|
|
|
_FLAGS
|
|
|
|
This command lists account names. By default it shows all known
|
|
accounts, either used in transactions or declared with account
|
|
directives.
|
|
|
|
With query arguments, only matched account names and account names
|
|
referenced by matched postings are shown.
|
|
|
|
Or it can show just the used accounts (--used/-u), the declared accounts
|
|
(--declared/-d), the accounts declared but not used (--unused), the
|
|
accounts used but not declared (--undeclared), or the first account
|
|
matched by an account name pattern, if any (--find).
|
|
|
|
It shows a flat list by default. With --tree, it uses indentation to
|
|
show the account hierarchy. In flat mode you can add --drop N to omit
|
|
the first few account name components. Account names can be
|
|
depth-clipped with depth:N or --depth N or -N.
|
|
|
|
With --types, it also shows each account's type, if it's known. (See
|
|
Declaring accounts > Account types.)
|
|
|
|
With --positions, it also shows the file and line number of each
|
|
account's declaration, if any, and the account's overall declaration
|
|
order; these may be useful when troubleshooting account display order.
|
|
|
|
With --directives, it adds the account keyword, showing valid account
|
|
directives which can be pasted into a journal file. This is useful
|
|
together with --undeclared when updating your account declarations to
|
|
satisfy hledger check accounts.
|
|
|
|
The --find flag can be used to look up a single account name, in the
|
|
same way that the aregister command does. It returns the
|
|
alphanumerically-first matched account name, or if none can be found, it
|
|
fails with a non-zero exit code.
|
|
|
|
Examples:
|
|
|
|
$ hledger accounts
|
|
assets:bank:checking
|
|
assets:bank:saving
|
|
assets:cash
|
|
expenses:food
|
|
expenses:supplies
|
|
income:gifts
|
|
income:salary
|
|
liabilities:debts
|
|
|
|
$ hledger accounts --undeclared --directives >> $LEDGER_FILE
|
|
$ hledger check accounts
|