81744d81a1
Before 1.50, journal's include directive's handling of glob patterns (*, **, ?, etc.) had these limitations: - ** always searched intermediate dot directories - ** matched only directories, not files In 1.50-1.50.3, it had different limitations, some unintended: - it ignored all dot files, dot dirs, and symbolic links to dot dirs, even when explicitly mentioned in the pattern (unless using --old-glob) - it showed symbolic links dereferenced, eg in `hledger files` output Now it has fewer limitations, mainly this: - it ignores all dot files and dot dirs, even when explicitly mentioned (unless using --old-glob) Ie it no longer ignores symbolic links to dot dirs, and it no longer shows symbolic links dereferenced. Also: including the current file is now always harmless, whether using a glob pattern or not. Internally, file paths in the "include file stack" (jincludefilestack) are now just absolute, but not canonicalised; showing symbolic links un-dereferenced in output and error messages seems generally more useful. This might affect output elsewhere also. (Those paths are still canonicalised on the fly when checking for include cycles, not so efficiently: each time an include directive is parsed, all the current parent files and all the new glob-matched include files will be re-canonicalised. Hopefully this is unnoticeable.) |
||
|---|---|---|
| .github | ||
| .sandstorm | ||
| .vscode/notebooks | ||
| bin | ||
| checks | ||
| doc | ||
| docker | ||
| docker-arm32v7 | ||
| examples | ||
| hledger | ||
| hledger-lib | ||
| hledger-ui | ||
| hledger-web | ||
| tools | ||
| .ci | ||
| .ctags | ||
| .dockerignore | ||
| .editorconfig | ||
| .ghci | ||
| .gitignore | ||
| .hlint.yaml | ||
| .mailmap | ||
| .version | ||
| azure-pipelines.yml | ||
| bench1k.sh | ||
| bench5k.sh | ||
| bench10k.sh | ||
| bench100k.sh | ||
| bench-10ktxns-10kaccts.sh | ||
| bench-10ktxns-100kaccts.sh | ||
| bench-ledger.sh | ||
| bench-many-accts.sh | ||
| bench-many-txns.sh | ||
| bench.sh | ||
| cabal.project | ||
| CHANGES | ||
| dev.hs | ||
| dir | ||
| Dockerfile | ||
| ghc-tags.yaml | ||
| hie-cabal.yaml | ||
| hie-stack.yaml | ||
| hledger.conf | ||
| hledger.conf.sample | ||
| Justfile | ||
| LICENSE | ||
| Makefile | ||
| Makefile.helpsys | ||
| README.md | ||
| Shake.hs | ||
| stack96.yaml | ||
| stack98.yaml | ||
| stack910.yaml | ||
| stack914.yaml | ||
| stack.yaml | ||
hledger
Robust, intuitive plain text accounting
Welcome! This is a brief intro to hledger. For a more detailed version, see the home page: https://hledger.org
hledger is lightweight, cross platform, multi-currency, double-entry accounting software. It lets you track money, investments, cryptocurrencies, invoices, time, inventory and more, in a safe, future-proof plain text data format with full version control and privacy.
hledger aims to help both computer experts and regular folks gain clarity in their finances and time management. Though the UIs are basic, hledger can model any accounting situation and provide precise, clear reports. It is reliable, quick, and backed by the highly supportive Plain Text Accounting ecosystem. Using it is an excellent way to learn double entry accounting.
Compared to other PTA apps, hledger is actively maintained, with regular releases, and a strong focus on being easy to use and practical for everyday accounting.
More features: - Installs easily on unix, mac or windows - Complete, built-in documentation in multiple formats, beginner videos, tutorials etc. - Multiple UIs: command-line, terminal, web, mobile, editors/IDEs - Good at importing and exporting CSV; also outputs text/HTML/JSON/SQL - A robust, general, well-specified multi-currency accounting engine - Fast, analysing 25k transactions per second on a macbook air m1 - Accurate to 255 decimal places - Supports your preferred account names, currencies, number formats - Inspired by and partly compatible with Ledger CLI; interconvertible with Beancount - Scriptable by CLI, HTTP or API, with plenty of examples - Clean Haskell codebase, continually improved since 2007, with $100 regression bounties - Free software licensed under GNU General Public License v3.0 or later.
Examples
I use hledger to: - track income and spending, sometimes with budgets - see time reports by day/week/month/project - track reimbursables, invoices and payments - predict cashflow and account balances - get accurate numbers for tax filing - research past events
Here’s an example of the journal file format:
2022-01-01 opening balances as of this date
assets:bank:checking $1000
assets:bank:savings $2000
assets:cash $100
liabilities:creditcard $-50
equity:opening/closing balances
2022-01-15 market
expenses:food $50
assets:cash $-50
2022-02-01 GOODWORKS CORP
assets:bank:checking $1000
income:salary $-1000
and some simple reports:
$ hledger bs
Balance Sheet 2022-02-15
|| 2022-02-15
========================++============
Assets ||
------------------------++------------
assets:bank:checking || $2000
assets:bank:savings || $2000
assets:cash || $50
------------------------++------------
|| $4050
========================++============
Liabilities ||
------------------------++------------
liabilities:creditcard || $50
------------------------++------------
|| $50
========================++============
Net: || $4000
$ hledger is --monthly
Income Statement 2022-01-01..2022-02-28
|| Jan Feb
===============++=============
Revenues ||
---------------++-------------
income:salary || 0 $1000
---------------++-------------
|| 0 $1000
===============++=============
Expenses ||
---------------++-------------
expenses:food || $50 0
---------------++-------------
|| $50 0
===============++=============
Net: || $-50 $1000
More examples and screenshots: https://hledger.org/#how-to-get-started
Funding
hledger is brought to you by Simon Michael, 140+ contributors, and the generous financial sponsors below.
After enjoying some personal or organisational success with hledger, you might want to become one of them, to help support this work. It’s easy! Please see https://hledger.org/sponsor.html for details.
Organisational sponsors
Individual sponsors
