[libclang][Dependency Scanning] Implementing C-APIs to Report a Module's Link Libraries (#10994) (#11008)

This PR implements the C-APIs for a client can query a module's link libraries.

rdar://154807137
(cherry picked from commit 708340e)

Author: qiongsiwu

clang/include/clang-c/Dependencies.h

@@ -735,6 +735,56 @@ const char *clang_experimental_DepGraph_getTUContextHash(CXDepGraph);
 CINDEX_LINKAGE
 CXDiagnosticSet clang_experimental_DepGraph_getDiagnostics(CXDepGraph);
 
+/**
+ * An opaque object that contains a \c CXDepGraphModule 's list of link
+ * libraries.
+ */
+typedef struct CXOpaqueDepGraphModuleLinkLibrarySet
+    *CXDepGraphModuleLinkLibrarySet;
+
+/**
+ * An opaque object that contains information about a link library.
+ */
+typedef struct CXOpaqueDepGraphModuleLinkLibrary *CXDepGraphModuleLinkLibrary;
+
+/**
+ * Get the set of link libraries given a \c CXDepGraphModule instance.
+ * The returned set is a pointer into memory that the \c CXDepGraphModule
+ * instance owns. Therefore the set does not need to be disposed.
+ */
+CINDEX_LINKAGE CXDepGraphModuleLinkLibrarySet
+    clang_experimental_DepGraphModule_getLinkLibrarySet(CXDepGraphModule);
+
+/**
+ * Get the size of \c CXDepGraphModuleLinkLibrarySet .
+ */
+CINDEX_LINKAGE size_t clang_experimental_DepGraphModuleLinkLibrarySet_getSize(
+    CXDepGraphModuleLinkLibrarySet);
+
+/**
+ * Retrieve the \c CXDepGraphModuleLinkLibrary instance at index \p Idx from the
+ * \c CXDepGraphModuleLinkLibrarySet instance.
+ */
+CINDEX_LINKAGE CXDepGraphModuleLinkLibrary
+clang_experimental_DepGraphModuleLinkLibrarySet_getLinkLibrary(
+    CXDepGraphModuleLinkLibrarySet, size_t Idx);
+
+/**
+ * Get the `Library` string from the \c CXDepGraphModuleLinkLibrary instance.
+ * `Library` could be a library name, or an absolute path to a library or a
+ * framework, as specified in the corresponding \c CXDepGraphModule instance's
+ * modulemap.
+ */
+CINDEX_LINKAGE CXString clang_experimental_DepGraphModuleLinkLibrary_getLibrary(
+    CXDepGraphModuleLinkLibrary);
+
+/**
+ * Returns true if the \c CXDepGraphModuleLinkLibrary is a framework, false
+ * otherwise.
+ */
+CINDEX_LINKAGE bool clang_experimental_DepGraphModuleLinkLibrary_isFramework(
+    CXDepGraphModuleLinkLibrary);
+
 /**
  * @}
  */

clang/test/Index/Core/Inputs/module/module.modulemap

@@ -8,4 +8,8 @@ module ModA {
       header "SubSubModA.h"
     }
   }
+
+  link framework "libModA"
+  link "libModB"
+  link "/absolute/path/to/a/lib/file"
 }

clang/test/Index/Core/scan-deps-by-mod-name.m

@@ -21,6 +21,10 @@
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/ModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubSubModA.h
+// CHECK-NEXT:     link libraries:
+// CHECK-NEXT:         libModA(framework)
+// CHECK-NEXT:         libModB
+// CHECK-NEXT:         /absolute/path/to/a/lib/file
 // CHECK-NEXT:     build-args: {{.*}} -emit-module {{.*}} -fmodule-name=ModA {{.*}} -fno-implicit-modules {{.*}}
 // CHECK-NEXT: dependencies:
 // CHECK-NEXT:   command 0:

clang/test/Index/Core/scan-deps-cas.m

@@ -41,6 +41,10 @@
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/ModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubSubModA.h
+// CHECK-NEXT:     link libraries:
+// CHECK-NEXT:         libModA(framework)
+// CHECK-NEXT:         libModB
+// CHECK-NEXT:         /absolute/path/to/a/lib/file
 // CHECK-NEXT:     build-args:
 // CHECK-SAME:       -cc1
 // CHECK-SAME:       -fcas-path
@@ -81,6 +85,10 @@
 // INCLUDE_TREE-NEXT:       [[PREFIX]]/Inputs/module/ModA.h
 // INCLUDE_TREE-NEXT:       [[PREFIX]]/Inputs/module/SubModA.h
 // INCLUDE_TREE-NEXT:       [[PREFIX]]/Inputs/module/SubSubModA.h
+// INCLUDE_TREE-NEXT:     link libraries:
+// INCLUDE_TREE-NEXT:         libModA(framework)
+// INCLUDE_TREE-NEXT:         libModB
+// INCLUDE_TREE-NEXT:         /absolute/path/to/a/lib/file
 // INCLUDE_TREE-NEXT:     build-args:
 // INCLUDE_TREE-SAME:       -cc1
 // INCLUDE_TREE-SAME:       -fcas-path

clang/test/Index/Core/scan-deps.m

@@ -29,6 +29,10 @@
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/ModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubModA.h
 // CHECK-NEXT:       [[PREFIX]]/Inputs/module/SubSubModA.h
+// CHECK-NEXT:     link libraries:
+// CHECK-NEXT:         libModA(framework)
+// CHECK-NEXT:         libModB
+// CHECK-NEXT:         /absolute/path/to/a/lib/file
 // CHECK-NEXT:     build-args: {{.*}} -emit-module {{.*}} -fmodule-name=ModA {{.*}} -fno-implicit-modules {{.*}}
 
 // CHECK-NEXT: dependencies:

clang/tools/c-index-test/core_main.cpp

@@ -854,6 +854,25 @@ static int scanDeps(ArrayRef<const char *> Args, std::string WorkingDirectory,
         // (mostly) platform-agnostic.
         if (!StringRef(FileName).ends_with("SDKSettings.json"))
           llvm::outs() << "      " << FileName << "\n";
+      CXDepGraphModuleLinkLibrarySet LinkLibs =
+          clang_experimental_DepGraphModule_getLinkLibrarySet(Mod);
+      size_t NumLinkLibs =
+          clang_experimental_DepGraphModuleLinkLibrarySet_getSize(LinkLibs);
+      if (NumLinkLibs) {
+        llvm::outs() << "    link libraries:\n";
+        for (size_t Idx = 0; Idx < NumLinkLibs; Idx++) {
+          CXDepGraphModuleLinkLibrary Lib =
+              clang_experimental_DepGraphModuleLinkLibrarySet_getLinkLibrary(
+                  LinkLibs, Idx);
+          CXString Library =
+              clang_experimental_DepGraphModuleLinkLibrary_getLibrary(Lib);
+          bool IsFramework =
+              clang_experimental_DepGraphModuleLinkLibrary_isFramework(Lib);
+          const char *IsFrameworkStr = IsFramework ? "(framework)" : "";
+          llvm::outs() << "        " << clang_getCString(Library)
+                       << IsFrameworkStr << "\n";
+        }
+      }
       llvm::outs() << "    build-args:";
       for (const auto &Arg :
            ArrayRef(BuildArguments.Strings, BuildArguments.Count))

clang/tools/libclang/CDependencies.cpp

@@ -773,3 +773,46 @@ std::string OutputLookup::lookupModuleOutput(const ModuleDeps &MD,
     PCMPath.first->second = ::lookupModuleOutput(MD, MOK, MLOContext, MLO);
   return PCMPath.first->second;
 }
+
+namespace {
+typedef llvm::SmallVectorImpl<clang::Module::LinkLibrary>
+    DepGraphModuleLinkLibrarySet;
+typedef clang::Module::LinkLibrary DepGraphModuleLinkLibrary;
+} // namespace
+
+DEFINE_SIMPLE_CONVERSION_FUNCTIONS(DepGraphModuleLinkLibrarySet,
+                                   CXDepGraphModuleLinkLibrarySet)
+DEFINE_SIMPLE_CONVERSION_FUNCTIONS(DepGraphModuleLinkLibrary,
+                                   CXDepGraphModuleLinkLibrary)
+
+CXDepGraphModuleLinkLibrarySet
+clang_experimental_DepGraphModule_getLinkLibrarySet(CXDepGraphModule CXDepMod) {
+  const ModuleDeps &ModDeps = *unwrap(CXDepMod)->ModDeps;
+  return wrap(&ModDeps.LinkLibraries);
+}
+
+size_t clang_experimental_DepGraphModuleLinkLibrarySet_getSize(
+    CXDepGraphModuleLinkLibrarySet S) {
+  const DepGraphModuleLinkLibrarySet *LinkLibraries = unwrap(S);
+  return LinkLibraries->size();
+}
+
+CXDepGraphModuleLinkLibrary
+clang_experimental_DepGraphModuleLinkLibrarySet_getLinkLibrary(
+    CXDepGraphModuleLinkLibrarySet S, size_t Idx) {
+  const DepGraphModuleLinkLibrarySet *LinkLibraries = unwrap(S);
+  return wrap(&(*LinkLibraries)[Idx]);
+}
+
+CXString clang_experimental_DepGraphModuleLinkLibrary_getLibrary(
+    CXDepGraphModuleLinkLibrary L) {
+  const DepGraphModuleLinkLibrary *Lib = unwrap(L);
+  return cxstring::createRef(Lib->Library.c_str());
+}
+
+bool clang_experimental_DepGraphModuleLinkLibrary_isFramework(
+    CXDepGraphModuleLinkLibrary L) {
+  const DepGraphModuleLinkLibrary *Lib = unwrap(L);
+  return Lib->IsFramework;
+}
+

clang/tools/libclang/libclang.map

@@ -575,6 +575,11 @@ LLVM_21 {
     clang_experimental_DependencyScannerServiceOptions_setCWDOptimization;
     clang_experimental_DepGraphModule_isCWDIgnored;
     clang_experimental_DepGraphModule_isInStableDirs; 
+    clang_experimental_DepGraphModule_getLinkLibrarySet;
+    clang_experimental_DepGraphModuleLinkLibrarySet_getSize;
+    clang_experimental_DepGraphModuleLinkLibrarySet_getLinkLibrary;
+    clang_experimental_DepGraphModuleLinkLibrary_getLibrary;
+    clang_experimental_DepGraphModuleLinkLibrary_isFramework;
 };
 
 # Example of how to add a new symbol version entry.  If you do add a new symbol