[llvm][tapi-diff] Transition diff-tool to be more general purpose

This is the first of transition tapi-diff to be readtapi.
This tool will eventually replace functionality for Xcode's `xcrun tapi stubify` and
`xcrun tapi archive`.
This patch updates the tool name and is a minor refactor for the driver to handle more options.

Reviewed By: zixuw

Differential Revision: https://reviews.llvm.org/D153045

(cherry picked from commit 5656d79)

Author: cyndyishida

llvm/test/CMakeLists.txt

@@ -133,7 +133,7 @@ set(LLVM_TEST_DEPENDS
           llvm-strip
           llvm-symbolizer
           llvm-tblgen
-          llvm-tapi-diff
+          llvm-readtapi
           llvm-tli-checker
           llvm-undname
           llvm-windres

llvm/test/lit.cfg.py

@@ -167,7 +167,7 @@ def get_asan_rtlib():
     'llvm-pdbutil', 'llvm-profdata', 'llvm-profgen', 'llvm-ranlib', 'llvm-rc', 'llvm-readelf',
     'llvm-readobj', 'llvm-remark-size-diff', 'llvm-rtdyld', 'llvm-sim',
     'llvm-size', 'llvm-split', 'llvm-stress', 'llvm-strings', 'llvm-strip',
-    'llvm-tblgen', 'llvm-tapi-diff', 'llvm-undname', 'llvm-windres',
+    'llvm-tblgen', 'llvm-readtapi', 'llvm-undname', 'llvm-windres',
     'llvm-c-test', 'llvm-cxxfilt', 'llvm-xray', 'yaml2obj', 'obj2yaml',
     'yaml-bench', 'verify-uselistorder', 'bugpoint', 'llc', 'llvm-symbolizer',
     'opt', 'sancov', 'sanstats', 'llvm-remarkutil'])

llvm/test/tools/llvm-tapi-diff/Inputs/macho.yaml renamed to llvm/test/tools/llvm-readtapi/Inputs/macho.yaml

@@ -1,6 +1,6 @@
 ; RUN: mkdir -p %t
 ; RUN: yaml2obj %S/Inputs/macho.yaml -o %t/macho.dylib
-; RUN: not llvm-tapi-diff %S/Inputs/v4A.tbd %t/macho.dylib 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4A.tbd %t/macho.dylib 2>&1 | FileCheck %s
 
 ; CHECK: error: {{.*}}macho.dylib' unsupported file format
 ; CHECK-NOT: error:

llvm/test/tools/llvm-tapi-diff/Inputs/v4A.tbd renamed to llvm/test/tools/llvm-readtapi/Inputs/v4A.tbd

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4B.tbd %S/Inputs/v4E.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4B.tbd %S/Inputs/v4E.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4B.tbd
 ; CHECK:> {{.*}}/Inputs/v4E.tbd

llvm/test/tools/llvm-tapi-diff/Inputs/v4B.tbd renamed to llvm/test/tools/llvm-readtapi/Inputs/v4B.tbd

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4A.tbd %S/Inputs/v4B.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4A.tbd %S/Inputs/v4B.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4A.tbd
 ; CHECK:> {{.*}}/Inputs/v4B.tbd

llvm/test/tools/llvm-tapi-diff/Inputs/v4C.tbd renamed to llvm/test/tools/llvm-readtapi/Inputs/v4C.tbd

@@ -0,0 +1,4 @@
+; RUN: llvm-readtapi --compare %S/Inputs/v4A.tbd %S/Inputs/v4A.tbd 2>&1 | FileCheck %s --allow-empty
+
+; CHECK-NOT: error:
+; CHECK-NOT: warning:

llvm/test/tools/llvm-tapi-diff/Inputs/v4D.tbd renamed to llvm/test/tools/llvm-readtapi/Inputs/v4D.tbd

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4B.tbd %S/Inputs/v4D.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4B.tbd %S/Inputs/v4D.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4B.tbd
 ; CHECK:> {{.*}}/Inputs/v4D.tbd

llvm/test/tools/llvm-tapi-diff/Inputs/v4E.tbd renamed to llvm/test/tools/llvm-readtapi/Inputs/v4E.tbd

@@ -0,0 +1,3 @@
+; RUN: not llvm-readtapi --compare %S/Inputs/v4A.tbd %S/Inputs/v4.tbd 2>&1 | FileCheck -DMSG=%errc_ENOENT %s
+
+; CHECK: error: {{.*}}v4.tbd' [[MSG]]

llvm/test/tools/llvm-tapi-diff/incorrect-format.test renamed to llvm/test/tools/llvm-readtapi/compare-incorrect-format.test

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4A.tbd %S/Inputs/v4D.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4A.tbd %S/Inputs/v4D.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4A.tbd
 ; CHECK:> {{.*}}/Inputs/v4D.tbd

llvm/test/tools/llvm-tapi-diff/same-num-inlines.test renamed to llvm/test/tools/llvm-readtapi/compare-inlines.test

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4A.tbd %S/Inputs/v4C.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4A.tbd %S/Inputs/v4C.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4A.tbd
 ; CHECK:> {{.*}}/Inputs/v4C.tbd

llvm/test/tools/llvm-tapi-diff/left-single-inline.test renamed to llvm/test/tools/llvm-readtapi/compare-left-single-inline.test

