release.yml

name: Publish to PyPI

on:
  push:
    branches:
      - 'main'
    tags:
      - 'v[0-9]+.[0-9]+.[0-9]+'

jobs:
  pypi-publish:
    name: Upload release to PyPI and update documentation
    runs-on: ubuntu-latest
    environment: release
    permissions:
      id-token: write
    steps:
    - uses: actions/checkout@v4
    - name: Set up Python
      uses: actions/setup-python@v5
      with:
        python-version: '3.x'
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        python -m pip install build setuptools setuptools-scm sphinx sphinx_rtd_theme myst_parser
    - name: Build the packages
      run: |
        python -m build
      - name: Publish package distributions to PyPI
        uses: pypa/gh-action-pypi-publish@release/v1
    - name: Generate documentation with latest version
      run: |
        sphinx-build -b html docsrc docs -E -d "docsrc/_doctrees"
    - name: Check if any new docs were built
      id: verify_diff
      run: |
        git diff --quiet . || echo "changed=true" >> $GITHUB_OUTPUT
    - name: Commit and push the new documentation
      if: steps.verify_diff.outputs.changed == true
      run: |
        git config user.name Documentation builder[bot]
        git config user.email brian@bdwarner.com
        git add docs
        git commit -m "Rebuild the documentation"
        git push