@@ -737,7 +737,7 @@ described in `modified wheel filename`_, and are characterizing using
737737hierarchical structure of namespaces, features and feature values. When
738738evaluating wheels to install, the installer determines whether variant
739739properties of a given wheel are compatible with the system, and perform
740- variant ordering based on the priority of the compatible variant
740+ ` variant ordering `_ based on the priority of the compatible variant
741741properties. This is done in addition to determining the compatibility.
742742The ordering by variant properties takes precedence over ordering by
743743tags.
@@ -751,18 +751,22 @@ embedded in the wheel; it can be either provided directly by the
751751wheel maintainer or queried at wheel build time from an AoT plugin.
752752
753753Both kinds of plugins are usually implemented as Python packages which
754- implement the provider plugin API, but they may also be vendored or
754+ implement the ` provider plugin API `_ , but they may also be vendored or
755755reimplemented by installers to improve security, as outlined in
756- `Providers `_.
757-
758- Plugin packages may be installed in isolated or non-isolated
759- environments. In particular, all plugins may be returned by the
760- ``get_requires_for_build_wheel() `` hook of a :pep: `517 ` backend, and
756+ `Providers `_. Plugin packages may be installed in isolated or
757+ non-isolated environments. In particular, all plugins may be returned by
758+ the ``get_requires_for_build_wheel() `` hook of a :pep: `517 ` backend, and
761759therefore installed along with other build dependencies. For this
762760reason, it is important that plugin packages do not narrowly pin
763761dependencies, as that could prevent different packages from being
764762installed simultaneously in the same environment.
765763
764+ Metadata governing variant support is defined in ``pyproject.toml ``
765+ file, and it is copied into ``variant.json `` file in wheels, as explored
766+ in `metadata in source tree and wheels `_. Additionally, `variant
767+ environment markers `_ can be used to define dependencies specific to a
768+ subset of variants.
769+
766770
767771Modified wheel filename
768772-----------------------
0 commit comments