ledger

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 42 Open GitHub ↗

Golang parser for Ledger files - with ledgerfmt, akin to gofmt.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build](https://img.shields.io/travis/abourget/ledger.svg?style=flat-square)](https://travis-ci.org/abourget/ledger)
[![Coverage](https://img.shields.io/coveralls/abourget/ledger.svg?style=flat-square)](https://coveralls.io/github/abourget/ledger)
[![API Documentation](https://img.shields.io/badge/api-GoDoc-blue.svg?style=flat-square)](https://godoc.org/github.com/abourget/ledger/journal)
[![BSD License](https://img.shields.io/badge/license-BSD-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD)

Go Ledger
=========

Library and binaries to parse relatively complex Ledger files, and provide
an abstract syntax tree (a full programmatic representation of the
file), to be able to tweak some parts programmatically, and then write
back the files to disk.

It has a few higher level APIs added by https://github.com/cschomburg
and https://github.com/glasser Many thanks for your contributions!

* `ledger-go` provides a few tools to interact with Ledger files, such
  as balance reports.

* `ledgerfmt`, similar to `gofmt`, parses the input file, indents and
  aligns according to conventions, and outputs the file back, without
  any semantic changes or interpretation of the data.

* `ledger2json` parses your Ledger file and outputs a `.json` file,
  which you can manipulate with any software.

Installation
============

```bash
go get -u github.com/abourget/ledger/cmd/...
```

Shortcomings
============

This implementation has a few limitations compared to the C++ version:

* The current implementation does not validate any balances. It merely
  acts on the text of the file.
* It does not yet support all top-level constructs, like "account",
  "alias", "P", "D", "year" / "Y", etc.. Most of those should be
  simple to implement.
* It does not yet understand tags. They are only considered comments.
* It does not yet implement the `value_expr` language that allows you
  to do complex math computations directly in the postings of your
  transactions. It merely store the string text of the expression,
  PROVIDED it is enclosed in parenthesis, e.g. `(123 + 2 * 3 USD)`.

ledger

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README