pyrustygraph 0.4.1__tar.gz

pyrustygraph-0.4.1/.fleet/settings.json

@@ -0,0 +1,3 @@
+{
+    "editor.guides": []
+}

pyrustygraph-0.4.1/.github/workflows/README.md

@@ -0,0 +1,215 @@
+# Python Package Publishing Workflows
+
+This directory contains GitHub Actions workflows for automatically building and publishing the `rustygraph` Python package to PyPI.
+
+## Workflows
+
+### 1. `publish-python.yml` - Publish on Main Branch Commits
+This workflow automatically publishes the package to PyPI when changes are pushed to the `main` branch.
+
+**Triggers:**
+- Push to `main` branch with changes in: `src/`, `python/`, `pyproject.toml`, `Cargo.toml`, or `Cargo.lock`
+- Manual workflow dispatch
+
+**What it does:**
+- Builds wheels for Linux (x86_64, aarch64)
+- Builds wheels for macOS (x86_64, aarch64/Apple Silicon)
+- Builds wheels for Windows (x64)
+- Builds source distribution (sdist)
+- Publishes all artifacts to PyPI
+
+### 2. `publish-python-on-tag.yml` - Publish on Version Tags (RECOMMENDED)
+This workflow publishes the package when you create and push a version tag.
+
+**Triggers:**
+- Push of tags matching `v*` pattern (e.g., `v0.4.0`, `v1.0.0`)
+- Manual workflow dispatch
+
+**What it does:**
+- Builds wheels for Linux (x86_64, aarch64)
+- Builds wheels for macOS (x86_64, aarch64/Apple Silicon)
+- Builds wheels for Windows (x64)
+- Builds source distribution (sdist)
+- Publishes all artifacts to PyPI
+- Creates a GitHub Release with the built wheels attached
+
+## Setup Instructions
+
+### 1. Set up PyPI API Token
+
+You need to configure a PyPI API token as a GitHub secret:
+
+1. Go to [PyPI Account Settings](https://pypi.org/manage/account/)
+2. Scroll to "API tokens" section
+3. Click "Add API token"
+4. Give it a name (e.g., "rustygraph-github-actions")
+5. Set scope to "Entire account" or specific to "rustygraph" project
+6. Copy the token (starts with `pypi-`)
+7. Go to your GitHub repository → Settings → Secrets and variables → Actions
+8. Click "New repository secret"
+9. Name: `PYPI_API_TOKEN`
+10. Value: paste your PyPI token
+11. Click "Add secret"
+
+### 2. Alternative: Use Trusted Publishing (Recommended)
+
+PyPI supports "trusted publishing" which doesn't require managing tokens:
+
+1. Go to [PyPI project management](https://pypi.org/manage/project/rustygraph/settings/)
+2. Scroll to "Publishing" section
+3. Add a new publisher:
+   - PyPI Project Name: `rustygraph`
+   - Owner: `paulmagos` (your GitHub username/org)
+   - Repository name: `rustygraph`
+   - Workflow name: `publish-python-on-tag.yml`
+   - Environment name: (leave empty)
+
+If using trusted publishing, you can remove the `MATURIN_PYPI_TOKEN` line from the workflow.
+
+## Usage
+
+### Option 1: Publish on Every Commit to Main
+
+The `publish-python.yml` workflow will automatically run when you push to main:
+
+```bash
+git add .
+git commit -m "Update feature"
+git push origin main
+```
+
+**Note:** This publishes immediately! Make sure your code is ready for release.
+
+### Option 2: Publish on Tagged Releases (RECOMMENDED)
+
+The `publish-python-on-tag.yml` workflow runs when you create a version tag:
+
+1. Update version in `pyproject.toml`:
+   ```toml
+   [project]
+   version = "0.5.0"
+   ```
+
+2. Update version in `Cargo.toml`:
+   ```toml
+   [package]
+   version = "0.5.0"
+   ```
+
+3. Commit the changes:
+   ```bash
+   git add pyproject.toml Cargo.toml
+   git commit -m "Bump version to 0.5.0"
+   ```
+
+4. Create and push a tag:
+   ```bash
+   git tag v0.5.0
+   git push origin v0.5.0
+   ```
+
+5. The workflow will automatically:
+   - Build wheels for all platforms
+   - Publish to PyPI
+   - Create a GitHub Release
+
+### Manual Trigger
+
+Both workflows can be manually triggered:
+
+1. Go to GitHub → Actions
+2. Select the workflow
+3. Click "Run workflow"
+4. Choose the branch
+5. Click "Run workflow"
+
+## Monitoring
+
+### Check Workflow Status
+
+1. Go to GitHub repository → Actions tab
+2. Click on the workflow run
+3. View logs for each job (linux, macos, windows, sdist, release)
+
+### Verify Publication
+
+After successful run:
+
+1. Check PyPI: https://pypi.org/project/rustygraph/
+2. Install and test:
+   ```bash
+   pip install --upgrade rustygraph
+   python -c "import rustygraph; print(rustygraph.__version__)"
+   ```
+
+## Troubleshooting
+
+### Build Failures
+
+**Error: "Rust compiler not found"**
+- The workflow uses maturin-action which includes Rust toolchain
+- Check if `Cargo.toml` is valid
+
+**Error: "Python version not supported"**
+- Ensure `pyproject.toml` has correct Python version requirements
+- The workflow uses Python 3.11 for building
+
+### Publication Failures
+
+**Error: "Invalid API token"**
+- Verify `PYPI_API_TOKEN` secret is set correctly
+- Make sure token hasn't expired
+
+**Error: "File already exists"**
+- The version already exists on PyPI
+- Bump the version in `pyproject.toml` and `Cargo.toml`
+- The workflow uses `--skip-existing` to avoid this error
+
+**Error: "Package name already taken"**
+- If first time publishing, you need to register the package name
+- Publish manually first: `maturin publish`
+
+## Best Practices
+
+1. **Use tagged releases** (Option 2) rather than publishing on every commit
+2. **Test locally** before pushing:
+   ```bash
+   maturin build --release
+   maturin develop
+   pytest python/tests/
+   ```
+3. **Version management**:
+   - Use semantic versioning (MAJOR.MINOR.PATCH)
+   - Keep `pyproject.toml` and `Cargo.toml` versions in sync
+4. **Update CHANGELOG.md** before releasing
+5. **Test the package** after publishing:
+   ```bash
+   pip install --upgrade rustygraph
+   python python/examples/comprehensive_example.py
+   ```
+
+## Platform Support
+
+The workflows build for:
+
+- **Linux**: x86_64 (Intel/AMD), aarch64 (ARM)
+- **macOS**: x86_64 (Intel), aarch64 (Apple Silicon M1/M2/M3)
+- **Windows**: x64
+
+Users on these platforms can install pre-built wheels. Others will compile from source.
+
+## Disabling Auto-Publish
+
+If you want to disable automatic publishing on commits:
+
+1. Rename or delete `publish-python.yml`
+2. Keep only `publish-python-on-tag.yml`
+3. Publish only when you explicitly create tags
+
+## Related Files
+
+- `pyproject.toml` - Python package metadata and build configuration
+- `Cargo.toml` - Rust crate configuration
+- `src/integrations/python.rs` - Python bindings implementation
+- `python/rustygraph/__init__.py` - Python package entry point
+

pyrustygraph-0.4.1/.github/workflows/bump_version.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+"""
+Version bumper for rustygraph
+Keeps version numbers in sync across pyproject.toml and Cargo.toml
+"""
+
+import re
+import sys
+from pathlib import Path
+
+
+def update_version_in_file(file_path: Path, new_version: str) -> bool:
+    """Update version in a TOML file."""
+    content = file_path.read_text()
+
+    # Pattern for version = "X.Y.Z"
+    pattern = r'(version\s*=\s*")[^"]+(")'
+    replacement = rf'\g<1>{new_version}\g<2>'
+
+    new_content = re.sub(pattern, replacement, content, count=1)
+
+    if content == new_content:
+        return False
+
+    file_path.write_text(new_content)
+    return True
+
+
+def get_current_version(file_path: Path) -> str | None:
+    """Extract current version from a TOML file."""
+    content = file_path.read_text()
+    match = re.search(r'version\s*=\s*"([^"]+)"', content)
+    return match.group(1) if match else None
+
+
+def validate_version(version: str) -> bool:
+    """Check if version follows semantic versioning."""
+    pattern = r'^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$'
+    return bool(re.match(pattern, version))
+
+
+def main():
+    if len(sys.argv) != 2:
+        print("Usage: bump_version.py VERSION")
+        print("Example: bump_version.py 0.5.0")
+        sys.exit(1)
+
+    new_version = sys.argv[1]
+
+    # Validate version format
+    if not validate_version(new_version):
+        print(f"❌ Invalid version format: {new_version}")
+        print("   Must follow semantic versioning: MAJOR.MINOR.PATCH")
+        print("   Examples: 0.5.0, 1.0.0, 1.2.3-beta")
+        sys.exit(1)
+
+    # Paths
+    project_root = Path(__file__).parent.parent.parent
+    pyproject_path = project_root / "pyproject.toml"
+    cargo_path = project_root / "Cargo.toml"
+
+    # Check files exist
+    if not pyproject_path.exists():
+        print(f"❌ Not found: {pyproject_path}")
+        sys.exit(1)
+    if not cargo_path.exists():
+        print(f"❌ Not found: {cargo_path}")
+        sys.exit(1)
+
+    # Get current versions
+    pyproject_version = get_current_version(pyproject_path)
+    cargo_version = get_current_version(cargo_path)
+
+    print("📦 RustyGraph Version Bumper")
+    print("=" * 40)
+    print(f"Current versions:")
+    print(f"  pyproject.toml: {pyproject_version}")
+    print(f"  Cargo.toml:     {cargo_version}")
+    print(f"\nNew version: {new_version}")
+    print()
+
+    # Confirm
+    response = input("Proceed? [y/N] ").strip().lower()
+    if response not in ('y', 'yes'):
+        print("Aborted.")
+        sys.exit(0)
+
+    # Update files
+    print("\nUpdating files...")
+
+    if update_version_in_file(pyproject_path, new_version):
+        print(f"✅ Updated {pyproject_path.name}")
+    else:
+        print(f"⚠️  No changes in {pyproject_path.name}")
+
+    if update_version_in_file(cargo_path, new_version):
+        print(f"✅ Updated {cargo_path.name}")
+    else:
+        print(f"⚠️  No changes in {cargo_path.name}")
+
+    print("\n📋 Next steps:")
+    print(f"  1. Review changes: git diff")
+    print(f"  2. Commit: git commit -am 'Bump version to {new_version}'")
+    print(f"  3. Tag: git tag v{new_version}")
+    print(f"  4. Push: git push origin main && git push origin v{new_version}")
+    print(f"\nThe GitHub Action will automatically publish to PyPI.")
+
+
+if __name__ == "__main__":
+    main()
+

pyrustygraph-0.4.1/.github/workflows/publish-python-on-tag.yml

@@ -0,0 +1,136 @@
+name: Publish Python Package on Tag
+
+on:
+  push:
+    tags:
+      - 'v*'  # Trigger on version tags like v0.4.0, v1.0.0, etc.
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  # Build wheels for Linux
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+        manylinux: auto
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-linux-${{ matrix.target }}
+        path: dist
+
+  # Build wheels for macOS
+  macos:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        target: [aarch64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-macos-${{ matrix.target }}
+        path: dist
+
+  # Build wheels for Windows
+  windows:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        target: [x64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-windows-${{ matrix.target }}
+        path: dist
+
+  # Build source distribution
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Build sdist
+      uses: PyO3/maturin-action@v1
+      with:
+        command: sdist
+        args: --out dist
+
+    - name: Upload sdist
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-sdist
+        path: dist
+
+  # Publish to PyPI
+  release:
+    name: Release to PyPI
+    runs-on: ubuntu-latest
+    needs: [linux, macos, windows, sdist]
+    permissions:
+      id-token: write  # Required for trusted publishing
+    steps:
+    - uses: actions/download-artifact@v4
+      with:
+        pattern: wheels-*
+        merge-multiple: true
+        path: dist
+
+    - name: Publish to PyPI
+      uses: PyO3/maturin-action@v1
+      with:
+        command: upload
+        args: --non-interactive --skip-existing dist/*
+      env:
+        MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v1
+      with:
+        files: dist/*
+        generate_release_notes: true
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

pyrustygraph-0.4.1/.github/workflows/publish-python.yml

@@ -0,0 +1,133 @@
+name: Publish Python Package
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'src/**'
+      - 'python/**'
+      - 'pyproject.toml'
+      - 'Cargo.toml'
+      - 'Cargo.lock'
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  # Build wheels for Linux
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+        manylinux: auto
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-linux-${{ matrix.target }}
+        path: dist
+
+  # Build wheels for macOS
+  macos:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        target: [aarch64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-macos-${{ matrix.target }}
+        path: dist
+
+  # Build wheels for Windows
+  windows:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        target: [x64]
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Build wheels
+      uses: PyO3/maturin-action@v1
+      with:
+        target: ${{ matrix.target }}
+        args: --release --out dist --find-interpreter
+        sccache: 'true'
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-windows-${{ matrix.target }}
+        path: dist
+
+  # Build source distribution
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Build sdist
+      uses: PyO3/maturin-action@v1
+      with:
+        command: sdist
+        args: --out dist
+
+    - name: Upload sdist
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheels-sdist
+        path: dist
+
+  # Publish to PyPI
+  release:
+    name: Release to PyPI
+    runs-on: ubuntu-latest
+    needs: [linux, macos, windows, sdist]
+    permissions:
+      id-token: write  # Required for trusted publishing
+    steps:
+    - uses: actions/download-artifact@v4
+      with:
+        pattern: wheels-*
+        merge-multiple: true
+        path: dist
+
+    - name: Publish to PyPI
+      uses: PyO3/maturin-action@v1
+      with:
+        command: upload
+        args: --non-interactive --skip-existing dist/*
+      env:
+        MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+

pyrustygraph-0.4.1/.github/workflows/rust.yml

@@ -0,0 +1,22 @@
+name: Rust
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Build
+      run: cargo build --verbose
+    - name: Run tests
+      run: cargo test --verbose