Use declarative metadata with pyproject.toml

.github/workflows/docutils-latest.yml

@@ -21,8 +21,6 @@ jobs:
         python-version: 3
     - name: Check Python version
       run: python --version
-    - name: Unpin docutils
-      run: sed -i -e "s/'docutils>=.*'/'docutils'/" setup.py
     - name: Install graphviz
       run: sudo apt-get install graphviz
     - name: Install dependencies

.github/workflows/lint.yml

@@ -20,6 +20,6 @@ jobs:
       with:
         python-version: 3
     - name: Install dependencies
-      run:  pip install -U tox
+      run:  python -m pip install -U tox pip
     - name: Run Tox
       run:  tox -e ${{ matrix.tool }}

CHANGES

@@ -4,6 +4,10 @@ Release 5.2.0 (in development)
 Dependencies
 ------------
 
+* #10356: Sphinx now uses declarative metadata with ``pyproject.toml`` to
+  create packages, using PyPA's ``build`` project as a build backend. Patch by
+  Adam Turner.
+
 Incompatible changes
 --------------------
 

Makefile

@@ -74,7 +74,7 @@ covertest:
 
 .PHONY: build
 build:
-	@$(PYTHON) setup.py build
+	@$(PYTHON) -m build .
 
 .PHONY: docs
 docs:

pyproject.toml

@@ -0,0 +1,135 @@
+[build-system]
+requires = ["flit_core>=3.7"]
+build-backend = "flit_core.buildapi"
+
+# project metadata
+[project]
+name = "Sphinx"
+description = "Python documentation generator"
+readme = "README.rst"
+urls.Changelog = "https://www.sphinx-doc.org/en/master/changes.html"
+urls.Code = "https://github.com/sphinx-doc/sphinx"
+urls.Download = "https://pypi.org/project/Sphinx/"
+urls.Homepage = "https://www.sphinx-doc.org/"
+urls."Issue tracker" = "https://github.com/sphinx-doc/sphinx/issues"
+license.text = "BSD"
+requires-python = ">=3.6"
+
+# Classifiers list: https://pypi.org/classifiers/
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Framework :: Setuptools Plugin",
+    "Framework :: Sphinx",
+    "Framework :: Sphinx :: Extension",
+    "Framework :: Sphinx :: Theme",
+    "Topic :: Documentation",
+    "Topic :: Documentation :: Sphinx",
+    "Topic :: Internet :: WWW/HTTP :: Site Management",
+    "Topic :: Printing",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Text Processing",
+    "Topic :: Text Processing :: General",
+    "Topic :: Text Processing :: Indexing",
+    "Topic :: Text Processing :: Markup",
+    "Topic :: Text Processing :: Markup :: HTML",
+    "Topic :: Text Processing :: Markup :: LaTeX",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "sphinxcontrib-applehelp",
+    "sphinxcontrib-devhelp",
+    "sphinxcontrib-jsmath",
+    "sphinxcontrib-htmlhelp>=2.0.0",
+    "sphinxcontrib-serializinghtml>=1.1.5",
+    "sphinxcontrib-qthelp",
+    "Jinja2>=3.0",
+    "Pygments>=2.12",
+    "docutils>=0.14,<0.20",
+    "snowballstemmer>=2.0",
+    "babel>=2.9",
+    "alabaster>=0.7,<0.8",
+    "imagesize>=1.3",
+    "requests>=2.5.0",
+    "packaging>=21.0",
+    "importlib-metadata>=4.8; python_version < '3.10'",
+    "colorama>=0.4.5; sys_platform == 'win32'",
+]
+dynamic = ["version"]
+
+[project.optional-dependencies]
+docs = [
+    "sphinxcontrib-websupport",
+]
+lint = [
+    "flake8>=3.5.0",
+    "flake8-comprehensions",
+    "flake8-bugbear",
+    "isort",
+    "mypy>=0.971",
+    "sphinx-lint",
+    "docutils-stubs",
+    "types-typed-ast",
+    "types-requests",
+]
+test = [
+    "pytest>=4.6",
+    "html5lib",
+    "typed_ast; python_version < '3.8'",
+    "cython",
+]
+
+[[project.authors]]
+name = "Georg Brandl"
+email = "georg@python.org"
+
+[project.scripts]
+sphinx-build = "sphinx.cmd.build:main"
+sphinx-quickstart = "sphinx.cmd.quickstart:main"
+sphinx-apidoc = "sphinx.ext.apidoc:main"
+sphinx-autogen = "sphinx.ext.autosummary.generate:main"
+
+[project.entry-points."distutils.commands"]
+build_sphinx = 'sphinx.setup_command:BuildDoc'
+
+[tool.flit.module]
+name = "sphinx"
+
+[tool.flit.sdist]
+include = [
+    "LICENSE",
+    "AUTHORS",
+    "CHANGES",
+    # Documentation
+    "doc/",
+    "CODE_OF_CONDUCT",  # used as an include in the Documentation
+    "EXAMPLES",  # used as an include in the Documentation
+    # Tests
+    "tests/",
+    "tox.ini",
+    # Utilities
+    "utils/",
+    "babel.cfg",
+]
+exclude = [
+    "doc/_build",
+]

setup.cfg

@@ -1,14 +1,3 @@
-[metadata]
-license_files = LICENSE
-
-[egg_info]
-tag_build = .dev
-tag_date = true
-
-[aliases]
-release = egg_info -Db ''
-upload = upload --sign --identity=36580288
-
 [flake8]
 max-line-length = 95
 ignore = E116,E241,E251,E741,W504,I101,B006,B023