From bc57599ace268326b95249dada9275084cbed1b8 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 30 May 2022 03:26:08 +0900
Subject: [PATCH] Close #9820: Use setuptools.Command if available

distutils was marked as deprecated since Python 3.10 (see PEP 632).
And it will be removed since Python 3.12.  To follow the deprecation,
this starts to use `setuptools.Command` if available.
---
 sphinx/setup_command.py | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/sphinx/setup_command.py b/sphinx/setup_command.py
index d654c3f0612..5e63df3a717 100644
--- a/sphinx/setup_command.py
+++ b/sphinx/setup_command.py
@@ -6,8 +6,6 @@
 import os
 import sys
 import warnings
-from distutils.cmd import Command
-from distutils.errors import DistutilsExecError
 from io import StringIO
 from typing import Any, Dict
 
@@ -18,6 +16,13 @@
 from sphinx.util.docutils import docutils_namespace, patch_docutils
 from sphinx.util.osutil import abspath
 
+try:
+    from setuptools import Command
+    from setuptools.errors import ExecError
+except ImportError:
+    from distutils.cmd import Command
+    from distutils.errors import DistutilsExecError as ExecError
+
 
 class BuildDoc(Command):
     """
@@ -97,7 +102,7 @@ def initialize_options(self) -> None:
         self.link_index = False
         self.copyright = ''
         # Link verbosity to distutils' (which uses 1 by default).
-        self.verbosity = self.distribution.verbose - 1  # type: ignore
+        self.verbosity = self.distribution.verbose - 1
         self.traceback = False
         self.nitpicky = False
         self.keep_going = False
@@ -125,7 +130,7 @@ def finalize_options(self) -> None:
 
         if self.build_dir is None:
             build = self.get_finalized_command('build')
-            self.build_dir = os.path.join(abspath(build.build_base), 'sphinx')  # type: ignore
+            self.build_dir = os.path.join(abspath(build.build_base), 'sphinx')
 
         self.doctree_dir = os.path.join(self.build_dir, 'doctrees')
 
@@ -139,7 +144,7 @@ def run(self) -> None:
 
         if not color_terminal():
             nocolor()
-        if not self.verbose:  # type: ignore
+        if not self.verbose:
             status_stream = StringIO()
         else:
             status_stream = sys.stdout  # type: ignore
@@ -171,8 +176,7 @@ def run(self) -> None:
                                  verbosity=self.verbosity, keep_going=self.keep_going)
                     app.build(force_all=self.all_files)
                     if app.statuscode:
-                        raise DistutilsExecError(
-                            'caused by %s builder.' % app.builder.name)
+                        raise ExecError('caused by %s builder.' % app.builder.name)
             except Exception as exc:
                 handle_exception(app, self, exc, sys.stderr)
                 if not self.pdb: