Merge pull request #3 from btucker/feature/add-wheel

fix: include libfoundation_models.dylib in wheels and build for multiple python versions

Author: btucker

.github/workflows/publish-to-pypi.yml

@@ -10,65 +10,98 @@ permissions:
   id-token: write # Required for trusted publishing to PyPI
 
 jobs:
-  build:
-    name: Build package on macOS
+  build-wheels:
+    name: Build wheels on macOS for Python ${{ matrix.python-version }}
     runs-on: macos-26
+    strategy:
+      matrix:
+        # Build wheels for all supported Python versions
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Set up Python
+      - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
+          python-version: ${{ matrix.python-version }}
 
       - name: Check macOS version
         run: |
           echo "macOS version:"
           sw_vers
           echo "Architecture:"
           uname -m
+          echo "Python version:"
+          python --version
 
-      - name: Install build dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install build wheel setuptools Cython>=3.0.0
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
 
-      - name: Build package
+      - name: Build wheel
+        env:
+          MACOSX_DEPLOYMENT_TARGET: "26.0"
+          ARCHFLAGS: "-arch arm64"
+          _PYTHON_HOST_PLATFORM: "macosx-26.0-arm64"
         run: |
-          python -m build
+          uv build --wheel
 
-      - name: Check build artifacts
+      - name: Verify wheel contents
         run: |
           echo "Build artifacts:"
           ls -lh dist/
           echo ""
