DOCS: update CHANGELOG for deprecation #1974
This file contains 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
| name: continuous-integration | |
| on: | |
| push: | |
| branches: [master] | |
| tags: | |
| - 'v*' | |
| pull_request: | |
| workflow_call: | |
| env: | |
| PY_COLORS: 1 | |
| FORCE_COLOR: True | |
| jobs: | |
| pre-commit: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - uses: actions/setup-python@v4 | |
| with: | |
| python-version: 3.11 | |
| - uses: pre-commit/action@v3.0.0 | |
| tests: | |
| continue-on-error: ${{ matrix.experimental || false }} | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| os: [ubuntu-latest] | |
| python-version: ["3.9", "3.10", "3.11"] | |
| # Only test the latest major release of Sphinx because otherwise we need to | |
| # keep multiple versions of regression tests on file and this creates lots of | |
| # noise in the tests. | |
| sphinx: ["~=5.0","~=6.0","~=7.0"] | |
| include: | |
| - os: windows-latest | |
| # Python 3.12 is broken on windows builds until the following PR is released: | |
| # https://github.com/pradyunsg/sphinx-theme-builder/pull/47 | |
| python-version: 3.11 | |
| # Windows pulling in dependencies fails | |
| experimental: true | |
| - os: macos-latest | |
| python-version: 3.x | |
| runs-on: ${{ matrix.os }} | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Set up Python ${{ matrix.python-version }} | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: ${{ matrix.python-version }} | |
| cache: "pip" | |
| cache-dependency-path: "pyproject.toml" | |
| - name: Install dependencies with Sphinx ${{ matrix.sphinx }} | |
| run: | | |
| python -m pip install --upgrade pip | |
| python -m pip install --upgrade "sphinx${{matrix.sphinx}}" -e .[test] --pre | |
| - name: Run pytest | |
| run: > | |
| pytest --durations=10 --cov=sphinx_book_theme --cov-report=xml --cov-report=term-missing | |
| # Only upload to codecov on pull requests so that we don't trigger rate limit blocks | |
| - name: Upload to Codecov | |
| if: matrix.os == 'ubuntu-latest' && matrix.python-version == 3.9 && github.repository == 'executablebooks/sphinx-book-theme' && github.event_name == 'pull_request' | |
| uses: codecov/codecov-action@v3.1.4 | |
| with: | |
| name: ebp-sbt-pytests-py3.7 | |
| flags: pytests | |
| file: ./coverage.xml | |
| fail_ci_if_error: true | |
| # Build the docs and fail if an *unexpected* warning occurs. | |
| docs-audit: | |
| runs-on: ubuntu-latest | |
| name: Build and Audit Documentation | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Set up Python | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: '3.9' | |
| cache: "pip" | |
| cache-dependency-path: "pyproject.toml" | |
| - name: Install dependencies | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install -e .[doc] | |
| # Only check for broken links on pull requests so that we don't block releases | |
| - name: Check for broken links | |
| if: github.event_name == 'pull_request' | |
| run: > | |
| sphinx-build -b linkcheck docs docs/_build/linkcheck | |
| - name: Build documentation to audit | |
| run: > | |
| sphinx-build -b html docs docs/_build/html -w warnings.txt | |
| - name: Check that there are no unexpected warnings | |
| shell: python | |
| run: | | |
| from pathlib import Path | |
| text = Path("./warnings.txt").read_text().strip() | |
| expected_warning_snippets = ["kitchen-sink", "urllib/parse.py"] | |
| print("\n=== Sphinx Warnings ===\n\n" + text) # Print just for reference so we can look at the logs | |
| unexpected = [ii for ii in text.split("\n") if not any(snippet in ii for snippet in expected_warning_snippets)] | |
| assert len(unexpected) == 0 | |
| - name: Audit with Lighthouse | |
| uses: treosh/lighthouse-ci-action@10.1.0 | |
| with: | |
| configPath: ".github/workflows/lighthouserc.json" | |
| temporaryPublicStorage: true | |
| uploadArtifacts: true | |
| runs: 5 |