https://github.com/daniel-wells/beancount_balancechange

A Beancount plugin that performs an assertion (check) on the change in balance between two dates.
https://github.com/daniel-wells/beancount_balancechange

beancount

Last synced: about 1 month ago
JSON representation

A Beancount plugin that performs an assertion (check) on the change in balance between two dates.

• Host: GitHub
• URL: https://github.com/daniel-wells/beancount_balancechange
• Owner: daniel-wells
• License: gpl-2.0
• Created: 2022-02-14T23:54:23.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-07-26T23:35:41.000Z (over 2 years ago)
• Last Synced: 2024-08-02T06:14:49.734Z (4 months ago)
• Topics: beancount
• Language: Python
• Homepage:
• Size: 29.3 KB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-beancount - beancount-balancechange - Checks _change_ in balance between two dates (Plugins / Misc)

README

        
![ci testing badge](https://github.com/daniel-wells/beancount_balancechange/actions/workflows/python-app.yml/badge.svg)

A [beancount](https://beancount.github.io/docs/) plugin that performs an assertion (check) on the change in balance between two dates.

For Income and Expense accounts the standard balance assertions aren't so useful

because we aren't interested in the absolute balance but rather the _change_ in balance.

This plugin allows you to assert that a balance has changed by a given amount between

two dates using the following syntax:

```

2021-04-06 custom "balance_change" Income:EmployerA -50000 GBP

    since: 2020-04-06

```

For example you might want to check your total income for the tax year matches that on your P60.

Installation:

```

pip install git+https://github.com/daniel-wells/beancount_balancechange.git

```

Usage:

Add the following line to your ledger file:

```

plugin "beancount_balancechange.balance_change"

```