xlsxturbo
High-performance Excel writer with automatic type detection. Written in Rust, usable from Python.
xlsxturbo exports pandas and polars DataFrames and CSV files to .xlsx. It uses Rust for
the hot path and keeps the Python API small enough to drop straight into a script, a
report job, or a batch pipeline. Roughly 7-9x faster than pandas + openpyxl on the
reference benchmarks, with the Excel features those exports usually need — tables,
conditional formatting, charts, data validation, images — available as focused keyword
arguments rather than a workbook object model.
Full documentation · Capability matrix · Changelog
Install
pip install xlsxturbo
Wheels are published for Python 3.9+ on Linux, Windows, and macOS. There are no runtime dependencies beyond the interpreter.
Export a DataFrame
import pandas as pd
from xlsxturbo import df_to_xlsx
df = pd.DataFrame({
"product": ["Widget", "Gadget", "Gizmo"],
"price": [19.99, 34.50, 8.75],
"in_stock": [True, False, True],
"restock": pd.to_datetime(["2024-03-01", "2024-03-15", "2024-04-01"]),
})
df_to_xlsx(df, "products.xlsx", table_style="Medium2", autofit=True)
Types carry across without configuration: numbers stay numbers, booleans become Excel booleans, and dates and datetimes become real Excel date values with a display format attached. polars DataFrames work the same way — neither library is a dependency.
Convert a CSV
from xlsxturbo import csv_to_xlsx
csv_to_xlsx("sales.csv", "sales.xlsx")
Types are detected from the file's text. There is also a command-line tool for the same job, though it is not included in the PyPI wheel — it has to be built from source. See CSV conversion.
What it can do
- DataFrame and CSV export — pandas, polars, and CSV in,
.xlsxout - Excel tables with 61 built-in styles, autofilter, and banded rows
- Formatting — header and per-column styles, number formats, per-side borders, alignment, wrapping, auto-fit and explicit column widths, row heights, merged ranges, rich text
- Conditional formatting — colour scales, data bars, icon sets
- Formulas — calculated columns and workbook-level defined names
- Native Excel charts and in-cell sparklines, both editable in Excel
- Data validation — dropdowns, numeric ranges, text-length constraints
- Cell-level extras — arbitrary cell writes, hyperlinks, comments, checkboxes, images, textboxes
- Multi-sheet workbooks with per-sheet option overrides
- Constant memory mode for very large exports, and optional parallel CSV parsing
- Atomic writes — a failed export never truncates the file already at that path
The capability matrix is the authoritative list: it is generated from the source and shows which options each function accepts, which are overridable per sheet, and which survive constant-memory mode.
Performance
On 100,000 rows x 50 columns of mixed types, xlsxturbo is about 4.6x faster than polars,
7x faster than pandas + xlsxwriter, and 9.3x faster than pandas + openpyxl. Absolute
timings are system-specific; the ratios are stable. Full tables, test systems, and
methodology are on the
performance page, and both benchmark
suites live in benchmarks/ so you can measure your own hardware.
Known limitations
- Write-only. xlsxturbo creates workbooks; it cannot open or modify an existing one.
- Timezone-aware datetimes are written as their local wall-clock value — Excel has no timezone concept, so the UTC offset is not preserved.
- Integers above 2^53 are written as text to avoid silent precision loss.
- Durations (
Timedelta/timedelta64) are written as text; Excel has no duration type.
The compatibility page has the complete list with the workaround for each.
Project status
- Production-ready for the documented DataFrame and CSV export workflows.
- Tested in CI on Python 3.9 and 3.12 across Linux, Windows, and macOS, plus Python 3.14 on Linux.
- SemVer: breaking API changes require a major version bump.
- Advanced Excel features are exposed through focused parameters rather than a full workbook object model. That is a deliberate scope boundary, not a gap to be filled.
Contributing
Setup takes about five minutes and is described in CONTRIBUTING.md, along with the exact lint, type, and test commands CI runs. Security reports go through the process in SECURITY.md.
License
MIT
1 maintainer
Release files for xlsxturbo 0.19.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 | |
|---|---|---|---|
| xlsxturbo-0.19.0.tar.gz | 314.8 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| xlsxturbo-0.19.0-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| xlsxturbo-0.19.0-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details |
| xlsxturbo-0.19.0-cp39-abi3-macosx_10_12_x86_64.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 6.0 MB
Release files / xlsxturbo-0.19.0.tar.gz
| Download URL | xlsxturbo-0.19.0.tar.gz |
|---|---|
| Size | 314.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4620a16caccf34a7139ddefadb73ae25650a5e834f6dd85817c7f25bfa4edc1a
|
|
BLAKE2b-256 checksum How to use checksums |
11299f80ba9dad365df6c85ab08a1518c492d2b1d9096870c4ecf6e2081709c3
|
| 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 Jul 30, 2026.
Transparency logRelease files / xlsxturbo-0.19.0-cp39-abi3-win_amd64.whl
| Download URL | xlsxturbo-0.19.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
645c759028b1c6327e30548f777dcd06fa23f6c68dd74ee6dfbf4d8a353cfb90
|
|
BLAKE2b-256 checksum How to use checksums |
5cee30581c59087a12ea5b5f40ab397333be5512c85e53e4df940086aff5ee57
|
| 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 Jul 30, 2026.
Transparency logRelease files / xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_x86_64.whl
| Download URL | xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
edc89fcecb7b4136adf583adc727829aead9e7c7615c88bacf0064ec2df53438
|
|
BLAKE2b-256 checksum How to use checksums |
3cf8bcfcd319b6a4ab50d525221ba94d14dda273dd6127f87cf49015932ab45d
|
| 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 Jul 30, 2026.
Transparency logRelease files / xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_aarch64.whl
| Download URL | xlsxturbo-0.19.0-cp39-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
e8acb3eba43ee72c585824ad7d0926541b5c554829a16cca29bc0dc4e28fa9b4
|
|
BLAKE2b-256 checksum How to use checksums |
c3fd55cbf905b6f2165c7e275aeb904d5b3326b88b4558f78afc27933863d486
|
| 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 Jul 30, 2026.
Transparency logRelease files / xlsxturbo-0.19.0-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | xlsxturbo-0.19.0-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
fe3ad762d62be84de5e4106217d35be10820ced9ae1267e07cc3b6985ddb645e
|
|
BLAKE2b-256 checksum How to use checksums |
0b7c75d530bb774cd59bc067723bc326237315e47354101c8f8a94f73db333d0
|
| 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 Jul 30, 2026.
Transparency logRelease files / xlsxturbo-0.19.0-cp39-abi3-macosx_10_12_x86_64.whl
| Download URL | xlsxturbo-0.19.0-cp39-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
c057a5bcdcdc173365433688424a5b14e93b6ae2f452d065856ccef9ca2d4e23
|
|
BLAKE2b-256 checksum How to use checksums |
6779c5d82dbb51ef198cb615cf6a606545efd3085238b0428ee1dfc04645ae63
|
| 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 Jul 30, 2026.
Transparency log
