gh-131531: android.py enhancements to support cibuildwheel

[mhsmith]

#131532 added an Android release package format for the use of external tools such as cibuildwheel. This PR adds a number of features to that package to allow third-party wheels to be built and tested against it:

• Add an android.py env command which prints necessary environment variables (CC, CFLAGS, etc.).
• Generalize the android.py test command so it can be used to run any test suite, not only Python's own tests.

The corresponding cibuildwheel PR is pypa/cibuildwheel#2349.

• Issue: Android cibuildwheel support #131531

[AA-Turner]

Suggested change

	sysconfigdata_files = prefix.glob("lib/python*/_sysconfigdata__android_*.py")
	host = re.fullmatch(
	r"_sysconfigdata__android_(.+).py", next(sysconfigdata_files).name
	)[1]
	sysconfigdata_files = prefix.glob("lib/python*/_sysconfigdata__android_*.py")
	sysconfigdata_file = next(sysconfigdata_files).name
	host = re.fullmatch(r"_sysconfigdata__android_(.+).py", sysconfigdata_file)[1]

[mhsmith]

Done, with a small change to the variable names to distinguish more clearly between Paths and strings.

[AA-Turner]

Is there a way to avoid shell=True? We should try to avoid it, especially as code in python/cpython is prominent. Also, prefer 'encoding' to 'text':

Suggested change

	check=True, shell=True, capture_output=True, text=True,
	check=True, shell=True, capture_output=True, encoding='utf-8',

[mhsmith]

In this case the whole point of the code is to run a shell script and determine which environment variables it sets, so shell=True is unavoidable. However, the script is entirely under our control – it's in the repository right next to this file.

Also, prefer 'encoding' to 'text'

Thanks, fixed.

[AA-Turner]

This seems simpler, unless there's a need to minimise the size of 'env'? You could even use a dictcomp.

Suggested change

	key, value = match[2], match[3]
	if os.environ.get(key) != value:
	env[key] = value
	key, value = match[2], match[3]
	env[key] = value

[mhsmith]

This code is run by the android.py env command, which cibuildwheel uses to determine the environment variables it needs when building for Android. It outputs all variables changed by the android-env.sh script, which looks something like this:

% ./Android/android.py env aarch64-linux-android
export AR=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-ar
export AS=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-as
export CC=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/aarch64-linux-android24-clang
export CFLAGS='-D__BIONIC_NO_PAGE_SIZE_MACRO -I/Users/msmith/git/python/cpython/cross-build/aarch64-linux-android/prefix/include'
export CPU_COUNT=10
export CXX=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/aarch64-linux-android24-clang++
export CXXFLAGS='-D__BIONIC_NO_PAGE_SIZE_MACRO -I/Users/msmith/git/python/cpython/cross-build/aarch64-linux-android/prefix/include'
export HOST=aarch64-linux-android
export LD=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/ld
export LDFLAGS='-Wl,--build-id=sha1 -Wl,--no-rosegment -Wl,-z,max-page-size=16384 -Wl,--no-undefined -lm -L/Users/msmith/git/python/cpython/cross-build/aarch64-linux-android/prefix/lib'
export NM=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-nm
export PKG_CONFIG='pkg-config --define-prefix'
export PKG_CONFIG_LIBDIR=/Users/msmith/git/python/cpython/cross-build/aarch64-linux-android/prefix/lib/pkgconfig
export RANLIB=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-ranlib
export READELF=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-readelf
export SHLVL=2
export STRIP=/Users/msmith/Library/Android/sdk/ndk/27.1.12297006/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-strip

If this included every single environment variable, it would be a lot less convenient to use it to set variables manually when debugging build problems. It would also be a lot more difficult to verify its correctness.