Welcome to the

statement-reader

About

Welcome to the official documentation for statement-reader — a Python library designed to help you extract and structure data from bank PDF statements.

Banking operations are often provided in PDF format, which is great for human readability but not ideal for further processing by computers. This library solves that problem by parsing unstructured PDF text into structured Python objects that can be easily analyzed, stored, or visualized.

Basic usage

Why Use

statement-reader

?

• ✅ Extracts key operation fields: date, time, category, amount, balance, and more.
• ✅ Supports income/expense classification based on the transaction pattern.
• ✅ Automatically cleans up non-breaking spaces and commas for correct numeric parsing.
• ✅ Returns structured Python objects for easy integration with other tools and libraries.
• ✅ Designed for Sberbank statement lines, but extensible to other formats.

Getting Started

To get started, install the package:

Usage

Use it to parse a line from a Sberbank statement:

API Reference

For full details about classes, methods, and parameters, check out the API reference.