Fix the type annotation for sphinx.testing.fixtures.rootdir

[ftnext]

Subject: Tweak rootdir fixture's type hint

Feature or Bugfix

• Refactoring

Purpose

https://www.sphinx-doc.org/en/master/extdev/testing.html#usage

If you want to know more detailed usage, please refer to tests/conftest.py` and other test_*.py files under the tests/ directory.

In tests/conftest.py, I noticed that rootdir returns pathlib.Path instead of str.

sphinx/tests/conftest.py

Lines 43 to 45 in 043750e

	@pytest.fixture(scope='session')
	def rootdir() -> Path:
	return Path(__file__).parent.resolve() / 'roots'

rootdir in sphinx/testing/fixture.py is type-hinted as returning str

sphinx/sphinx/testing/fixtures.py

Lines 44 to 46 in 043750e

	@pytest.fixture(scope='session')
	def rootdir() -> str | None:
	return None

but rootdir is treated as pathlib.Path in app_params fixture.

sphinx/sphinx/testing/fixtures.py

Lines 110 to 112 in 043750e

	if rootdir and not srcdir.exists():
	testroot_path = rootdir / ('test-' + testroot)
	shutil.copytree(testroot_path, srcdir)

• pathlib.Path / str: works!
• str / str: not work

Detail

(See Purpose. That's all)

Relates

• N/A