[docs] Make shell interpreter explicit about cibuildwheel

[henryiii]

(Not disagreeing with better docs, btw)

[joerick]

Agreed on the docs. It's one of those things that was implied and never said.

[henryiii]

This is just subprocess.run with shell=True. Python respects the $SHELL environment variable on Posix. Generally, this is whatever you are running on macOS. On Linux, since it runs in the manylinux docker container, you'll have bash. Not sure if it's always cmd on Windows or if it respects what you run it from.

In general, it's probably best to keep this simple and cross-platform, and then manually run a bash/bat/whatever script with complex commands if you need them. Or a Python script. :)

[JP-Ellis]

Yeah, I had a hunch it would just be calling subprocess.run. I guess for me, it just wasn't clear and other than trial and error, it was difficult to figure out.

I think there's a few things that could help here:

1. Improving the docs to make what you explained really clear.
2. Perhaps adding some clearer diagnostics in the CI logs that show which shell interpreter is being used.

Ultimately, it would be awesome to be able to specify the interpreter to allow something like:

before-build = {
  shell = "python",
  script = 'import shutil; shutil.rm("{package}/bin")'
}

Though I'm not sure if there's a desire for that, and it might complicate things significantly.

[henryiii]

You can do that today. Use

before-build = [
 """python -c 'import shutil; shutil.rm("{package}/bin")'""",
]

Same for bash, etc. Better yet, stick the contents in a file, stick #!/usr/bin/env python (or bash, etc) at the top, make it executable, then run the file, like

before-build = [
 "./tools/remove_bin.py",
]

These are all cross platform and don’t depend on the shell Python uses.

Also, your example was invalid TOML (though it will be valid in TOML 1.1 eventually). Inline tables must be one line in 1.0. :(