build-python-version.yml

name: Build Python Version

on:
  workflow_call:
    inputs:
      python_version:
        description: Full Python version (e.g. 3.13.12)
        required: true
        type: string
  workflow_dispatch:
    inputs:
      python_version:
        description: Full Python version (e.g. 3.13.12)
        required: true
        type: choice
        options:
          - 3.12.13
          - 3.13.14
          - 3.14.6

env:
  PYTHON_VERSION: ${{ inputs.python_version || github.event.inputs.python_version }}
  # Optional override: pin a specific python-build-standalone release date
  # (https://github.com/astral-sh/python-build-standalone/releases). When empty,
  # linux/package-for-linux.sh auto-resolves the newest release for PYTHON_VERSION.
  PYTHON_DIST_RELEASE: ""

permissions:
  contents: read

jobs:
  build-darwin:
    name: Build Python for iOS and macOS
    runs-on: macos-26
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Derive short Python version
        shell: bash
        run: |
          echo "PYTHON_VERSION_SHORT=$(echo "$PYTHON_VERSION" | cut -d. -f1,2)" >> "$GITHUB_ENV"

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ env.PYTHON_VERSION_SHORT }}

      - name: Build Python for iOS and macOS
        working-directory: darwin
        shell: bash
        run: |
          mkdir -p dist

          # iOS: 3.14+ uses CPython's in-tree Apple tooling, 3.13 builds from source per
          # iOS/README.rst, 3.12 uses beeware. Emits normalized ./install + ./support.
          python build_ios.py "$PYTHON_VERSION"

          # mobile-forge artifact: iOS-only install+support tree (same structure as before).
          # Captured before the macOS build also writes into ./support / ./install.
          tar -czf dist/python-ios-mobile-forge-$PYTHON_VERSION.tar.gz install support

          # macOS: universal2 framework built from source (all versions).
          python build_macos.py "$PYTHON_VERSION"

          # Package scripts receive the FULL Python version: the tarball name
          # carries it verbatim so a date-keyed release can host multiple
          # patches of the same minor (e.g. 3.14.5 + 3.14.6) side by side.
          # Internal lookups inside the scripts derive the short version
          # themselves where they need it.
          bash ./package-ios-for-dart.sh . "$PYTHON_VERSION"
          bash ./package-macos-for-dart.sh . "$PYTHON_VERSION"

      - name: Upload Darwin build artifacts
        uses: actions/upload-artifact@v7
        with:
          name: python-darwin-${{ env.PYTHON_VERSION }}
          path: darwin/dist/python-*.tar.gz
          if-no-files-found: error

  build-android:
    name: Build Python for Android
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Derive short Python version
        shell: bash
        run: |
          echo "PYTHON_VERSION_SHORT=$(echo "$PYTHON_VERSION" | cut -d. -f1,2)" >> "$GITHUB_ENV"

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ env.PYTHON_VERSION_SHORT }}

      - name: Run pre-build tests
        shell: bash
        env:
          PYTHON_VERSION_SHORT: ${{ env.PYTHON_VERSION_SHORT }}
          MOBILE_FORGE_TEST_PHASE: pre_build
        run: python3 -m unittest discover -s android/tests -t android/tests -v

      - working-directory: android
        shell: bash
        run: |
          bash ./build-all.sh "$PYTHON_VERSION"
          mkdir -p dist
          tar -czf dist/python-android-mobile-forge-$PYTHON_VERSION.tar.gz install support
          bash ./package-for-dart.sh install "$PYTHON_VERSION" arm64-v8a
          bash ./package-for-dart.sh install "$PYTHON_VERSION" x86_64
          read version_major version_minor < <(echo "$PYTHON_VERSION" | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/')
          version_int=$((version_major * 100 + version_minor))
          if [ $version_int -lt 313 ]; then
            bash ./package-for-dart.sh install "$PYTHON_VERSION" armeabi-v7a
          fi

      - name: Run post-build tests
        shell: bash
        env:
          PYTHON_VERSION_SHORT: ${{ env.PYTHON_VERSION_SHORT }}
          MOBILE_FORGE_TEST_PHASE: post_build
          MOBILE_FORGE_INSTALL_TREE: ${{ github.workspace }}/android/install
        run: python3 -m unittest discover -s android/tests -t android/tests -v

      - name: Upload build artifacts
        uses: actions/upload-artifact@v7
        with:
          name: python-android-${{ env.PYTHON_VERSION }}
          path: android/dist/python-android-*.tar.gz
          if-no-files-found: error

  build-linux:
    name: Build Python for Linux
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Derive short Python version
        shell: bash
        run: |
          echo "PYTHON_VERSION_SHORT=$(echo "$PYTHON_VERSION" | cut -d. -f1,2)" >> "$GITHUB_ENV"

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ env.PYTHON_VERSION_SHORT }}

      - working-directory: linux
        shell: bash
        env:
          # Lets resolve_pbs.py authenticate to the GitHub API and avoid rate limits.
          GITHUB_TOKEN: ${{ github.token }}
        run: |
          bash ./package-for-linux.sh x86_64 "_v2"
          bash ./package-for-linux.sh aarch64 ""

      - name: Upload build artifacts
        uses: actions/upload-artifact@v7
        with:
          name: python-linux-${{ env.PYTHON_VERSION }}
          path: linux/python-linux-dart-*.tar.gz
          if-no-files-found: error

  build-windows:
    name: Build Python for Windows
    runs-on: windows-2022
    steps:
      - uses: actions/checkout@v6

      - name: Derive short Python version
        shell: pwsh
        run: |
          $parts = "${{ env.PYTHON_VERSION }}".Split(".")
          "PYTHON_VERSION_SHORT=$($parts[0]).$($parts[1])" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ env.PYTHON_VERSION_SHORT }}

      - name: Build CPython from sources and package for Dart
        shell: pwsh
        run: |
          .\windows\package-for-dart.ps1 `
            -PythonVersion "${{ env.PYTHON_VERSION }}" `
            -PythonVersionShort "${{ env.PYTHON_VERSION_SHORT }}"

      - name: Upload build artifacts
        uses: actions/upload-artifact@v7
        with:
          name: python-windows-${{ env.PYTHON_VERSION }}
          path: windows/python-windows-for-dart-*.zip
          if-no-files-found: error

  # The publish-release job lives in the parent workflow (build-python.yml):
  # date-keyed releases collect tarballs from every matrix entry into one
  # release, so the publish step has to run after the full matrix completes.