setuptools-rust 1.5.1__tar.gz → 1.6.0__tar.gz

setuptools-rust-1.6.0/.bumpversion.cfg

@@ -0,0 +1,9 @@
+[bumpversion]
+commit = True
+tag = False
+current_version = 1.6.0
+message = release: {new_version}
+
+[bumpversion:file:setup.cfg]
+
+[bumpversion:file:setuptools_rust/version.py]

setuptools-rust-1.6.0/.gitattributes

@@ -0,0 +1 @@
+html-py-ever/test/*.html linguist-vendored=true

setuptools-rust-1.6.0/.github/dependabot.yml

@@ -0,0 +1,22 @@
+version: 2
+updates:
+
+  - package-ecosystem: "cargo"
+    directory: "examples/hello-world"
+    schedule:
+      interval: "monthly"
+
+  - package-ecosystem: "cargo"
+    directory: "examples/html-py-ever"
+    schedule:
+      interval: "monthly"
+
+  - package-ecosystem: "cargo"
+    directory: "examples/namespace_package"
+    schedule:
+      interval: "monthly"
+
+  - package-ecosystem: "cargo"
+    directory: "examples/rust_with_cffi"
+    schedule:
+      interval: "monthly"

setuptools-rust-1.6.0/.github/workflows/ci.yml

@@ -0,0 +1,440 @@
+name: CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref_name }}-${{ github.event.pull_request.number || github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  fmt:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - run: pip install black
+
+      - run: black --check .
+
+  mypy:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - run: pip install nox
+
+      - run: nox -s mypy
+
+  pytest:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - run: pip install nox
+
+      - run: nox -s test
+
+  build:
+    name:  ${{ matrix.python-version }} ${{ matrix.platform.os }}-${{ matrix.platform.python-architecture }}
+    runs-on: ${{ matrix.platform.os }}
+    strategy:
+      # If one platform fails, allow the rest to keep testing if `CI-no-fail-fast` label is present
+      fail-fast: ${{ !contains(github.event.pull_request.labels.*.name, 'CI-no-fail-fast') }}
+      matrix:
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12-dev", pypy-3.7, pypy-3.8, pypy-3.9]
+        platform: [
+          { os: "macos-latest",   python-architecture: "x64", rust-target: "x86_64-apple-darwin" },
+          { os: "ubuntu-latest", python-architecture: "x64", rust-target: "x86_64-unknown-linux-gnu" },
+          { os: "windows-latest", python-architecture: "x64", rust-target: "x86_64-pc-windows-msvc" },
+          { os: "windows-latest", python-architecture: "x86", rust-target: "i686-pc-windows-msvc" },
+        ]
+        exclude:
+          # No 32-bit pypy 3.7 on Windows
+          - python-version: pypy-3.7
+            platform: { os: "windows-latest", python-architecture: "x86" }
+          # No 32-bit pypy 3.8 on Windows
+          - python-version: pypy-3.8
+            platform: { os: "windows-latest", python-architecture: "x86" }
+          # No 32-bit pypy 3.9 on Windows
+          - python-version: pypy-3.9
+            platform: { os: "windows-latest", python-architecture: "x86" }
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+          architecture: ${{ matrix.platform.python-architecture }}
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.platform.rust-target }}
+
+      - name: Install Rust aarch64-apple-darwin target
+        if: matrix.platform.os == 'macos-latest'
+        run: rustup target add aarch64-apple-darwin
+
+      - name: Install test dependencies
+        run: pip install --upgrade nox
+
+      - name: Build package
+        run: pip install -e .
+
+      - name: Test examples
+        shell: bash
+        env:
+          PYTHON: ${{ matrix.python-version }}
+        run: nox -s test-examples
+
+      - name: Test macOS universal2
+        if: matrix.platform.os == 'macos-latest' && !startsWith(matrix.python-version, 'pypy')
+        shell: bash
+        env:
+          DEVELOPER_DIR: /Applications/Xcode.app/Contents/Developer
+          MACOSX_DEPLOYMENT_TARGET: '10.9'
+          ARCHFLAGS: -arch x86_64 -arch arm64
+          PYO3_CROSS_LIB_DIR: /Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.8/lib
+        run: |
+          cd examples/namespace_package
+          pip install wheel
+          python setup.py bdist_wheel
+          ls -l dist/
+          pip install --force-reinstall dist/namespace_package*_universal2.whl
+          cd -
+          python -c "from namespace_package import rust; assert rust.rust_func() == 14"
+          python -c "from namespace_package import python; assert python.python_func() == 15"
+
+      - name: Test sdist vendor Rust crates
+        shell: bash
+        run: nox -s test-sdist-vendor
+        env:
+          CARGO_BUILD_TARGET: ${{ matrix.platform.rust-target }}
+
+  test-abi3:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # If one platform fails, allow the rest to keep testing if `CI-no-fail-fast` label is present
+      fail-fast: ${{ !contains(github.event.pull_request.labels.*.name, 'CI-no-fail-fast') }}
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@master
+      - name: Setup python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Rust aarch64-apple-darwin target
+        if: matrix.os == 'macos-latest'
+        run: rustup target add aarch64-apple-darwin
+
+      - name: Build package
+        run: pip install -e .
+
+      - name: Build an abi3 wheel
+        shell: bash
+        run: |
+          set -e
+          cd examples/rust_with_cffi/
+          python --version
+          pip install -U wheel
+          python setup.py bdist_wheel --py-limited-api=cp39
+          ls -la dist/
+        env:
+          # https://github.com/actions/setup-python/issues/26
+          MACOSX_DEPLOYMENT_TARGET: 10.9
+
+      # Now we switch to a differnet Python version and ensure we can install
+      # the wheel we just built.
+      - name: Setup python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install abi3 wheel and run tests
+        shell: bash
+        run: |
+          set -e
+          cd examples/
+          pip install -U wheel
+          python --version
+          pip install rust_with_cffi/dist/rust_with_cffi*.whl
+          python -c "from rust_with_cffi import rust; assert rust.rust_func() == 14"
+          python -c "from rust_with_cffi.cffi import lib; assert lib.cffi_func() == 15"
+
+      - name: Run abi3audit
+        shell: bash
+        run: |
+          set -e
+          pip install abi3audit
+          cd examples/
+          abi3audit rust_with_cffi/dist/rust_with_cffi*.whl
+
+  test-crossenv:
+    runs-on: ubuntu-latest
+    strategy:
+      # If one platform fails, allow the rest to keep testing if `CI-no-fail-fast` label is present
+      fail-fast: ${{ !contains(github.event.pull_request.labels.*.name, 'CI-no-fail-fast') }}
+      matrix:
+        platform: [
+          { target: "aarch64-unknown-linux-gnu", arch: "aarch64" },
+          { target: "armv7-unknown-linux-gnueabihf", arch: "armv7" },
+        ]
+    steps:
+      - uses: actions/checkout@master
+      - name: Build wheels
+        run: |
+          echo 'set -ex
+          curl -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
+          source ~/.cargo/env
+          rustup target add ${{ matrix.platform.target }}
+
+          # https://github.com/pypa/setuptools_scm/issues/707
+          git config --global --add safe.directory /io
+
+          cd examples/rust_with_cffi/
+          python3.9 -m pip install crossenv
+          python3.9 -m crossenv "/opt/python/cp39-cp39/bin/python3" --cc $TARGET_CC --cxx $TARGET_CXX --sysroot $TARGET_SYSROOT --env LIBRARY_PATH= --manylinux manylinux1 venv
+          . venv/bin/activate
+          build-pip install cffi wheel "setuptools>=62.4"
+          cross-expose cffi
+          pip install wheel
+          pip install -e ../../
+          python setup.py bdist_wheel --py-limited-api=cp37
+          ls -la dist/
+          ' > build-wheels.sh
+
+          docker run --rm -v "$PWD":/io -w /io messense/manylinux2014-cross:${{ matrix.platform.arch }} bash build-wheels.sh
+      - name: Install abi3 wheel and run tests
+        uses: uraimo/run-on-arch-action@v2.0.5
+        with:
+          arch: ${{ matrix.platform.arch }}
+          distro: ubuntu20.04
+          dockerRunArgs: |
+            --volume "${PWD}/examples:/examples"
+          install: |
+            apt-get update
+            apt-get install -y --no-install-recommends python3 python3-dev python3-pip build-essential libffi-dev
+          run: |
+            cd /examples
+            python3 --version
+            pip3 install rust_with_cffi/dist/rust_with_cffi*.whl
+            python3 -c "from rust_with_cffi import rust; assert rust.rust_func() == 14"
+            python3 -c "from rust_with_cffi.cffi import lib; assert lib.cffi_func() == 15"
+
+  test-cross:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.8
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Install cross
+        uses: taiki-e/install-action@v1
+        with:
+          tool: cross
+      - name: Build package
+        run: pip install -e .
+      - name: Build wheel using cross
+        shell: bash
+        env:
+          CARGO: cross
+          CARGO_BUILD_TARGET: aarch64-unknown-linux-gnu
+          PYO3_CROSS_LIB_DIR: /opt/python/cp38-cp38/lib
+        run: |
+          cd examples/namespace_package
+          docker build -t cross-pyo3:aarch64-unknown-linux-gnu .
+          python -m pip install wheel
+          python setup.py bdist_wheel --plat-name manylinux2014_aarch64
+          ls -la dist/
+      - uses: uraimo/run-on-arch-action@v2.1.1
+        name: Install built wheel
+        with:
+          arch: aarch64
+          distro: ubuntu20.04
+          dockerRunArgs: |
+            --volume "${PWD}/examples/namespace_package:/io"
+          install: |
+            apt-get update
+            apt-get install -y --no-install-recommends python3 python3-pip
+            pip3 install -U pip
+          run: |
+            pip3 install namespace_package --no-index --find-links /io/dist/ --force-reinstall
+            python3 -c "from namespace_package import rust; assert rust.rust_func() == 14"
+            python3 -c "from namespace_package import python; assert python.python_func() == 15"
+
+  test-zigbuild:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.8
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: aarch64-unknown-linux-gnu
+      - name: Install cargo-zigbuild
+        run: |
+          python3 -m pip install cargo-zigbuild
+      - name: Build package
+        run: pip install -e .
+      - name: Build wheel using cargo-zigbuild
+        shell: bash
+        env:
+          CARGO: cargo-zigbuild
+          CARGO_BUILD_TARGET: aarch64-unknown-linux-gnu
+          PYO3_CROSS_LIB_DIR: /opt/python/cp38-cp38/lib
+        run: |
+          mkdir -p $PYO3_CROSS_LIB_DIR
+          docker cp -L $(docker create --rm quay.io/pypa/manylinux2014_aarch64:latest):/opt/python/cp38-cp38 /opt/python
+          cd examples/namespace_package
+          python -m pip install wheel
+          python setup.py bdist_wheel --plat-name manylinux2014_aarch64
+          ls -la dist/
+      - uses: uraimo/run-on-arch-action@v2.1.1
+        name: Install built wheel
+        with:
+          arch: aarch64
+          distro: ubuntu20.04
+          dockerRunArgs: |
+            --volume "${PWD}/examples/namespace_package:/io"
+          install: |
+            apt-get update
+            apt-get install -y --no-install-recommends python3 python3-pip
+            pip3 install -U pip
+          run: |
+            pip3 install namespace_package --no-index --find-links /io/dist/ --force-reinstall
+            python3 -c "from namespace_package import rust; assert rust.rust_func() == 14"
+            python3 -c "from namespace_package import python; assert python.python_func() == 15"
+
+  test-cibuildwheel:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: aarch64-apple-darwin
+      - uses: pypa/cibuildwheel@v2.3.1
+        env:
+          CIBW_BUILD: cp39-*
+          CIBW_BEFORE_BUILD: pip install -e .
+          CIBW_ARCHS_MACOS: "x86_64 universal2 arm64"
+          CIBW_BUILD_VERBOSITY: 1
+        with:
+          package-dir: examples/namespace_package
+
+  test-mingw:
+    runs-on: windows-latest
+    name:  ${{ matrix.python-version }} mingw-${{ matrix.arch }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include: [
+          { msystem: MINGW64, arch: x86_64, path: mingw64, rust_target: x86_64-pc-windows-gnu },
+          { msystem: MINGW32, arch: i686, path: mingw32, rust_target: i686-pc-windows-gnu }
+        ]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install MSys2 and dependencies
+        uses: msys2/setup-msys2@v2
+        with:
+          update: true
+          msystem: ${{ matrix.msystem }}
+          install: >-
+            git
+            mingw-w64-${{ matrix.arch }}-python
+            mingw-w64-${{ matrix.arch }}-python-pip
+            mingw-w64-${{ matrix.arch }}-openssl
+            mingw-w64-${{ matrix.arch }}-toolchain
+
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable-${{ matrix.rust_target }}
+
+      - name: Install test dependencies
+        shell: msys2 {0}
+        run: python -m pip install --upgrade nox pip wheel
+
+      - name: Create libpython symlink
+        shell: msys2 {0}
+        run: ln -s /${{ matrix.path }}/lib/libpython3.10.dll.a /${{ matrix.path }}/lib/libpython310.dll.a
+
+      - name: Test examples
+        shell: msys2 {0}
+        run: |
+          PATH="$PATH:/c/Users/runneradmin/.cargo/bin" nox -s test-mingw
+
+  test-emscripten:
+    name: Test Emscripten
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+      - run: |
+          PYODIDE_VERSION=0.21.0
+
+          cd emscripten
+          npm i pyodide@0.21.0 prettier
+          cd node_modules/pyodide/
+          node ../prettier/bin-prettier.js -w pyodide.asm.js
+          EMSCRIPTEN_VERSION=$(node -p "require('./repodata.json').info.platform.split('_').slice(1).join('.')")
+          PYTHON_VERSION=3.10
+
+          echo "PYODIDE_VERSION=$PYODIDE_VERSION" >> $GITHUB_ENV
+          echo "EMSCRIPTEN_VERSION=$EMSCRIPTEN_VERSION" >> $GITHUB_ENV
+          echo "PYTHON_VERSION=$PYTHON_VERSION" >> $GITHUB_ENV
+          echo "ORIG_PATH=$PATH" >> $GITHUB_ENV
+      - uses: dtolnay/rust-toolchain@nightly
+        with:
+          components: rust-src
+          targets: wasm32-unknown-emscripten
+      - uses: mymindstorm/setup-emsdk@v11
+        with:
+          version: ${{env.EMSCRIPTEN_VERSION}}
+          actions-cache-folder: emsdk-cache
+      - uses: actions/setup-python@v4
+        id: setup-python
+        with:
+          python-version: ${{env.PYTHON_VERSION}}
+      - run: pip install nox
+      - uses: actions/cache@v3
+        with:
+          path: |
+            tests/pyodide
+          key: ${{ hashFiles('tests/*.js') }} - ${{ hashFiles('noxfile.py') }} - ${{ steps.setup-python.outputs.python-path }}
+      - uses: Swatinem/rust-cache@v2
+      - name: Test
+        run: |
+          export PATH=$ORIG_PATH:$PATH
+          nox -s test-examples-emscripten

setuptools-rust-1.6.0/.github/workflows/python-publish.yml

@@ -0,0 +1,37 @@
+# This workflows will upload a Python Package using Twine when a release is created
+# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        # Fetch all history so that setuptools_scm works correctly
+        fetch-depth: 0
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      # Install build and packaging dependencies.
+      # setuptools-scm is necessary for ensuring all files from VCS (such as
+      # examples) are in the sdist.
+      run: |
+        pip install --upgrade pip setuptools wheel twine setuptools-scm
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*

setuptools-rust-1.6.0/.gitignore

@@ -0,0 +1,12 @@
+*.pyc
+*.pyo
+*.so
+.eggs
+.tox
+dist
+build
+target
+.pytest_cache
+*.egg-info
+pyo3
+docs/_build

setuptools-rust-1.6.0/.readthedocs.yaml

@@ -0,0 +1,7 @@
+version: 2
+
+python:
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .

{setuptools-rust-1.5.1 → setuptools-rust-1.6.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.6.0 (2023-04-27)
+### Changed
+- Prefer passing `--crate-type` option to cargo if "toolchain >= 1.64". [#322](https://github.com/PyO3/setuptools-rust/pull/322)
+
+### Fixed
+- Fix a bug where rebuilding the library would cause any running processes using it to segfault. [#295](https://github.com/PyO3/setuptools-rust/pull/295)
+- Fix `setup.cfg` format for compatibility with "poetry==1.4.0". [#319](https://github.com/PyO3/setuptools-rust/pull/319)
+
+## 1.5.2 (2022-09-19)
+### Fixed
+- Fix regression in `dylib` build artifacts not being found since 1.5.0. [#290](https://github.com/PyO3/setuptools-rust/pull/290)
+- Fix regression in sdist missing examples and other supplementary files since 1.5.0. [#291](https://github.com/PyO3/setuptools-rust/pull/291)
+
 ## 1.5.1 (2022-08-14)
 ### Fixed
 - Fix regression in `get_lib_name` crashing since 1.5.0. [#280](https://github.com/PyO3/setuptools-rust/pull/280)

{setuptools-rust-1.5.1/setuptools_rust.egg-info → setuptools-rust-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: setuptools-rust
-Version: 1.5.1
+Version: 1.6.0
 Summary: Setuptools Rust extension plugin
 Home-page: https://github.com/PyO3/setuptools-rust
 Author: Nikolay Kim
@@ -11,11 +11,11 @@ Classifier: Topic :: Software Development :: Version Control
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: MacOS :: MacOS X

setuptools-rust-1.6.0/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

setuptools-rust-1.6.0/docs/README.md

@@ -0,0 +1,2 @@
+```{include} ../README.md
+```

setuptools-rust-1.6.0/docs/building_wheels.md

@@ -0,0 +1,59 @@
+# Building wheels
+
+Because `setuptools-rust` is an extension to `setuptools`, the standard `setup.py bdist_wheel` command is used to build distributable wheels. These wheels can be uploaded to PyPI using standard tools such as [twine](https://github.com/pypa/twine).
+
+`setuptools-rust` supports building for the [PEP 384](https://www.python.org/dev/peps/pep-0384/) "stable" (aka "limited") API when the `--py-limited-api` option is passed to `setup.py bdist_wheel`. If using PyO3 bindings for `RustExtension`, then the correct [`pyo3/abi3`](https://pyo3.rs/v0.14.5/features.html#abi3) sub-feature is automatically enabled. In this way, abi3 wheels can be uploaded to make package distributors' roles easier, and  package users installing from source with `python setup.py install` can use optimizations specific to their Python version.
+
+This chapter of the documentation explains two possible ways to build wheels for multiple Python versions below.
+
+## Using `cibuildwheel`
+
+[`cibuildwheel`][cibuildwheel] is a tool to build wheels for multiple platforms using Github Actions.
+
+The [`rtoml` package does this, for example](https://github.com/samuelcolvin/rtoml/blob/143ee0907bba616cbcd5cc58eefe9000fcc2b5f2/.github/workflows/ci.yml#L99-L195).
+
+## Building manually
+
+Place a script called `build-wheels.sh` with the following contents in your project root (next to the `setup.py` file):
+
+```{eval-rst}
+.. literalinclude:: ../examples/html-py-ever/build-wheels.sh
+   :language: bash
+```
+
+This script can be used to produce wheels for multiple Python versions.
+
+### Binary wheels on linux
+
+To build binary wheels on linux, you need to use the [manylinux docker container](https://github.com/pypa/manylinux). You will run the `build-wheels.sh` from above inside that container.
+
+First, pull the `manylinux2014` Docker image:
+
+```bash
+docker pull quay.io/pypa/manylinux2014_x86_64
+```
+
+Then use the following command to build wheels for supported Python versions:
+
+```bash
+docker run --rm -v `pwd`:/io quay.io/pypa/manylinux2014_x86_64 bash /io/build-wheels.sh
+```
+
+This will create wheels in the `dist` directory:
+
+```bash
+$ ls dist
+hello_rust-0.1.0-cp37-cp37m-linux_x86_64.whl          hello_rust-0.1.0-cp37-cp37m-manylinux2014_x86_64.whl
+hello_rust-0.1.0-cp38-cp38-linux_x86_64.whl           hello_rust-0.1.0-cp38-cp38-manylinux2014_x86_64.whl
+hello_rust-0.1.0-cp39-cp39-linux_x86_64.whl           hello_rust-0.1.0-cp39-cp39-manylinux2014_x86_64.whl
+```
+
+It is possible to use any of the `manylinux` docker images: `manylinux1`, `manylinux2010` or `manylinux2014`. (Just replace `manylinux2014` in the above instructions with the alternative version you wish to use.)
+
+### Binary wheels on macOS
+
+For building wheels on macOS it is sufficient to run the `bdist_wheel` command, i.e. `setup.py bdist_wheel`.
+
+To build `universal2` wheels set the `ARCHFLAGS` environment variable to contain both `x86_64` and `arm64`, for example `ARCHFLAGS="-arch x86_64 -arch arm64"`. Wheel-building solutions such as [`cibuildwheel`][cibuildwheel] set this environment variable automatically.
+
+[cibuildwheel]: https://github.com/pypa/cibuildwheel