Xfina (Python Bindings)

Xfina is a blazingly fast library for parsing Indian financial statements (Bank Accounts, Credit Cards, Mutual Funds) and international brokers (IBKR), written in Rust and exposed to Python via PyO3.

It converts raw PDFs, Excel files, and CSVs into structured, ReBIT-compliant JSON dictionaries in milliseconds.

Installation

pip install xfina

Quick Start

The Python bindings expose the exact same parsing functions as the Rust core. Since it is backed by Rust, it requires raw bytes or string contents to be passed in, rather than file paths.

Parsing a Bank Statement (Excel)

import xfina

# Read the file as raw bytes
with open("hdfc_statement.xls", "rb") as f:
    file_bytes = f.read()

# Parse it! 
# The second argument is an optional password (None for Excel)
# The format parameter defaults to "xfina" if omitted, but can be "rebit"
account_data = xfina.parse_hdfc_ba(file_bytes, password=None, format="xfina")

print(f"Account Name: {account_data['profile']['holders']['holder'][0]['name']}")

Parsing a CAMS Mutual Fund Statement (PDF)

import xfina
import json

with open("cams_cas.pdf", "rb") as f:
    file_bytes = f.read()

# Pass the password to decrypt the PDF
mf_data = xfina.parse_cams(file_bytes, password="PAN1234567")

# It returns a standard Python dictionary. You can easily dump it to JSON:
with open("output.json", "w") as f:
    json.dump(mf_data, f, indent=2)

Parsing an IBKR Statement (CSV)

import xfina

# IBKR and HDFC Credit Card parsers expect a string (CSV content), not raw bytes
with open("ibkr_activity.csv", "r", encoding="utf-8") as f:
    csv_content = f.read()

ibkr_data = xfina.parse_ibkr(csv_content, format="rebit")

Available Parsers

All parsers return a structured Python dictionary that mirrors the ReBIT JSON schema. Each parser accepts an optional format parameter which defaults to "xfina", but can be "rebit" for strict AA schema compliance without our extended data fields.