Brotli wheels

This repository is used to build and publish brotli “wheels“ package.

What are wheels?

Wheels are the new standard of Python distribution and are intended to replace eggs.

Advantages of wheels

• Faster installation for pure Python and native C extension packages.
• Avoids arbitrary code execution for installation. (Avoids setup.py)
• Installation of a C extension does not require a compiler on Windows or macOS.
• Allows better caching for testing and continuous integration.
• Creates .pyc files as part of installation to ensure they match the Python interpreter used.
• More consistent installs across platforms and machines.

Updating to a new brotli version

This repository includes the google/brotli library as a git submodule at src/brotli. To build wheels for a new brotli release:

1. Update the submodule

cd src/brotli
git fetch origin
git checkout <TAG>  # e.g., v1.2.0
cd ../..
git add src/brotli
git commit -m "Update brotli submodule to <TAG>"

2. Push to trigger CI builds

git push

This will automatically trigger GitHub Actions to build wheels for:

• Python versions: 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, 3.14
• Linux: x86_64, i686, aarch64, ppc64le (manylinux2014)
• macOS: x86_64, ARM64 (universal2)
• Windows: x64, x86

3. Publish to PyPI (for releases)

To publish the built wheels to PyPI:

1. Create a new GitHub release from the Releases page
2. Tag the release (e.g., v1.2.0)
3. Publish the release

The GitHub Actions workflow will automatically upload all built wheels and the source distribution to PyPI when a release is published.