ci: add Python CI matrix with coverage and publish workflow

Agent-Logs-Url: https://github.com/Rahuldrabit/Genetic_algorithm/sessions/edbe1fdb-9301-434a-90c8-2a55d8a15bb0

Co-authored-by: Rahuldrabit <104688569+Rahuldrabit@users.noreply.github.com>

Author: Copilot

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest pytest-cov ruff
+          pip install .
+
+      - name: Lint
+        run: |
+          ruff check genetic_algorithm tests/test_python_package.py
+
+      - name: Run Python tests with coverage
+        run: |
+          export PYTHONPATH=.
+          pytest --cov=genetic_algorithm

.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+          python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+

README.md

@@ -1,5 +1,7 @@
 # Genetic Algorithm Framework (C++)
 
+![CI](https://github.com/Rahuldrabit/Genetic_algorithm/actions/workflows/ci.yml/badge.svg)
+
 A reusable C++ genetic algorithm framework you can embed in any application. It exposes a small, modern C++ API and ships with a rich set of crossover, mutation, and selection operators.
 
 ## 🚀 Features

genetic_algorithm/__init__.py

@@ -0,0 +1,4 @@
+"""Python package alias for the compiled :mod:`ga` extension."""
+
+from ga import *  # noqa: F401,F403
+

pyproject.toml

@@ -24,5 +24,5 @@ Repository = "https://github.com/Rahuldrabit/Genetic_algorithm"
 Issues = "https://github.com/Rahuldrabit/Genetic_algorithm/issues"
 
 [tool.scikit-build]
-# This project ships a compiled extension module (`ga`) and no pure-Python package tree.
-wheel.packages = []
+# Ship the compiled extension (`ga`) and a lightweight Python package alias.
+wheel.packages = ["genetic_algorithm"]

tests/test_python_package.py

@@ -0,0 +1,5 @@
+def test_python_package_alias_importable():
+    import genetic_algorithm
+
+    assert hasattr(genetic_algorithm, "Config")
+