Skip to content

simonmichael/hledger_finance

Repository files navigation

hledger finance repo

In this repo we keep a ledger and reports of the hledger project's finances, for clarity and dogfooding.
See also the hledger.org Project finances page.

In this directory:

  • Justfile - maintenance and reporting scripts. Run just to see help.
  • hledger.conf - local hledger config
  • main.journal - top-level journal file
  • accounts.journal - account declarations
  • oc.csv - all hledger open collective transactions, exported as CSV
  • oc.csv.rules - hledger CSV rules for converting the above to..
  • oc.journal - journal file generated from oc.csv
  • other.journal - other transactions, manually recorded
  • README.md - this readme. Hand-maintained content plus hledger-generated reports.

Reports update process:

  • View latest Open Collective transactions
  • Check parameters 1
    • all should be set to All
  • Click Download CSV
  • Check parameters 2
    • Date range should be sufficient to leave no gap
    • Timezone should be what rules require: Local (consider switching to UTC for greater stability)
    • Start date / End date should be sufficient to leave no gap (Why both these and Date range ? Try ignoring these)
    • Exported Fields should be Platform Default
    • Separate transactions compatibility should be ENABLED
  • Click Export CSV
  • Wait for and check for a successful complete download by browser. Warning this is deceptive.
  • Manually close the Export CSV dialog
  • In finance dir, just update (gather csv, regenerate journal and reports)
  • Deal with any snafu (missing python deps..)
  • Review diffs in magit, investigate/resolve any problems
  • Review reports in VSC markdown preview, check that these match:
  • Commit
  • git push to update https://github.com/simonmichael/hledger_finance

Reports

Revenues & Expenses This Year

Commodity2025-01-01..2025-02-01
Revenues
donationsUSD178.00
  GuestUSD52.00
  incognitoUSD50.00
  Joyful SystemsUSD20.00
  October SwimmerUSD20.00
  Jack TodaroUSD10.00
  Brandon BarkerUSD4.00
  FrankUSD4.00
  James BlachlyUSD4.00
  Ken EwingUSD4.00
  Rishi HyankiUSD4.00
  Samim PezeshkiUSD4.00
  Richard KellyUSD2.00
Total:USD178.00
 
Expenses
feesUSD31.87
  Open Source CollectiveUSD17.80
  STRIPEUSD9.50
  PAYPALUSD4.57
Total:USD31.87
 
Net:USD146.13

Revenues & Expenses by Year

accountrevenues:donationsexpenses:bountiesexpenses:feesexpenses:miscTotal:
commodityUSDUSDUSDUSDUSD
2017120.000-19.080100.92
2018225.000-34.930190.07
2019105.000-23.33081.67
20201254.380-189.8101064.57
20214721.00-760.01-708.3403252.65
20223744.00-400.00-592.10-578.122173.78
20231868.00-862.00-303.93-100.00602.07
20241277.00-1198.14-171.890-93.03
2025178.000-31.870146.13
total13492.38-3220.15-2075.28-678.127518.83

Assets & Liabilities By Year

accountassets:opencollectiveTotal:
commodityUSDUSD
2017100.92100.92
2018290.99290.99
2019372.66372.66
20201437.231437.23
20214689.884689.88
20226863.666863.66
20237465.737465.73
20247372.707372.70
20257518.837518.83