Make the {project} placeholder available to repair-wheel-command

[arcondello]

Closes #2588
Closes #1931

Let me know if you'd prefer a different approach for testing, the change I made amounts to a smoke test.

[agriyakhetarpal]

Thanks, @arcondello! This looks good to me. Could you also mark #1931 to be closed with this?

[arcondello]

Oh wow, totally missed that one. Updated

[henryiii]

I'm a little surprised we don't run the command from the project directory on Linux.

[joerick]

I'm a little surprised we don't run the command from the project directory on Linux.

This is what's confusing me also... I'm 90% sure that we do...! But I think this can still be useful so I'm happy to merge it.

On testing, it appears that the previous test did actually assert that the cwd was the project directory previously. Could we make sure that we don't lose that too? It might be best to revert the test change and add another test, perhaps on just a single python version, that runs the script with the {project} placeholder.

[arcondello]

On testing, it appears that the previous test did actually assert that the cwd was the project directory previously. Could we make sure that we don't lose that too? It might be best to revert the test change and add another test, perhaps on just a single python version, that runs the script with the {project} placeholder.

Sure, I can do that

[arcondello]

As an alternative, if the intent is always to run the repair-wheel-command in the project directory, I can change the PR to update the documentation to specify that. IMO the explicit approach gives more flexibility in the future, but I am happy either way.

[joerick]

As an alternative, if the intent is always to run the repair-wheel-command in the project directory, I can change the PR to update the documentation to specify that.

Yes, that is the intention. I doubt that will change - the other commands like before-build etc. also run from the project dir (which is the cwd when cibuildwheel starts). Logic with relative paths gets pretty strange if we change this rule!

Happy to see this noted in the docs.

Also, I think it might be nice for consistency for {package} to be expanded in repair-wheel-command as well. If you have time :)

[arcondello]

Happy to see this noted in the docs.

Will do

Also, I think it might be nice for consistency for {package} to be expanded in repair-wheel-command as well. If you have time :)

Sure, I can do that.

Likely will be able to update the PR tomorrow

[arcondello]

Ok updated, sorry for the delay. Though I fear my pattern matching for the tests is falling short and that something more sophisticated would be better.

[arcondello]

I dont think the readthedocs error is related to this PR? but if it is let me know

[Copilot]

Pull Request Overview

This PR adds support for the {project} and {package} placeholders in the repair-wheel-command configuration option, allowing users to reference the project root and package directory in their custom repair wheel commands.

• Adds project and package parameters to prepare_command calls for repair_command across all platforms
• Updates documentation to mention the new placeholder support
• Adds a parameterized test to verify the placeholders work correctly

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
cibuildwheel/platforms/windows.py	Adds package and project parameters to repair command preparation
cibuildwheel/platforms/macos.py	Adds package and project parameters to repair command preparation
cibuildwheel/platforms/linux.py	Adds package and project parameters to repair command preparation using container paths
cibuildwheel/platforms/pyodide.py	Adds package and project parameters to repair command preparation
cibuildwheel/platforms/android.py	Adds package and project parameters to repair command preparation
docs/options.md	Documents the availability of {package} and {project} placeholders for repair-wheel-command
test/test_custom_repair_wheel.py	Adds parameterized test to verify placeholder functionality in repair wheel commands

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.