Add Python Semantic Release for automated version management

- Add python-semantic-release dependency via pixi
- Configure PSR in pyproject.toml with version tracking and changelog generation
- Update release workflow to use manual dispatch with patch/minor/major options
- Run full test suite (linting, type checking, unit tests, integration tests) before release
- Use pixi for package management in GitHub Actions
- Implement PSR for automated version bumping and tagging
- Maintain PyPI trusted publishing for secure releases

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: msch-nutrient

.github/workflows/release.yml

@@ -1,31 +1,84 @@
 name: Release
 
 on:
-  release:
-    types: [created]
+  workflow_dispatch:
+    inputs:
+      level:
+        description: 'Version level to bump'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
 
 jobs:
-  deploy:
+  release:
     runs-on: ubuntu-latest
-
+    concurrency: release
+    permissions:
+      id-token: write
+      contents: write
+    
     steps:
     - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
 
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
         python-version: '3.12'
 
-    - name: Install dependencies
+    - name: Cache pip dependencies
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install Pixi
+      uses: prefix-dev/setup-pixi@v0.8.1
+      with:
+        pixi-version: v0.29.0
+
+    - name: Run linting with ruff
       run: |
-        python -m pip install --upgrade pip
-        pip install -e ".[dev]"
+        pixi run python -m ruff check .
+        pixi run python -m ruff format --check .
+
+    - name: Run type checking with mypy
+      run: pixi run python -m mypy src tests
+
+    - name: Run unit tests with pytest
+      run: pixi run python -m pytest tests/unit/ -v --cov=nutrient_dws --cov-report=xml --cov-report=term
+
+    - name: Run integration tests
+      if: github.repository == 'jdrhyne/nutrient-dws-client-python'
+      run: |
+        pixi run python -c "
+        import os
+        with open('tests/integration/integration_config.py', 'w') as f:
+            f.write(f'API_KEY = \"{os.environ[\"NUTRIENT_DWS_API_KEY\"]}\"\n')
+        "
+        pixi run python -m pytest tests/integration/ -v
+      env:
+        NUTRIENT_DWS_API_KEY: ${{ secrets.NUTRIENT_DWS_API_KEY }}
 
     - name: Build package
-      run: python -m build
+      run: pixi run python -m build
 
-    - name: Publish to PyPI
+    - name: Check package with twine
+      run: pixi run twine check dist/*
+
+    - name: Semantic Release
+      run: pixi run python -m semantic_release version --${{ inputs.level }}
       env:
-        TWINE_USERNAME: __token__
-        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
-      run: twine upload dist/*
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      if: github.ref == 'refs/heads/main'