@@ -1,4 +1,4 @@
-; RUN: not llvm-tapi-diff %S/Inputs/v4B.tbd %S/Inputs/v4C.tbd 2>&1 | FileCheck %s
+; RUN: not llvm-readtapi --compare %S/Inputs/v4B.tbd %S/Inputs/v4C.tbd 2>&1 | FileCheck %s
 
 ; CHECK:< {{.*}}/Inputs/v4B.tbd
 ; CHECK:> {{.*}}/Inputs/v4C.tbd

llvm/test/tools/llvm-readtapi/compare-matching-tapi-files.test

@@ -1,7 +1,7 @@
 ; RUN: rm -rf %t
 ; RUN: split-file %s %t  
-; RUN: llvm-tapi-diff %t/Simple_v5.tbd  %t/Simple_v5.tbd 2>&1 | FileCheck %s --allow-empty
-; RUN: llvm-tapi-diff %t/Simple_v5.tbd  %t/Simple_v4.tbd 2>&1 | FileCheck %s --allow-empty
+; RUN: llvm-readtapi --compare %t/Simple_v5.tbd  %t/Simple_v5.tbd 2>&1 | FileCheck %s --allow-empty
+; RUN: llvm-readtapi --compare %t/Simple_v5.tbd  %t/Simple_v4.tbd 2>&1 | FileCheck %s --allow-empty
 
 ; CHECK-NOT: error:
 ; CHECK-NOT: warning:

llvm/test/tools/llvm-tapi-diff/mismatched-number-of-inlines.test renamed to llvm/test/tools/llvm-readtapi/compare-mismatched-inlines.test

@@ -4,7 +4,7 @@ set(LLVM_LINK_COMPONENTS
   TextAPI
   )
 
-add_llvm_tool(llvm-tapi-diff
-  llvm-tapi-diff.cpp
+add_llvm_tool(llvm-readtapi
+  llvm-readtapi.cpp
   DiffEngine.cpp
   )

llvm/test/tools/llvm-readtapi/compare-misspelled-files.test

@@ -0,0 +1,90 @@
+//===-- llvm-readtapi.cpp - tapi file reader and manipulator -----*- C++-*-===//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+//
+// This file defines the command-line driver for llvm-readtapi.
+//
+//===----------------------------------------------------------------------===//
+#include "DiffEngine.h"
+#include "llvm/Object/TapiUniversal.h"
+#include "llvm/Support/CommandLine.h"
+#include "llvm/Support/Error.h"
+#include "llvm/Support/InitLLVM.h"
+#include "llvm/Support/MemoryBuffer.h"
+#include "llvm/Support/WithColor.h"
+#include "llvm/Support/raw_ostream.h"
+#include <cstdlib>
+
+using namespace llvm;
+using namespace MachO;
+using namespace object;
+
+namespace {
+cl::OptionCategory TapiCat("llvm-readtapi options");
+cl::OptionCategory CompareCat("llvm-readtapi --compare options");
+
+cl::opt<std::string> InputFileName(cl::Positional, cl::desc("<tapi file>"),
+                                   cl::Required, cl::cat(TapiCat));
+cl::opt<std::string> CompareInputFileName(cl::Positional,
+                                          cl::desc("<comparison file>"),
+                                          cl::Required, cl::cat(CompareCat));
+enum OutputKind {
+  Compare,
+};
+
+cl::opt<OutputKind>
+    Output(cl::desc("choose command action:"),
+           cl::values(clEnumValN(Compare, "compare",
+                                 "compare tapi file for library differences")),
+           cl::init(OutputKind::Compare), cl::cat(TapiCat));
+} // anonymous namespace
+
+Expected<std::unique_ptr<Binary>> convertFileToBinary(std::string &Filename) {
+  ErrorOr<std::unique_ptr<MemoryBuffer>> BufferOrErr =
+      MemoryBuffer::getFileOrSTDIN(Filename);
+  if (BufferOrErr.getError())
+    return errorCodeToError(BufferOrErr.getError());
+  return createBinary(BufferOrErr.get()->getMemBufferRef());
+}
+
+int main(int Argc, char **Argv) {
+  InitLLVM X(Argc, Argv);
+  cl::HideUnrelatedOptions(TapiCat);
+  cl::ParseCommandLineOptions(Argc, Argv,
+                              "TAPI File Reader and Manipulator Tool");
+
+  if (Output == OutputKind::Compare) {
+    if (InputFileName.empty() || CompareInputFileName.empty()) {
+      cl::PrintHelpMessage();
+      return EXIT_FAILURE;
+    }
+
+    ExitOnError ExitOnErr("error: '" + InputFileName + "' ",
+                          /*DefaultErrorExitCode=*/2);
+    auto BinLHS = ExitOnErr(convertFileToBinary(InputFileName));
+
+    TapiUniversal *FileLHS = dyn_cast<TapiUniversal>(BinLHS.get());
+    if (!FileLHS) {
+      ExitOnErr(createStringError(std::errc::executable_format_error,
+                                  "unsupported file format"));
+    }
+
+    ExitOnErr.setBanner("error: '" + CompareInputFileName + "' ");
+    auto BinRHS = ExitOnErr(convertFileToBinary(CompareInputFileName));
+
+    TapiUniversal *FileRHS = dyn_cast<TapiUniversal>(BinRHS.get());
+    if (!FileRHS) {
+      ExitOnErr(createStringError(std::errc::executable_format_error,
+                                  "unsupported file format"));
+    }
+
+    raw_ostream &OS = outs();
+    return DiffEngine(FileLHS, FileRHS).compareFiles(OS);
+  }
+
+  return 0;
+}