gggp 0.1.0__tar.gz

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

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install maturin pytest
+
+      - name: Build wheel
+        run: maturin build --release --interpreter python3.11 -o dist
+
+      - name: Install built wheel
+        run: python -m pip install dist/*.whl
+
+      - name: Run tests
+        run: pytest -q
+

gggp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build wheels and sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+
+      - name: Build source distribution
+        run: |
+          python -m pip install --upgrade pip maturin
+          maturin sdist --out dist
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+

gggp-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.mypy_cache/
+.venv/
+
+target/
+dist/
+build/
+*.egg-info/
+

gggp-0.1.0/Cargo.lock

@@ -0,0 +1,180 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "gggp-core-py"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.182"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6800badb6cb2082ffd7b6a67e6125bb39f18782f793520caee8cb8846be06112"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.115"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e614ed320ac28113fa64972c4262d5dbc89deacdfd00c34a3e4cea073243c12"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "537dd038a89878be9b64dd4bd1b260315c1bb94f4d784956b81e27a088d9a09e"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

gggp-0.1.0/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "gggp-core-py"
+version = "0.1.0"
+edition = "2021"
+license = "MIT"
+repository = "https://github.com/olkhovoy/gggp"
+description = "Minimal GGGP core Python extension"
+readme = "README.md"
+
+[lib]
+name = "gggp_core_py"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.22", features = ["extension-module"] }
+

gggp-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Alexander Olkhovoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

gggp-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: gggp
+Version: 0.1.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Summary: Rust-powered GGGP core with Python bindings
+Author: Alexander Olkhovoy
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# gggp
+
+Minimal Rust Library + Python SDK foundation for GGGP.
+
+This repository currently provides a small Python extension module (built from Rust via `pyo3` + `maturin`) to establish release and CI/CD workflows.
+
+## Install (local)
+
+```bash
+python -m pip install -U pip maturin
+maturin build --release -o dist
+python -m pip install dist/*.whl
+```
+
+## Python API
+
+```python
+import gggp
+
+print(gggp.version())
+child_a, child_b = gggp.one_point_crossover([1, 2, 3], [10, 20, 30], split=1)
+mutated = gggp.mutate_gene([1, 2, 3], index=2, value=99)
+```
+
+## Release
+
+1. Configure PyPI Trusted Publisher for this repository and workflow file:
+   - Repository: `olkhovoy/gggp`
+   - Workflow: `.github/workflows/publish.yml`
+2. Create and push a version tag:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+The `publish` workflow will build wheel + sdist and upload to PyPI.
+
+

gggp-0.1.0/README.md

@@ -0,0 +1,38 @@
+# gggp
+
+Minimal Rust Library + Python SDK foundation for GGGP.
+
+This repository currently provides a small Python extension module (built from Rust via `pyo3` + `maturin`) to establish release and CI/CD workflows.
+
+## Install (local)
+
+```bash
+python -m pip install -U pip maturin
+maturin build --release -o dist
+python -m pip install dist/*.whl
+```
+
+## Python API
+
+```python
+import gggp
+
+print(gggp.version())
+child_a, child_b = gggp.one_point_crossover([1, 2, 3], [10, 20, 30], split=1)
+mutated = gggp.mutate_gene([1, 2, 3], index=2, value=99)
+```
+
+## Release
+
+1. Configure PyPI Trusted Publisher for this repository and workflow file:
+   - Repository: `olkhovoy/gggp`
+   - Workflow: `.github/workflows/publish.yml`
+2. Create and push a version tag:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+The `publish` workflow will build wheel + sdist and upload to PyPI.
+

gggp-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["maturin>=1.7,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "gggp"
+description = "Rust-powered GGGP core with Python bindings"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Alexander Olkhovoy" }]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Rust",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+dynamic = ["version"]
+
+[tool.maturin]
+bindings = "pyo3"
+python-source = "python"
+module-name = "gggp._core"
+features = ["pyo3/extension-module"]

gggp-0.1.0/python/gggp/__init__.py

@@ -0,0 +1,4 @@
+from ._core import mutate_gene, one_point_crossover, version
+
+__all__ = ["version", "one_point_crossover", "mutate_gene"]
+

gggp-0.1.0/src/lib.rs

@@ -0,0 +1,58 @@
+use pyo3::exceptions::PyIndexError;
+use pyo3::prelude::*;
+
+#[pyfunction]
+fn version() -> &'static str {
+    env!("CARGO_PKG_VERSION")
+}
+
+#[pyfunction]
+#[pyo3(signature = (chromosome_a, chromosome_b, split=None))]
+fn one_point_crossover(
+    chromosome_a: Vec<i64>,
+    chromosome_b: Vec<i64>,
+    split: Option<usize>,
+) -> PyResult<(Vec<i64>, Vec<i64>)> {
+    let min_len = chromosome_a.len().min(chromosome_b.len());
+    if min_len == 0 {
+        return Ok((chromosome_a, chromosome_b));
+    }
+
+    let cross_at = split.unwrap_or(min_len / 2);
+    if cross_at > min_len {
+        return Err(PyIndexError::new_err(format!(
+            "split={} is out of bounds for min_len={}",
+            cross_at, min_len
+        )));
+    }
+
+    let mut child_a = chromosome_a.clone();
+    let mut child_b = chromosome_b.clone();
+    child_a[cross_at..min_len].copy_from_slice(&chromosome_b[cross_at..min_len]);
+    child_b[cross_at..min_len].copy_from_slice(&chromosome_a[cross_at..min_len]);
+    Ok((child_a, child_b))
+}
+
+#[pyfunction]
+#[pyo3(signature = (chromosome, index, value))]
+fn mutate_gene(chromosome: Vec<i64>, index: usize, value: i64) -> PyResult<Vec<i64>> {
+    if index >= chromosome.len() {
+        return Err(PyIndexError::new_err(format!(
+            "index={} is out of bounds for chromosome length={}",
+            index,
+            chromosome.len()
+        )));
+    }
+    let mut out = chromosome;
+    out[index] = value;
+    Ok(out)
+}
+
+#[pymodule]
+fn _core(_py: Python<'_>, module: &Bound<'_, PyModule>) -> PyResult<()> {
+    module.add_function(wrap_pyfunction!(version, module)?)?;
+    module.add_function(wrap_pyfunction!(one_point_crossover, module)?)?;
+    module.add_function(wrap_pyfunction!(mutate_gene, module)?)?;
+    Ok(())
+}
+

gggp-0.1.0/tests/test_core.py

@@ -0,0 +1,21 @@
+import gggp
+
+
+def test_version_is_string():
+    v = gggp.version()
+    assert isinstance(v, str)
+    assert v.count(".") >= 1
+
+
+def test_one_point_crossover():
+    a = [1, 2, 3, 4]
+    b = [10, 20, 30, 40]
+    c1, c2 = gggp.one_point_crossover(a, b, split=2)
+    assert c1 == [1, 2, 30, 40]
+    assert c2 == [10, 20, 3, 4]
+
+
+def test_mutate_gene():
+    result = gggp.mutate_gene([1, 2, 3], index=1, value=99)
+    assert result == [1, 99, 3]
+