Add GitHub Actions workflows for PyPI publishing

Author: D4mianWayne

.github/workflows/README.md

@@ -0,0 +1,76 @@
+# GitHub Actions Workflows for PyPI Publishing
+
+This directory contains GitHub Actions workflows for automatically publishing the diffrays package to PyPI.
+
+## Workflows
+
+### 1. `publish.yml` - Production PyPI Publishing
+- **Triggers**: 
+  - When a GitHub release is published
+  - Manual trigger via GitHub Actions UI
+- **Purpose**: Publishes the package to the official PyPI repository
+- **Required Secret**: `PYPI_API_TOKEN`
+
+### 2. `testpypi.yml` - TestPyPI Publishing
+- **Triggers**: 
+  - Push to `main` or `develop` branches
+  - Manual trigger via GitHub Actions UI
+- **Purpose**: Publishes the package to TestPyPI for testing
+- **Required Secret**: `TEST_PYPI_API_TOKEN`
+
+## Setup Instructions
+
+### For Production PyPI Publishing:
+
+1. **Create PyPI API Token**:
+   - Go to [PyPI](https://pypi.org) and log in
+   - Navigate to Account Settings → API tokens
+   - Create a new API token (scope: "Entire account" or project-specific)
+   - Copy the token (starts with `pypi-`)
+
+2. **Add GitHub Secret**:
+   - Go to your GitHub repository
+   - Settings → Secrets and variables → Actions
+   - Click "New repository secret"
+   - Name: `PYPI_API_TOKEN`
+   - Value: Your PyPI API token
+
+3. **Publishing Process**:
+   - Update version in `pyproject.toml`
+   - Commit and push changes
+   - Create a GitHub release with the same version number
+   - The workflow will automatically publish to PyPI
+
+### For TestPyPI Publishing:
+
+1. **Create TestPyPI Account**:
+   - Go to [test.pypi.org](https://test.pypi.org)
+   - Create an account (can be same as PyPI account)
+
+2. **Create TestPyPI API Token**:
+   - Log in to TestPyPI
+   - Go to Account Settings → API tokens
+   - Create a new API token
+   - Copy the token
+
+3. **Add GitHub Secret**:
+   - Add `TEST_PYPI_API_TOKEN` secret in GitHub repository settings
+   - Value: Your TestPyPI API token
+
+## Usage
+
+### Manual Publishing
+Both workflows support manual triggering:
+1. Go to GitHub repository → Actions tab
+2. Select the desired workflow
+3. Click "Run workflow"
+
+### Version Management
+- Update the version in `pyproject.toml` before creating a release
+- The version in the release tag should match the version in `pyproject.toml`
+- Example: If `pyproject.toml` has `version = "1.6"`, create a release with tag `v1.6`
+
+## Security Notes
+- Never commit API tokens to the repository
+- Use repository secrets for storing sensitive information
+- API tokens provide better security than username/password authentication

.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allows manual triggering
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.8'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check package
+      run: twine check dist/*
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: twine upload dist/*

.github/workflows/testpypi.yml

@@ -0,0 +1,36 @@
+name: Publish to TestPyPI
+
+on:
+  push:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.8'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check package
+      run: twine check dist/*
+    
+    - name: Publish to TestPyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+        TWINE_REPOSITORY_URL: https://test.pypi.org/legacy/
+      run: twine upload dist/*