Add sfin2beancount - Beancount equivalent of sfin2ledger

[robcohen]

Hi,

I've created sfin2beancount, a Beancount equivalent of sfin2ledger. It follows the same structure, style, and approach.

Repo: https://github.com/robcohen/sfin2beancount

Would SimpleFIN be interested in hosting this under the simplefin org? Happy to transfer the repo or submit however works best.

Features

• Same file structure as sfin2ledger
• Same test style (2 tests: test_basic, test_credit)
• Same setup.py format (distutils)
• Zero dependencies (stdlib only, dropped six since py2 is EOL)
• MIT licensed

Usage

curl "${ACCESS_URL}/accounts" | sfin2beancount

Sample Output

2024-01-15 * "Gas Station"
  Assets:My-Checking  -44.37 USD
  Expenses:Uncategorized

2024-01-16 * "Direct Deposit"
  Assets:My-Checking  2500.00 USD
  Income:Uncategorized

Beancount has a large user base and there's currently no official SimpleFIN tool for it. This would fill that gap.

Let me know if you'd like any changes to the code or structure.

[robcohen]

I've also created a beangulp importer for SimpleFIN:

https://github.com/robcohen/beangulp-simplefin

This provides integration with the beangulp import framework (the official Beancount 3.0 importer system), giving users:

• Duplicate detection against existing ledger
• File archiving
• Integration with smart_importer for ML categorization

Together these two tools cover both workflows:

• sfin2beancount - Unix pipe style (curl | sfin2beancount >> ledger)
• beangulp-simplefin - beangulp framework style (beangulp extract file.json)

Happy to transfer both repos to the SimpleFIN org if you're interested.

[iffy]

This is great! I'm glad SimpleFIN works well for this.

You may want to consider these upcoming changes: simplefin/simplefin.github.com#31 We'll be deploying these to the SimpleFIN Bridge soon (not sure if it will be before or after the new year) in a backward compatible way. I'll note in that PR when we do.

Let me give some thought as to whether to bring this in to the simplefin org or not. Thank you for sending this!

[robcohen]

Thank you for such a prompt reply! I'll look into this and get back to you on it.