26#include "clang-include-cleaner/Record.h"
38#include "clang/Basic/Stack.h"
39#include "clang/Format/Format.h"
40#include "clang/Lex/Preprocessor.h"
41#include "clang/Tooling/CompilationDatabase.h"
42#include "clang/Tooling/Core/Replacement.h"
43#include "llvm/ADT/ArrayRef.h"
44#include "llvm/ADT/STLExtras.h"
45#include "llvm/ADT/StringRef.h"
46#include "llvm/Support/Error.h"
47#include "llvm/Support/Path.h"
48#include "llvm/Support/raw_ostream.h"
70 UpdateIndexCallbacks(FileIndex *FIndex,
71 ClangdServer::Callbacks *ServerCallbacks,
72 const ThreadsafeFS &TFS, AsyncTaskRunner *Tasks,
73 bool CollectInactiveRegions)
74 : FIndex(FIndex), ServerCallbacks(ServerCallbacks), TFS(TFS),
75 Stdlib{std::make_shared<StdLibSet>()}, Tasks(Tasks),
76 CollectInactiveRegions(CollectInactiveRegions) {}
79 PathRef Path, llvm::StringRef Version, CapturedASTCtx ASTCtx,
80 std::shared_ptr<const include_cleaner::PragmaIncludes> PI)
override {
85 auto &PP = ASTCtx.getPreprocessor();
86 auto &CI = ASTCtx.getCompilerInvocation();
87 if (
auto Loc = Stdlib->add(CI.getLangOpts(), PP.getHeaderSearchInfo()))
88 indexStdlib(CI, std::move(*Loc));
91 auto Task = [FIndex(FIndex),
Path(
Path.str()), Version(Version.str()),
92 ASTCtx(std::move(ASTCtx)), PI(std::move(PI))]()
mutable {
93 trace::Span Tracer(
"PreambleIndexing");
94 FIndex->updatePreamble(
Path, Version, ASTCtx.getASTContext(),
95 ASTCtx.getPreprocessor(), *PI);
99 Tasks->runAsync(
"Preamble indexing for:" +
Path + Version,
105 void indexStdlib(
const CompilerInvocation &CI, StdLibLocation Loc) {
109 auto Task = [LO(CI.getLangOpts()), Loc(std::move(Loc)),
110 CI(std::make_unique<CompilerInvocation>(CI)),
121 WithContext
C(std::move(Ctx));
122 clang::noteBottomOfStack();
125 if (Stdlib->isBest(LO))
126 FIndex->updatePreamble(std::move(IF));
130 Tasks->runAsync(
"IndexStdlib", std::move(Task));
135 void onMainAST(
PathRef Path, ParsedAST &
AST, PublishFn Publish)
override {
141 ServerCallbacks->onDiagnosticsReady(
Path,
AST.version(),
142 AST.getDiagnostics());
143 if (CollectInactiveRegions) {
144 ServerCallbacks->onInactiveRegionsReady(
Path,
150 void onFailedAST(
PathRef Path, llvm::StringRef Version,
151 std::vector<Diag> Diags, PublishFn Publish)
override {
154 [&]() { ServerCallbacks->onDiagnosticsReady(
Path, Version, Diags); });
157 void onFileUpdated(
PathRef File,
const TUStatus &Status)
override {
159 ServerCallbacks->onFileUpdated(
File, Status);
164 ServerCallbacks->onSemanticsMaybeChanged(
File);
169 ClangdServer::Callbacks *ServerCallbacks;
170 const ThreadsafeFS &TFS;
171 std::shared_ptr<StdLibSet> Stdlib;
172 AsyncTaskRunner *Tasks;
173 bool CollectInactiveRegions;
178 DraftStoreFS(
const ThreadsafeFS &Base,
const DraftStore &Drafts)
179 : Base(Base), DirtyFiles(Drafts) {}
182 llvm::IntrusiveRefCntPtr<llvm::vfs::FileSystem> viewImpl()
const override {
183 auto OFS = llvm::makeIntrusiveRefCnt<llvm::vfs::OverlayFileSystem>(
184 Base.view(std::nullopt));
185 OFS->pushOverlay(DirtyFiles.asVFS());
189 const ThreadsafeFS &Base;
190 const DraftStore &DirtyFiles;
217 : FeatureModules(Opts.FeatureModules), CDB(CDB), TFS(TFS),
218 DynamicIdx(Opts.BuildDynamicSymbolIndex
219 ? new
FileIndex(Opts.EnableOutgoingCalls)
221 ModulesManager(Opts.ModulesManager),
222 ClangTidyProvider(Opts.ClangTidyProvider),
223 UseDirtyHeaders(Opts.UseDirtyHeaders),
224 LineFoldingOnly(Opts.LineFoldingOnly),
225 PreambleParseForwardingFunctions(Opts.PreambleParseForwardingFunctions),
226 SkipPreambleBuild(Opts.SkipPreambleBuild),
227 ImportInsertions(Opts.ImportInsertions),
228 PublishInactiveRegions(Opts.PublishInactiveRegions),
229 WorkspaceRoot(Opts.WorkspaceRoot),
230 Transient(Opts.ImplicitCancellation ?
TUScheduler::InvalidateOnUpdate
232 DirtyFS(std::make_unique<DraftStoreFS>(TFS, DraftMgr)),
233 ContextProvider(Opts.ContextProvider) {
235 IndexTasks.emplace();
240 std::make_unique<UpdateIndexCallbacks>(
242 IndexTasks ? &*IndexTasks :
nullptr,
243 PublishInactiveRegions));
246 if (this->Index != nullptr) {
247 MergedIdx.push_back(std::make_unique<MergedIndex>(Idx, this->Index));
248 this->Index = MergedIdx.back().get();
253 if (Opts.StaticIndex)
254 AddIndex(Opts.StaticIndex);
255 if (Opts.BackgroundIndex) {
256 BackgroundIndex::Options BGOpts;
257 BGOpts.ThreadPoolSize = std::max(Opts.AsyncThreadsCount, 1u);
258 BGOpts.OnProgress = [Callbacks](BackgroundQueue::Stats S) {
260 Callbacks->onBackgroundIndexProgress(S);
262 BGOpts.ContextProvider = Opts.ContextProvider;
263 BGOpts.SupportContainedRefs = Opts.EnableOutgoingCalls;
264 BackgroundIdx = std::make_unique<BackgroundIndex>(
267 [&CDB](llvm::StringRef
File) { return CDB.getProjectInfo(File); }),
269 AddIndex(BackgroundIdx.get());
272 AddIndex(DynamicIdx.get());
274 if (Opts.FeatureModules) {
275 FeatureModule::Facilities F{
276 *this->WorkScheduler,
280 for (
auto &Mod : *Opts.FeatureModules)
289 WorkScheduler.reset();
291 if (FeatureModules) {
292 for (
auto &Mod : *FeatureModules)
294 for (
auto &Mod : *FeatureModules)
300 llvm::StringRef Version,
302 std::string ActualVersion = DraftMgr.addDraft(
File, Version, Contents);
309 Inputs.
TFS = &getHeaderFS();
310 Inputs.
Contents = std::string(Contents);
311 Inputs.
Version = std::move(ActualVersion);
313 Inputs.
Opts = std::move(Opts);
314 Inputs.
Index = Index;
318 adjustParseInputs(Inputs,
File);
319 bool NewFile = WorkScheduler->update(
File, Inputs, WantDiags);
321 if (NewFile && BackgroundIdx)
322 BackgroundIdx->boostRelated(
File);
326 llvm::function_ref<
bool(llvm::StringRef
File)> Filter) {
328 for (
const Path &FilePath : DraftMgr.getActiveFiles())
329 if (Filter(FilePath))
330 if (
auto Draft = DraftMgr.getDraft(FilePath))
331 addDocument(FilePath, *Draft->Contents, Draft->Version,
336 auto Draft = DraftMgr.getDraft(
File);
339 return std::move(Draft->Contents);
351 std::mutex PublishMu;
354 : Provider(Provider), Publish(Publish) {}
361 std::chrono::steady_clock::now() - std::chrono::seconds(5);
362 llvm::SmallString<256> PosixPath;
364 assert(llvm::sys::path::is_absolute(
File));
365 llvm::sys::path::native(
File, PosixPath, llvm::sys::path::Style::posix);
366 Params.
Path = PosixPath.str();
369 llvm::StringMap<std::vector<Diag>> ReportableDiagnostics;
370 Config C = Provider->
getConfig(Params, [&](
const llvm::SMDiagnostic &D) {
374 handleDiagnostic(D, !Publish || D.getFilename().empty()
376 : &ReportableDiagnostics[D.getFilename()]);
381 if (!ReportableDiagnostics.empty()) {
382 std::lock_guard<std::mutex> Lock(PublishMu);
383 for (
auto &
Entry : ReportableDiagnostics)
390 void handleDiagnostic(
const llvm::SMDiagnostic &D,
391 std::vector<Diag> *ClientDiagnostics) {
392 switch (D.getKind()) {
393 case llvm::SourceMgr::DK_Error:
394 elog(
"config error at {0}:{1}:{2}: {3}", D.getFilename(), D.getLineNo(),
395 D.getColumnNo(), D.getMessage());
397 case llvm::SourceMgr::DK_Warning:
398 log(
"config warning at {0}:{1}:{2}: {3}", D.getFilename(),
399 D.getLineNo(), D.getColumnNo(), D.getMessage());
401 case llvm::SourceMgr::DK_Note:
402 case llvm::SourceMgr::DK_Remark:
403 vlog(
"config note at {0}:{1}:{2}: {3}", D.getFilename(), D.getLineNo(),
404 D.getColumnNo(), D.getMessage());
405 ClientDiagnostics =
nullptr;
408 if (ClientDiagnostics)
414 return [I(std::make_shared<Impl>(Provider, Publish))](llvm::StringRef
Path) {
420 DraftMgr.removeDraft(
File);
421 WorkScheduler->remove(
File);
428 auto CodeCompleteOpts = Opts;
429 if (!CodeCompleteOpts.Index)
430 CodeCompleteOpts.Index = Index;
432 auto Task = [Pos, CodeCompleteOpts,
File =
File.str(), CB = std::move(CB),
433 this](llvm::Expected<InputsAndPreamble> IP)
mutable {
435 return CB(IP.takeError());
437 return CB(llvm::make_error<CancelledError>(Reason));
439 std::optional<SpeculativeFuzzyFind> SpecFuzzyFind;
443 vlog(
"Build for file {0} is not ready. Enter fallback mode.",
File);
444 }
else if (CodeCompleteOpts.Index) {
445 SpecFuzzyFind.emplace();
447 std::lock_guard<std::mutex> Lock(CachedCompletionFuzzyFindRequestMutex);
448 SpecFuzzyFind->CachedReq = CachedCompletionFuzzyFindRequestByFile[
File];
451 ParseInputs ParseInput{IP->Command, &getHeaderFS(), IP->Contents.str()};
454 if (!IP->Contents.ends_with(
"\n"))
456 ParseInput.
Index = Index;
458 CodeCompleteOpts.MainFileSignals = IP->Signals;
460 CodeCompleteOpts.ArgumentLists =
Config::current().Completion.ArgumentLists;
461 CodeCompleteOpts.InsertIncludes =
463 CodeCompleteOpts.CodePatterns =
Config::current().Completion.CodePatterns;
464 CodeCompleteOpts.MacroFilter =
Config::current().Completion.MacroFilter;
465 adjustParseInputs(ParseInput,
File);
469 File, Pos, IP->Preamble, ParseInput, CodeCompleteOpts,
470 SpecFuzzyFind ? &*SpecFuzzyFind :
nullptr);
476 CB(std::move(Result));
480 if (SpecFuzzyFind->NewReq) {
481 std::lock_guard<std::mutex> Lock(CachedCompletionFuzzyFindRequestMutex);
482 CachedCompletionFuzzyFindRequestByFile[
File] = *SpecFuzzyFind->NewReq;
487 if (SpecFuzzyFind->Result.valid())
488 SpecFuzzyFind->Result.wait();
492 WorkScheduler->runWithPreamble(
493 "CodeComplete",
File,
494 (Opts.RunParser == CodeCompleteOptions::AlwaysParse)
504 auto Action = [Pos,
File =
File.str(), CB = std::move(CB),
506 this](llvm::Expected<InputsAndPreamble> IP)
mutable {
508 return CB(IP.takeError());
512 return CB(
error(
"Failed to parse includes"));
514 ParseInputs ParseInput{IP->Command, &getHeaderFS(), IP->Contents.str()};
517 if (!IP->Contents.ends_with(
"\n"))
519 ParseInput.
Index = Index;
521 DocumentationFormat));
533 return CB(llvm::make_error<LSPError>(
"trying to format non-added document",
535 std::vector<tooling::Range> RequestedRanges;
537 RequestedRanges.reserve(Rngs.size());
538 for (
const auto &Rng : Rngs) {
541 return CB(Begin.takeError());
544 return CB(End.takeError());
545 RequestedRanges.emplace_back(*Begin, *End - *Begin);
548 RequestedRanges = {tooling::Range(0, Code->size())};
552 auto Action = [
File =
File.str(), Code = std::move(*Code),
553 Ranges = std::move(RequestedRanges), CB = std::move(CB),
556 tooling::Replacements IncludeReplaces =
557 format::sortIncludes(Style, Code, Ranges,
File);
558 auto Changed = tooling::applyAllReplacements(Code, IncludeReplaces);
560 return CB(
Changed.takeError());
562 CB(IncludeReplaces.merge(format::reformat(
564 tooling::calculateRangesAfterReplacements(IncludeReplaces, Ranges),
567 WorkScheduler->runQuick(
"Format",
File, std::move(Action));
571 StringRef TriggerText,
572 Callback<std::vector<TextEdit>> CB) {
575 return CB(llvm::make_error<LSPError>(
"trying to format non-added document",
579 return CB(CursorPos.takeError());
580 auto Action = [
File =
File.str(), Code = std::move(*Code),
581 TriggerText = TriggerText.str(), CursorPos = *CursorPos,
582 CB = std::move(CB),
this]()
mutable {
584 std::vector<TextEdit> Result;
585 for (
const tooling::Replacement &R :
590 WorkScheduler->runQuick(
"FormatOnType",
File, std::move(Action));
594 std::optional<std::string> NewName,
597 auto Action = [Pos,
File =
File.str(), CB = std::move(CB),
598 NewName = std::move(NewName),
599 RenameOpts](llvm::Expected<InputsAndAST> InpAST)
mutable {
601 return CB(InpAST.takeError());
605 clangd::rename({Pos, NewName.value_or(
"__clangd_rename_placeholder"),
606 InpAST->AST,
File,
nullptr,
607 nullptr, RenameOpts});
612 return CB(Results.takeError());
616 WorkScheduler->runWithAST(
"PrepareRename",
File, std::move(Action));
622 auto Action = [
File =
File.str(), NewName = NewName.str(), Pos, Opts,
624 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
629 return CB(InpAST.takeError());
631 DirtyFS->view(std::nullopt), Index, Opts});
633 return CB(R.takeError());
637 *InpAST->Inputs.TFS,
false);
638 llvm::Error Err = llvm::Error::success();
639 for (
auto &E : R->GlobalChanges)
641 llvm::joinErrors(
reformatEdit(E.getValue(), Style), std::move(Err));
644 return CB(std::move(Err));
646 RenameFiles.
record(R->GlobalChanges.size());
649 WorkScheduler->runWithAST(
"Rename",
File, std::move(Action));
655llvm::Expected<std::vector<std::unique_ptr<Tweak::Selection>>>
657 llvm::vfs::FileSystem *FS) {
660 return Begin.takeError();
663 return End.takeError();
664 std::vector<std::unique_ptr<Tweak::Selection>> Result;
666 AST.AST.getASTContext(),
AST.AST.getTokens(), *Begin, *End,
668 Result.push_back(std::make_unique<Tweak::Selection>(
669 AST.Inputs.Index, AST.AST, *Begin, *End, std::move(T), FS));
672 assert(!Result.empty() &&
"Expected at least one SelectionTree");
673 return std::move(Result);
679std::optional<ClangdServer::CodeActionResult::Rename>
680tryConvertToRename(
const Diag *Diag,
const Fix &
Fix) {
681 bool IsClangTidyRename = Diag->Source == Diag::ClangTidy &&
682 Diag->Name ==
"readability-identifier-naming" &&
684 if (IsClangTidyRename && Diag->InsideMainFile) {
685 ClangdServer::CodeActionResult::Rename R;
686 R.NewName =
Fix.Edits.front().newText;
687 R.FixMessage =
Fix.Message;
688 R.Diag = {Diag->Range, Diag->Message};
699 auto Action = [Params, CB = std::move(CB),
700 FeatureModules(this->FeatureModules)](
701 Expected<InputsAndAST> InpAST)
mutable {
703 return CB(InpAST.takeError());
708 return llvm::any_of(Only, [&](llvm::StringRef Base) {
709 return Kind.consume_front(Base) &&
710 (Kind.empty() || Kind.starts_with(
"."));
715 Result.
Version = InpAST->AST.version().str();
717 auto FindMatchedDiag = [&InpAST](
const DiagRef &DR) ->
const Diag * {
718 for (
const auto &
Diag : InpAST->AST.getDiagnostics())
726 if (
auto Rename = tryConvertToRename(
Diag,
Fix)) {
727 Result.
Renames.emplace_back(std::move(*Rename));
736 auto Selections = tweakSelection(Params.
Selection, *InpAST,
nullptr);
738 return CB(Selections.takeError());
740 llvm::DenseSet<llvm::StringRef> PreparedTweaks;
741 auto DeduplicatingFilter = [&](
const Tweak &T) {
742 return KindAllowed(T.kind()) && Params.
TweakFilter(T) &&
743 !PreparedTweaks.count(T.id());
745 for (
const auto &Sel : *Selections) {
746 for (
auto &T :
prepareTweaks(*Sel, DeduplicatingFilter, FeatureModules)) {
748 PreparedTweaks.insert(T->id());
749 TweakAvailable.record(1, T->id());
752 CB(std::move(Result));
755 WorkScheduler->runWithAST(
"codeAction", Params.
File, std::move(Action),
767 TweakAttempt.
record(1, TweakID);
768 auto Action = [
File =
File.str(), Sel, TweakID = TweakID.str(),
770 this](Expected<InputsAndAST> InpAST)
mutable {
772 return CB(InpAST.takeError());
773 auto FS = DirtyFS->view(std::nullopt);
774 auto Selections = tweakSelection(Sel, *InpAST, FS.get());
776 return CB(Selections.takeError());
777 std::optional<llvm::Expected<Tweak::Effect>> Effect;
780 for (
const auto &Selection : *Selections) {
781 auto T =
prepareTweak(TweakID, *Selection, FeatureModules);
783 Effect = (*T)->apply(*Selection);
786 Effect = T.takeError();
788 assert(Effect &&
"Expected at least one selection");
789 if (*Effect && (*Effect)->FormatEdits) {
791 for (
auto &It : (*Effect)->ApplyEdits) {
793 format::FormatStyle Style =
796 elog(
"Failed to format {0}: {1}", It.first(), std::move(Err));
799 TweakFailed.
record(1, TweakID);
801 return CB(std::move(*Effect));
803 WorkScheduler->runWithAST(
"ApplyTweak",
File, std::move(Action));
807 Callback<std::vector<LocatedSymbol>> CB) {
808 auto Action = [Pos, CB = std::move(CB),
809 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
811 return CB(InpAST.takeError());
815 WorkScheduler->runWithAST(
"Definitions",
File, std::move(Action));
826 if (
auto CorrespondingFile =
828 return CB(std::move(CorrespondingFile));
829 auto Action = [
Path =
Path.str(), CB = std::move(CB),
830 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
832 return CB(InpAST.takeError());
835 WorkScheduler->runWithAST(
"SwitchHeaderSource",
Path, std::move(Action));
841 [Pos, CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST)
mutable {
843 return CB(InpAST.takeError());
847 WorkScheduler->runWithAST(
"Highlights",
File, std::move(Action), Transient);
851 Callback<std::optional<HoverInfo>> CB) {
852 auto Action = [
File =
File.str(), Pos, CB = std::move(CB),
853 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
855 return CB(InpAST.takeError());
857 File, InpAST->Inputs.Contents, *InpAST->Inputs.TFS,
false);
861 WorkScheduler->runWithAST(
"Hover",
File, std::move(Action), Transient);
866 Callback<std::vector<TypeHierarchyItem>> CB) {
867 auto Action = [
File =
File.str(), Pos, Resolve, Direction, CB = std::move(CB),
868 this](Expected<InputsAndAST> InpAST)
mutable {
870 return CB(InpAST.takeError());
875 WorkScheduler->runWithAST(
"TypeHierarchy",
File, std::move(Action));
880 Callback<std::optional<std::vector<TypeHierarchyItem>>> CB) {
881 WorkScheduler->run(
"typeHierarchy/superTypes",
"",
882 [=, CB = std::move(CB)]()
mutable {
888 Callback<std::vector<TypeHierarchyItem>> CB) {
890 "typeHierarchy/subTypes",
"",
896 Callback<std::optional<TypeHierarchyItem>> CB) {
898 "Resolve Type Hierarchy",
"", [=, CB = std::move(CB)]()
mutable {
906 auto Action = [
File =
File.str(), Pos,
907 CB = std::move(CB)](Expected<InputsAndAST> InpAST)
mutable {
909 return CB(InpAST.takeError());
912 WorkScheduler->runWithAST(
"CallHierarchy",
File, std::move(Action));
917 Callback<std::vector<CallHierarchyIncomingCall>> CB) {
918 WorkScheduler->run(
"Incoming Calls",
"",
919 [CB = std::move(CB), Item,
this]()
mutable {
925 Callback<std::vector<InlayHint>> CB) {
926 auto Action = [RestrictRange(std::move(RestrictRange)),
927 CB = std::move(CB)](Expected<InputsAndAST> InpAST)
mutable {
929 return CB(InpAST.takeError());
932 WorkScheduler->runWithAST(
"InlayHints",
File, std::move(Action), Transient);
937 Callback<std::vector<CallHierarchyOutgoingCall>> CB) {
938 WorkScheduler->run(
"Outgoing Calls",
"",
939 [CB = std::move(CB), Item,
this]()
mutable {
950 llvm::StringRef Query,
int Limit,
951 Callback<std::vector<SymbolInformation>> CB) {
953 "getWorkspaceSymbols",
"",
954 [Query = Query.str(), Limit, CB = std::move(CB),
this]()
mutable {
955 CB(clangd::getWorkspaceSymbols(Query, Limit, Index,
956 WorkspaceRoot.value_or(
"")));
961 Callback<std::vector<DocumentSymbol>> CB) {
963 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST)
mutable {
965 return CB(InpAST.takeError());
968 WorkScheduler->runWithAST(
"DocumentSymbols",
File, std::move(Action),
973 Callback<std::vector<FoldingRange>> CB) {
976 return CB(llvm::make_error<LSPError>(
977 "trying to compute folding ranges for non-added document",
979 auto Action = [LineFoldingOnly = LineFoldingOnly, CB = std::move(CB),
980 Code = std::move(*Code)]()
mutable {
985 WorkScheduler->runQuick(
"FoldingRanges",
File, std::move(Action));
989 Callback<std::vector<LocatedSymbol>> CB) {
990 auto Action = [Pos, CB = std::move(CB),
991 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
993 return CB(InpAST.takeError());
996 WorkScheduler->runWithAST(
"FindType",
File, std::move(Action));
1001 auto Action = [Pos, CB = std::move(CB),
1002 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
1004 return CB(InpAST.takeError());
1008 WorkScheduler->runWithAST(
"Implementations",
File, std::move(Action));
1014 auto Action = [Pos, Limit, AddContainer, CB = std::move(CB),
1015 this](llvm::Expected<InputsAndAST> InpAST)
mutable {
1017 return CB(InpAST.takeError());
1021 WorkScheduler->runWithAST(
"References",
File, std::move(Action));
1025 Callback<std::vector<SymbolDetails>> CB) {
1027 [Pos, CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST)
mutable {
1029 return CB(InpAST.takeError());
1033 WorkScheduler->runWithAST(
"SymbolInfo",
File, std::move(Action));
1037 const std::vector<Position> &Positions,
1038 Callback<std::vector<SelectionRange>> CB) {
1039 auto Action = [Positions, CB = std::move(CB)](
1040 llvm::Expected<InputsAndAST> InpAST)
mutable {
1042 return CB(InpAST.takeError());
1043 std::vector<SelectionRange> Result;
1044 for (
const auto &Pos : Positions) {
1046 Result.push_back(std::move(*
Range));
1048 return CB(
Range.takeError());
1050 CB(std::move(Result));
1052 WorkScheduler->runWithAST(
"SemanticRanges",
File, std::move(Action));
1056 Callback<std::vector<DocumentLink>> CB) {
1058 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST)
mutable {
1060 return CB(InpAST.takeError());
1063 WorkScheduler->runWithAST(
"DocumentLinks",
File, std::move(Action),
1070 auto Action = [CB = std::move(CB),
1071 PublishInactiveRegions = PublishInactiveRegions](
1072 llvm::Expected<InputsAndAST> InpAST)
mutable {
1074 return CB(InpAST.takeError());
1080 WorkScheduler->runWithAST(
"SemanticHighlights",
File, std::move(Action),
1085 Callback<std::optional<ASTNode>> CB) {
1087 [R, CB(std::move(CB))](llvm::Expected<InputsAndAST> Inputs)
mutable {
1089 return CB(Inputs.takeError());
1093 auto Node = DynTypedNode::create(
1094 *Inputs->AST.getASTContext().getTranslationUnitDecl());
1095 return CB(
dumpAST(Node, Inputs->AST.getTokens(),
1096 Inputs->AST.getASTContext()));
1098 unsigned Start, End;
1102 return CB(Offset.takeError());
1106 return CB(Offset.takeError());
1108 Inputs->AST.getASTContext(), Inputs->AST.getTokens(), Start, End,
1110 if (const SelectionTree::Node *N = T.commonAncestor()) {
1111 CB(dumpAST(N->ASTNode, Inputs->AST.getTokens(),
1112 Inputs->AST.getASTContext()));
1120 WorkScheduler->runWithAST(
"GetAST",
File, std::move(Action));
1125 WorkScheduler->runWithAST(Name,
File, std::move(Action));
1130 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST)
mutable {
1132 return CB(InpAST.takeError());
1133 return CB(InpAST->AST.getDiagnostics());
1136 WorkScheduler->runWithAST(
"Diagnostics",
File, std::move(Action));
1140 return WorkScheduler->fileStats();
1148#if defined(__has_feature) && \
1149 (__has_feature(address_sanitizer) || __has_feature(hwaddress_sanitizer) || \
1150 __has_feature(memory_sanitizer) || __has_feature(thread_sanitizer))
1151 if (TimeoutSeconds.has_value())
1152 (*TimeoutSeconds) *= 10;
1157 if (!WorkScheduler->blockUntilIdle(
timeoutSeconds(TimeoutSeconds)))
1160 if (IndexTasks && !IndexTasks->wait(
timeoutSeconds(TimeoutSeconds)))
1172 for (std::optional<double> Timeout :
1173 {TimeoutSeconds, TimeoutSeconds, std::optional<double>(0)}) {
1176 if (BackgroundIdx && !BackgroundIdx->blockUntilIdleForTest(Timeout))
1178 if (FeatureModules && llvm::any_of(*FeatureModules, [&](
FeatureModule &M) {
1185 "Something scheduled work while we're blocking the main thread!");
1191 DynamicIdx->profile(MT.
child(
"dynamic_index"));
1193 BackgroundIdx->profile(MT.
child(
"background_index"));
1194 WorkScheduler->profile(MT.
child(
"tuscheduler"));
1202 auto HasRequiredModules = [
this,
File]() {
1203 if (!ModulesManager)
1211 return ModulesManager->hasRequiredModules(
File);
static cl::opt< bool > Fix("fix", desc(R"(
Apply suggested fixes. Without -fix-errors
clang-tidy will bail out if any compilation
errors were found.
)"), cl::init(false), cl::cat(ClangTidyCategory))
void elog(const char *Fmt, Ts &&... Vals)
static Factory createDiskBackedStorageFactory(std::function< std::optional< ProjectInfo >(PathRef)> GetProjectInfo)
Interface with hooks for users of ClangdServer to be notified of events.
virtual void onDiagnosticsReady(PathRef File, llvm::StringRef Version, llvm::ArrayRef< Diag > Diagnostics)
Called by ClangdServer when Diagnostics for File are ready.
llvm::StringMap< TUScheduler::FileStats > fileStats() const
Returns estimated memory usage and other statistics for each of the currently open files.
ClangdServer(const GlobalCompilationDatabase &CDB, const ThreadsafeFS &TFS, const Options &Opts, Callbacks *Callbacks=nullptr)
Creates a new ClangdServer instance.
void prepareRename(PathRef File, Position Pos, std::optional< std::string > NewName, const RenameOptions &RenameOpts, Callback< RenameResult > CB)
Test the validity of a rename operation.
void prepareCallHierarchy(PathRef File, Position Pos, Callback< std::vector< CallHierarchyItem > > CB)
Get information about call hierarchy for a given position.
void resolveTypeHierarchy(TypeHierarchyItem Item, int Resolve, TypeHierarchyDirection Direction, Callback< std::optional< TypeHierarchyItem > > CB)
Resolve type hierarchy item in the given direction.
void documentSymbols(StringRef File, Callback< std::vector< DocumentSymbol > > CB)
Retrieve the symbols within the specified file.
void workspaceSymbols(StringRef Query, int Limit, Callback< std::vector< SymbolInformation > > CB)
Retrieve the top symbols from the workspace matching a query.
void diagnostics(PathRef File, Callback< std::vector< Diag > > CB)
Fetches diagnostics for current version of the File.
void typeHierarchy(PathRef File, Position Pos, int Resolve, TypeHierarchyDirection Direction, Callback< std::vector< TypeHierarchyItem > > CB)
Get information about type hierarchy for a given position.
void removeDocument(PathRef File)
Remove File from list of tracked files, schedule a request to free resources associated with it.
void outgoingCalls(const CallHierarchyItem &Item, Callback< std::vector< CallHierarchyOutgoingCall > >)
Resolve outgoing calls for a given call hierarchy item.
void addDocument(PathRef File, StringRef Contents, llvm::StringRef Version="null", WantDiagnostics WD=WantDiagnostics::Auto, bool ForceRebuild=false)
Add a File to the list of tracked C++ files or update the contents if File is already tracked.
void findDocumentHighlights(PathRef File, Position Pos, Callback< std::vector< DocumentHighlight > > CB)
Get document highlights for a given position.
static std::function< Context(PathRef)> createConfiguredContextProvider(const config::Provider *Provider, ClangdServer::Callbacks *)
Creates a context provider that loads and installs config.
void signatureHelp(PathRef File, Position Pos, MarkupKind DocumentationFormat, Callback< SignatureHelp > CB)
Provide signature help for File at Pos.
void findReferences(PathRef File, Position Pos, uint32_t Limit, bool AddContainer, Callback< ReferencesResult > CB)
Retrieve locations for symbol references.
void switchSourceHeader(PathRef Path, Callback< std::optional< clangd::Path > > CB)
Switch to a corresponding source file when given a header file, and vice versa.
void findType(PathRef File, Position Pos, Callback< std::vector< LocatedSymbol > > CB)
Retrieve symbols for types referenced at Pos.
void findImplementations(PathRef File, Position Pos, Callback< std::vector< LocatedSymbol > > CB)
Retrieve implementations for virtual method.
static Options optsForTest()
void subTypes(const TypeHierarchyItem &Item, Callback< std::vector< TypeHierarchyItem > > CB)
Get direct children of a type hierarchy item.
void semanticRanges(PathRef File, const std::vector< Position > &Pos, Callback< std::vector< SelectionRange > > CB)
Get semantic ranges around a specified position in a file.
void formatFile(PathRef File, const std::vector< Range > &Rngs, Callback< tooling::Replacements > CB)
Run formatting for the File with content Code.
void applyTweak(PathRef File, Range Sel, StringRef ID, Callback< Tweak::Effect > CB)
Apply the code tweak with a specified ID.
void semanticHighlights(PathRef File, Callback< std::vector< HighlightingToken > >)
void getAST(PathRef File, std::optional< Range > R, Callback< std::optional< ASTNode > > CB)
Describe the AST subtree for a piece of code.
void symbolInfo(PathRef File, Position Pos, Callback< std::vector< SymbolDetails > > CB)
Get symbol info for given position.
void onFileEvent(const DidChangeWatchedFilesParams &Params)
Called when an event occurs for a watched file in the workspace.
void superTypes(const TypeHierarchyItem &Item, Callback< std::optional< std::vector< TypeHierarchyItem > > > CB)
Get direct parents of a type hierarchy item.
void profile(MemoryTree &MT) const
Builds a nested representation of memory used by components.
void findHover(PathRef File, Position Pos, Callback< std::optional< HoverInfo > > CB)
Get code hover for a given position.
void formatOnType(PathRef File, Position Pos, StringRef TriggerText, Callback< std::vector< TextEdit > > CB)
Run formatting after TriggerText was typed at Pos in File with content Code.
void rename(PathRef File, Position Pos, llvm::StringRef NewName, const RenameOptions &Opts, Callback< RenameResult > CB)
Rename all occurrences of the symbol at the Pos in File to NewName.
void customAction(PathRef File, llvm::StringRef Name, Callback< InputsAndAST > Action)
Runs an arbitrary action that has access to the AST of the specified file.
void codeAction(const CodeActionInputs &Inputs, Callback< CodeActionResult > CB)
Surface code actions (quick-fixes for diagnostics, or available code tweaks) for a given range in a f...
void locateSymbolAt(PathRef File, Position Pos, Callback< std::vector< LocatedSymbol > > CB)
Find declaration/definition locations of symbol at a specified position.
void incomingCalls(const CallHierarchyItem &Item, Callback< std::vector< CallHierarchyIncomingCall > >)
Resolve incoming calls for a given call hierarchy item.
bool blockUntilIdleForTest(std::optional< double > TimeoutSeconds=10)
void inlayHints(PathRef File, std::optional< Range > RestrictRange, Callback< std::vector< InlayHint > >)
Resolve inlay hints for a given document.
void codeComplete(PathRef File, Position Pos, const clangd::CodeCompleteOptions &Opts, Callback< CodeCompleteResult > CB)
Run code completion for File at Pos.
void reparseOpenFilesIfNeeded(llvm::function_ref< bool(llvm::StringRef File)> Filter)
Requests a reparse of currently opened files using their latest source.
void foldingRanges(StringRef File, Callback< std::vector< FoldingRange > > CB)
Retrieve ranges that can be used to fold code within the specified file.
void documentLinks(PathRef File, Callback< std::vector< DocumentLink > > CB)
Get all document links in a file.
std::shared_ptr< const std::string > getDraft(PathRef File) const
Gets the contents of a currently tracked file.
A context is an immutable container for per-request data that must be propagated through layers that ...
static const Context & current()
Returns the context for the current thread, creating it if needed.
static Deadline infinity()
A FeatureModule contributes a vertical feature to clangd.
virtual bool blockUntilIdle(Deadline)
Waits until the module is idle (no background work) or a deadline expires.
This manages symbols from files and an in-memory index on all symbols.
Provides compilation arguments used for parsing C and C++ files.
static bool createEach(ASTContext &AST, const syntax::TokenBuffer &Tokens, unsigned Begin, unsigned End, llvm::function_ref< bool(SelectionTree)> Func)
Interface for symbol indexes that can be used for searching or matching symbols among a set of symbol...
Handles running tasks for ClangdServer and managing the resources (e.g., preambles and ASTs) for open...
@ StaleOrAbsent
Besides accepting stale preamble, this also allow preamble to be absent (not ready or failed to build...
@ Stale
The preamble may be generated from an older version of the file.
Wrapper for vfs::FileSystem for use in multithreaded programs like clangd.
An interface base for small context-sensitive refactoring actions.
WithContext replaces Context::current() with a provided scope.
A source of configuration fragments.
Config getConfig(const Params &, DiagnosticCallback) const
Build a config based on this provider.
Records an event whose duration is the lifetime of the Span object.
FIXME: Skip testing on windows temporarily due to the different escaping code mode.
@ Changed
The file got changed.
std::vector< TypeHierarchyItem > subTypes(const TypeHierarchyItem &Item, const SymbolIndex *Index)
Returns direct children of a TypeHierarchyItem.
std::optional< std::vector< TypeHierarchyItem > > superTypes(const TypeHierarchyItem &Item, const SymbolIndex *Index)
Returns direct parents of a TypeHierarchyItem using SymbolIDs stored inside the item.
std::vector< CallHierarchyIncomingCall > incomingCalls(const CallHierarchyItem &Item, const SymbolIndex *Index)
std::vector< HighlightingToken > getSemanticHighlightings(ParsedAST &AST, bool IncludeInactiveRegionTokens)
llvm::Expected< std::unique_ptr< Tweak > > prepareTweak(StringRef ID, const Tweak::Selection &S, const FeatureModuleSet *Modules)
ASTNode dumpAST(const DynTypedNode &N, const syntax::TokenBuffer &Tokens, const ASTContext &Ctx)
std::vector< DocumentHighlight > findDocumentHighlights(ParsedAST &AST, Position Pos)
Returns highlights for all usages of a symbol at Pos.
std::vector< DocumentLink > getDocumentLinks(ParsedAST &AST)
Get all document links.
std::vector< SymbolDetails > getSymbolInfo(ParsedAST &AST, Position Pos)
Get info about symbols at Pos.
void vlog(const char *Fmt, Ts &&... Vals)
llvm::Error reformatEdit(Edit &E, const format::FormatStyle &Style)
Formats the edits and code around it according to Style.
std::vector< LocatedSymbol > findType(ParsedAST &AST, Position Pos, const SymbolIndex *Index)
Returns symbols for types referenced at Pos.
llvm::unique_function< void(llvm::Expected< T >)> Callback
A Callback<T> is a void function that accepts Expected<T>.
llvm::Expected< std::vector< FoldingRange > > getFoldingRanges(const std::string &Code, bool LineFoldingOnly)
Returns a list of ranges whose contents might be collapsible in an editor.
llvm::Expected< RenameResult > rename(const RenameInputs &RInputs)
Renames all occurrences of the symbol.
std::vector< TypeHierarchyItem > getTypeHierarchy(ParsedAST &AST, Position Pos, int ResolveLevels, TypeHierarchyDirection Direction, const SymbolIndex *Index, PathRef TUPath)
Get type hierarchy information at Pos.
llvm::Error error(std::error_code EC, const char *Fmt, Ts &&... Vals)
ReferencesResult findReferences(ParsedAST &AST, Position Pos, uint32_t Limit, const SymbolIndex *Index, bool AddContext)
Returns references of the symbol at a specified Pos.
std::optional< HoverInfo > getHover(ParsedAST &AST, Position Pos, const format::FormatStyle &Style, const SymbolIndex *Index)
Get the hover information when hovering at Pos.
std::vector< tooling::Replacement > formatIncremental(llvm::StringRef OriginalCode, unsigned OriginalCursor, llvm::StringRef InsertedText, format::FormatStyle Style)
Applies limited formatting around new InsertedText.
std::vector< LocatedSymbol > locateSymbolAt(ParsedAST &AST, Position Pos, const SymbolIndex *Index)
Get definition of symbol at a specified Pos.
llvm::Expected< SelectionRange > getSemanticRanges(ParsedAST &AST, Position Pos)
Returns the list of all interesting ranges around the Position Pos.
void log(const char *Fmt, Ts &&... Vals)
llvm::Expected< size_t > positionToOffset(llvm::StringRef Code, Position P, bool AllowColumnsBeyondLineLength)
Turn a [line, column] pair into an offset in Code.
llvm::Expected< std::vector< DocumentSymbol > > getDocumentSymbols(ParsedAST &AST)
Retrieves the symbols contained in the "main file" section of an AST in the same order that they appe...
std::optional< Path > getCorrespondingHeaderOrSource(PathRef OriginalFile, llvm::IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS)
Given a header file, returns the best matching source file, and vice visa.
llvm::StringRef PathRef
A typedef to represent a ref to file path.
Diag toDiag(const llvm::SMDiagnostic &D, Diag::DiagSource Source)
std::vector< std::unique_ptr< Tweak > > prepareTweaks(const Tweak::Selection &S, llvm::function_ref< bool(const Tweak &)> Filter, const FeatureModuleSet *Modules)
Calls prepare() on all tweaks that satisfy the filter, returning those that can run on the selection.
WantDiagnostics
Determines whether diagnostics should be generated for a file snapshot.
@ Auto
Diagnostics must not be generated for this snapshot.
std::vector< LocatedSymbol > findImplementations(ParsedAST &AST, Position Pos, const SymbolIndex *Index)
Returns implementations at a specified Pos:
std::string Path
A typedef to represent a file path.
int isCancelled(const Context &Ctx)
If the current context is within a cancelled task, returns the reason.
void resolveTypeHierarchy(TypeHierarchyItem &Item, int ResolveLevels, TypeHierarchyDirection Direction, const SymbolIndex *Index)
std::vector< Range > getInactiveRegions(ParsedAST &AST)
Deadline timeoutSeconds(std::optional< double > Seconds)
Makes a deadline from a timeout in seconds. std::nullopt means wait forever.
CodeCompleteResult codeComplete(PathRef FileName, Position Pos, const PreambleData *Preamble, const ParseInputs &ParseInput, CodeCompleteOptions Opts, SpeculativeFuzzyFind *SpecFuzzyFind)
Gets code completions at a specified Pos in FileName.
std::vector< CallHierarchyOutgoingCall > outgoingCalls(const CallHierarchyItem &Item, const SymbolIndex *Index)
SignatureHelp signatureHelp(PathRef FileName, Position Pos, const PreambleData &Preamble, const ParseInputs &ParseInput, MarkupKind DocumentationFormat)
Get signature help at a specified Pos in FileName.
std::vector< InlayHint > inlayHints(ParsedAST &AST, std::optional< Range > RestrictRange, InlayHintOptions HintOptions)
Compute and return inlay hints for a file.
TextEdit replacementToEdit(llvm::StringRef Code, const tooling::Replacement &R)
SymbolSlab indexStandardLibrary(llvm::StringRef HeaderSources, std::unique_ptr< CompilerInvocation > CI, const StdLibLocation &Loc, const ThreadsafeFS &TFS)
std::vector< CallHierarchyItem > prepareCallHierarchy(ParsedAST &AST, Position Pos, PathRef TUPath)
Get call hierarchy information at Pos.
format::FormatStyle getFormatStyleForFile(llvm::StringRef File, llvm::StringRef Content, const ThreadsafeFS &TFS, bool FormatFile)
Choose the clang-format style we should apply to a certain file.
===– Representation.cpp - ClangDoc Representation --------—*- C++ -*-===//
Represents programming constructs like functions or constructors in the context of call hierarchy.
std::vector< TweakRef > TweakRefs
std::vector< Rename > Renames
std::vector< QuickFix > QuickFixes
std::function< Context(PathRef)> ContextProvider
If set, queried to derive a processing context for some work.
clangd::PreambleThrottler * PreambleThrottler
This throttler controls which preambles may be built at a given time.
bool StorePreamblesInMemory
Cached preambles are potentially large. If false, store them on disk.
ASTRetentionPolicy RetentionPolicy
AST caching policy. The default is to keep up to 3 ASTs in memory.
unsigned AsyncThreadsCount
To process requests asynchronously, ClangdServer spawns worker threads.
DebouncePolicy UpdateDebounce
Time to wait after a new file version before computing diagnostics.
static const llvm::StringLiteral QUICKFIX_KIND
Settings that express user/project preferences and control clangd behavior.
static clangd::Key< Config > Key
Context key which can be used to set the current Config.
static const Config & current()
Returns the Config of the current Context, or an empty configuration.
static DebouncePolicy fixed(clock::duration)
A policy that always returns the same duration, useful for tests.
A top-level diagnostic that may have Notes and Fixes.
std::vector< Fix > Fixes
Alternative fixes for this diagnostic, one should be chosen.
A set of edits generated for a single file.
Represents a single fix-it that editor can apply to fix the error.
A tree that can be used to represent memory usage of nested components while preserving the hierarchy...
MemoryTree & child(llvm::StringLiteral Name)
No copy of the Name.
bool PreambleParseForwardingFunctions
The parsed preamble and associated data.
PrecompiledPreamble Preamble
Position start
The range's start position.
Position end
The range's end position.
bool WantFormat
If true, format the rename edits, only meaningful in ClangdServer layer.
ASTRetentionPolicy RetentionPolicy
Determines when to keep idle ASTs in memory for future use.
DebouncePolicy UpdateDebounce
Time to wait after an update to see if another one comes along.
std::function< Context(PathRef)> ContextProvider
Used to create a context that wraps each single operation.
bool StorePreamblesInMemory
Cache (large) preamble data in RAM rather than temporary files on disk.
unsigned AsyncThreadsCount
Number of concurrent actions.
clangd::PreambleThrottler * PreambleThrottler
This throttler controls which preambles may be built at a given time.
Describes the context used to evaluate configuration fragments.
std::chrono::steady_clock::time_point FreshTime
Hint that stale data is OK to improve performance (e.g.
llvm::StringRef Path
Absolute path to a source file we're applying the config to.
Represents measurements of clangd events, e.g.
@ Counter
An aggregate number whose rate of change over time is meaningful.
@ Distribution
A distribution of values with a meaningful mean and count.
void record(double Value, llvm::StringRef Label="") const
Records a measurement for this metric to active tracer.