-          echo "Verifying wheel contents:"
-          unzip -l dist/*.whl || true
+          echo "Checking for dylib in wheel:"
+          if unzip -l dist/*.whl | grep -q "libfoundation_models.dylib"; then
+            echo "✓ libfoundation_models.dylib found in wheel"
+            unzip -l dist/*.whl | grep -E "(dylib|\.so)"
+          else
+            echo "✗ ERROR: libfoundation_models.dylib NOT found in wheel!"
+            echo "Full wheel contents:"
+            unzip -l dist/*.whl
+            exit 1
+          fi
 
-      - name: Upload build artifacts
+      - name: Upload wheel
         uses: actions/upload-artifact@v4
         with:
-          name: python-package-distributions
-          path: dist/
+          name: wheel-${{ matrix.python-version }}
+          path: dist/*.whl
 
   publish:
     name: Publish to PyPI
-    needs: build
+    needs: [build-wheels]
     runs-on: ubuntu-latest
 
     steps:
-      - name: Download build artifacts
+      - name: Download all artifacts
         uses: actions/download-artifact@v4
         with:
-          name: python-package-distributions
           path: dist/
+          merge-multiple: true
 
       - name: Verify artifacts
         run: |
           echo "Downloaded artifacts:"
           ls -lh dist/
+          echo ""
+          echo "Verifying each wheel contains dylib:"
+          for wheel in dist/*.whl; do
+            echo "Checking $wheel:"
+            ls -lh "$wheel"
+            if unzip -l "$wheel" | grep -q "libfoundation_models.dylib"; then
+              echo "  ✓ dylib present"
+            else
+              echo "  ✗ ERROR: dylib missing in $wheel!"
+              echo "Wheel contents:"
+              unzip -l "$wheel"
+              exit 1
+            fi
+          done
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
       fail-fast: false
 
     steps:
@@ -38,13 +38,20 @@ jobs:
           echo "Architecture:"
           uname -m
 
-      - name: Install dependencies and build extensions
+      - name: Build wheel
         run: |
-          uv sync --extra dev
+          uv build --wheel
+
+      - name: Install wheel and test dependencies
+        run: |
+          uv venv .test-venv
+          source .test-venv/bin/activate
+          uv pip install dist/*.whl pytest pytest-asyncio pytest-cov
 
       - name: Check Apple Intelligence availability
         run: |
-          uv run python -c "
+          source .test-venv/bin/activate
+          python -c "
           import applefoundationmodels as afm
           status = afm.Client.check_availability()
           reason = afm.Client.get_availability_reason()
@@ -54,15 +61,19 @@ jobs:
           "
         continue-on-error: true
 
-      - name: Run tests
+      - name: Run tests from installed wheel
         run: |
-          # Tests will auto-skip if Apple Intelligence is unavailable
-          uv run pytest tests/ -v --tb=short -ra
+          source .test-venv/bin/activate
+          cd /tmp
+          pytest ${{ github.workspace }}/tests/ -v --tb=short -ra
 
       - name: Run tests with coverage (Python 3.11 only)
         if: matrix.python-version == '3.11'
         run: |
-          uv run pytest tests/ --cov=applefoundationmodels --cov-report=xml --cov-report=term
+          source .test-venv/bin/activate
+          cd /tmp
+          pytest ${{ github.workspace }}/tests/ --cov=applefoundationmodels --cov-report=xml --cov-report=term
+          cp coverage.xml ${{ github.workspace }}/
 
       - name: Upload coverage reports
         if: matrix.python-version == '3.11'

MANIFEST.in

@@ -1,27 +1,16 @@
-# Include all necessary files in source distribution
-
-# Swift source files
-include applefoundationmodels/swift/*.swift
-include applefoundationmodels/swift/*.h
-
-# Dynamic library
-include lib/*.dylib
-include lib/*.swiftmodule
-
-# Cython source files
-include applefoundationmodels/*.pyx
-include applefoundationmodels/*.pxd
-
-# Type stub marker
-include applefoundationmodels/py.typed
+# This file is for sdist builds only (not used for wheels)
+# Wheels use pyproject.toml [tool.setuptools.package-data] instead
 
 # Documentation
 include README.md
 include LICENSE
 
-# Exclude unnecessary files
+# Exclude build artifacts and source files from wheels
 global-exclude *.pyc
 global-exclude __pycache__
 global-exclude *.so
 global-exclude .DS_Store
 global-exclude *.a
+global-exclude *.swift
+global-exclude *.h
+global-exclude lib/*

README.md

@@ -14,7 +14,7 @@ Python bindings for Apple's FoundationModels framework - Direct access to on-dev
 ## Requirements
 
 - macOS 26.0+ (macOS Sequoia or later)
-- Python 3.8 or higher
+- Python 3.9 or higher
 - Apple Intelligence enabled on your device
 
 ## Installation
@@ -47,7 +47,7 @@ pip install -e .
 
 - macOS 26.0+ (Sequoia) with Apple Intelligence enabled
 - Xcode command line tools (`xcode-select --install`)
-- Python 3.8 or higher
+- Python 3.9 or higher
 
 **Note:** The Swift dylib is built automatically during installation.
 
@@ -320,17 +320,34 @@ See the `examples/` directory for complete working examples:
 
 ### Building from Source
 
+This project uses [uv](https://docs.astral.sh/uv/) for fast, reliable builds and dependency management:
+
 ```bash
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
 # Install development dependencies
-pip install -e ".[dev]"
+uv sync --extra dev
 
 # Run tests
-pytest
+uv run pytest
 
 # Type checking
-mypy applefoundationmodels
+uv run mypy applefoundationmodels
 
 # Format code
+uv run black applefoundationmodels examples
+
+# Build wheels
+uv build --wheel
+```
+
+You can also use pip if preferred:
+
+```bash
+pip install -e ".[dev]"
+pytest
+mypy applefoundationmodels
 black applefoundationmodels examples
 ```
 

pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "apple-foundation-models"
-version = "0.1.3"
-description = "Python bindings for Apple's FoundationModels framework - on-device AI"
+version = "0.1.4"
+description = "Python bindings for Apple's FoundationModels framework - on-device AI (requires macOS 26.0+)"
 readme = "README.md"
 license = { text = "MIT" }
 authors = [{ name = "Ben Tucker" }]
@@ -24,16 +24,17 @@ classifiers = [
   "License :: OSI Approved :: MIT License",
   "Operating System :: MacOS :: MacOS X",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Cython",
   "Topic :: Scientific/Engineering :: Artificial Intelligence",
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = ["typing-extensions>=4.0.0"]
 
 [project.optional-dependencies]
@@ -48,10 +49,14 @@ Issues = "https://github.com/btucker/apple-foundation-models-py/issues"
 
 [tool.setuptools]
 packages = ["applefoundationmodels"]
-include-package-data = true
 
 [tool.setuptools.package-data]
-applefoundationmodels = ["py.typed", "*.pxd"]
+applefoundationmodels = [
+    "py.typed",
+    "*.pxd",
+    "*.pyx",
+    "*.dylib",
+]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]