puggles 0.1.0__tar.gz

puggles-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [master, python-library]
+  pull_request:
+  workflow_call: # so release.yml can gate publishing on a green run
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: test (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - uses: Swatinem/rust-cache@v2
+      - name: Build
+        run: cargo build --all-targets
+      - name: Test
+        run: cargo test --all-targets
+      # The GPU feature is compile-checked only: CI runners have no usable adapter.
+      - name: Check GPU feature
+        run: cargo check --features gpu --all-targets
+      - name: Clippy
+        run: cargo clippy --all-targets
+
+  python:
+    name: python bindings
+    runs-on: ubuntu-latest
+    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
+      - name: Build and install
+        run: pip install maturin && maturin build --release --manifest-path python/Cargo.toml --out dist && pip install --find-links dist puggles
+      - name: Smoke test
+        run: |
+          python - <<'SMOKE'
+          import puggles as pg
+
+          problem = pg.Problem(
+              solution_length=10,
+              number_of_objectives=2,
+              solution_data_types=[pg.Real(0.0, 1.0)] * 10,
+              objective_function=lambda x: [x[0], 1.0 - x[0]],
+              direction=[-1, -1],
+          )
+          def front(**kw):
+              ga = pg.NSGAII(problem, population_size=50, execution_mode="sequential", **kw)
+              ga.run(2000)
+              return [tuple(s.objectives) for s in ga.get_archive()]
+
+          assert front(), "empty archive"
+
+          # Seeding must reproduce a run exactly, and must not silently pin unseeded runs.
+          assert front(seed=1) == front(seed=1), "seeded runs are not reproducible"
+          assert front(seed=1) != front(seed=2), "different seeds gave identical runs"
+          assert front() != front(), "unseeded runs are deterministic — seed leaked in"
+
+          print("ok", len(front(seed=1)), "solutions; seeding verified")
+          SMOKE

puggles-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,148 @@
+# Two ways to publish:
+#
+#   Staged (use this for a first release) — Actions > Release > Run workflow, and pick a target:
+#     testpypi   rehearsal upload to test.pypi.org; nothing on real PyPI is consumed
+#     pypi       wheels for 5 platforms + sdist -> PyPI
+#     crates-io  the Rust crate -> crates.io
+#
+#   All at once — push a version tag: `git tag v0.1.0 && git push origin v0.1.0`
+#   (a tag ignores the selector and publishes to BOTH registries).
+#
+# PyPI auth: repository secrets TEST_PYPI_API_TOKEN (rehearsals) and PYPI_API_TOKEN (real).
+#   Generate at <host>/manage/account/token/ and add under Settings > Secrets > Actions.
+#   The two registries are separate accounts, so each needs its own token.
+# Alternatively, leave the secret unset to use Trusted Publishing instead — register a
+#   publisher on that host matching owner/repo/workflow/environment exactly.
+# crates.io auth: repository secret CARGO_REGISTRY_TOKEN.
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      targets:
+        description: "Which registries to publish to"
+        type: choice
+        default: testpypi
+        options: [testpypi, pypi, crates-io, both]
+
+permissions:
+  contents: read
+
+jobs:
+  # Gate everything on a green test run: a bad crates.io publish cannot be undone, only yanked.
+  test:
+    uses: ./.github/workflows/ci.yml
+
+  crates-io:
+    needs: test
+    # A tag publishes everywhere; a manual run publishes only what you picked.
+    if: github.event_name == 'push' || contains(fromJSON('["crates-io","both"]'), inputs.targets)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo publish --token ${{ secrets.CARGO_REGISTRY_TOKEN }}
+
+  wheels:
+    needs: test
+    if: github.event_name == 'push' || contains(fromJSON('["testpypi","pypi","both"]'), inputs.targets)
+    name: wheels (${{ matrix.platform.target }} on ${{ matrix.platform.os }})
+    runs-on: ${{ matrix.platform.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - { os: ubuntu-latest,  target: x86_64  }
+          - { os: ubuntu-latest,  target: aarch64 }
+          - { os: macos-latest,   target: x86_64  }
+          - { os: macos-latest,   target: aarch64 }
+          - { os: windows-latest, target: x64     }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      # abi3-py39 means one wheel per platform covers every Python from 3.9 up.
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --manifest-path python/Cargo.toml
+          manylinux: auto
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform.os }}-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    needs: test
+    if: github.event_name == 'push' || contains(fromJSON('["testpypi","pypi","both"]'), inputs.targets)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist --manifest-path python/Cargo.toml
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  pypi:
+    needs: [wheels, sdist]
+    # `targets: testpypi` uploads to test.pypi.org instead — a throwaway rehearsal, since a real
+    # PyPI version number can never be reused once published, even after deleting it.
+    name: publish (${{ inputs.targets == 'testpypi' && 'TestPyPI' || 'PyPI' }})
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write # for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - name: List artifacts
+        run: ls -la dist
+      - name: Check the upload token is present
+        env:
+          TOKEN: ${{ inputs.targets == 'testpypi' && secrets.TEST_PYPI_API_TOKEN || secrets.PYPI_API_TOKEN }}
+        run: |
+          NAME=${{ inputs.targets == 'testpypi' && 'TEST_PYPI_API_TOKEN' || 'PYPI_API_TOKEN' }}
+          if [ -z "$TOKEN" ]; then
+            echo "::error::Repository secret $NAME is empty or unset."
+            echo "The publish step would fall back to Trusted Publishing and fail with a"
+            echo "confusing 'invalid-publisher' error. Add the secret at:"
+            echo "  Settings > Secrets and variables > Actions > New repository secret"
+            echo "  Name: $NAME   (exact, case-sensitive)"
+            echo "Generate the value at the matching host's /manage/account/token/ page."
+            exit 1
+          fi
+          # Never print the token; length alone confirms it arrived.
+          echo "$NAME is set (${#TOKEN} characters)."
+          case "$TOKEN" in
+            pypi-*) echo "Prefix looks correct." ;;
+            *) echo "::warning::Token does not start with 'pypi-' — check you copied the whole value." ;;
+          esac
+      - name: Show the identity this job will claim
+        run: |
+          echo "Register a Trusted Publisher matching EXACTLY these values:"
+          echo "  Owner:            ${{ github.repository_owner }}"
+          echo "  Repository name:  ${{ github.event.repository.name }}"
+          echo "  Workflow name:    release.yml"
+          echo "  Environment name: release"
+          echo
+          echo "Uploading to: ${{ inputs.targets == 'testpypi' && 'https://test.pypi.org/legacy/' || 'https://upload.pypi.org/legacy/' }}"
+          echo "  -> the publisher must be registered on THAT host; pypi.org and test.pypi.org are separate."
+          echo
+          echo "full workflow ref: ${{ github.workflow_ref }}"
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: ${{ inputs.targets == 'testpypi' && 'https://test.pypi.org/legacy/' || 'https://upload.pypi.org/legacy/' }}
+          # API token auth. Leave the matching secret unset to fall back to Trusted
+          # Publishing (which needs a publisher registered on that host whose
+          # owner/repo/workflow/environment match this job's OIDC claims exactly).
+          password: ${{ inputs.targets == 'testpypi' && secrets.TEST_PYPI_API_TOKEN || secrets.PYPI_API_TOKEN }}

puggles-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+/target
+target/
+# sandbox/
+.DS_Store
+.vscode/*
+.vscode
+.vscode/settings.json
+.vscode/settings.json
+.venv/
+*.ipynb
+.ipynb_checkpoints/
+.claude/*
+
+# Python bindings build/packaging artifacts (python/ crate)
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+build/
+dist/
+*.whl
+
+# Datasets
+*.csv
+# Build artifacts
+python/target/
+dist/