Skip to content

Infra: Faster incremental builds, up to 5.4x#4848

Open
hugovk wants to merge 2 commits intopython:mainfrom
hugovk:faster-incremental-builds
Open

Infra: Faster incremental builds, up to 5.4x#4848
hugovk wants to merge 2 commits intopython:mainfrom
hugovk:faster-incremental-builds

Conversation

@hugovk
Copy link
Member

@hugovk hugovk commented Mar 5, 2026

Fixes #3477.

Two changes:

  • Only rebuild index files when metadata changes. This was slow, likely because they had to read in and process all the PEP files.
  • Split the search index build to its own make target, run on CI/RTD for deploys/previews. We don't need this for most local builds, it adds some 3-5s, and you can specify it if you need it.
PEPs built main PR Speed up
all 42s (4.6s) 30s 1.4x
1 27s (3.5s) 5s 5.4x
0 25s (3.5s) 5s 5.0x

Where:

  • all: make clean html
  • 1: touch peps/pep-0008.rst; make html
  • 0: make html
  • Time in brackets is time for search rebuild.

📚 Documentation preview 📚: https://pep-previews--4848.org.readthedocs.build/

@hugovk hugovk added the infra Core infrastructure for building and rendering PEPs label Mar 5, 2026
@hugovk hugovk requested a review from a team as a code owner March 5, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

infra Core infrastructure for building and rendering PEPs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Infra: PEP 0 generation makes edit cycle too slow

1 participant