//===- FileList.cpp ---------------------------------------------*- 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 // //===----------------------------------------------------------------------===// #include "clang/InstallAPI/FileList.h" #include "clang/Basic/DiagnosticFrontend.h" #include "clang/InstallAPI/FileList.h" #include "llvm/ADT/StringSwitch.h" #include "llvm/Support/Error.h" #include "llvm/Support/JSON.h" #include "llvm/TextAPI/TextAPIError.h" #include // clang-format off /* InstallAPI JSON Input Format specification. { "headers" : [ # Required: Key must exist. { # Optional: May contain 0 or more header inputs. "path" : "/usr/include/mach-o/dlfn.h", # Required: Path should point to destination # location where applicable. "type" : "public", # Required: Maps to HeaderType for header. "language": "c++" # Optional: Language mode for header. } ], "version" : "3" # Required: Version 3 supports language mode & project header input. } */ // clang-format on using namespace llvm; using namespace llvm::json; using namespace llvm::MachO; using namespace clang::installapi; namespace { class Implementation { private: Expected parseString(const Object *Obj, StringRef Key, StringRef Error); Expected parsePath(const Object *Obj); Expected parseType(const Object *Obj); std::optional parseLanguage(const Object *Obj); Error parseHeaders(Array &Headers); public: std::unique_ptr InputBuffer; clang::FileManager *FM; unsigned Version; HeaderSeq HeaderList; Error parse(StringRef Input); }; Expected Implementation::parseString(const Object *Obj, StringRef Key, StringRef Error) { auto Str = Obj->getString(Key); if (!Str) return make_error(Error, inconvertibleErrorCode()); return *Str; } Expected Implementation::parseType(const Object *Obj) { auto TypeStr = parseString(Obj, "type", "required field 'type' not specified"); if (!TypeStr) return TypeStr.takeError(); if (*TypeStr == "public") return HeaderType::Public; else if (*TypeStr == "private") return HeaderType::Private; else if (*TypeStr == "project" && Version >= 2) return HeaderType::Project; return make_error(TextAPIErrorCode::InvalidInputFormat, "unsupported header type"); } Expected Implementation::parsePath(const Object *Obj) { auto Path = parseString(Obj, "path", "required field 'path' not specified"); if (!Path) return Path.takeError(); return *Path; } std::optional Implementation::parseLanguage(const Object *Obj) { auto Language = Obj->getString("language"); if (!Language) return std::nullopt; return StringSwitch(*Language) .Case("c", clang::Language::C) .Case("c++", clang::Language::CXX) .Case("objective-c", clang::Language::ObjC) .Case("objective-c++", clang::Language::ObjCXX) .Default(clang::Language::Unknown); } Error Implementation::parseHeaders(Array &Headers) { for (const auto &H : Headers) { auto *Obj = H.getAsObject(); if (!Obj) return make_error("expect a JSON object", inconvertibleErrorCode()); auto Type = parseType(Obj); if (!Type) return Type.takeError(); auto Path = parsePath(Obj); if (!Path) return Path.takeError(); auto Language = parseLanguage(Obj); StringRef PathStr = *Path; if (*Type == HeaderType::Project) { HeaderList.emplace_back( HeaderFile{PathStr, *Type, /*IncludeName=*/"", Language}); continue; } if (FM) if (!FM->getOptionalFileRef(PathStr)) return createFileError( PathStr, make_error_code(std::errc::no_such_file_or_directory)); auto IncludeName = createIncludeHeaderName(PathStr); HeaderList.emplace_back(PathStr, *Type, IncludeName.has_value() ? IncludeName.value() : "", Language); } return Error::success(); } Error Implementation::parse(StringRef Input) { auto Val = json::parse(Input); if (!Val) return Val.takeError(); auto *Root = Val->getAsObject(); if (!Root) return make_error("not a JSON object", inconvertibleErrorCode()); auto VersionStr = Root->getString("version"); if (!VersionStr) return make_error(TextAPIErrorCode::InvalidInputFormat, "required field 'version' not specified"); if (VersionStr->getAsInteger(10, Version)) return make_error(TextAPIErrorCode::InvalidInputFormat, "invalid version number"); if (Version < 1 || Version > 3) return make_error(TextAPIErrorCode::InvalidInputFormat, "unsupported version"); // Not specifying any header files should be atypical, but valid. auto Headers = Root->getArray("headers"); if (!Headers) return Error::success(); Error Err = parseHeaders(*Headers); if (Err) return Err; return Error::success(); } } // namespace llvm::Error FileListReader::loadHeaders(std::unique_ptr InputBuffer, HeaderSeq &Destination, clang::FileManager *FM) { Implementation Impl; Impl.InputBuffer = std::move(InputBuffer); Impl.FM = FM; if (llvm::Error Err = Impl.parse(Impl.InputBuffer->getBuffer())) return Err; Destination.reserve(Destination.size() + Impl.HeaderList.size()); llvm::move(Impl.HeaderList, std::back_inserter(Destination)); return Error::success(); }