recipe: thrift 0.25.0

[ndonkoHenri]

Adds Apache Thrift's Python runtime with its optional C++ codec, thrift.protocol.fastbinary, built for Android and iOS. Requested in flet#6909.

• Recipe
• Docs
• Example

Why a recipe

Upstream publishes desktop wheels only (cibuildwheel, since 0.24.0) and no pure-Python wheel, so flet build has nothing to install on mobile. The source_packages workaround suggested in the discussion builds the sdist for the build host instead. pip's isolated build drops serious_python's platform-faking sitecustomize, and pip never tag-checks a wheel it built itself. Verified on flet 1.0.3:

• The APK carries a macOS Mach-O as lib/<abi>/libthrift-protocol-fastbinary.so for all three ABIs.
• The iOS app ships a .fwork pointing at a framework that was never built.
• The app runs on thrift's pure-Python fallback. The *Accelerated protocols retry the broken load on every construction and ran 12–23x slower than the plain classes.

Changes

• CIBUILDWHEEL=1 makes setup.py fail when the extension doesn't compile, instead of building a pure-Python wheel.
• mobile.patch drops setup.cfg's [install] optimize = 1. Its byte-compile step imports distutils in the cross interpreter and fails on 3.12+.
• Android depends on flet-libcpp-shared for libc++_shared.so.
• Skills:
  • new-mobile-recipe: an optional extension is not "pure Python" for source_packages; new shape row for forcing optional extensions.
  • forge-error-catalogue: the source_packages cause of the iOS lipo error, and the setup.cfg [install] optimize distutils failure.
  • local-recipe-testing: concurrent iOS builds share dist_ios; give each its own PUB_CACHE.

Validation

• CI 6/6 with mobile_test_pythons=ALL (run): 11 passed, EXIT 0, on cp312, cp313 and cp314 for Android and iOS.
• Tests:
  • The codec loads, and the Accelerated protocols bind it.
  • Output is byte-identical to pure Python, and round trips succeed.
  • Loopback TCP (framed, buffered, bare) and HTTP (buffered, bare) calls count native encodes and decodes.
  • All 11 fail against a pure-Python build, which is the negative control.
• Wheels: Android DT_NEEDED lists libc++_shared.so with 16 KB LOAD alignment; iOS slices are MH_DYLIB.
• Example built and run with flet 1.0.3 on an Android 14 arm64 emulator and an iOS 18.6 simulator: native codec active, RPC and declared exception working, 9–25x native gain for the example payload.
• TLS probe on both platforms: TSSLSocket with the default context verifies against Flet's certifi bundle, and self-signed or expired hosts are rejected.
• Two adversarial review rounds on the README, example and tests.

Consumer notes

Gives Flet apps a native-speed Thrift client over TCP or HTTP; the generated code is produced on desktop. Install, transport setup, TLS and error handling are in the recipe README, with a runnable telemetry-rpc example.