bank-ledger

A minimal Python package for a simple bank ledger with Account, Transaction, and Ledger.

• Library code lives in src/bank_ledger/
• Handy scripts live in scripts/
• Installed locally in editable mode via requirements.txt (contains -e .)

Repo layout

bank-ledger/
├─ src/
│  └─ bank_ledger/
│     ├─ __init__.py
│     ├─ __main__.py
│     ├─ account.py
│     ├─ ledger.py
│     └─ transaction.py
├─ scripts/
│  └─ smoke_test.py
├─ .gitignore
├─ pyproject.toml
├─ requirements.txt
└─ README.md

Requirements

• Python 3.11+ (3.12/3.13 OK)

Setup

# from repo root
python -m venv .venv

Windows (PowerShell):

. .\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt

macOS/Linux:

source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt

This installs the package in editable mode so changes under src/bank_ledger/ are picked up immediately.

Quick check

Run using CLI:

python -m bank_ledger

Run using GUI:

python -m bank_ledger.gui

Run the smoke script:

python scripts/smoke_test.py