2.5.0

• ✨ Added support for building ABI3 wheels. cibuildwheel will now recognise when an ABI3 wheel was produced, and skip subsequent build steps where the previously built wheel is compatible. Tests still will run on all selected versions of Python, using the ABI3 wheel. Check this entry in the docs for more info. (#1091)
• ✨ You can now build wheels directly from sdist archives, in addition to source directories. Just call cibuildwheel with an sdist argument on the command line, like cibuildwheel mypackage-1.0.0.tar.gz. For more details, check the --help output (#1096)
• 🐛 Fix a bug where cibuildwheel would crash when no builds are selected and --allow-empty is passed (#1086)
• 🐛 Workaround a permissions issue on Linux relating to newer versions of git and setuptools_scm (#1095)
• 📚 Minor docs improvements

v2.4.0

• ✨ cibuildwheel now supports running locally on Windows and macOS (as well as Linux). On macOS, you'll have to install the versions of Pythons that you want to use from Python.org, and cibuildwheel will use them. On Windows, cibuildwheel will install it's own versions of Python. Check out the documentation for instructions. (#974)
• ✨ Added support for building PyPy 3.9 wheels. (#1031)
• ✨ Listing at the end of the build now displays the size of each wheel (#975)
• 🐛 Workaround a connection timeout bug on Travis CI ppc64le runners (#906)
• 🐛 Fix an encoding error when reading setup.py in the wrong encoding (#977)
• 🛠 Setuptools updated to 61.3.0, including experimental support for reading config from pyproject.toml(PEP 621). This could change the behaviour of your build if you have a pyproject.toml with a [project] table, because that takes precedence over setup.py and setup.cfg. Check out the setuptools docs and the project metadata specification for more info.
• 🛠 Many other dependency updates.
• 📚 Minor docs improvements

v2.3.1

• 🐛 Setting pip options like PIP_USE_DEPRECATED in CIBW_ENVIRONMENT no longer adversely affects cibuildwheel's ability to set up a Python environment (#956)
• 📚 Docs fixes and improvements

v2.3.0

• 📈 cibuildwheel now defaults to manylinux2014 image for linux builds, rather than manylinux2010. If you want to stick with manylinux2010, it's simple to set this using the image options. (#926)
• ✨ You can now pass environment variables from the host machine into the Docker container during a Linux build. Check out the docs for CIBW_ENVIRONMENT_PASS_LINUX for the details. (#914)
• ✨ Added support for building PyPy 3.8 wheels. (#881)
• ✨ Added support for building Windows arm64 CPython wheels on a Windows arm64 runner. We can't test this in CI yet, so for now, this is experimental. (#920)
• 📚 Improved the deployment documentation (#911)
• 🛠 Changed the escaping behaviour inside cibuildwheel's option placeholders e.g. {project} in before_build or {dest_dir} in repair_wheel_command. This allows bash syntax like ${SOME_VAR} to passthrough without being interpreted as a placeholder by cibuildwheel. See this section in the docs for more info. (#889)
• 🛠 Pip updated to 21.3, meaning it now defaults to in-tree builds again. If this causes an issue with your project, setting environment variable PIP_USE_DEPRECATED=out-of-tree-build is available as a temporary flag to restore the old behaviour. However, be aware that this flag will probably be removed soon. (#881)
• 🐛 You can now access the current Python interpreter using python3 within a build on Windows (#917)

v2.2.2

• 🐛 Fix bug in the GitHub Action step causing a syntax error (#895)

v2.2.1

• 🛠 Added a config-file option on the GitHub Action to specify something other than pyproject.toml in your GitHub Workflow file. (#883)
• 🐛 Fix missing resources in sdist and released wheel on PyPI. We've also made some internal changes to our release processes to make them more reliable. (#893, #894)

v2.2.1b1

• 🛠 Added a config-file option on the GitHub Action to specify something
  other than pyproject.toml in your GitHub Workflow file. (#883)
• 🐛 Fix missing resources in sdist and released wheel on PyPI. We've made
  some internal change to our release processes to make them more reliable.
  (#893, #894)

v2.2.0

• 🌟 Added support for musllinux. Support for this new wheel format lets projects build wheels for Linux distributions that use musl libc, notably, Alpine Docker containers. (#768)

  Musllinux builds are enabled by default. If you're not ready to build musllinux, add *-musllinux_* to your CIBW_SKIP/skip option. Or, you might have to make some changes to your options - to simplify that process, you can use...

• 🌟 TOML option overrides! This provides much greater flexibility in configuration via pyproject.toml. (#854)

  You can now set build options for any subset of your builds using a match pattern. So, for example, you can customise CPython 3.8 builds with an override on cp38-* or musllinux builds by selecting *musllinux*. Check out the docs for more info on the specifics.

• 🛠 Added support for building PyPy wheels on macOS 11 CI runners. (#875)

• 🛠 Setting an empty string for the CIBW_*_IMAGE option will now fallthrough to the config file or cibuildwheel's default, rather than causing an error. This makes the option easier to use in CI build matricies. (#829)

• 🛠 Support for TOML 1.0 when reading config files, via the tomli package. (#876)

v2.2.0b1

Currently in prerelease. The below release notes will be condensed into a single entry on final release.

v2.2.0b1 (19 October 2021)

• 🌟 TOML option overrides. This provides much greater flexibility in configuration via pyproject.toml.

  You can now set build options for any subset of your builds using a match pattern. So, for example, you can customise CPython 3.8 builds with an override on cp38-* or musllinux builds by selecting *musllinux*. Check out the docs for more info on the specifics.

v2.2.0a1 (23 September 2021)

• 🌟 Added support for musllinux. Support for this new wheel format lets projects build wheels for Linux distributions that use musl libc, notably, Alpine Docker containers.

  Musllinux builds are enabled by default. To disable them on your project, add *-musllinux_* to your CIBW_SKIP/skip
  option. (#768)

• 🛠 Setting an empty string for the CIBW_*_IMAGE option will now fallthrough to the config file or cibuildwheel's default, rather than causing an error. This makes the option easier to use in CI build matricies. (#829)

v2.1.3

• 🛠 Updated CPython 3.10 to the 3.10.0 final release.