//===--- SwiftConformingMethodList.cpp ------------------------------------===// // // This source file is part of the Swift.org open source project // // Copyright (c) 2019 Apple Inc. and the Swift project authors // Licensed under Apache License v2.0 with Runtime Library Exception // // See https://swift.org/LICENSE.txt for license information // See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors // //===----------------------------------------------------------------------===// #include "SwiftASTManager.h" #include "SwiftEditorDiagConsumer.h" #include "SwiftLangSupport.h" #include "swift/Frontend/Frontend.h" #include "swift/Frontend/PrintingDiagnosticConsumer.h" #include "swift/IDE/ConformingMethodList.h" #include "swift/IDETool/IDEInspectionInstance.h" #include "clang/AST/ASTContext.h" #include "clang/AST/Comment.h" #include "clang/AST/Decl.h" #include "clang/AST/Type.h" using namespace SourceKit; using namespace swift; using namespace ide; static void translateConformingMethodListOptions(OptionsDictionary &from, ConformingMethodList::Options &to) { // ConformingMethodList doesn't receive any options at this point. } static void deliverResults(SourceKit::ConformingMethodListConsumer &SKConsumer, CancellableResult Result) { switch (Result.getKind()) { case CancellableResultKind::Success: { SKConsumer.setReusingASTContext(Result->DidReuseAST); if (!Result->Result) { // If we have no results, don't call SKConsumer.handleResult which causes // empty results to be delivered. break; } SmallString<512> SS; llvm::raw_svector_ostream OS(SS); unsigned TypeNameBegin = SS.size(); Result->Result->ExprType.print(OS); unsigned TypeNameLength = SS.size() - TypeNameBegin; unsigned TypeUSRBegin = SS.size(); SwiftLangSupport::printTypeUSR(Result->Result->ExprType, OS); unsigned TypeUSRLength = SS.size() - TypeUSRBegin; struct MemberInfo { size_t DeclNameBegin = 0; size_t DeclNameLength = 0; size_t TypeNameBegin = 0; size_t TypeNameLength = 0; size_t TypeUSRBegin = 0; size_t TypeUSRLength = 0; size_t DescriptionBegin = 0; size_t DescriptionLength = 0; size_t SourceTextBegin = 0; size_t SourceTextLength = 0; StringRef BriefComment; MemberInfo() {} }; SmallVector Members; for (auto member : Result->Result->Members) { Members.emplace_back(); auto &memberElem = Members.back(); auto funcTy = cast(member)->getMethodInterfaceType(); funcTy = Result->Result->ExprType->getTypeOfMember( Result->Result->DC->getParentModule(), member, funcTy); auto resultTy = funcTy->castTo()->getResult(); // Name. memberElem.DeclNameBegin = SS.size(); member->getName().print(OS); memberElem.DeclNameLength = SS.size() - memberElem.DeclNameBegin; // Type name. memberElem.TypeNameBegin = SS.size(); resultTy.print(OS); memberElem.TypeNameLength = SS.size() - memberElem.TypeNameBegin; // Type USR. memberElem.TypeUSRBegin = SS.size(); SwiftLangSupport::printTypeUSR(resultTy, OS); memberElem.TypeUSRLength = SS.size() - memberElem.TypeUSRBegin; // Description. memberElem.DescriptionBegin = SS.size(); SwiftLangSupport::printMemberDeclDescription( member, Result->Result->ExprType, /*usePlaceholder=*/false, OS); memberElem.DescriptionLength = SS.size() - memberElem.DescriptionBegin; // Sourcetext. memberElem.SourceTextBegin = SS.size(); SwiftLangSupport::printMemberDeclDescription( member, Result->Result->ExprType, /*usePlaceholder=*/true, OS); memberElem.SourceTextLength = SS.size() - memberElem.SourceTextBegin; // DocBrief. auto MaybeClangNode = member->getClangNode(); if (MaybeClangNode) { if (auto *D = MaybeClangNode.getAsDecl()) { const auto &ClangContext = D->getASTContext(); if (const clang::RawComment *RC = ClangContext.getRawCommentForAnyRedecl(D)) memberElem.BriefComment = RC->getBriefText(ClangContext); } } else { memberElem.BriefComment = member->getSemanticBriefComment(); } } SourceKit::ConformingMethodListResult SKResult; SmallVector SKMembers; for (auto info : Members) { StringRef Name(SS.begin() + info.DeclNameBegin, info.DeclNameLength); StringRef TypeName(SS.begin() + info.TypeNameBegin, info.TypeNameLength); StringRef TypeUSR(SS.begin() + info.TypeUSRBegin, info.TypeUSRLength); StringRef Description(SS.begin() + info.DescriptionBegin, info.DescriptionLength); StringRef SourceText(SS.begin() + info.SourceTextBegin, info.SourceTextLength); SKMembers.push_back({Name, TypeName, TypeUSR, Description, SourceText, info.BriefComment}); } SKResult.TypeName = StringRef(SS.begin() + TypeNameBegin, TypeNameLength); SKResult.TypeUSR = StringRef(SS.begin() + TypeUSRBegin, TypeUSRLength); SKResult.Members = SKMembers; SKConsumer.handleResult(SKResult); break; } case CancellableResultKind::Failure: SKConsumer.failed(Result.getError()); break; case CancellableResultKind::Cancelled: SKConsumer.cancelled(); break; } } void SwiftLangSupport::getConformingMethodList( llvm::MemoryBuffer *UnresolvedInputFile, unsigned Offset, OptionsDictionary *optionsDict, ArrayRef Args, ArrayRef ExpectedTypeNames, SourceKitCancellationToken CancellationToken, SourceKit::ConformingMethodListConsumer &SKConsumer, llvm::Optional vfsOptions) { std::string error; // FIXME: the use of None as primary file is to match the fact we do not read // the document contents using the editor documents infrastructure. auto fileSystem = getFileSystem(vfsOptions, /*primaryFile=*/llvm::None, error); if (!fileSystem) { return SKConsumer.failed(error); } ConformingMethodList::Options options; if (optionsDict) { translateConformingMethodListOptions(*optionsDict, options); } performWithParamsToCompletionLikeOperation( UnresolvedInputFile, Offset, /*InsertCodeCompletionToken=*/true, Args, fileSystem, CancellationToken, [&](CancellableResult ParmsResult) { ParmsResult.mapAsync( [&](auto &Params, auto DeliverTransformed) { getIDEInspectionInstance()->conformingMethodList( Params.Invocation, Args, fileSystem, Params.completionBuffer, Offset, Params.DiagC, ExpectedTypeNames, Params.CancellationFlag, DeliverTransformed); }, [&](auto Result) { deliverResults(SKConsumer, Result); }); }); }