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.

v2.2.0a1

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

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

• 🛠 Updated CPython 3.10 to 3.10.0rc2
• 📚 Multiple docs updates
• 🐛 Improved warnings when built binaries are bundled into the container on Linux. (#807)