prepare for v0.1.0 release

Author: networmix

.github/workflows/release.yml

@@ -0,0 +1,76 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  pull_request:
+    paths-ignore:
+      - "docs/**"
+      - "**.md"
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Wheel (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, macos-13]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # Build wheels using cibuildwheel
+      # ENV variables control the build (architectures, python versions)
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.21.3
+        env:
+          # Build for Python 3.9+
+          CIBW_BUILD: "cp39-* cp310-* cp311-* cp312-* cp313-*"
+          # Skip PyPy and musllinux for now (unless desired)
+          CIBW_SKIP: "pp* *-musllinux_*"
+
+          # macOS: Build Universal2 wheels on Intel runner (macos-13)
+          CIBW_ARCHS_MACOS: "universal2"
+          CIBW_TEST_COMMAND: "python -c \"import netgraph_core; print(netgraph_core.__version__)\""
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build SDist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build SDist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+
+  publish_pypi:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Required for Trusted Publishing (OIDC)
+
+    # Only publish on tag pushes
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/tests.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches: [ main, master ]
   pull_request:
+  workflow_dispatch:
 
 jobs:
   test:
@@ -13,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-22.04, macos-13]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
@@ -48,11 +49,3 @@ jobs:
             build/coverage/coverage-python.xml
             build/coverage/coverage-cpp.xml
             build/coverage/coverage-combined.html
-      # - name: Upload to Codecov
-      #   uses: codecov/codecov-action@v4
-      #   with:
-      #     files: |
-      #       coverage-python.xml
-      #       coverage-cpp.xml
-      #     token: ${{ secrets.CODECOV_TOKEN }}
-      #     fail_ci_if_error: false

.github/workflows/wheels.yml

@@ -49,6 +49,7 @@ coverage.xml
 *.py.cover
 .hypothesis/
 .pytest_cache/
+.benchmarks/
 cover/
 
 # Consolidated coverage artifacts

.gitignore

@@ -0,0 +1,77 @@
+# Contributing to NetGraph-Core
+
+This document provides guidelines for setting up your development environment and submitting contributions.
+
+## Development Setup
+
+NetGraph-Core is a hybrid C++/Python project. You will need:
+
+- Python 3.9+
+- C++20 compatible compiler (GCC 10+, Clang 12+, MSVC 2019+)
+- CMake 3.23+
+- Ninja (recommended)
+
+### 1. Clone the repository
+
+```bash
+git clone https://github.com/networmix/NetGraph-Core.git
+cd NetGraph-Core
+```
+
+### 2. Create a virtual environment and install dependencies
+
+We use a `Makefile` to simplify development tasks.
+
+```bash
+make dev
+source venv/bin/activate
+```
+
+This will:
+
+- Create a virtual environment in `./venv`
+- Install all development dependencies
+- Install pre-commit hooks
+
+## Workflow
+
+### Running Tests
+
+Run all checks (linting + C++ tests + Python tests):
+
+```bash
+make check
+```
+
+Run specific test suites:
+
+```bash
+make cpp-test   # C++ tests (GoogleTest)
+make py-test    # Python tests (pytest)
+```
+
+### Code Style
+
+- **Python**: We use `ruff` for linting and formatting, and `pyright` for static type checking.
+- **C++**: We follow standard C++20 practices.
+
+Auto-fix Python formatting:
+
+```bash
+make format
+```
+
+## Release Process
+
+Releases are automated via GitHub Actions when a new tag is pushed.
+
+1. Bump version in `pyproject.toml` and `python/netgraph_core/_version.py`.
+2. Commit and push.
+3. Create and push a tag:
+
+   ```bash
+   git tag v0.1.0
+   git push origin v0.1.0
+   ```
+
+4. The CI pipeline will build wheels, sdist, and publish to PyPI.