docs.yml

name: Deploy to GitHub pages
on:
  push:
    branches: [ master ]
jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2

    - name: Generate static pydoc html
      uses: actions/setup-python@v2
      with:
        python-version: '3.10'
    - run: |
        python -m pip install --upgrade pip
        python -m pip install git+https://github.com/pdoc3/pdoc.git@f358893e4fcfd7f29857a7ff5491b606ff146d39
        python -m pdoc --html bitspec.py

    - name: Build docs and commit to fresh git repo
      run: |
        cd html
        mv bitspec.html index.html
        git init
        git add -A
        git config --local user.email "action@users.noreply.github.com"
        git config --local user.name "GitHub Action"
        git commit -m 'deploy'

    - name: Force push to destination branch
      uses: ad-m/github-push-action@v0.5.0
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        branch: gh-pages
        force: true
        directory: ./html