From 82b1824e09cc9aed67659426743794d7a51c6937 Mon Sep 17 00:00:00 2001
From: sobolevn <mail@sobolevn.me>
Date: Wed, 17 Dec 2025 14:23:30 +0300
Subject: [PATCH] gh-142859: Add `Tools/check-c-api-docs` to mypy check
 (GH-142860) (cherry picked from commit
 248eb3efb3cad7799ef9b4a2dd77a66d1ae65c11)

Co-authored-by: sobolevn <mail@sobolevn.me>
---
 .github/workflows/mypy.yml      |  2 ++
 Tools/check-c-api-docs/mypy.ini | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 Tools/check-c-api-docs/mypy.ini

diff --git a/.github/workflows/mypy.yml b/.github/workflows/mypy.yml
index 5d5d77f29f6eb1..f821cdf1f6fbc8 100644
--- a/.github/workflows/mypy.yml
+++ b/.github/workflows/mypy.yml
@@ -25,6 +25,7 @@ on:
       - "Tools/build/update_file.py"
       - "Tools/build/verify_ensurepip_wheels.py"
       - "Tools/cases_generator/**"
+      - "Tools/check-c-api-docs/**"
       - "Tools/clinic/**"
       - "Tools/jit/**"
       - "Tools/peg_generator/**"
@@ -57,6 +58,7 @@ jobs:
           "Lib/tomllib",
           "Tools/build",
           "Tools/cases_generator",
+          "Tools/check-c-api-docs",
           "Tools/clinic",
           "Tools/jit",
           "Tools/peg_generator",
diff --git a/Tools/check-c-api-docs/mypy.ini b/Tools/check-c-api-docs/mypy.ini
new file mode 100644
index 00000000000000..f42eb2836e2fd8
--- /dev/null
+++ b/Tools/check-c-api-docs/mypy.ini
@@ -0,0 +1,19 @@
+[mypy]
+files = Tools/check-c-api-docs/
+pretty = True
+
+# We need `_colorize` import:
+mypy_path = $MYPY_CONFIG_FILE_DIR/../../Misc/mypy
+
+# Make sure Python can still be built
+# using Python 3.13 for `PYTHON_FOR_REGEN`...
+python_version = 3.13
+
+# ...And be strict:
+strict = True
+extra_checks = True
+enable_error_code = 
+    ignore-without-code,
+    redundant-expr,
+    truthy-bool,
+    possibly-undefined,