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 same entry point as the Rust core. To keep the core parsing logic as pure functions without side-effects (like file I/O), the library requires raw bytes to be passed in rather than file paths.
Parsing a Credit Card Statement
import xfina
with open("statement.xls", "rb") as fh:
data = fh.read()
# Hand over the bytes; the format is worked out from the content.
statement = xfina.parse(data, filename="statement.xls")
statement["format"] # "ba-hdfc"
statement["category"] # "bank_account"
statement["institution"] # "HDFC Bank"
statement["detection"] # how it was identified, plus the file's metadata
statement["validation"] # the two-level validation report
statement["data"] # the account, in the requested schema
# ReBIT output, or a pinned format that skips detection:
xfina.parse(data, schema="rebit")
xfina.parse(data, **{"as": "ba-hdfc"})
Failures raise xfina.XfinaParseError, which is where this differs from the
JS binding: exceptions are the idiom here, so the same information arrives as
attributes rather than in an error envelope.
try:
xfina.parse(data, filename=name)
except xfina.XfinaParseError as e:
if e.kind == "password_required":
prompt_for_password(e.format) # the format the filename suggested
The four functions
| Function | Purpose |
|---|---|
parse(bytes, password=None, filename=None, modified_timestamp=None, **{"as": None}, schema=None) |
Identify and parse a statement. |
detect(bytes, password=None, filename=None, modified_timestamp=None) |
Identify a statement without parsing it. |
formats() |
Every format this build knows, with id, category, institution, containers and enabled. |
version() |
The version of the parsers actually running. |
2 maintainers
Metadata
2 maintainers
Release files for xfina 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| xfina-0.8.1.tar.gz | 259.3 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| xfina-0.8.1-cp38-abi3-win_amd64.whl | CPython 3.8 | abi3 | Windows x86-64 | Details |
| xfina-0.8.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.8 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| xfina-0.8.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.8 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| xfina-0.8.1-cp38-abi3-macosx_11_0_arm64.whl | CPython 3.8 | abi3 | macOS 11.0+ ARM64 | Details |
| xfina-0.8.1-cp38-abi3-macosx_10_12_x86_64.whl | CPython 3.8 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 12.8 MB
Release files / xfina-0.8.1.tar.gz
| Download URL | xfina-0.8.1.tar.gz |
|---|---|
| Size | 259.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75a30de476659d69216d2ad51cef825bed11a36a6115af28f7c0454eb45ef3c9
|
|
BLAKE2b-256 checksum How to use checksums |
fac2425e60de92fce30ee8121fe4fa005993ac7145e014efdf02ae212c2385d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / xfina-0.8.1-cp38-abi3-win_amd64.whl
| Download URL | xfina-0.8.1-cp38-abi3-win_amd64.whl |
|---|---|
| Size | 2.3 MB |
| Tags | CPython 3.8 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c7cfcca56f26bbdccd8b88192fc8cb5886a9d02f06d5f0346dcc3019eca1e25b
|
|
BLAKE2b-256 checksum How to use checksums |
76f59ddf251211b4d46360155837c9dc1720e6df346d5ece67236916a7b9b293
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / xfina-0.8.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | xfina-0.8.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.8 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1656f46db60313f61ebfff1d0fad975aefb1a8675ea5a0ecb0985638f027f6a3
|
|
BLAKE2b-256 checksum How to use checksums |
ab776bc72aeb402bfb9e14e0f7aae6ccfec0f64f4e8a371018a1255d48e844fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / xfina-0.8.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | xfina-0.8.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.8 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
167bb7518b5ba932fe4db86a54f2add99b73081624bc1d6bc6ec6531b2efcff6
|
|
BLAKE2b-256 checksum How to use checksums |
525ca57836c6df1ebda1fc761ca1a85d5da24f59b21085bf6f4d502f3aa53888
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / xfina-0.8.1-cp38-abi3-macosx_11_0_arm64.whl
| Download URL | xfina-0.8.1-cp38-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.8 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
01252078154716dae689e50ae56402202e71970776977ab9acb5a414aab44ab7
|
|
BLAKE2b-256 checksum How to use checksums |
6e639a3348caba0d8e93b7c511700a4bdb0e273f8fbfc17d8ddcfefdfc42c711
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / xfina-0.8.1-cp38-abi3-macosx_10_12_x86_64.whl
| Download URL | xfina-0.8.1-cp38-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.8 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
f90e2f77305da703249e7311a6179b369000c3636702be2722f9104481c7143e
|
|
BLAKE2b-256 checksum How to use checksums |
58887db617cfc5581db21cd7c475715aa7cc6697be181b82058e3204dc6df272
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency log
