PEP 517: add clarifying sentence about duplicate keys in config-settings (GH-2996)

This commit is contained in:
Ralf Gommers 2023-02-01 08:31:26 +00:00 committed by GitHub
parent 77bbe7983a
commit c36b348151
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 3 deletions

View File

@ -374,9 +374,11 @@ dictionary provided as an "escape hatch" for users to pass ad-hoc
configuration into individual package builds. Build backends MAY configuration into individual package builds. Build backends MAY
assign any semantics they like to this dictionary. Build frontends assign any semantics they like to this dictionary. Build frontends
SHOULD provide some mechanism for users to specify arbitrary SHOULD provide some mechanism for users to specify arbitrary
string-key/string-value pairs to be placed in this dictionary. For string-key/string-value pairs to be placed in this dictionary.
example, they might support some syntax like ``--package-config For example, they might support some syntax like ``--package-config CC=gcc``.
CC=gcc``. Build frontends MAY also provide arbitrary other mechanisms In case a user provides duplicate string-keys, build frontends SHOULD
combine the corresponding string-values into a list of strings.
Build frontends MAY also provide arbitrary other mechanisms
for users to place entries in this dictionary. For example, ``pip`` for users to place entries in this dictionary. For example, ``pip``
might choose to map a mix of modern and legacy command line arguments might choose to map a mix of modern and legacy command line arguments
like:: like::