~goorzhel/beancount-clipper

Beancount importer for Clipper cards
53f0df15 — Antonio Gurgel 6 hours ago
Don't crash on empty PDFs
919aab16 — Antonio Gurgel 6 hours ago
Add empty-PDF test
54787f8a — Antonio Gurgel 7 hours ago
Rearrange fixtures

clone

read-only
https://git.sr.ht/~goorzhel/beancount-clipper
read/write
git@git.sr.ht:~goorzhel/beancount-clipper

You can also use your local clone with git send-email.

#Beancount: Clipper

Beancount importer for PDFs obtained from Clipper, the fare card used by most transit operators in the San Francisco Bay Area.

#Usage

#Install dependencies

#Configure importer

Add something like this to your importer configuration:

from beancount_clipper import ClipperImporter

CONFIG = [
  ClipperImporter("1234567890", "Assets:Cash:Clipper", "Expenses:Transport:Public")
]

The class signature:

  • card_number (str): The number of your Clipper card.
  • card_account (str): The Beancount account for the card.
  • exp_account (str | None, default None): The expense account with which to balance transactions.

#Download data

Log into your Clipper account. For each card:

  1. Select More Options then View Activity.
  2. Choose a date range. The past limit is ninety (90) days.
  3. Select Download PDF.
Do not follow this link