PEP 735: Refine phrasing around 'non-standard' tool features (#3689)

Refine "non-standard" phrasing in PEP 735

One of the Poetry maintainers noted tha the current phrasing could be
read as a negative take on `poetry` and `pdm` using "non-standard"
data.

At the same time, it's important to be clear that the problem being
solved here is not adequately solved by the existing tools due to the
lack of an existing underlying standard.

This rephrasing tries to balance these two concerns, describing the
current behaviors as 'tool specific' and focusing on "standardization"
(positive) rather than "non-standardization" (negative).
This commit is contained in:
Stephen Rosen 2024-02-26 13:05:24 -06:00 committed by GitHub
parent 3029af3348
commit c55835e170
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 4 deletions

View File

@ -168,8 +168,10 @@ Regarding Poetry and PDM Dependency Groups
------------------------------------------ ------------------------------------------
The existing Poetry and PDM tools already offer a feature which each calls The existing Poetry and PDM tools already offer a feature which each calls
"Dependency Groups", but using non-standard data belonging to the ``poetry`` "Dependency Groups". However, absent any standard for specifying collections
and ``pdm`` tools. of dependencies, each tool defines these in a tool-specific way, in the
relevant sections of the ``[tool]`` table.
(PDM also uses extras for some Dependency Groups, and overlaps the notion (PDM also uses extras for some Dependency Groups, and overlaps the notion
heavily with extras.) heavily with extras.)
@ -180,8 +182,9 @@ to common dependency specifiers.
It should be possible for such tools to use standardized Dependency Groups as It should be possible for such tools to use standardized Dependency Groups as
extensions of their own Dependency Group mechanisms. extensions of their own Dependency Group mechanisms.
However, defining a new data format which replaces the existing Poetry and PDM However, defining a new data format which replaces the existing Poetry and PDM
solutions is a non-goal, as it would require standardizing their various solutions is a non-goal. Doing so would require standardizing several
non-standard features. additional features, such as path dependencies, which are supported by these
tools.
Dependency Groups are not Hidden Extras Dependency Groups are not Hidden Extras
--------------------------------------- ---------------------------------------