bankstatements-core 0.1.1

Core PDF bank statement parsing library

bankstatements-core

Core PDF bank statement parsing library — PDF extraction, services, and templates.

Used as the foundation for bankstatements-free and the premium distribution.

---

Installation

pip install bankstatements-core

Features

• PDF extraction with configurable table boundaries
• Template-based statement detection (AIB Ireland, Revolut, and more)
• CSV, JSON, and Excel export
• Batch processing with recursive directory scanning
• SHA-256 duplicate detection
• Transaction type classification (purchase, payment, refund, fee, transfer)
• Monthly summaries and expense analysis
• IBAN extraction and grouping
• GDPR-compliant local processing — no data leaves your machine

Supported Banks

Bank	Template
AIB Ireland	aib_ireland.json
Revolut	revolut.json
Generic fallback	default.json

Quick Start

from bankstatements_core.services.processor import StatementProcessor

processor = StatementProcessor(input_dir="./input", output_dir="./output")
results = processor.process()

Documentation

Full documentation and source: github.com/longieirl/bankstatementprocessor