serious_python 3.0.0

serious_python: ^3.0.0 copied to clipboard

• New in-process transport (dart_bridge FFI). SeriousPython.run can now run the embedded interpreter in-process through the dart_bridge FFI bridge instead of talking to it over a socket. The Python lifecycle (initialize / run / teardown) is absorbed into the dart_bridge native library on every platform — dart_bridge.xcframework (iOS/macOS), libdart_bridge.so (Android/Linux), and dart_bridge.dll / dart_bridge.pyd (Windows) — and a new PythonBridge API exposes a MsgPack control channel plus dedicated binary data channels between Dart and Python. See the bridge_example app. The bundled dart_bridge is 1.4.0.
• Android native packaging — memory-mapped from the APK. Python extension modules are relocated into jniLibs and loaded directly from the APK (mmap, no extraction) by a custom importer that resolves them from .soref markers; pure Python ships in stored, ABI-common asset zips read via zipimport (no per-ABI duplication). Apps no longer need useLegacyPackaging / keepDebugSymbols — the brittle per-app packaging config is gone. Set SERIOUS_PYTHON_ANDROID_EXTRACT_PACKAGES (comma-separated relative paths) to ship path-hungry packages extracted to disk. The dart-bridge Android binary uses the full CPython API (PyConfig) to install the importer before site runs.
• Breaking change: requires Flutter 3.44.2 / Dart 3.12+. The Android plugin moves to AGP 8.11.1, compileSdk 36, Java 17, and the Kotlin-DSL Gradle build (build.gradle.kts).
• Python runtime versions are now a committed snapshot of flet-dev/python-build's date-keyed manifest.json, generated by dart run serious_python:gen_version_tables. SERIOUS_PYTHON_VERSION (short, e.g. 3.14) is the single input — the full CPython version, python-build release date, Pyodide version + platform tag, and dart_bridge version all derive from it. SERIOUS_PYTHON_FULL_VERSION, SERIOUS_PYTHON_BUILD_DATE, and DART_BRIDGE_VERSION remain as rarely-needed escape hatches. The native build configs (Android build.gradle, Darwin podspec, Linux/Windows CMakeLists.txt) read the generated python_versions.properties, and a CI job fails if the snapshots drift from the manifest. This replaces the per-config hardcoded defaults and the flet build-exported SERIOUS_PYTHON_FULL_VERSION / SERIOUS_PYTHON_BUILD_DATE introduced in 2.0.0.
• Bundle 3.12.13 / 3.13.14 / 3.14.6 (python-build 20260614); Pyodide 0.27.7 / 0.29.4 / 314.0.0 (314.0.0 GA, up from the 314.0.0a2 in 2.0.0).
• Add dart run serious_python:main version [--json] — prints the serious_python version, the pinned python-build release, and the supported Python / Pyodide / dart_bridge matrix.
• The embedded Darwin runtime re-extracts when the selected Python version changes (a version marker guards dist_ios / dist_macos), so a clean build after switching --python-version can't mix C-extension ABIs (bad magic number / unknown slot ID).
• Cache downloaded Python distributions and dart_bridge artifacts under $FLET_CACHE_DIR (default ~/.flet/cache) across all platforms.
• Remove the scaffold getPlatformVersion method from the platform plugins.
• Drop the x86 (32-bit Intel) Android ABI — Flutter no longer produces it. Android builds target arm64-v8a + x86_64 (plus armeabi-v7a on Python 3.12); the x86 wheel platform-tag entry and the Android packaging rules referencing it are removed.
• Android ABI list now reads from python-build's manifest (per-minor android_abis, surfaced as <short>.android_abis in python_versions.properties and PythonRelease.androidAbis in the generated Dart) instead of the hardcoded if pythonVersion == "3.12" branch in serious_python_android/android/build.gradle.kts. Drives both defaultConfig.ndk.abiFilters and the per-ABI download/copy fan-out; adding a future minor only needs the one-line manifest edit.
• Breaking change: the configure command (and the bare in-place version-switching machinery, including stageDarwinRuntime) is removed. Switching the bundled Python version between builds is now handled by a clean rebuild — flet build wipes its build dir on a version change, and the Darwin dist_ios / dist_macos version marker re-extracts the runtime — so a separate serious_python configure step is no longer needed.
• Bug fix: the Pyodide 0.29 wheel platform tag for the 3.13 row was pyodide-2025.0-wasm32, but Pyodide publishes 0.29 wheels under pyemscripten_2025_0_wasm32; corrected to pyemscripten-2025.0-wasm32 so flet build web --python-version 3.13 matches native wheels.

