Sync Project with generate-demo nox session and test CI/CD #13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # .github/workflows/docs-build.yml | |
| # See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions | |
| name: Build Documentation | |
| on: | |
| pull_request: | |
| paths: | |
| - "docs/**" # Documentation source files | |
| - "src/**/*.py" # Code changes might impact API docs | |
| - "noxfile.py" | |
| - "pyproject.toml" | |
| - ".github/workflows/docs-build.yml" | |
| # Include relevant config files that affect docs build | |
| - ".ruff.toml" # Affects docstrings via linting | |
| - "pyrightconfig.json" # Affects type hints in docs | |
| push: | |
| branches: | |
| - main | |
| - master | |
| paths: | |
| - "docs/**" | |
| - "src/**/*.py" | |
| - "noxfile.py" | |
| - "pyproject.toml" | |
| - ".github/workflows/docs-build.yml" | |
| workflow_dispatch: | |
| jobs: | |
| build-docs: | |
| name: Run Documentation Build Check | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@v4 | |
| - name: Install uv | |
| uses: astral-sh/setup-uv@v6 | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version-file: ".github/workflows/.python-version" | |
| - name: Build documentation | |
| run: uvx nox -s docs-build | |
| - name: Upload documentation (HTML) Artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: html-docs | |
| path: docs/_build/html/ | |
| retention-days: 5 |