turbo-xlsx-rs 0.1.3

Native workbook-model-to-XLSX writer (PyO3 binding over the turbo-xlsx Rust core).

turbo-xlsx-rs (Python)

Native workbook-model-to-XLSX writer — a PyO3 binding over the turbo-xlsx Rust core. Turn a structured workbook into a formatted .xlsx (OOXML SpreadsheetML, OPC-zipped). Country-agnostic: locale and ISO-4217 currency code are inputs, never hardcoded.

Install

pip install turbo-xlsx-rs          # lean writer
pip install turbo-xlsx-rs-parse    # writer + XLSX reader (adds parse())

The PyPI distribution is turbo-xlsx-rs (PyPI rejects turbo-xlsx as too close to the existing turboxlsx); the import name stays turbo_xlsx either way. The -parse wheel adds an .xlsx reader — pick whichever variant you need.

import turbo_xlsx as x

wb = {
    "sheets": [
        {
            "name": "Pay",
            "rows": [
                {"cells": [
                    {"type": "string", "value": "Alice"},
                    {"type": "currency", "value": 123456,
                     "currency": {"code": "MXN", "locale": "es-MX"}},
                ]}
            ],
        }
    ]
}

data = x.write(wb)            # -> bytes, starts with b"PK" (xlsx is a zip)
assert data.startswith(b"PK")

API

• write(workbook, opts=None) -> bytes — one-shot from a workbook dict.
• write_full(workbook, opts=None) -> (bytes, list) — also returns lint diagnostics.
• write_from_json(input, opts=None) -> bytes — input is a JSON string or value.
• write_rows(input, opts=None) -> bytes — fast-path: one sheet from typed columns + rows ({sheetName?, locale?, columns?, rows}).
• create_writer(opts=None) -> WorkbookWriter / WorkbookWriter(locale=None, opts=None) — row-by-row streaming: start_sheet, write_row, end_sheet, finish() -> (bytes, list).
• parse(data, format=None, sheet=None, typed=False) -> str — turbo-xlsx-rs-parse wheel only. Read an .xlsx (incl. DEFLATE-compressed) into JSON (values grid or typed=True model), format="csv", or format="md". ~10× faster than openpyxl at reading, cell-for-cell verified against it.

opts is an optional dict {meta: {title, author, subject, company}, locale?, password?}. Setting password encrypts the output with ECMA-376 Agile Encryption (AES-256) — x.write(wb, {"password": "s3cret"}) — which Excel/LibreOffice open with that password.

Fatal validate/write faults raise TurboXlsxError (with .code and .message). Non-fatal lints are returned, never raised.