Fix RTD version switcher hiding #2957

Workflow file for this run

	name: continuous-integration

	# README
	# ======
	#
	# All the jobs are defined with `matrix` for OS and Python version, even if we
	# only run them on one combination of OS/Python. The reason for this is you get
	# a nice side-effect that the OS and Python version of the job are listed in
	# parentheses next to the job name in the Actions UI.

	# This prevents workflows from being run twice on PRs
	# ref: https://github.community/t/how-to-trigger-an-action-on-push-or-pull-request-but-not-both/16662
	on:
	push:
	branches:
	- main
	pull_request:
	workflow_call:

	env:
	COVERAGE_THRESHOLD: 60

	jobs:
	lint:
	strategy:
	matrix:
	os: [ubuntu-latest]
	python-version: ["3.11"]
	runs-on: ${{ matrix.os }}
	steps:
	- uses: actions/checkout@v3
	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"
	cache-dependency-path: "pyproject.toml"
	- uses: pre-commit/[email protected]

	# run our test suite on various combinations of OS / Python / Sphinx version
	run-pytest:
	needs: [lint]
	strategy:
	fail-fast: false
	matrix:
	os: [ubuntu-latest]
	python-version: ["3.8", "3.9", "3.10", "3.11"]
	include:
	# macos test
	- os: macos-latest
	python-version: "3.11"
	# windows test
	- os: windows-latest
	python-version: "3.11"
	# needed to cache the browsers for the accessibility tests
	env:
	PLAYWRIGHT_BROWSERS_PATH: ${{ github.workspace }}/pw-browsers
	runs-on: ${{ matrix.os }}
	steps:
	- uses: actions/checkout@v3
	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"
	cache-dependency-path: "pyproject.toml"
	- name: Install dependencies
	# if Sphinx version not specified in matrix, the constraints in the
	# pyproject.toml file determine Sphinx version
	if: false == matrix.sphinx-version
	shell: bash
	# setting shell to BASH and using PYTHONUTF8 env var makes the editable
	# install work on Windows even though there are emoji in our README
	run: \|
	export PYTHONUTF8=1
	python -m pip install --upgrade pip wheel setuptools
	python -m pip install -e .[test]
	- name: Install dependencies (legacy Sphinx)
	# here we override the pyproject.toml constraints to get a specific
	# Sphinx version.
	if: matrix.sphinx-version
	run: \|
	python -m pip install --upgrade pip wheel setuptools
	python -m pip install -e .[test] sphinx==${{ matrix.sphinx-version }}
	- name: Show installed versions
	run: python -m pip list
	- name: Compile MO files
	run: \|
	pip install nox
	nox -s compile
	- name: Run tests
	run: pytest -m "not a11y" --color=yes --cov pydata_sphinx_theme --cov-branch --cov-report xml:cov.xml --cov-report= --cov-fail-under ${{ env.COVERAGE_THRESHOLD }}
	- name: Upload to Codecov
	if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
	uses: codecov/[email protected]
	with:
	files: cov.xml
	fail_ci_if_error: true

	# note I am setting this on top of the Python cache as I could not find
	# how to set the hash key on the python one
	- name: Set up browser cache (for accessibility tests)
	uses: actions/cache@v3
	with:
	path: \|
	${{ github.workspace }}/pw-browsers
	key: ${{ runner.os }}-pw-${{ hashFiles('pyproject.toml') }}
	restore-keys: \|
	${{ runner.os }}-pw-

	- name: Run accessibility tests with playwright
	if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
	run: \|
	nox -s a11y
	continue-on-error: true

	# Build our site on the 3 major OSes and check for Sphinx warnings
	build-site:
	needs: [lint]
	strategy:
	fail-fast: false
	matrix:
	os: [ubuntu-latest, macos-latest, windows-latest]
	python-version: ["3.11"]
	runs-on: ${{ matrix.os }}
	steps:
	- uses: actions/checkout@v3
	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"
	cache-dependency-path: "pyproject.toml"
	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip wheel setuptools
	python -m pip install -e .[doc]
	- name: Show installed versions
	run: python -m pip list
	- name: Build docs
	run: sphinx-build -b html docs/ docs/_build/html --keep-going -w warnings.txt
	- name: Check for unexpected Sphinx warnings
	run: python tests/utils/check_warnings.py

	# Run local Lighthouse audit against built site
	audit:
	needs: [build-site]
	strategy:
	matrix:
	os: [ubuntu-latest]
	python-version: ["3.11"]
	runs-on: ${{ matrix.os }}
	steps:
	- uses: actions/checkout@v3
	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"
	cache-dependency-path: "pyproject.toml"
	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip wheel setuptools
	python -m pip install -e .[doc]
	- name: Show installed versions
	run: python -m pip list
	# We want to run the audit on a simplified documentation build so that
	# the audit results aren't affected by non-theme things like extensions.
	# Here we copy over just the kitchen sink into an empty docs site with
	# only the theme loaded so extensions don't play a role in audit scores.
	- name: Copy kitchen sink to a tiny site and build it
	run: \|
	mkdir audit/
	mkdir audit/site
	cp -r docs/examples/kitchen-sink audit/site/kitchen-sink
	printf "Test\n====\n\n.. toctree::\n\n kitchen-sink/index\n" > audit/site/index.rst
	echo 'html_theme = "pydata_sphinx_theme"' > audit/site/conf.py
	echo '.. toctree::\n :glob:\n\n *' >> audit/site/index.rst
	sphinx-build audit/site audit/_build
	# The lighthouse audit runs directly on the HTML files, no serving needed
	- name: Audit with Lighthouse
	uses: treosh/lighthouse-ci-action@v10
	with:
	configPath: ".github/workflows/lighthouserc.json"
	temporaryPublicStorage: true
	uploadArtifacts: true
	runs: 3 # Multiple runs to reduce variance

	# Generate a profile of the code and upload as an artifact
	profile:
	needs: [build-site, run-pytest]
	strategy:
	matrix:
	os: [ubuntu-latest]
	python-version: ["3.11"]
	runs-on: ${{ matrix.os }}
	steps:
	- uses: actions/checkout@v3
	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"
	cache-dependency-path: "pyproject.toml"
	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip wheel setuptools nox
	python -m pip install -e .[test]
	- name: Show installed versions
	run: python -m pip list
	- name: Generate a profile
	run: nox -s profile
	continue-on-error: true
	- uses: actions/upload-artifact@v3
	with:
	name: profile-results
	path: profile.svg

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Fix RTD version switcher hiding #2957

Workflow file

Fix RTD version switcher hiding #2957

Jobs

Run details

Workflow file for this run