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

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

Built distributions (wheels)

Table of built distributions (wheels) for fastexcel 0.11.5
File Actions
fastexcel-0.11.5-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for fastexcel-0.11.5-cp38-abi3-win_amd64.whl
fastexcel-0.11.5-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.11.5-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
fastexcel-0.11.5-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details for fastexcel-0.11.5-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
fastexcel-0.11.5-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for fastexcel-0.11.5-cp38-abi3-macosx_11_0_arm64.whl
fastexcel-0.11.5-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details for fastexcel-0.11.5-cp38-abi3-macosx_10_12_x86_64.whl

Total release size: 5.5 MB

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

Download URL fastexcel-0.11.5-cp38-abi3-win_amd64.whl
Size 918.1 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
2e4583e519ed43e69788b5d1701621104c4fd2b5cd979562c9f696ed968397d0
BLAKE2b-256 checksum
How to use checksums
23ae30fdaffe7d518fa6d469e895cd9a27b60f63861e3f419ee6c1545e440bf2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.7.0

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

Download URL fastexcel-0.11.5-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 1.2 MB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
9c2d4642df0a978d81d7be0ba57fe9db8bffdcbd431cd8aa3d69da1170c5f021
BLAKE2b-256 checksum
How to use checksums
6b42e79ea65bf7f780bf86a05421c373f90b8264bbfc06cd33564fad537d1053
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.7.0

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

Download URL fastexcel-0.11.5-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 1.2 MB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
ab26d59088b53f5bfc21b9172a759731171f357de97116fef295fe2db4b0f622
BLAKE2b-256 checksum
How to use checksums
e22e4b52e0d921fdcc9c39b89e70fa6e388c10db6b7655240ebfdfc61bd94b6c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.7.0

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

Download URL fastexcel-0.11.5-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
7ef0f62cfc6f2188366b18cf151951aed095df3823bb89fd642525f9cdac8e0b
BLAKE2b-256 checksum
How to use checksums
aeff9c215ddd8ce3086b131c663a7f2bcc1665b20065f1fc196e3f27e5edf9f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.7.0

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

Download URL fastexcel-0.11.5-cp38-abi3-macosx_10_12_x86_64.whl
Size 1.1 MB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
c13ae6aa5fab53314bb736ff49b8d314a3ad119e27977868fae7f4b281d6ede5
BLAKE2b-256 checksum
How to use checksums
2c48551fdda57beec59c41b1fe08862ab80315b1d45101a78a1e467e2e91a485
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.7.0

Security for fastexcel 0.11.5

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.11.5 This release

5 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