datatools-dev/.github/workflows/build.yml

name: Build installers

# Triggers:
#   * Tag push (v*) → produces installers + portable zips, attaches them
#     to a GitHub Release.
#   * Manual dispatch → uploads everything as workflow artifacts only.
#
# Outputs per platform (downloadable by buyers):
#   * macOS:    .dmg installer  + portable .zip (signed .app inside).
#   * Windows:  .exe installer  + portable .zip (no-install).
#   * Linux:    .AppImage (already portable; no separate zip).
#
# Self-contained: every artifact ships its own Python interpreter + every
# runtime dep through PyInstaller. No pre/post install steps on the
# buyer's machine.
#
# What this workflow doesn't do (yet):
#   * Code signing (Mac Developer ID, Windows code-signing cert).
#     Those need GitHub Secrets the owner sets up first. See
#     build/README.md "Signing" for the secret names this workflow
#     will read once they exist.
#   * Auto-update endpoint generation. v1 distributes via Gumroad;
#     buyers re-download for updates.

on:
  workflow_dispatch:
  push:
    tags:
      - 'v*'

permissions:
  contents: write   # needed to create the release on tag push

jobs:
  build:
    name: Build (${{ matrix.os }})
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: macos-latest
            platform: mac
            installer_glob: dist/DataTools-*-mac.dmg
            portable_glob:  dist/DataTools-*-mac-portable.zip
          - os: windows-latest
            platform: win
            installer_glob: dist/DataTools-*-win-setup.exe
            portable_glob:  dist/DataTools-*-win-portable.zip
          - os: ubuntu-latest
            platform: linux
            installer_glob: dist/DataTools-*-linux-x86_64.AppImage
            portable_glob:  ''   # AppImage is already a portable single file
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
          cache: pip

      - name: Install build deps
        run: |
          pip install --upgrade pip
          pip install -r requirements.txt
          pip install pyinstaller pillow

      - name: Read version
        id: version
        shell: bash
        run: |
          VER=$(python -c "import re; print(re.search(r'__version__\s*=\s*\"([^\"]+)\"', open('src/__init__.py').read()).group(1))")
          echo "version=$VER" >> "$GITHUB_OUTPUT"

      - name: Generate platform icons
        run: python build/generate_icons.py

      - name: Build PyInstaller bundle
        run: pyinstaller build/datatools.spec --clean --noconfirm

      # ---- Per-platform installer packaging ------------------------

      - name: Package macOS DMG (installer)
        if: matrix.os == 'macos-latest'
        run: bash build/macos/build_dmg.sh "${{ steps.version.outputs.version }}"

      - name: Package macOS portable .zip
        if: matrix.os == 'macos-latest'
        run: bash build/macos/build_zip.sh "${{ steps.version.outputs.version }}"

      - name: Install Inno Setup (Windows)
        if: matrix.os == 'windows-latest'
        run: choco install innosetup --no-progress -y

      - name: Package Windows installer
        if: matrix.os == 'windows-latest'
        shell: cmd
        run: |
          iscc /DAppVersion=${{ steps.version.outputs.version }} build\installer.iss

      - name: Package Windows portable .zip
        if: matrix.os == 'windows-latest'
        run: python build/build_portable_zip.py win ${{ steps.version.outputs.version }}

      - name: Install AppImage tooling (Linux)
        if: matrix.os == 'ubuntu-latest'
        run: |
          sudo apt-get update
          sudo apt-get install -y libfuse2 wget
          wget -q https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage -O /usr/local/bin/appimagetool
          sudo chmod +x /usr/local/bin/appimagetool

      - name: Package Linux AppImage
        if: matrix.os == 'ubuntu-latest'
        run: bash build/appimage/build.sh "${{ steps.version.outputs.version }}"

      # ---- Upload + release ----------------------------------------

      - name: Upload installer artifact
        uses: actions/upload-artifact@v4
        with:
          name: DataTools-${{ matrix.platform }}-installer
          path: ${{ matrix.installer_glob }}
          if-no-files-found: error

      - name: Upload portable artifact
        if: matrix.portable_glob != ''
        uses: actions/upload-artifact@v4
        with:
          name: DataTools-${{ matrix.platform }}-portable
          path: ${{ matrix.portable_glob }}
          if-no-files-found: error

      - name: Attach installer to Release (tag push only)
        if: startsWith(github.ref, 'refs/tags/v')
        uses: softprops/action-gh-release@v2
        with:
          files: ${{ matrix.installer_glob }}
          fail_on_unmatched_files: true
          generate_release_notes: true

      - name: Attach portable to Release (tag push only)
        if: startsWith(github.ref, 'refs/tags/v') && matrix.portable_glob != ''
        uses: softprops/action-gh-release@v2
        with:
          files: ${{ matrix.portable_glob }}
          fail_on_unmatched_files: true