wheel tags

Usage

wheel tags [-h] [--remove] [--python-tag TAG] [--abi-tag TAG] [--platform-tag TAG] [--build NUMBER] WHEEL [...]

Description

Make a new wheel with given tags from an existing wheel. Any tags left unspecified will remain the same. Multiple tags are separated by a “.” Starting with a “+” will append to the existing tags. Starting with a “-” will remove a tag. Be sure to use the equals syntax on the shell so that it does not get parsed as an extra option, such as --python-tag=-py2. The original file will remain unless --remove is given. The output filename(s) will be displayed on stdout for further processing.

Options

--remove

Remove the original wheel, keeping only the retagged wheel.

--python-tag=TAG

Override the python tag (prepend with “+” to append, “-” to remove). Multiple tags can be separated with a dot.

--abi-tag=TAG

Override the abi tag (prepend with “+” to append, “-” to remove). Multiple tags can be separated with a dot.

--platform-tag=TAG

Override the platform tag (prepend with “+” to append, “-” to remove). Multiple tags can be separated with a dot.

--build=NUMBER

Specify a build number.

Examples

• Replace a wheel’s Python specific tags with generic tags (if no Python extensions are present, for example):

  $ wheel tags --python-tag=py2.py3 --abi-tag=none cmake-3.20.2-cp39-cp39-win_amd64.whl
  cmake-3.20.2-py2.py3-none-win_amd64.whl
  

• Add compatibility tags for macOS universal wheels and older pips:

  $ wheel tags \
      --platform-tag=+macosx_10_9_x86_64.macosx_11_0_arm64 \
      ninja-1.11.1-py2.py3-none-macosx_10_9_universal2.whl
  ninja-1.11.1-py2.py3-none-macosx_10_9_universal2.macosx_10_9_x86_64.macosx_11_0_arm64.whl