• Breaking change: the package command's default Python is now the latest supported stable (3.14), up from the previously implicit 3.12. Scripts that ran dart run serious_python:main package … without --python-version will now download CPython 3.14, install 3.14 wheels, and use the matching Pyodide / Android platform tags. Pin explicitly with --python-version 3.12 (or SERIOUS_PYTHON_VERSION=3.12) to preserve the old behavior.
• Breaking change: Android sysconfig.get_platform() tag format changed from android-24-arm64-v8a to android-24-arm64_v8a (and similarly for armeabi-v7a). The emitted wheel tag (android_24_arm64_v8a) is unchanged, but anything reading the raw sysconfig.get_platform() string from sitecustomize.py should switch separators.
• Breaking change: Windows host arch identifier dropped the -shared suffix (x86_64-pc-windows-msvc-shared → x86_64-pc-windows-msvc); follows astral-sh/python-build-standalone, which only publishes the combined (already shared) install_only_stripped build.
• Multi-version Python support. The package command accepts --python-version (or SERIOUS_PYTHON_VERSION env var) to select between Python 3.12 / 3.13 / 3.14. The matching CPython-standalone build, Pyodide release, and Emscripten wheel platform tag are looked up from a new _pythonReleases table. Adding a future pre-release line (e.g. 3.15 beta) is a one-row append with prerelease: true; the Flet CLI uses that flag to keep open-ended requires-python specifiers (>=3.14) on stable, while still letting --python-version 3.15 or ==3.15.* opt in.
• The Emscripten pip platform tag is now derived per Python release (e.g. pyodide-2024.0-wasm32 for 0.27.7, pyemscripten-2026.0-wasm32 for 314.0.0a2), via a pyodide_platform_tag field in the version registry. The previous static pyodide-2024.0-wasm32 entry in platforms["Emscripten"] has been removed.
• sitecustomize.py now shims platform.android_ver so the new pip / packaging that ships with python-build-standalone 20260602+ can compute Android wheel tags on Python 3.12 hosts (where android_ver didn't exist) and on Python 3.13+ hosts (where it returns api_level=0 off-device).
• Skip 32-bit Android ABIs (armeabi-v7a, x86) when Python ≥ 3.13 — PEP 738 dropped 32-bit Android support, and flet-dev/python-build no longer publishes those runtimes for those versions.

Improvements #

• Cache downloaded Python distribution tarballs (python-android-dart-<py>-<abi>.tar.gz) across builds. The downloadDistArchive_* Gradle tasks now write to a persistent cache directory — $FLET_CACHE_DIR/python-build/v<python_version>/ if the env var is set, otherwise ~/.flet/cache/python-build/v<python_version>/ — and use onlyIfModified true + useETag "all" so subsequent builds issue a conditional GET (If-None-Match / If-Modified-Since) against objects.githubusercontent.com instead of re-downloading 30–100 MB per ABI per build. When the upstream release republishes a tarball at the same URL (e.g. a Python patch update under the existing v<py> release), the validators flip and the cache refreshes automatically; otherwise the build skips the download entirely. tempAndMove true guards against partial downloads being kept in the cache (flet-dev/flet#6555, #208) by @FeodorFitsner.

Bug fixes #

• Set PIP_REQUIRE_VIRTUALENV=false for pip install in the package command so packaging works in environments where users have globally exported PIP_REQUIRE_VIRTUALENV=true (#202, #204) by @FeodorFitsner.

• Breaking change: --platform argument value Pyodide has been renamed to Emscripten to match what platform.system() returns in the Pyodide runtime, so PEP 508 markers like platform_system != 'Emscripten' work consistently.

• Fix web packaging to skip site-packages when appropriate (#199).

• Disable user-site packages in pip environment (#195).

• Android: Add debug logs and deduplicate FFI imports.
• Android: Invalidate extracted assets when version keys change.

• Add zipDirectoryPosix to create POSIX-compliant app archives on Windows.
• Enforce C++20 standard for serious_python plugin build.
• Fix: Normalize WINDIR path for bundled DLLs in CMake.
• Fix Logcat logging crash on some Android devices.

• Fix logging on Android.

• Fix app restart on Android 10.
• Redirect Python output to logcat.

• Make zipDirectory call asynchronous.

• Bump archive to ^4.0.7.
• Fixed iOS framework identifier generation.

• 16 KB memory page support for Android 15+ (by @ReYaNOW).

• Fix: Hidden files in site-packages are skipped when building macOS app.
• Fix: Do not delete package metadata in .dist-info directories (#164).

• Breaking change: multiple --requirements options of package command must be passed as --requirements DEP_1 --requirements DEP_2 ... (or -r DEP_1 -r DEP_2 ...) instead of -r DEP_1,DEP_2,... to support dependency specifications with commas, e.g. pandas>=2.2,<3.
• Fix site-packages packaging for Pyodide platform.

• Fix serious_python to work on macOS 12 Monterey and built with Xcode 14.

• Set MinimumOSVersion to 13.0 for generated Python frameworks.
• iOS and macOS packaging: Python system libraries are put into python.bundle to pass App Store verification.
• On macOS, Windows, and Linux, application site packages are copied in an unpacked state to the application bundle to speed up the first launch.
• Pyodide 0.27.2
• Python 3.12.9
• Packaging --cleanup option replaced with two separate --cleanup-app and --cleanup-packages options.
• New packaging options --cleanup-app-files and --cleanup-package-files to specify a list of globs to exclude files and directories from app and site packages.
• New packaging --skip-site-packages option to skip site packages installation for faster re-builds.
• Packaging --arch option accepts a list now.

• Fixed: xcframeworks migration script didn't work for sub-directories.

• Added com.flet.serious_python_android.PythonActivity holder class with mActivity holding a reference to an app MainActivity. Needed for plyer.
• Android plugin sets MAIN_ACTIVITY_HOST_CLASS_NAME environment variable with the name of activity holder class name (com.flet.serious_python_android.PythonActivity).
• Android plugin sets MAIN_ACTIVITY_CLASS_NAME environment variable with a class name of an app MainActivity.
• Android plugin sets ANDROID_NATIVE_LIBRARY_DIR environment variable with the path to a directory containing app .so libraries. Needed for patching ctypes.find_library.
• Changed behavior of SERIOUS_PYTHON_ALLOW_SOURCE_DISTRIBUTIONS environment variable that should contain a comma-separated list of packages to allow installation from source distribution.
• Fixed: iOS site-packages to xcframeworks migration script supports both library.so and library.{something}.so.

• Added Java loadLibrary to Android plugin to support pyjnius (#128).

• Copy site-packages/flutter contents to SERIOUS_PYTHON_FLUTTER_PACKAGES.
• Added SERIOUS_PYTHON_ALLOW_SOURCE_DISTRIBUTIONS variable to allow pip installing from source distributions.

• Remove PYTHONOPTIMIZE=2 to make CFFI work.

• Copy .so libraries from {site-packages}/opt to jniLibs.

• Remove --only-binary when packaging for desktop platforms (#112)
• Fixed: only pass string args ('script') if they are not null. (#77)
• Fixed: script set as empty string to fix windows build error (#83)

• Not based on Kivy!
• Fast packaging uses pre-built Python binary packages hosted on https://pypi.flet.dev and https://pypi.org. If a binary package for specific platform/arch is not found the packaging process does not make an attempt to compile it, but just exits with a meaningful error.
• To package for iOS and Android developer should set SERIOUS_PYTHON_SITE_PACKAGES environment variable with a path to a temp directory for installed app packages. The contents of that directory is embedded into app bundle during app compilation. For macOS, Linux and Windows app packages are installed into __pypackages__ inside app package asset zip.
• Packaging command is not looking for requirements.txt or pyproject.toml anymore, but all requirements should be passed explicitly via --requirements option. The value of --requirements option is passed "as is" to pip command. For example, --requirements flet,numpy==2.1.1 install two requirements directly, or --requirements -r,requirements.txt installs deps from a file.
• MacOS packaging includes Python binaries for both arm64 and x86_64 architectures. Can limit to only one architecture with --arch option.
• New options to enable compilation and cleanup of app and packages .py files: --compile-app, --compile-packages and --cleanup.
• Packaging for web is no longer relied on a HTML document with links, but spawns its own PyPI-compatible server with links to Pyodide packages.
• Build python distributive is cached in Flutter's build directory, not temp, to avoid re-downloading on consequent re-packages.
• Web builds updated to Pyodide 0.26.2.
• Packages for iOS and Android are built with Mobile Forge.
• Python for all platforms is built with flet-dev/python-build and this CI job. Python distros for Dart and Mobile Forge uploaded to releases.

• Added namespace definition to Android Gradle build.
• Bump dependencies.

• runPython() method to support running Python script.
• Updated flet_example to catch program output and errors, sys.exit() support.
• package command to read dependencies from pyproject.toml.

• --exclude option for package command - to exclude directories and files from Python app package.
• Re-create temp Python distributive directory on every run of package command.

• --verbose flag - verbose output.
• --mobile flag - (removes .so) from app dest archive.
• --web flag for packaging for pyodide.
• --find-links option for installing pip dependencies from alternative sources (indexes).
• --dep-mappings for rewriting flet dependency to either flet-embed or flet-pyodide.
• --req-deps for adding required dependencies like flet-embed or flet-pyodide.
• --platform option for use with sitecustomize.py to tweak pip to pull platform-specific packages.
• More structured regular output.
• Bump deps versions.

• Simplified Python initialization on Android.

• Python 3.11.6 for all platforms.

• Bumping version after fixing pubspec.yaml.

• macOS, Windows and Linux support.
• Support for custom Python libraries in Android and iOS apps.

• Set Flutter SDK requirements to remove publishing warnings.

• serious_python all-in-one package refactored to a federated plug-in with multiple endorsed packages.

• Fix _Py_HashRandomization_Init error on Windows.
• Reliably re-download Python executable.

• Android fixes to make it work on some devices when installed via Play Store.

• Exclude x86 from supported ABIs.
• Fixed: Packaging python app using the packaging command raising an error on windows (#8).

• Fix iOS pod.

• Android support.

• SeriousPython.run() should be split into two methods to return temp dir with unpacked python app (#6).

• Bump .podspec version.

• Add app's path to PYTHONPATH.
• Compile Python app to a bytecode.
• Compile Python system standard libraries to a bytecode.

• Package dist site-packages to a zip, so publishing to App Store doesn't fail.

• Fixed issue with setting current directory on Python start.
• Added --pre flag to serious_python:main CLI.
• Added Flet example.
• Hid internal implementation behind src dir.

• Initial release of serious_python with iOS support.