Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Comparison

Ledger and Hledger’s transactions are a (balanced) group of account postings. Transity’s transactions are a group of transfers between two accounts.

Syntax

Checkout the files hledger.journal and journal.yaml for similar transactions modeled in Hledger and in Transity.

There is a lot of ambiguity in the ledger journal format. Are you able to tell the difference between the 2 options?

2019-01-17 Bought food
  expenses:food  $10
  assets:cash

vs

2019-01-17 Bought food
  assets:cash
  expenses:food  $10

Also, it lacks some fields for more precise recording of which parties where involved.

  • What food?
  • Where did you buy it?
  • When exactly did you buy it?
  • Which supermarket?
2019-01-17 Bought food
  expenses:food  $10
  assets:cash

Example

A Transity entry as a transaction made of up four transfers:

utc: '2024-04-16 18:50:28'
tags: [domain]
note: 1 year registration of domain "ad-si.com"
transfers:
  - from: adrian:hypo:giro
    to: paypal
    amount: 9.94 €
    transaction-id: '24360863'

  - from: paypal
    to: namecheap
    amount: 10.87 $

  - from: namecheap
    to: icann
    amount: 0.18 $
    tag: [fee]

  - from: namecheap
    to: feram
    amount: 1 domain-year
    note: ad-si.com

Possible Translations to Hledger:

Version A:

2024-04-16 1 year registration of domain "ad-si.com"  ; domain:
  adrian:hypo:giro  -9.94 €
  paypal             9.94 €        ; transaction-id: 24360863
  paypal           -10.87 $
  namecheap         10.87 $
  namecheap        -0.18 $
  icann             0.18 $         ; fee:
  namecheap        -1 domain-year
  feram             1 domain-year  ; note: ad-si.com

Version B:

2024-04-16 1 year registration of domain "ad-si.com"  ; domain:, transaction-id: 24360863
  adrian:hypo:giro
  paypal             9.94 €

2024-04-16 1 year registration of domain "ad-si.com"  ; domain:
  paypal
  namecheap         10.87 $

2024-04-16 1 year registration of domain "ad-si.com"  ; domain:, fee:
  namecheap
  icann             0.18 $

2024-04-16 1 year registration of domain "ad-si.com"  ; domain:, note: ad-si.com
  namecheap
  feram             1 domain-year

Reporting

hledger --file examples/hledger.journal balance
# vs
transity balance examples/journal.yaml

hledger --file examples/hledger.journal register
# vs
transity transactions examples/journal.yaml

hledger --file examples/hledger.journal register --output-format=csv
# vs
transity entries examples/journal.yaml

Features

Several features are missing in Ledger and Hledger: