add logging to BuildSystemIntegrationExtensions

Author: matthewbastien

Sources/DocCDocumentation/BuildSystemIntegrationExtensions.swift

@@ -14,14 +14,19 @@ package import BuildServerProtocol
 package import BuildSystemIntegration
 package import Foundation
 import LanguageServerProtocol
+import SKLogging
 
 package extension BuildSystemManager {
   /// Retrieves the name of the Swift module for a given target.
   ///
   /// - Parameter target: The build target identifier
   /// - Returns: The name of the Swift module or nil if it could not be determined
   func moduleName(for target: BuildTargetIdentifier) async -> String? {
-    let sourceFiles = (try? await sourceFiles(in: [target]).flatMap(\.sources)) ?? []
+    let sourceFiles =
+      await orLog(
+        "Failed to retreive source files from target \(target.uri)",
+        { try await self.sourceFiles(in: [target]).flatMap(\.sources) }
+      ) ?? []
     for sourceFile in sourceFiles {
       let language = await defaultLanguage(for: sourceFile.uri, in: target)
       guard language == .swift else {
@@ -39,7 +44,11 @@ package extension BuildSystemManager {
   /// - Parameter target: The build target identifier
   /// - Returns: The URL of the documentation catalog or nil if one could not be found
   func doccCatalog(for target: BuildTargetIdentifier) async -> URL? {
-    let sourceFiles = (try? await sourceFiles(in: [target]).flatMap(\.sources)) ?? []
+    let sourceFiles =
+      await orLog(
+        "Failed to retreive source files from target \(target.uri)",
+        { try await self.sourceFiles(in: [target]).flatMap(\.sources) }
+      ) ?? []
     let catalogURLs = sourceFiles.compactMap { sourceItem -> URL? in
       guard sourceItem.dataKind == .sourceKit,
         let data = SourceKitSourceItemData(fromLSPAny: sourceItem.data),
@@ -49,6 +58,9 @@ package extension BuildSystemManager {
       }
       return sourceItem.uri.fileURL
     }.sorted(by: { $0.absoluteString >= $1.absoluteString })
+    if catalogURLs.count > 1 {
+      logger.error("Multiple SwiftDocC catalogs found in build target \(target.uri)")
+    }
     return catalogURLs.first
   }
 }