Skip to content

Feature/build perf - #10799

Merged
GarrettBeatty merged 3 commits into
v2from
feature/build-perf
Oct 23, 2026
Merged

GarrettBeatty merged 3 commits into
v2from
feature/build-perf

Conversation

@GarrettBeatty

Copy link
Copy Markdown
Contributor

Issue #, if available:

Description of changes:

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

* Parallelize docs builds with sphinx-build -j

* Declare the guzzle theme parallel-safe and build sitemap.xml from the
  environment so it is complete and ordered like a serial build when
  writing in parallel.
* Add the parallel_chunks extension, which reads with one interleaved
  chunk per process so the main process does not repeatedly unpickle
  large environments, and restores the serial document order.
* Add the parallel_write extension, which loads, resolves and indexes
  doctrees in the worker processes and merges search index entries
  back in chunk order.

With sphinx-build -j 16 this builds the docs in ~9.5 minutes instead of
~57 minutes, with output identical to a serial build.

* Fail unit tests when Sphinx is upgraded without revalidation

The parallel docs extensions patch Sphinx internals, so add a unit test
that fails when the Sphinx version in requirements-docs-lock.txt no
longer matches the version they were validated against, with steps to
confirm parallel and serial builds produce identical output.

Also restore the release version in doc/source/conf.py, which was
accidentally reverted.
Add a --dist option to scripts/ci/run-tests and run the integration
tests with --dist loadgroup. Tests are grouped per file as before,
except the large offline skeleton tests, which are distributed per
test, and the S3 plugin tests, which are distributed per class.
* Fix test_can_delete_single_sse_c_object waiting ~100s for the
  object_exists waiter to fail.
* Don't retry connection errors in test_verify_endpoint_url_is_used,
  which uses an endpoint with nothing listening.
@GarrettBeatty
GarrettBeatty requested a review from a team as a code owner October 22, 2026 16:53
@GarrettBeatty
GarrettBeatty merged commit da4fc51 into v2 Oct 23, 2026
112 of 114 checks passed
@GarrettBeatty
GarrettBeatty deleted the feature/build-perf branch October 23, 2026 14:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants