Skip to main content

fastexcel

A fast excel file reader for Python, written in Rust.

Based on calamine and Apache Arrow.

Docs available here.

Dev setup

Prerequisites

Python>=3.8 and a recent Rust toolchain must be installed on your machine. cargo must be available in your PATH.

First setup

On the very first time you setup the project, you'll need to create a virtualenv and install the necessary tools:

python -m venv .venv
source .venv/bin/activate
(.venv) make dev-setup

This will also set up pre-commit.

Installing the project in dev mode

In order to install the project in dev mode (for local tests for example), use make dev-install. This will compile the wheel (in debug mode) and install it. It will then be available in your venv.

Installing the project in prod mode

This is required for profiling, as dev mode wheels are much slower. make prod-install will compile the project in release mode and install it in your local venv, overriding previous dev installs.

Linting and formatting

The Makefile provides the lint and format extras to ease this.

Running the tests

make test

Running the benchmarks

Speed benchmark

make benchmarks

Memory benchmark

mprof run -T 0.01 python python/tests/benchmarks/memory.py python/tests/benchmarks/fixtures/plain_data.xls

Building the docs

make doc

Creating a release

  1. Create a PR containing a commit that only updates the version in Cargo.toml.
  2. Once it is approved, squash and merge it into main.
  3. Tag the squashed commit, and push it.
  4. The release GitHub action will take care of the rest.

Dev tips

  • Use cargo check to verify that your rust code compiles, no need to go through maturin every time
  • cargo clippy = 💖
  • Careful with arrow constructors, they tend to allocate a lot
  • mprof and time go a long way for perf checks, no need to go fancy right from the start

Metadata

Release files for fastexcel 0.12.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastexcel 0.12.1
File Size Uploaded Provenance Actions
fastexcel-0.12.1.tar.gz 38.3 kB Without provenance Details for fastexcel-0.12.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for fastexcel 0.12.1
File Actions
fastexcel-0.12.1-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for fastexcel-0.12.1-cp38-abi3-win_amd64.whl
fastexcel-0.12.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details for fastexcel-0.12.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
fastexcel-0.12.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details for fastexcel-0.12.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
fastexcel-0.12.1-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for fastexcel-0.12.1-cp38-abi3-macosx_11_0_arm64.whl
fastexcel-0.12.1-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details for fastexcel-0.12.1-cp38-abi3-macosx_10_12_x86_64.whl

Total release size: 6.0 MB

Release files / fastexcel-0.12.1.tar.gz

Download URL fastexcel-0.12.1.tar.gz
Size 38.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5dc2f1ff3ddff6c933d1f924add7f7f5dc20388c1e70b22afae0f28b3c4f01c9
BLAKE2b-256 checksum
How to use checksums
93bf1876776d424bbcb069520710df4b930adfe998eaa0bb4a88988254ffa8e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Release files / fastexcel-0.12.1-cp38-abi3-win_amd64.whl

Download URL fastexcel-0.12.1-cp38-abi3-win_amd64.whl
Size 1.0 MB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
5c1868546ae0912040449e0b26dd4759db3f76a94e0fa5ac3c86fdaf54185e9c
BLAKE2b-256 checksum
How to use checksums
85136662e60e76e878e2251ca78d7f6630103a8e998f9ca1fa7154f94845425f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Release files / fastexcel-0.12.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL fastexcel-0.12.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 1.3 MB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
a169b72df88406007d8449a4b216effddeaad5e9d73f4de1fbd8cbfd6ce6a01c
BLAKE2b-256 checksum
How to use checksums
500dc2e61c3b30d2cbd083cb010346745edc8e6ade3401b1f9d7f083aaff051e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Release files / fastexcel-0.12.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL fastexcel-0.12.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 1.3 MB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
c09119f14760dfee0c1cb94ef281bee2abb844975fdf0fbf34c5b836ff58d39d
BLAKE2b-256 checksum
How to use checksums
9d56f4967db7c848e191d633366fe4876af74e656e809c9719c1a7489b50349d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Release files / fastexcel-0.12.1-cp38-abi3-macosx_11_0_arm64.whl

Download URL fastexcel-0.12.1-cp38-abi3-macosx_11_0_arm64.whl
Size 1.1 MB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
e889290b2d1437e57c4fb500657f0d2908de6aa5b291475b93e3b5d7e0cea938
BLAKE2b-256 checksum
How to use checksums
b5d71ff26ec00aac2623a87e9397c252f515f45ed28425007c1b895f1810fd5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Release files / fastexcel-0.12.1-cp38-abi3-macosx_10_12_x86_64.whl

Download URL fastexcel-0.12.1-cp38-abi3-macosx_10_12_x86_64.whl
Size 1.2 MB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
7c4c959a49329a53540ed86d4f92cd4af2d774b08c47ad190841e4daf042758a
BLAKE2b-256 checksum
How to use checksums
64a8e39f5c609deaf1754b520e75231368b373c4e6a62dfc6e8d283918aa2284
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.8.1

Security for fastexcel 0.12.1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.

Release history Release notifications | RSS feed

This release

0.12.1 This release

6 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page