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. Runjust
to see help.hledger.conf
- local hledger configmain.journal
- top-level journal fileaccounts.journal
- account declarationsoc.csv
- all hledger open collective transactions, exported as CSVoc.csv.rules
- hledger CSV rules for converting the above to..oc.journal
- journal file generated from oc.csvother.journal
- other transactions, manually recordedREADME.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:
- Assets report > latest asset balance
- https://opencollective.com/hledger#category-BUDGET > TODAY'S BALANCE
- Commit
git push
to update https://github.com/simonmichael/hledger_finance
Commodity | 2025-01-01..2025-02-01 | |
---|---|---|
Revenues | ||
donations | USD | 178.00 |
Guest | USD | 52.00 |
incognito | USD | 50.00 |
Joyful Systems | USD | 20.00 |
October Swimmer | USD | 20.00 |
Jack Todaro | USD | 10.00 |
Brandon Barker | USD | 4.00 |
Frank | USD | 4.00 |
James Blachly | USD | 4.00 |
Ken Ewing | USD | 4.00 |
Rishi Hyanki | USD | 4.00 |
Samim Pezeshki | USD | 4.00 |
Richard Kelly | USD | 2.00 |
Total: | USD | 178.00 |
Expenses | ||
fees | USD | 31.87 |
Open Source Collective | USD | 17.80 |
STRIPE | USD | 9.50 |
PAYPAL | USD | 4.57 |
Total: | USD | 31.87 |
Net: | USD | 146.13 |
account | revenues:donations | expenses:bounties | expenses:fees | expenses:misc | Total: |
---|---|---|---|---|---|
commodity | USD | USD | USD | USD | USD |
2017 | 120.00 | 0 | -19.08 | 0 | 100.92 |
2018 | 225.00 | 0 | -34.93 | 0 | 190.07 |
2019 | 105.00 | 0 | -23.33 | 0 | 81.67 |
2020 | 1254.38 | 0 | -189.81 | 0 | 1064.57 |
2021 | 4721.00 | -760.01 | -708.34 | 0 | 3252.65 |
2022 | 3744.00 | -400.00 | -592.10 | -578.12 | 2173.78 |
2023 | 1868.00 | -862.00 | -303.93 | -100.00 | 602.07 |
2024 | 1277.00 | -1198.14 | -171.89 | 0 | -93.03 |
2025 | 178.00 | 0 | -31.87 | 0 | 146.13 |
total | 13492.38 | -3220.15 | -2075.28 | -678.12 | 7518.83 |
account | assets:opencollective | Total: |
---|---|---|
commodity | USD | USD |
2017 | 100.92 | 100.92 |
2018 | 290.99 | 290.99 |
2019 | 372.66 | 372.66 |
2020 | 1437.23 | 1437.23 |
2021 | 4689.88 | 4689.88 |
2022 | 6863.66 | 6863.66 |
2023 | 7465.73 | 7465.73 |
2024 | 7372.70 | 7372.70 |
2025 | 7518.83 | 7518.83 |