Skip to content

Commit 32bc5cb

Browse files
committed
Allow ignoring packages with unknown markers
1 parent 7e3ad96 commit 32bc5cb

1 file changed

Lines changed: 9 additions & 7 deletions

File tree

source/specifications/dependency-specifiers.rst

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -334,13 +334,15 @@ contain non-ASCII text that users wish to perform comparisons against.
334334
Unknown marker fields
335335
'''''''''''''''''''''
336336

337-
References to unknown marker fields SHOULD raise an error rather than resulting
338-
in a comparison that evaluates to True or False. This is so that attempted
339-
installations involving unknown marker fields result in a clear installation
340-
failure, rather than an apparently successful installation that then fails at
341-
runtime due to missing dependencies (if the unknown marker is treated as
342-
False) or a potentially cryptic installation failure of a dependency that is
343-
not valid for the current platform (if the unknown marker is treated as True)
337+
References to unknown marker fields SHOULD render a package version ineligible
338+
for installation or inclusion in a locked dependency tree rather than resulting
339+
in a comparison that evaluates to True or False. This is so that published
340+
package versions with unknown marker fields are either ignored when resolving
341+
dependencies or emit a descriptive installation failure, rather than producing
342+
an apparently successful installation that then fails at runtime due to missing
343+
dependencies (if the unknown marker is treated as False) or a potentially
344+
cryptic installation failure of a dependency that is not valid for the
345+
current platform (if the unknown marker is treated as True).
344346

345347
Variables whose value cannot be calculated on a given Python implementation
346348
should evaluate to ``0`` for ``Version`` fields, and an empty string for all

0 commit comments

Comments
 (0)