Skip to content

Commit cb14503

Browse files
PEP 774: Add a footnote with calculation details (#4261)
1 parent d99042d commit cb14503

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

peps/pep-0774.rst

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ difference between the actual commits and the same commits with stencils added
8989
amounts to a difference of 0.03 MB per stencil file. This is a small increase in
9090
the context of the overall repository size, which has grown by 2.55 MB in the
9191
same time period. For six stencil files, this amounts to an upper bound of 0.18 MB.
92-
The current total size of the stencil files for all six platforms is 7.2 MB.
92+
The current total size of the stencil files for all six platforms is 7.2 MB. [#stencil_calc]_
9393

9494
These stencils could become larger in the future with changes to register
9595
allocation, which would introduce 5-6 variants per instruction in each stencil
@@ -252,6 +252,17 @@ challenges of accessibility and simplicity, and fails to eliminate the
252252
dependency which was deemed undesirable at the Python Core Developer Sprint in
253253
the fall (the impetus for this PEP), making it a poor long-term solution.
254254

255+
Footnotes
256+
=========
257+
258+
.. [#stencil_calc] Calculated using this `Gist
259+
<https://gist.github.com/savannahostrowski/c66ac62267e626d82aafa27939468e30>`__.
260+
This script replays commits for roughly the past 90 days, generates the
261+
stencil file for the platform for each commit, and then commits the stencil
262+
file into a copy of the repository if they change. The calculation compares
263+
the before and after of the repository after running ``git gc --aggressive``,
264+
which is used to pack the repo (similar to what GitHub does on repo clone).
265+
255266
Copyright
256267
=========
257268

0 commit comments

Comments
 (0)