Merge pull request #63 from CurtisTechSolutions/feat/python-native-bindings

feat(python): build native training wheels with NumPy observations

Author: nosam1998

.github/workflows/python.yml

@@ -0,0 +1,42 @@
+name: Python CI
+on:
+  pull_request:
+  push:
+    branches: [main]
+permissions:
+  contents: read
+concurrency:
+  group: python-ci-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  native-wheel:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: python -m pip install "maturin>=1.9,<2" "pytest>=8,<9" "numpy>=1.24,<3"
+      - run: maturin build --release --locked --out dist
+      - name: Install built wheel
+        run: |
+          python - <<'PY'
+          import glob
+          import subprocess
+          import sys
+          subprocess.check_call([sys.executable, "-m", "pip", "install", *glob.glob("dist/*.whl")])
+          PY
+      - run: python -m pytest python/tests -q
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gamesforai-wheel-${{ matrix.os }}
+          path: dist/*.whl

Cargo.lock

@@ -13,6 +13,7 @@ members = [
     "crates/adapters/gfa-mcp",
     "crates/apps/gfa-server",
     "crates/apps/gfa-cli",
+    "crates/apps/gfa-py",
     "xtask",
     "crates/domain/gfa-api-types",
     "crates/domain/gfa-service",
@@ -28,6 +29,8 @@ license = "GPL-3.0-only"
 repository = "https://github.com/CurtisTechSolutions/GamesForAI"
 
 [workspace.dependencies]
+pyo3 = { version = "0.29.2", features = ["abi3-py310"] }
+numpy = "0.29.0"
 gfa-core = { version = "0.1.0", path = "crates/core/gfa-core" }
 gfa-testkit = { version = "0.1.0", path = "crates/core/gfa-testkit" }
 gfa-game-tictactoe = { version = "0.1.0", path = "crates/games/gfa-game-tictactoe" }

Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "gfa-py"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[lib]
+name = "_native"
+crate-type = ["cdylib", "rlib"]
+test = false
+doctest = false
+
+[features]
+extension-module = ["pyo3/extension-module"]
+
+[dependencies]
+gfa-core.workspace = true
+gfa-games.workspace = true
+pyo3.workspace = true
+numpy.workspace = true
+serde_json.workspace = true
+
+[lints]
+workspace = true