Skip to content

Commit d82fc68

Browse files
committed
Mention optimization problems
Signed-off-by: William Woodruff <william@astral.sh>
1 parent 6fcd2c3 commit d82fc68

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

peps/pep-9999.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,14 @@ has modernized:
6161
``pypi:project-status-reason``, effectively flattening an object
6262
representation that appears naturally in the JSON representation.
6363

64+
Similarly, the HTML representation's rigidity makes it an optimization
65+
barrier: :pep:`658` allows indices to serve distribution metadata via
66+
the simple repository API, but the absence of a straightforward and
67+
backwards-compatible way to encode that metadata within the HTML
68+
representation means that installers must incur an additional HTTP round-trip
69+
to fetch relatively small amounts of information. :pep:`740` adopts a
70+
similar approach, with similar overhead repercussions.
71+
6472
In practice, some index PEPs have chosen not to modify the HTML representation
6573
at all, and instead focus solely on the JSON representation. :pep:`700`
6674
for example introduces both per-distribution metadata *and* a top-level

0 commit comments

Comments
 (0)