basic current_py_cc_headers_abi analysis test

Author: rickeylev

python/private/py_cc_toolchain_info.bzl

@@ -39,7 +39,7 @@ Information about the header files, struct with fields:
     considered private and should be forward along as-is (this better allows
     e.g. `:current_py_cc_headers` to act as the underlying headers target it
     represents).
-"",
+""",
         "headers_abi3": """
 :type: struct | None
 
@@ -67,7 +67,7 @@ fields:
 :::{versionadded} VERSION_NEXT_FEATURE
 :::
 """,
-        "libs": "\
+        "libs": """
 :type: struct | None
 
 If available, information about C libraries, struct with fields:

python/private/py_cc_toolchain_rule.bzl

@@ -73,8 +73,8 @@ py_cc_toolchain = rule(
             mandatory = True,
         ),
         "headers_abi3": attr.label(
-            doc = ""
-Target that provides the Python ABI3 headers.
+            doc = """
+Target that provides the Python ABI3 (stable abi) headers.
 
 Typically this is a cc_library target.
 
@@ -96,7 +96,7 @@ Typically this is a cc_library target.
             default = labels.VISIBLE_FOR_TESTING,
         ),
     },
-    doc = """\
+    doc = """
 A toolchain for a Python runtime's C/C++ information (e.g. headers)
 
 This rule carries information about the C/C++ side of a Python runtime, e.g.

tests/cc/current_py_cc_headers/current_py_cc_headers_tests.bzl

@@ -76,6 +76,24 @@ def _test_toolchain_is_registered_by_default_impl(env, target):
 
 _tests.append(_test_toolchain_is_registered_by_default)
 
+def _test_current_toolchain_headers_abi3(name):
+    analysis_test(
+        name = name,
+        impl = _test_current_toolchain_headers_impl,
+        target = "//python/cc:current_py_cc_headers_abi3",
+        config_settings = {
+            "//command_line_option:extra_toolchains": [CC_TOOLCHAIN],
+        },
+        attrs = {
+            "header": attr.label(
+                default = "//tests/support/cc_toolchains:fake_header.h",
+                allow_single_file = True,
+            ),
+        },
+    )
+
+_tests.append(_test_current_toolchain_headers_abi3)
+
 def current_py_cc_headers_test_suite(name):
     test_suite(
         name = name,

tests/support/cc_toolchains/BUILD.bazel

@@ -38,6 +38,7 @@ toolchain(
 py_cc_toolchain(
     name = "fake_py_cc_toolchain_impl",
     headers = ":fake_headers",
+    headers_abi3 = ":fake_headers",
     libs = ":fake_libs",
     python_version = "3.999",
     tags = PREVENT_IMPLICIT_BUILDING_TAGS,