alens-importers 0.1.0

Importers for Beancount's beangulp

alens-importers

Tool for importing IB Flex report entries into Beancount journal

Converting the functionality of interactive-brokers-flex-rs, ibflex, repo project to Python. Since Beancount provides an ingestion framework, beangulp, the tool should utilize that.

Former ib-flex-importer.

Setup

Install the latest beangulp (0.3.0) from the git repository directly:

uv pip install git+https://github.com/beancount/beangulp/

Run

uv run python import.py extract ./downloads > out/tmp.beancount

Debugging

Install the latest beangulp (0.3.0) from a git clone instead.

uv pip install -e <path to beangulp>

Testing

From terminal, the template is:

uv run pytest
uv run pytest <file_path>::<test_function_name>
uv run pytest <file_path>::<TestClassName>::<test_method_name>

Individual tests:

uv run pytest tests\test_ibflex.py::test_tax_reversal
uv run pytest tests\test_ibflex.py::test_cash_balances

Publish

The project cannot be published as it depends on the development version of the beangulp package, which is not published yet.

Docs

Following the examples at beangulp repo.

To configure the Flex report, see the instructions.

Related Projects

• Beangulp repo
• beancounttools, repo
• uabean, repo
• Red's Importers, repo