Skip to content

Commit da14f55

Browse files
committed
Try clarifying plugin-api defaults
Signed-off-by: Michał Górny <mgorny@quansight.com>
1 parent e2b7749 commit da14f55

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

peps/pep-9999.rst

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -178,10 +178,11 @@ information dictionary:
178178
install the provider plugin. If the dependency specifiers include
179179
environment markers, these are evaluated against the environment where
180180
the plugin is being installed, and the requirements for which the
181-
markers evaluate to false are filtered out. At least one dependency
181+
markers evaluate to false are filtered out. At least one dependency
182182
MUST remain present in every possible environment after filtering.
183-
Additionally, if ``plugin-api`` is not specified, the first dependency
184-
present after filtering MUST always evaluate to the same API endpoint.
183+
Additionally, if ``plugin-api`` is not specified explicitly, the first
184+
dependency that remains after filtering MUST always evaluate to the
185+
same default ``plugin-api`` value.
185186

186187
A provider information dictionary MAY additionally contain the following
187188
key:
@@ -195,9 +196,10 @@ contain the following key:
195196

196197
- ``plugin-api: str``: The API endpoint for the plugin. If it is
197198
specified, it MUST be an object reference as explained in the `API
198-
endpoint`_ section. If it is missing, the package name from the first
199-
dependency specifier in ``requires`` is used, after replacing all
200-
``-`` characters with ``_`` in the normalized package name.
199+
endpoint`_ section. If it is not specified, a default value is
200+
determined by normalizing the package name from the first dependency
201+
specifier in ``requires`` and then replacing all ``-`` characters with
202+
``_`` in the normalized package name.
201203

202204
It is invalid to specify ``requires`` or ``plugin-api`` if
203205
``static-properties`` are present.

0 commit comments

Comments
 (0)