swift-api-digester: add an action to generate empty baselines

Author: nkcsgexi

test/api-digester/Outputs/empty-baseline.json

@@ -0,0 +1,6 @@
+{
+  "kind": "Root",
+  "name": "TopLevel",
+  "printedName": "TopLevel",
+  "json_format_version": 1
+}

test/api-digester/dump-empty-baseline.swift

@@ -0,0 +1,8 @@
+// REQUIRES: OS=macosx
+// RUN: %empty-directory(%t.mod)
+// RUN: %empty-directory(%t.sdk)
+// RUN: %empty-directory(%t.module-cache)
+// RUN: %api-digester -generate-empty-baseline -o %t.result -avoid-tool-args
+// RUN: diff -u %S/Outputs/empty-baseline.json %t.result
+// RUN: %api-digester -deserialize-sdk -input-paths %S/Outputs/empty-baseline.json -o %t.result
+// RUN: diff -u %S/Outputs/empty-baseline.json %t.result

tools/swift-api-digester/ModuleAnalyzerNodes.cpp

@@ -2065,11 +2065,17 @@ void SwiftDeclCollector::serialize(StringRef Filename) {
   SwiftDeclCollector::serialize(Filename, RootNode);
 }
 
+SDKNodeRoot *
+swift::ide::api::getEmptySDKNodeRoot(SDKContext &SDKCtx) {
+  SwiftDeclCollector Collector(SDKCtx);
+  return Collector.getSDKRoot();
+}
+
 SDKNodeRoot*
 swift::ide::api::getSDKNodeRoot(SDKContext &SDKCtx,
                                  const CompilerInvocation &InitInvok,
-                                 const llvm::StringSet<> &ModuleNames,
-                                 CheckerOptions Opts) {
+                                 const llvm::StringSet<> &ModuleNames) {
+  CheckerOptions Opts = SDKCtx.getOpts();
   CompilerInvocation Invocation(InitInvok);
 
   CompilerInstance &CI = SDKCtx.newCompilerInstance();
@@ -2115,18 +2121,24 @@ swift::ide::api::getSDKNodeRoot(SDKContext &SDKCtx,
   return Collector.getSDKRoot();
 }
 
+void swift::ide::api::dumpSDKRoot(SDKNodeRoot *Root, StringRef OutputFile) {
+  assert(Root);
+  auto Opts = Root->getSDKContext().getOpts();
+  if (Opts.Verbose)
+    llvm::errs() << "Dumping SDK...\n";
+  SwiftDeclCollector::serialize(OutputFile, Root);
+  if (Opts.Verbose)
+    llvm::errs() << "Dumped to "<< OutputFile << "\n";
+}
+
 int swift::ide::api::dumpSDKContent(const CompilerInvocation &InitInvok,
                                     const llvm::StringSet<> &ModuleNames,
                                     StringRef OutputFile, CheckerOptions Opts) {
   SDKContext SDKCtx(Opts);
-  SDKNode *Root = getSDKNodeRoot(SDKCtx, InitInvok, ModuleNames, Opts);
+  SDKNodeRoot *Root = getSDKNodeRoot(SDKCtx, InitInvok, ModuleNames);
   if (!Root)
     return 1;
-  if (Opts.Verbose)
-    llvm::errs() << "Dumping SDK...\n";
-  SwiftDeclCollector::serialize(OutputFile, Root);
-  if (Opts.Verbose)
-    llvm::errs() << "Dumped to "<< OutputFile << "\n";
+  dumpSDKRoot(Root, OutputFile);
   return 0;
 }
 

tools/swift-api-digester/ModuleAnalyzerNodes.h

@@ -748,8 +748,11 @@ int dumpSwiftModules(const CompilerInvocation &InitInvok,
 
 SDKNodeRoot *getSDKNodeRoot(SDKContext &SDKCtx,
                             const CompilerInvocation &InitInvok,
-                            const llvm::StringSet<> &ModuleNames,
-                            CheckerOptions Opts);
+                            const llvm::StringSet<> &ModuleNames);
+
+SDKNodeRoot *getEmptySDKNodeRoot(SDKContext &SDKCtx);
+
+void dumpSDKRoot(SDKNodeRoot *Root, StringRef OutputFile);
 
 int dumpSDKContent(const CompilerInvocation &InitInvok,
                    const llvm::StringSet<> &ModuleNames,

tools/swift-api-digester/swift-api-digester.cpp

@@ -48,6 +48,7 @@ namespace  {
     DeserializeSDK,
     GenerateNameCorrectionTemplate,
     FindUsr,
+    GenerateEmptyBaseline,
   };
 } // end anonymous namespace
 
@@ -173,7 +174,10 @@ Action(llvm::cl::desc("Mode:"), llvm::cl::init(ActionType::None),
                      "Find USR for decls by given condition"),
           clEnumValN(ActionType::GenerateNameCorrectionTemplate,
                      "generate-name-correction",
-                     "Generate name correction template")));
+                     "Generate name correction template"),
+          clEnumValN(ActionType::GenerateEmptyBaseline,
+                     "generate-empty-baseline",
+                     "Generate an empty baseline")));
 
 static llvm::cl::list<std::string>
 SDKJsonPaths("input-paths",
@@ -2480,13 +2484,12 @@ static CheckerOptions getCheckOpts(int argc, char *argv[]) {
   return Opts;
 }
 
-static SDKNodeRoot *getSDKRoot(const char *Main, SDKContext &Ctx,
-                            CheckerOptions Opts, bool IsBaseline) {
+static SDKNodeRoot *getSDKRoot(const char *Main, SDKContext &Ctx, bool IsBaseline) {
   CompilerInvocation Invok;
   llvm::StringSet<> Modules;
   if (prepareForDump(Main, Invok, Modules, IsBaseline))
     return nullptr;
-  return getSDKNodeRoot(Ctx, Invok, Modules, Opts);
+  return getSDKNodeRoot(Ctx, Invok, Modules);
 }
 
 static bool hasBaselineInput() {
@@ -2537,8 +2540,8 @@ int main(int argc, char *argv[]) {
                                   std::move(protocolWhitelist));
     else {
       SDKContext Ctx(Opts);
-      return diagnoseModuleChange(Ctx, getSDKRoot(argv[0], Ctx, Opts, true),
-                                  getSDKRoot(argv[0], Ctx, Opts, false),
+      return diagnoseModuleChange(Ctx, getSDKRoot(argv[0], Ctx, true),
+                                  getSDKRoot(argv[0], Ctx, false),
                                   options::OutputFile,
                                   std::move(protocolWhitelist));
     }
@@ -2567,6 +2570,11 @@ int main(int argc, char *argv[]) {
       Store.addStorePath(Paths[I]);
     return deserializeNameCorrection(Store, options::OutputFile);
   }
+  case ActionType::GenerateEmptyBaseline: {
+    SDKContext Ctx(Opts);
+    dumpSDKRoot(getEmptySDKNodeRoot(Ctx), options::OutputFile);
+    return 0;
+  }
   case ActionType::FindUsr: {
     if (options::SDKJsonPaths.size() != 1) {
       llvm::cl::PrintHelpMessage();