Add --xml flag to persist xml artifacts for testing purposes

Summary:
Currently, all xml artifacts generated by doxygen are stored in the tmp dir and deleted at the end of the snapshot generation. For debugging reasons, this diff adds `--xml` flag to persist generated artifacts, so that they can be analyzed.

Changelog:
[Internal]

Differential Revision: D98289956

Author: coado

scripts/cxx-api/parser/__main__.py

@@ -14,6 +14,7 @@
 import argparse
 import concurrent.futures
 import os
+import shutil
 import subprocess
 import sys
 import tempfile
@@ -147,6 +148,7 @@ def build_snapshots(
     verbose: bool,
     view_filter: str | None = None,
     is_test: bool = False,
+    keep_xml: bool = False,
 ) -> None:
     if not is_test:
         configs_to_build = [
@@ -205,7 +207,16 @@ def build_snapshots(
             input_filter=input_filter,
         )
 
-        if verbose:
+        if keep_xml:
+                xml_src = os.path.join(work_dir, "xml")
+                xml_dst = os.path.join(output_dir, "xml")
+                if os.path.exists(xml_dst):
+                    shutil.rmtree(xml_dst)
+                shutil.copytree(xml_src, xml_dst)
+                if verbose:
+                    print(f"XML files saved to {xml_dst}")
+
+            if verbose:
             print(snapshot)
 
 
@@ -242,6 +253,11 @@ def main():
         action="store_true",
         help="Run on the local test directory instead of the react-native directory",
     )
+    parser.add_argument(
+        "--xml",
+        action="store_true",
+        help="Keep the generated Doxygen XML files next to the .api output in a xml/ directory",
+    )
     args = parser.parse_args()
 
     verbose = not args.check
@@ -299,6 +315,7 @@ def main():
             input_filter=input_filter,
             view_filter=args.view,
             is_test=args.test,
+            keep_xml=args.xml,
         )
 
         if args.check: