Skip to content

Rewrite RTD configuration to use build.jobs rather than build.commands#149429

Open
zware wants to merge 4 commits intopython:mainfrom
zware:rewrite_rtd_config
Open

Rewrite RTD configuration to use build.jobs rather than build.commands#149429
zware wants to merge 4 commits intopython:mainfrom
zware:rewrite_rtd_config

Conversation

@zware
Copy link
Copy Markdown
Member

@zware zware commented May 5, 2026

No description provided.

@zware zware force-pushed the rewrite_rtd_config branch 2 times, most recently from dfcae69 to 7438633 Compare May 5, 2026 20:02
Comment thread .readthedocs.yml
then
base_branch=main;
git fetch --depth=50 origin $base_branch;
for attempt in $(seq 10);
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think @StanFromIreland added a bash script for progressive unshallowing some time ago based on my experiments elsewhere. We could probably reuse that.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, he embedded bash in YAML: #147975 (comment). But perhaps, if it's extracted into Tools/, we could deduplicate the logic.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deduplicating sounds good, but I think I'll leave that for a later cleanup.

Comment thread .readthedocs.yml Outdated
zware and others added 2 commits May 5, 2026 15:45
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Comment thread .readthedocs.yml Outdated
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
@zware zware marked this pull request as ready for review May 5, 2026 20:58
@zware zware requested a review from AA-Turner as a code owner May 5, 2026 20:58
@bedevere-app
Copy link
Copy Markdown

bedevere-app Bot commented May 5, 2026

GH-149432 is a backport of this pull request to the 3.14 branch.

@zware
Copy link
Copy Markdown
Member Author

zware commented May 5, 2026

Opened the backport ahead of time because it needs to be manually adjusted anyway, and I want to make sure it doesn't do anything too weird on the 3.14 branch.

zware added a commit to zware/cpython that referenced this pull request May 5, 2026
zware added a commit to zware/cpython that referenced this pull request May 5, 2026
… build.commands (pythonGH-149429)

no --set-upstream, add explicit origin/?
Comment thread .readthedocs.yml
set -eEux;
if [ "$READTHEDOCS_VERSION_TYPE" = "external" ];
then
base_branch=main;
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there an env var that could be used instead of main? I imagine this isn't going to work well in backport PRs unless we check against stable branches.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My plan is to manually set base_branch to the right branch in each backport; I'm afraid RTD doesn't provide the base branch anywhere (that's documented, anyway).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants