Рассмотрим следующее pyproject.toml
:
[build-system]
requires = ["setuptools>=40.8.0", "wheel"]
[project]
name = "foo"
version = "0.0.0"
requires-python = "~=3.9"
Если я запускаю pip wheel .
в каталоге, содержащем этот файл, я создаю колесо с именем foo-0.0.0-py3-none-any.whl
. Однако это имя файла колеса указывает, что любой интерпретатор python3 подходит, но мои метаданные requires-python
в моем pyproject.toml
указывают, что приемлем только python3.9.
Как я могу заставить метаданные requires-python
отражаться в колесе? Я ожидаю, что в этом случае имя файла колеса будет foo-0.0.0-cp39-cp39-any.whl
. . .
Это не совсем то, для чего используется тег платформы в имени файла колеса - cp39 указывает, что вы совместимы только с CPython 3.9 или выше, и это колесо не должно выбираться PyPy или некоторыми другими реализациями. Обычно вы используете такой тег совместимости только в том случае, если у вас есть некоторые скомпилированные расширения C внутри колеса, специфичные для CPython.
Метаданные Requires-Python по-прежнему находятся внутри встроенного колеса, что вы увидите, если попытаетесь установить его на несовместимую версию Python:
$ python3.8 -m pip install ./foo-0.0.0-py3-none-any.whl
Processing ./foo-0.0.0-py3-none-any.whl
ERROR: Package 'foo' requires a different Python: 3.8.13 not in '~=3.9'
Расположение метаданных здесь:
$ unzip foo-0.0.0-py3-none-any.whl
Archive: foo-0.0.0-py3-none-any.whl
inflating: foo-0.0.0.dist-info/METADATA
inflating: foo-0.0.0.dist-info/WHEEL
inflating: foo-0.0.0.dist-info/top_level.txt
inflating: foo-0.0.0.dist-info/RECORD
$ grep Requires foo-0.0.0.dist-info/METADATA
Requires-Python: ~=3.9
Что касается того, как это работает с PyPI — индекс может возвращать эти метаданные в json API ( пример ) и в simple API ( пример)†. Это позволяет pip избежать загрузки и распаковки несовместимых дисков.
†It's in a data-requires-python
attribute of the href - you might have to "view-source" in your browser to see it.
Если у вас есть расширения для конкретной платформы, вы можете захотеть указать параметр plat_name
для расширения bdist_wheel setuptools.
Ах, у меня есть расширение cpython. . . это говорит о том, что я никогда не видел, чтобы кто-то использовал что-либо, кроме cpython.