Register report

Documentation about the centjes register command, for printing a register overview

currency USD 0.01

account assets:cash
account equity:opening-balances
account expenses:coffee

2025-01-28
  | Opening balances
  * assets:cash             +10 USD
  * equity:opening-balances -10 USD

2025-01-29
  | Coffee
  * assets:cash     -5 USD
  * expenses:coffee +5 USD

Timestamp  Description      Account                 Amount     Running    
2025-01-28 Opening balances assets:cash              10.00 USD  10.00  USD
                            equity:opening-balances -10.00 USD            
2025-01-29 Coffee           assets:cash              -5.00 USD  -5.00  USD
                            expenses:coffee           5.00 USD            

Reference

Options

centjes register [--convert CURRENCY] [--individually | --daily | --weekly | --monthly | --quarterly | --yearly | [--block BLOCK_SIZE]] [--virtual] [--year YEAR | --this-year | --last-year] [FILTER [FILTER]]

  --convert      Currency to convert to                                             
  --individually All transactions in one block                                      
  --daily        Group transactions by day                                          
  --weekly       Group transactions by week                                         
  --monthly      Group transactions by month                                        
  --quarterly    Group transactions by quarter                                      
  --yearly       Group transactions by year                                         
  --block        Group transactions                     default: BlockSizeIndividual
  --virtual      Show virtual postings too              default: False              
  --year         Balance at the end of the given year                               
  --this-year    Balance at the end of the current year                             
  --last-year    Balance at the end of last year                                    
  FILTER         filter                                                             
  FILTER         filter                                                             

Environment variables

  CENTJES_YEAR YEAR   Balance at the end of the given year

Configuration values

  Currency to convert to
  register.convert:
    # or null
    <string>
  Group transactions
  default: BlockSizeIndividual
  register.block:
    # or null
    <string>
  Show virtual postings too
  default: False
  register.virtual:
    # or null
    <boolean>
  Balance at the end of the given year
  register.year:
    # or null
    <integer>
  filter
  register.filter:
    # or null
    def: Filter
    # any of
    [ <string>
    , - ref: Filter
    ]

Combined settings

Usage: centjes register [--convert CURRENCY] [--individually | --daily | --weekly | --monthly | --quarterly | --yearly | [--block BLOCK_SIZE]] [--virtual] [--year YEAR | --this-year | --last-year] [FILTER [FILTER]]

register report

Available settings:
  Show this help text
  switch: -h|--help

  Currency to convert to
  option: --convert CURRENCY
  config:
    register.convert: # or null
      <string>

  All transactions in one block
  switch: --individually

  Group transactions by day
  switch: --daily

  Group transactions by week
  switch: --weekly

  Group transactions by month
  switch: --monthly

  Group transactions by quarter
  switch: --quarterly

  Group transactions by year
  switch: --yearly

  Group transactions
  option: --block BLOCK_SIZE
  config:
    register.block: # or null
      <string>
  default: BlockSizeIndividual

  Show virtual postings too
  switch: --virtual
  config:
    register.virtual: # or null
      <boolean>
  default: False

  Balance at the end of the given year
  option: --year YEAR
  env: CENTJES_YEAR YEAR
  config:
    register.year: # or null
      <integer>

  Balance at the end of the current year
  switch: --this-year

  Balance at the end of last year
  switch: --last-year

  filter
  argument: FILTER

  filter
  argument: FILTER

  filter
  config:
    register.filter: # or null
      def: Filter
      # any of
      [ <string>
      , - ref: Filter
      ]