This project has been archived by its maintainers, and is no longer receiving any updates.
openbooks-core
The core of Open Books: financial documents in, one proven JSON document per file out, or a typed refusal. Never guessed. Never partially released.
This package owns the openbooks.v1 contract (JSON Schema), Decimal and date normalisation, field evidence, the input guard,
the balance gates, the layout registry and the openbooks CLI. It contains no parsers: install the providers for the documents
you read.
| Package | Reads |
|---|---|
openbooks-statements |
bank CSV, OFX, MT940; [pdf] PDFs; [scan] scans (OCR) and the typed heads |
openbooks-gateways |
Stripe, Razorpay, PayPal, Wise |
openbooks-tax |
Form 26AS, AIS, FIRA, Form 1099-B, trial balance |
openbooks-doctor |
openbooks doctor: installation, provider and model-integrity checks |
openbooks |
all of the above |
pip install openbooks-core # only jsonschema is installed
python -m openbooks_core engine-info # version, contract version, installed layouts (JSON)
python -m openbooks_core run file.csv --machine # JSON lines on stdout
With no provider installed every known layout is refused with the name of the package to install; nothing is ever released by guesswork. A file that looks like a known layout whose provider is missing is refused, never passed to a looser parser.
Exit codes: 0 everything released, 1 something was refused, 2 usage error, 3 the engine could not run.
Status: 0.1, pre-release. Every layout has been exercised on synthetic fixtures only, not on real exports. Do not rely on it for real filings.
Licence: Apache-2.0.
Metadata
Release files for openbooks-core 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| openbooks_core-0.1.0.tar.gz | 27.1 kB | With provenance | Details for openbooks_core-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| openbooks_core-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for openbooks_core-0.1.0-py3-none-any.whl |
Total release size: 62.3 kB
Release files / openbooks_core-0.1.0.tar.gz
| Download URL | openbooks_core-0.1.0.tar.gz |
|---|---|
| Size | 27.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c73e1d4f8724863e4d22cddecf592c005545cbaadd8bddc0e9407a669fcdf404
|
|
BLAKE2b-256 checksum How to use checksums |
10d413645a9f42c648a0580325f3eb551cf803556c976d4d4c15d7900a78cf7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 18, 2026.
Transparency logRelease files / openbooks_core-0.1.0-py3-none-any.whl
| Download URL | openbooks_core-0.1.0-py3-none-any.whl |
|---|---|
| Size | 35.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8d080a04cc0e76d53b0331e2168706c2de86753bfc6bc9c7f2a8d773ca43db10
|
|
BLAKE2b-256 checksum How to use checksums |
b0b4069bb9b03bbe1d75f430a28ab623b9440c987e881fcceab47cfb5202d75e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 18, 2026.
Transparency logSecurity for openbooks-core 0.1.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for openbooks_core-0.1.0.tar.gz
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 Nov 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.