https://github.com/simonmichael/hledger_finance
The hledger project's public finances
https://github.com/simonmichael/hledger_finance
accounting finance hledger plaintext-accounting
Last synced: 7 months ago
JSON representation
The hledger project's public finances
- Host: GitHub
- URL: https://github.com/simonmichael/hledger_finance
- Owner: simonmichael
- Created: 2022-03-23T21:59:00.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-02-18T07:21:28.000Z (8 months ago)
- Last Synced: 2025-02-18T07:35:41.169Z (8 months ago)
- Topics: accounting, finance, hledger, plaintext-accounting
- Language: Just
- Homepage:
- Size: 533 KB
- Stars: 22
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://hledger.org/FINANCE.html) 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](https://opencollective.com/hledger/transactions?kind=CONTRIBUTION%2CEXPENSE%2CHOST_FEE%2CPAYMENT_PROCESSOR_FEE%2CPAYMENT_PROCESSOR_COVER)
- 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
## Reports
## Revenues & Expenses This Year
accountrevenues:donationsexpenses:feesTotal:commodityUSDUSDUSD2025-01141.00-24.08116.922025-0237.00-7.7929.21total178.00-31.87146.13average89.00-15.9473.06
## Revenues & Expenses by Year
accountrevenues:donationsexpenses:bountiesexpenses:feesexpenses:miscTotal:commodityUSDUSDUSDUSDUSD2017120.000-19.080100.922018225.000-34.930190.072019105.000-23.33081.6720201254.380-189.8101064.5720214721.00-760.01-708.3403252.6520223744.00-400.00-592.10-578.122173.7820231868.00-862.00-303.93-100.00602.0720241277.00-1198.14-171.890-93.032025178.000-31.870146.13total13492.38-3220.15-2075.28-678.127518.83
## Assets & Liabilities By Year
accountassets:opencollectiveTotal:commodityUSDUSD2017100.92100.922018290.99290.992019372.66372.6620201437.231437.2320214689.884689.8820226863.666863.6620237465.737465.7320247372.707372.7020257518.837518.83