clang-tools 23.0.0git
ClangdServer.cpp
Go to the documentation of this file.
1//===--- ClangdServer.cpp - Main clangd server code --------------*- C++-*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===-------------------------------------------------------------------===//
8
9#include "ClangdServer.h"
10#include "CodeComplete.h"
11#include "Config.h"
12#include "Diagnostics.h"
13#include "DumpAST.h"
14#include "FindSymbols.h"
15#include "Format.h"
16#include "HeaderSourceSwitch.h"
17#include "InlayHints.h"
18#include "ParsedAST.h"
19#include "Preamble.h"
20#include "Protocol.h"
22#include "SemanticSelection.h"
23#include "SourceCode.h"
24#include "TUScheduler.h"
25#include "XRefs.h"
26#include "clang-include-cleaner/Record.h"
27#include "index/FileIndex.h"
28#include "index/Merge.h"
29#include "index/StdLib.h"
30#include "refactor/Rename.h"
31#include "refactor/Tweak.h"
33#include "support/Context.h"
34#include "support/Logger.h"
35#include "support/MemoryTree.h"
37#include "support/Trace.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"
49#include <algorithm>
50#include <chrono>
51#include <future>
52#include <memory>
53#include <mutex>
54#include <optional>
55#include <string>
56#include <type_traits>
57#include <utility>
58#include <vector>
59
60namespace clang {
61namespace clangd {
62namespace {
63
64// Tracks number of times a tweak has been offered.
65static constexpr trace::Metric TweakAvailable(
66 "tweak_available", trace::Metric::Counter, "tweak_id");
67
68// Update the FileIndex with new ASTs and plumb the diagnostics responses.
69struct UpdateIndexCallbacks : public ParsingCallbacks {
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) {}
77
78 void onPreambleAST(
79 PathRef Path, llvm::StringRef Version, CapturedASTCtx ASTCtx,
80 std::shared_ptr<const include_cleaner::PragmaIncludes> PI) override {
81
82 if (!FIndex)
83 return;
84
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));
89
90 // FIndex outlives the UpdateIndexCallbacks.
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);
96 };
97
98 if (Tasks) {
99 Tasks->runAsync("Preamble indexing for:" + Path + Version,
100 std::move(Task));
101 } else
102 Task();
103 }
104
105 void indexStdlib(const CompilerInvocation &CI, StdLibLocation Loc) {
106 // This task is owned by Tasks, which outlives the TUScheduler and
107 // therefore the UpdateIndexCallbacks.
108 // We must be careful that the references we capture outlive TUScheduler.
109 auto Task = [LO(CI.getLangOpts()), Loc(std::move(Loc)),
110 CI(std::make_unique<CompilerInvocation>(CI)),
111 // External values that outlive ClangdServer
112 TFS(&TFS),
113 // Index outlives TUScheduler (declared first)
114 FIndex(FIndex),
115 // shared_ptr extends lifetime
116 Stdlib(Stdlib),
117 // We have some FS implementations that rely on information in
118 // the context.
119 Ctx(Context::current().clone())]() mutable {
120 // Make sure we install the context into current thread.
121 WithContext C(std::move(Ctx));
122 clang::noteBottomOfStack();
123 IndexFileIn IF;
124 IF.Symbols = indexStandardLibrary(std::move(CI), Loc, *TFS);
125 if (Stdlib->isBest(LO))
126 FIndex->updatePreamble(std::move(IF));
127 };
128 if (Tasks)
129 // This doesn't have a semaphore to enforce -j, but it's rare.
130 Tasks->runAsync("IndexStdlib", std::move(Task));
131 else
132 Task();
133 }
134
135 void onMainAST(PathRef Path, ParsedAST &AST, PublishFn Publish) override {
136 if (FIndex)
137 FIndex->updateMain(Path, AST);
138
139 if (ServerCallbacks)
140 Publish([&]() {
141 ServerCallbacks->onDiagnosticsReady(Path, AST.version(),
142 AST.getDiagnostics());
143 if (CollectInactiveRegions) {
144 ServerCallbacks->onInactiveRegionsReady(Path,
146 }
147 });
148 }
149
150 void onFailedAST(PathRef Path, llvm::StringRef Version,
151 std::vector<Diag> Diags, PublishFn Publish) override {
152 if (ServerCallbacks)
153 Publish(
154 [&]() { ServerCallbacks->onDiagnosticsReady(Path, Version, Diags); });
155 }
156
157 void onFileUpdated(PathRef File, const TUStatus &Status) override {
158 if (ServerCallbacks)
159 ServerCallbacks->onFileUpdated(File, Status);
160 }
161
162 void onPreamblePublished(PathRef File) override {
163 if (ServerCallbacks)
164 ServerCallbacks->onSemanticsMaybeChanged(File);
165 }
166
167private:
168 FileIndex *FIndex;
169 ClangdServer::Callbacks *ServerCallbacks;
170 const ThreadsafeFS &TFS;
171 std::shared_ptr<StdLibSet> Stdlib;
172 AsyncTaskRunner *Tasks;
173 bool CollectInactiveRegions;
174};
175
176class DraftStoreFS : public ThreadsafeFS {
177public:
178 DraftStoreFS(const ThreadsafeFS &Base, const DraftStore &Drafts)
179 : Base(Base), DirtyFiles(Drafts) {}
180
181private:
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());
186 return OFS;
187 }
188
189 const ThreadsafeFS &Base;
190 const DraftStore &DirtyFiles;
191};
192
193} // namespace
194
197 Opts.UpdateDebounce = DebouncePolicy::fixed(/*zero*/ {});
198 Opts.StorePreamblesInMemory = true;
199 Opts.AsyncThreadsCount = 4; // Consistent!
200 return Opts;
201}
202
213
215 const ThreadsafeFS &TFS, const Options &Opts,
217 : FeatureModules(Opts.FeatureModules), CDB(CDB), TFS(TFS),
218 DynamicIdx(Opts.BuildDynamicSymbolIndex
219 ? new FileIndex(Opts.EnableOutgoingCalls)
220 : nullptr),
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
231 : TUScheduler::NoInvalidation),
232 DirtyFS(std::make_unique<DraftStoreFS>(TFS, DraftMgr)) {
233 if (Opts.AsyncThreadsCount != 0)
234 IndexTasks.emplace();
235 // Pass a callback into `WorkScheduler` to extract symbols from a newly
236 // parsed file and rebuild the file index synchronously each time an AST
237 // is parsed.
238 WorkScheduler.emplace(CDB, TUScheduler::Options(Opts),
239 std::make_unique<UpdateIndexCallbacks>(
240 DynamicIdx.get(), Callbacks, TFS,
241 IndexTasks ? &*IndexTasks : nullptr,
242 PublishInactiveRegions));
243 // Adds an index to the stack, at higher priority than existing indexes.
244 auto AddIndex = [&](SymbolIndex *Idx) {
245 if (this->Index != nullptr) {
246 MergedIdx.push_back(std::make_unique<MergedIndex>(Idx, this->Index));
247 this->Index = MergedIdx.back().get();
248 } else {
249 this->Index = Idx;
250 }
251 };
252 if (Opts.StaticIndex)
253 AddIndex(Opts.StaticIndex);
254 if (Opts.BackgroundIndex) {
255 BackgroundIndex::Options BGOpts;
256 BGOpts.ThreadPoolSize = std::max(Opts.AsyncThreadsCount, 1u);
257 BGOpts.OnProgress = [Callbacks](BackgroundQueue::Stats S) {
258 if (Callbacks)
259 Callbacks->onBackgroundIndexProgress(S);
260 };
261 BGOpts.ContextProvider = Opts.ContextProvider;
262 BGOpts.SupportContainedRefs = Opts.EnableOutgoingCalls;
263 BackgroundIdx = std::make_unique<BackgroundIndex>(
264 TFS, CDB,
266 [&CDB](llvm::StringRef File) { return CDB.getProjectInfo(File); }),
267 std::move(BGOpts));
268 AddIndex(BackgroundIdx.get());
269 }
270 if (DynamicIdx)
271 AddIndex(DynamicIdx.get());
272
273 if (Opts.FeatureModules) {
274 FeatureModule::Facilities F{
275 *this->WorkScheduler,
276 this->Index,
277 this->TFS,
278 };
279 for (auto &Mod : *Opts.FeatureModules)
280 Mod.initialize(F);
281 }
282}
283
285 // Destroying TUScheduler first shuts down request threads that might
286 // otherwise access members concurrently.
287 // (Nobody can be using TUScheduler because we're on the main thread).
288 WorkScheduler.reset();
289 // Now requests have stopped, we can shut down feature modules.
290 if (FeatureModules) {
291 for (auto &Mod : *FeatureModules)
292 Mod.stop();
293 for (auto &Mod : *FeatureModules)
294 Mod.blockUntilIdle(Deadline::infinity());
295 }
296}
297
298void ClangdServer::addDocument(PathRef File, llvm::StringRef Contents,
299 llvm::StringRef Version,
300 WantDiagnostics WantDiags, bool ForceRebuild) {
301 std::string ActualVersion = DraftMgr.addDraft(File, Version, Contents);
302 ParseOptions Opts;
303 Opts.PreambleParseForwardingFunctions = PreambleParseForwardingFunctions;
304 Opts.ImportInsertions = ImportInsertions;
305
306 // Compile command is set asynchronously during update, as it can be slow.
307 ParseInputs Inputs;
308 Inputs.TFS = &getHeaderFS();
309 Inputs.Contents = std::string(Contents);
310 Inputs.Version = std::move(ActualVersion);
311 Inputs.ForceRebuild = ForceRebuild;
312 Inputs.Opts = std::move(Opts);
313 Inputs.Index = Index;
314 Inputs.ClangTidyProvider = ClangTidyProvider;
315 Inputs.FeatureModules = FeatureModules;
316 Inputs.ModulesManager = ModulesManager;
317 adjustParseInputs(Inputs, File);
318 bool NewFile = WorkScheduler->update(File, Inputs, WantDiags);
319 // If we loaded Foo.h, we want to make sure Foo.cpp is indexed.
320 if (NewFile && BackgroundIdx)
321 BackgroundIdx->boostRelated(File);
322}
323
325 llvm::function_ref<bool(llvm::StringRef File)> Filter) {
326 // Reparse only opened files that were modified.
327 for (const Path &FilePath : DraftMgr.getActiveFiles())
328 if (Filter(FilePath))
329 if (auto Draft = DraftMgr.getDraft(FilePath)) // else disappeared in race?
330 addDocument(FilePath, *Draft->Contents, Draft->Version,
332}
333
334std::shared_ptr<const std::string> ClangdServer::getDraft(PathRef File) const {
335 auto Draft = DraftMgr.getDraft(File);
336 if (!Draft)
337 return nullptr;
338 return std::move(Draft->Contents);
339}
340
341std::function<Context(PathRef)>
343 Callbacks *Publish) {
344 if (!Provider)
345 return [](llvm::StringRef) { return Context::current().clone(); };
346
347 struct Impl {
348 const config::Provider *Provider;
350 std::mutex PublishMu;
351
352 Impl(const config::Provider *Provider, ClangdServer::Callbacks *Publish)
353 : Provider(Provider), Publish(Publish) {}
354
355 Context operator()(llvm::StringRef File) {
356 config::Params Params;
357 // Don't reread config files excessively often.
358 // FIXME: when we see a config file change event, use the event timestamp?
359 Params.FreshTime =
360 std::chrono::steady_clock::now() - std::chrono::seconds(5);
361 llvm::SmallString<256> PosixPath;
362 if (!File.empty()) {
363 assert(llvm::sys::path::is_absolute(File));
364 llvm::sys::path::native(File, PosixPath, llvm::sys::path::Style::posix);
365 Params.Path = PosixPath.str();
366 }
367
368 llvm::StringMap<std::vector<Diag>> ReportableDiagnostics;
369 Config C = Provider->getConfig(Params, [&](const llvm::SMDiagnostic &D) {
370 // Create the map entry even for note diagnostics we don't report.
371 // This means that when the file is parsed with no warnings, we
372 // publish an empty set of diagnostics, clearing any the client has.
373 handleDiagnostic(D, !Publish || D.getFilename().empty()
374 ? nullptr
375 : &ReportableDiagnostics[D.getFilename()]);
376 });
377 // Blindly publish diagnostics for the (unopened) parsed config files.
378 // We must avoid reporting diagnostics for *the same file* concurrently.
379 // Source diags are published elsewhere, but those are different files.
380 if (!ReportableDiagnostics.empty()) {
381 std::lock_guard<std::mutex> Lock(PublishMu);
382 for (auto &Entry : ReportableDiagnostics)
383 Publish->onDiagnosticsReady(Entry.first(), /*Version=*/"",
384 Entry.second);
385 }
386 return Context::current().derive(Config::Key, std::move(C));
387 }
388
389 void handleDiagnostic(const llvm::SMDiagnostic &D,
390 std::vector<Diag> *ClientDiagnostics) {
391 switch (D.getKind()) {
392 case llvm::SourceMgr::DK_Error:
393 elog("config error at {0}:{1}:{2}: {3}", D.getFilename(), D.getLineNo(),
394 D.getColumnNo(), D.getMessage());
395 break;
396 case llvm::SourceMgr::DK_Warning:
397 log("config warning at {0}:{1}:{2}: {3}", D.getFilename(),
398 D.getLineNo(), D.getColumnNo(), D.getMessage());
399 break;
400 case llvm::SourceMgr::DK_Note:
401 case llvm::SourceMgr::DK_Remark:
402 vlog("config note at {0}:{1}:{2}: {3}", D.getFilename(), D.getLineNo(),
403 D.getColumnNo(), D.getMessage());
404 ClientDiagnostics = nullptr; // Don't emit notes as LSP diagnostics.
405 break;
406 }
407 if (ClientDiagnostics)
408 ClientDiagnostics->push_back(toDiag(D, Diag::ClangdConfig));
409 }
410 };
411
412 // Copyable wrapper.
413 return [I(std::make_shared<Impl>(Provider, Publish))](llvm::StringRef Path) {
414 return (*I)(Path);
415 };
416}
417
419 DraftMgr.removeDraft(File);
420 WorkScheduler->remove(File);
421}
422
424 const clangd::CodeCompleteOptions &Opts,
426 // Copy completion options for passing them to async task handler.
427 auto CodeCompleteOpts = Opts;
428 if (!CodeCompleteOpts.Index) // Respect overridden index.
429 CodeCompleteOpts.Index = Index;
430
431 auto Task = [Pos, CodeCompleteOpts, File = File.str(), CB = std::move(CB),
432 this](llvm::Expected<InputsAndPreamble> IP) mutable {
433 if (!IP)
434 return CB(IP.takeError());
435 if (auto Reason = isCancelled())
436 return CB(llvm::make_error<CancelledError>(Reason));
437
438 std::optional<SpeculativeFuzzyFind> SpecFuzzyFind;
439 if (!IP->Preamble) {
440 // No speculation in Fallback mode, as it's supposed to be much faster
441 // without compiling.
442 vlog("Build for file {0} is not ready. Enter fallback mode.", File);
443 } else if (CodeCompleteOpts.Index) {
444 SpecFuzzyFind.emplace();
445 {
446 std::lock_guard<std::mutex> Lock(CachedCompletionFuzzyFindRequestMutex);
447 SpecFuzzyFind->CachedReq = CachedCompletionFuzzyFindRequestByFile[File];
448 }
449 }
450 ParseInputs ParseInput{IP->Command, &getHeaderFS(), IP->Contents.str()};
451 // FIXME: Add traling new line if there is none at eof, workaround a crash,
452 // see https://github.com/clangd/clangd/issues/332
453 if (!IP->Contents.ends_with("\n"))
454 ParseInput.Contents.append("\n");
455 ParseInput.Index = Index;
456
457 CodeCompleteOpts.MainFileSignals = IP->Signals;
458 CodeCompleteOpts.AllScopes = Config::current().Completion.AllScopes;
459 CodeCompleteOpts.ArgumentLists = Config::current().Completion.ArgumentLists;
460 CodeCompleteOpts.InsertIncludes =
461 Config::current().Completion.HeaderInsertion;
462 CodeCompleteOpts.CodePatterns = Config::current().Completion.CodePatterns;
463 CodeCompleteOpts.MacroFilter = Config::current().Completion.MacroFilter;
464 adjustParseInputs(ParseInput, File);
465 // FIXME(ibiryukov): even if Preamble is non-null, we may want to check
466 // both the old and the new version in case only one of them matches.
467 CodeCompleteResult Result = clangd::codeComplete(
468 File, Pos, IP->Preamble, ParseInput, CodeCompleteOpts,
469 SpecFuzzyFind ? &*SpecFuzzyFind : nullptr);
470 // We don't want `codeComplete` to wait for the async call if it doesn't use
471 // the result (e.g. non-index completion, speculation fails), so that `CB`
472 // is called as soon as results are available.
473 {
474 clang::clangd::trace::Span Tracer("Completion results callback");
475 CB(std::move(Result));
476 }
477 if (!SpecFuzzyFind)
478 return;
479 if (SpecFuzzyFind->NewReq) {
480 std::lock_guard<std::mutex> Lock(CachedCompletionFuzzyFindRequestMutex);
481 CachedCompletionFuzzyFindRequestByFile[File] = *SpecFuzzyFind->NewReq;
482 }
483 // Explicitly block until async task completes, this is fine as we've
484 // already provided reply to the client and running as a preamble task
485 // (i.e. won't block other preamble tasks).
486 if (SpecFuzzyFind->Result.valid())
487 SpecFuzzyFind->Result.wait();
488 };
489
490 // We use a potentially-stale preamble because latency is critical here.
491 WorkScheduler->runWithPreamble(
492 "CodeComplete", File,
493 (Opts.RunParser == CodeCompleteOptions::AlwaysParse)
496 std::move(Task));
497}
498
500 MarkupKind DocumentationFormat,
502
503 auto Action = [Pos, File = File.str(), CB = std::move(CB),
504 DocumentationFormat,
505 this](llvm::Expected<InputsAndPreamble> IP) mutable {
506 if (!IP)
507 return CB(IP.takeError());
508
509 const auto *PreambleData = IP->Preamble;
510 if (!PreambleData)
511 return CB(error("Failed to parse includes"));
512
513 ParseInputs ParseInput{IP->Command, &getHeaderFS(), IP->Contents.str()};
514 // FIXME: Add traling new line if there is none at eof, workaround a crash,
515 // see https://github.com/clangd/clangd/issues/332
516 if (!IP->Contents.ends_with("\n"))
517 ParseInput.Contents.append("\n");
518 ParseInput.Index = Index;
519 CB(clangd::signatureHelp(File, Pos, *PreambleData, ParseInput,
520 DocumentationFormat));
521 };
522
523 // Unlike code completion, we wait for a preamble here.
524 WorkScheduler->runWithPreamble("SignatureHelp", File, TUScheduler::Stale,
525 std::move(Action));
526}
527
528void ClangdServer::formatFile(PathRef File, const std::vector<Range> &Rngs,
530 auto Code = getDraft(File);
531 if (!Code)
532 return CB(llvm::make_error<LSPError>("trying to format non-added document",
534 std::vector<tooling::Range> RequestedRanges;
535 if (!Rngs.empty()) {
536 RequestedRanges.reserve(Rngs.size());
537 for (const auto &Rng : Rngs) {
538 llvm::Expected<size_t> Begin = positionToOffset(*Code, Rng.start);
539 if (!Begin)
540 return CB(Begin.takeError());
541 llvm::Expected<size_t> End = positionToOffset(*Code, Rng.end);
542 if (!End)
543 return CB(End.takeError());
544 RequestedRanges.emplace_back(*Begin, *End - *Begin);
545 }
546 } else {
547 RequestedRanges = {tooling::Range(0, Code->size())};
548 }
549
550 // Call clang-format.
551 auto Action = [File = File.str(), Code = std::move(*Code),
552 Ranges = std::move(RequestedRanges), CB = std::move(CB),
553 this]() mutable {
554 format::FormatStyle Style = getFormatStyleForFile(File, Code, TFS, true);
555 tooling::Replacements IncludeReplaces =
556 format::sortIncludes(Style, Code, Ranges, File);
557 auto Changed = tooling::applyAllReplacements(Code, IncludeReplaces);
558 if (!Changed)
559 return CB(Changed.takeError());
560
561 CB(IncludeReplaces.merge(format::reformat(
562 Style, *Changed,
563 tooling::calculateRangesAfterReplacements(IncludeReplaces, Ranges),
564 File)));
565 };
566 WorkScheduler->runQuick("Format", File, std::move(Action));
567}
568
570 StringRef TriggerText,
571 Callback<std::vector<TextEdit>> CB) {
572 auto Code = getDraft(File);
573 if (!Code)
574 return CB(llvm::make_error<LSPError>("trying to format non-added document",
576 llvm::Expected<size_t> CursorPos = positionToOffset(*Code, Pos);
577 if (!CursorPos)
578 return CB(CursorPos.takeError());
579 auto Action = [File = File.str(), Code = std::move(*Code),
580 TriggerText = TriggerText.str(), CursorPos = *CursorPos,
581 CB = std::move(CB), this]() mutable {
582 auto Style = getFormatStyleForFile(File, Code, TFS, false);
583 std::vector<TextEdit> Result;
584 for (const tooling::Replacement &R :
585 formatIncremental(Code, CursorPos, TriggerText, Style))
586 Result.push_back(replacementToEdit(Code, R));
587 return CB(Result);
588 };
589 WorkScheduler->runQuick("FormatOnType", File, std::move(Action));
590}
591
593 std::optional<std::string> NewName,
594 const RenameOptions &RenameOpts,
596 auto Action = [Pos, File = File.str(), CB = std::move(CB),
597 NewName = std::move(NewName),
598 RenameOpts](llvm::Expected<InputsAndAST> InpAST) mutable {
599 if (!InpAST)
600 return CB(InpAST.takeError());
601 // prepareRename is latency-sensitive: we don't query the index, as we
602 // only need main-file references
603 auto Results =
604 clangd::rename({Pos, NewName.value_or("__clangd_rename_placeholder"),
605 InpAST->AST, File, /*FS=*/nullptr,
606 /*Index=*/nullptr, RenameOpts});
607 if (!Results) {
608 // LSP says to return null on failure, but that will result in a generic
609 // failure message. If we send an LSP error response, clients can surface
610 // the message to users (VSCode does).
611 return CB(Results.takeError());
612 }
613 return CB(*Results);
614 };
615 WorkScheduler->runWithAST("PrepareRename", File, std::move(Action));
616}
617
618void ClangdServer::rename(PathRef File, Position Pos, llvm::StringRef NewName,
619 const RenameOptions &Opts,
621 auto Action = [File = File.str(), NewName = NewName.str(), Pos, Opts,
622 CB = std::move(CB),
623 this](llvm::Expected<InputsAndAST> InpAST) mutable {
624 // Tracks number of files edited per invocation.
625 static constexpr trace::Metric RenameFiles("rename_files",
627 if (!InpAST)
628 return CB(InpAST.takeError());
629 auto R = clangd::rename({Pos, NewName, InpAST->AST, File,
630 DirtyFS->view(std::nullopt), Index, Opts});
631 if (!R)
632 return CB(R.takeError());
633
634 if (Opts.WantFormat) {
635 auto Style = getFormatStyleForFile(File, InpAST->Inputs.Contents,
636 *InpAST->Inputs.TFS, false);
637 llvm::Error Err = llvm::Error::success();
638 for (auto &E : R->GlobalChanges)
639 Err =
640 llvm::joinErrors(reformatEdit(E.getValue(), Style), std::move(Err));
641
642 if (Err)
643 return CB(std::move(Err));
644 }
645 RenameFiles.record(R->GlobalChanges.size());
646 return CB(*R);
647 };
648 WorkScheduler->runWithAST("Rename", File, std::move(Action));
649}
650
651namespace {
652// May generate several candidate selections, due to SelectionTree ambiguity.
653// vector of pointers because GCC doesn't like non-copyable Selection.
654llvm::Expected<std::vector<std::unique_ptr<Tweak::Selection>>>
655tweakSelection(const Range &Sel, const InputsAndAST &AST,
656 llvm::vfs::FileSystem *FS) {
657 auto Begin = positionToOffset(AST.Inputs.Contents, Sel.start);
658 if (!Begin)
659 return Begin.takeError();
660 auto End = positionToOffset(AST.Inputs.Contents, Sel.end);
661 if (!End)
662 return End.takeError();
663 std::vector<std::unique_ptr<Tweak::Selection>> Result;
665 AST.AST.getASTContext(), AST.AST.getTokens(), *Begin, *End,
666 [&](SelectionTree T) {
667 Result.push_back(std::make_unique<Tweak::Selection>(
668 AST.Inputs.Index, AST.AST, *Begin, *End, std::move(T), FS));
669 return false;
670 });
671 assert(!Result.empty() && "Expected at least one SelectionTree");
672 return std::move(Result);
673}
674
675// Some fixes may perform local renaming, we want to convert those to clangd
676// rename commands, such that we can leverage the index for more accurate
677// results.
678std::optional<ClangdServer::CodeActionResult::Rename>
679tryConvertToRename(const Diag *Diag, const Fix &Fix) {
680 bool IsClangTidyRename = Diag->Source == Diag::ClangTidy &&
681 Diag->Name == "readability-identifier-naming" &&
682 !Fix.Edits.empty();
683 if (IsClangTidyRename && Diag->InsideMainFile) {
684 ClangdServer::CodeActionResult::Rename R;
685 R.NewName = Fix.Edits.front().newText;
686 R.FixMessage = Fix.Message;
687 R.Diag = {Diag->Range, Diag->Message};
688 return R;
689 }
690
691 return std::nullopt;
692}
693
694} // namespace
695
698 auto Action = [Params, CB = std::move(CB),
699 FeatureModules(this->FeatureModules)](
700 Expected<InputsAndAST> InpAST) mutable {
701 if (!InpAST)
702 return CB(InpAST.takeError());
703 auto KindAllowed =
704 [Only(Params.RequestedActionKinds)](llvm::StringRef Kind) {
705 if (Only.empty())
706 return true;
707 return llvm::any_of(Only, [&](llvm::StringRef Base) {
708 return Kind.consume_front(Base) &&
709 (Kind.empty() || Kind.starts_with("."));
710 });
711 };
712
713 CodeActionResult Result;
714 Result.Version = InpAST->AST.version().str();
715 if (KindAllowed(CodeAction::QUICKFIX_KIND)) {
716 auto FindMatchedDiag = [&InpAST](const DiagRef &DR) -> const Diag * {
717 for (const auto &Diag : InpAST->AST.getDiagnostics())
718 if (Diag.Range == DR.Range && Diag.Message == DR.Message)
719 return &Diag;
720 return nullptr;
721 };
722 for (const auto &DiagRef : Params.Diagnostics) {
723 if (const auto *Diag = FindMatchedDiag(DiagRef))
724 for (const auto &Fix : Diag->Fixes) {
725 if (auto Rename = tryConvertToRename(Diag, Fix)) {
726 Result.Renames.emplace_back(std::move(*Rename));
727 } else {
728 Result.QuickFixes.push_back({DiagRef, Fix});
729 }
730 }
731 }
732 }
733
734 // Collect Tweaks
735 auto Selections = tweakSelection(Params.Selection, *InpAST, /*FS=*/nullptr);
736 if (!Selections)
737 return CB(Selections.takeError());
738 // Don't allow a tweak to fire more than once across ambiguous selections.
739 llvm::DenseSet<llvm::StringRef> PreparedTweaks;
740 auto DeduplicatingFilter = [&](const Tweak &T) {
741 return KindAllowed(T.kind()) && Params.TweakFilter(T) &&
742 !PreparedTweaks.count(T.id());
743 };
744 for (const auto &Sel : *Selections) {
745 for (auto &T : prepareTweaks(*Sel, DeduplicatingFilter, FeatureModules)) {
746 Result.TweakRefs.push_back(TweakRef{T->id(), T->title(), T->kind()});
747 PreparedTweaks.insert(T->id());
748 TweakAvailable.record(1, T->id());
749 }
750 }
751 CB(std::move(Result));
752 };
753
754 WorkScheduler->runWithAST("codeAction", Params.File, std::move(Action),
755 Transient);
756}
757
758void ClangdServer::applyTweak(PathRef File, Range Sel, StringRef TweakID,
760 // Tracks number of times a tweak has been attempted.
761 static constexpr trace::Metric TweakAttempt(
762 "tweak_attempt", trace::Metric::Counter, "tweak_id");
763 // Tracks number of times a tweak has failed to produce edits.
764 static constexpr trace::Metric TweakFailed(
765 "tweak_failed", trace::Metric::Counter, "tweak_id");
766 TweakAttempt.record(1, TweakID);
767 auto Action = [File = File.str(), Sel, TweakID = TweakID.str(),
768 CB = std::move(CB),
769 this](Expected<InputsAndAST> InpAST) mutable {
770 if (!InpAST)
771 return CB(InpAST.takeError());
772 auto FS = DirtyFS->view(std::nullopt);
773 auto Selections = tweakSelection(Sel, *InpAST, FS.get());
774 if (!Selections)
775 return CB(Selections.takeError());
776 std::optional<llvm::Expected<Tweak::Effect>> Effect;
777 // Try each selection, take the first one that prepare()s.
778 // If they all fail, Effect will hold get the last error.
779 for (const auto &Selection : *Selections) {
780 auto T = prepareTweak(TweakID, *Selection, FeatureModules);
781 if (T) {
782 Effect = (*T)->apply(*Selection);
783 break;
784 }
785 Effect = T.takeError();
786 }
787 assert(Effect && "Expected at least one selection");
788 if (*Effect && (*Effect)->FormatEdits) {
789 // Format tweaks that require it centrally here.
790 for (auto &It : (*Effect)->ApplyEdits) {
791 Edit &E = It.second;
792 format::FormatStyle Style =
793 getFormatStyleForFile(File, E.InitialCode, TFS, false);
794 if (llvm::Error Err = reformatEdit(E, Style))
795 elog("Failed to format {0}: {1}", It.first(), std::move(Err));
796 }
797 } else {
798 TweakFailed.record(1, TweakID);
799 }
800 return CB(std::move(*Effect));
801 };
802 WorkScheduler->runWithAST("ApplyTweak", File, std::move(Action));
803}
804
806 Callback<std::vector<LocatedSymbol>> CB) {
807 auto Action = [Pos, CB = std::move(CB),
808 this](llvm::Expected<InputsAndAST> InpAST) mutable {
809 if (!InpAST)
810 return CB(InpAST.takeError());
811 CB(clangd::locateSymbolAt(InpAST->AST, Pos, Index));
812 };
813
814 WorkScheduler->runWithAST("Definitions", File, std::move(Action));
815}
816
818 PathRef Path, Callback<std::optional<clangd::Path>> CB) {
819 // We want to return the result as fast as possible, strategy is:
820 // 1) use the file-only heuristic, it requires some IO but it is much
821 // faster than building AST, but it only works when .h/.cc files are in
822 // the same directory.
823 // 2) if 1) fails, we use the AST&Index approach, it is slower but supports
824 // different code layout.
825 if (auto CorrespondingFile =
826 getCorrespondingHeaderOrSource(Path, TFS.view(std::nullopt)))
827 return CB(std::move(CorrespondingFile));
828 auto Action = [Path = Path.str(), CB = std::move(CB),
829 this](llvm::Expected<InputsAndAST> InpAST) mutable {
830 if (!InpAST)
831 return CB(InpAST.takeError());
832 CB(getCorrespondingHeaderOrSource(Path, InpAST->AST, Index));
833 };
834 WorkScheduler->runWithAST("SwitchHeaderSource", Path, std::move(Action));
835}
836
838 PathRef File, Position Pos, Callback<std::vector<DocumentHighlight>> CB) {
839 auto Action =
840 [Pos, CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST) mutable {
841 if (!InpAST)
842 return CB(InpAST.takeError());
843 CB(clangd::findDocumentHighlights(InpAST->AST, Pos));
844 };
845
846 WorkScheduler->runWithAST("Highlights", File, std::move(Action), Transient);
847}
848
850 Callback<std::optional<HoverInfo>> CB) {
851 auto Action = [File = File.str(), Pos, CB = std::move(CB),
852 this](llvm::Expected<InputsAndAST> InpAST) mutable {
853 if (!InpAST)
854 return CB(InpAST.takeError());
855 format::FormatStyle Style = getFormatStyleForFile(
856 File, InpAST->Inputs.Contents, *InpAST->Inputs.TFS, false);
857 CB(clangd::getHover(InpAST->AST, Pos, std::move(Style), Index));
858 };
859
860 WorkScheduler->runWithAST("Hover", File, std::move(Action), Transient);
861}
862
864 TypeHierarchyDirection Direction,
865 Callback<std::vector<TypeHierarchyItem>> CB) {
866 auto Action = [File = File.str(), Pos, Resolve, Direction, CB = std::move(CB),
867 this](Expected<InputsAndAST> InpAST) mutable {
868 if (!InpAST)
869 return CB(InpAST.takeError());
870 CB(clangd::getTypeHierarchy(InpAST->AST, Pos, Resolve, Direction, Index,
871 File));
872 };
873
874 WorkScheduler->runWithAST("TypeHierarchy", File, std::move(Action));
875}
876
878 const TypeHierarchyItem &Item,
879 Callback<std::optional<std::vector<TypeHierarchyItem>>> CB) {
880 WorkScheduler->run("typeHierarchy/superTypes", /*Path=*/"",
881 [=, CB = std::move(CB)]() mutable {
882 CB(clangd::superTypes(Item, Index));
883 });
884}
885
887 Callback<std::vector<TypeHierarchyItem>> CB) {
888 WorkScheduler->run(
889 "typeHierarchy/subTypes", /*Path=*/"",
890 [=, CB = std::move(CB)]() mutable { CB(clangd::subTypes(Item, Index)); });
891}
892
894 TypeHierarchyItem Item, int Resolve, TypeHierarchyDirection Direction,
895 Callback<std::optional<TypeHierarchyItem>> CB) {
896 WorkScheduler->run(
897 "Resolve Type Hierarchy", "", [=, CB = std::move(CB)]() mutable {
898 clangd::resolveTypeHierarchy(Item, Resolve, Direction, Index);
899 CB(Item);
900 });
901}
902
904 PathRef File, Position Pos, Callback<std::vector<CallHierarchyItem>> CB) {
905 auto Action = [File = File.str(), Pos,
906 CB = std::move(CB)](Expected<InputsAndAST> InpAST) mutable {
907 if (!InpAST)
908 return CB(InpAST.takeError());
909 CB(clangd::prepareCallHierarchy(InpAST->AST, Pos, File));
910 };
911 WorkScheduler->runWithAST("CallHierarchy", File, std::move(Action));
912}
913
915 const CallHierarchyItem &Item,
916 Callback<std::vector<CallHierarchyIncomingCall>> CB) {
917 WorkScheduler->run("Incoming Calls", "",
918 [CB = std::move(CB), Item, this]() mutable {
919 CB(clangd::incomingCalls(Item, Index));
920 });
921}
922
923void ClangdServer::inlayHints(PathRef File, std::optional<Range> RestrictRange,
924 Callback<std::vector<InlayHint>> CB) {
925 auto Action = [RestrictRange(std::move(RestrictRange)),
926 CB = std::move(CB)](Expected<InputsAndAST> InpAST) mutable {
927 if (!InpAST)
928 return CB(InpAST.takeError());
929 CB(clangd::inlayHints(InpAST->AST, std::move(RestrictRange)));
930 };
931 WorkScheduler->runWithAST("InlayHints", File, std::move(Action), Transient);
932}
933
935 const CallHierarchyItem &Item,
936 Callback<std::vector<CallHierarchyOutgoingCall>> CB) {
937 WorkScheduler->run("Outgoing Calls", "",
938 [CB = std::move(CB), Item, this]() mutable {
939 CB(clangd::outgoingCalls(Item, Index));
940 });
941}
942
944 // FIXME: Do nothing for now. This will be used for indexing and potentially
945 // invalidating other caches.
946}
947
949 llvm::StringRef Query, int Limit,
950 Callback<std::vector<SymbolInformation>> CB) {
951 WorkScheduler->run(
952 "getWorkspaceSymbols", /*Path=*/"",
953 [Query = Query.str(), Limit, CB = std::move(CB), this]() mutable {
954 CB(clangd::getWorkspaceSymbols(Query, Limit, Index,
955 WorkspaceRoot.value_or("")));
956 });
957}
958
960 Callback<std::vector<DocumentSymbol>> CB) {
961 auto Action =
962 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST) mutable {
963 if (!InpAST)
964 return CB(InpAST.takeError());
965 CB(clangd::getDocumentSymbols(InpAST->AST));
966 };
967 WorkScheduler->runWithAST("DocumentSymbols", File, std::move(Action),
968 Transient);
969}
970
972 Callback<std::vector<FoldingRange>> CB) {
973 auto Code = getDraft(File);
974 if (!Code)
975 return CB(llvm::make_error<LSPError>(
976 "trying to compute folding ranges for non-added document",
978 auto Action = [LineFoldingOnly = LineFoldingOnly, CB = std::move(CB),
979 Code = std::move(*Code)]() mutable {
980 CB(clangd::getFoldingRanges(Code, LineFoldingOnly));
981 };
982 // We want to make sure folding ranges are always available for all the open
983 // files, hence prefer runQuick to not wait for operations on other files.
984 WorkScheduler->runQuick("FoldingRanges", File, std::move(Action));
985}
986
987void ClangdServer::findType(llvm::StringRef File, Position Pos,
988 Callback<std::vector<LocatedSymbol>> CB) {
989 auto Action = [Pos, CB = std::move(CB),
990 this](llvm::Expected<InputsAndAST> InpAST) mutable {
991 if (!InpAST)
992 return CB(InpAST.takeError());
993 CB(clangd::findType(InpAST->AST, Pos, Index));
994 };
995 WorkScheduler->runWithAST("FindType", File, std::move(Action));
996}
997
999 PathRef File, Position Pos, Callback<std::vector<LocatedSymbol>> CB) {
1000 auto Action = [Pos, CB = std::move(CB),
1001 this](llvm::Expected<InputsAndAST> InpAST) mutable {
1002 if (!InpAST)
1003 return CB(InpAST.takeError());
1004 CB(clangd::findImplementations(InpAST->AST, Pos, Index));
1005 };
1006
1007 WorkScheduler->runWithAST("Implementations", File, std::move(Action));
1008}
1009
1011 bool AddContainer,
1013 auto Action = [Pos, Limit, AddContainer, CB = std::move(CB),
1014 this](llvm::Expected<InputsAndAST> InpAST) mutable {
1015 if (!InpAST)
1016 return CB(InpAST.takeError());
1017 CB(clangd::findReferences(InpAST->AST, Pos, Limit, Index, AddContainer));
1018 };
1019
1020 WorkScheduler->runWithAST("References", File, std::move(Action));
1021}
1022
1024 Callback<std::vector<SymbolDetails>> CB) {
1025 auto Action =
1026 [Pos, CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST) mutable {
1027 if (!InpAST)
1028 return CB(InpAST.takeError());
1029 CB(clangd::getSymbolInfo(InpAST->AST, Pos));
1030 };
1031
1032 WorkScheduler->runWithAST("SymbolInfo", File, std::move(Action));
1033}
1034
1036 const std::vector<Position> &Positions,
1037 Callback<std::vector<SelectionRange>> CB) {
1038 auto Action = [Positions, CB = std::move(CB)](
1039 llvm::Expected<InputsAndAST> InpAST) mutable {
1040 if (!InpAST)
1041 return CB(InpAST.takeError());
1042 std::vector<SelectionRange> Result;
1043 for (const auto &Pos : Positions) {
1044 if (auto Range = clangd::getSemanticRanges(InpAST->AST, Pos))
1045 Result.push_back(std::move(*Range));
1046 else
1047 return CB(Range.takeError());
1048 }
1049 CB(std::move(Result));
1050 };
1051 WorkScheduler->runWithAST("SemanticRanges", File, std::move(Action));
1052}
1053
1055 Callback<std::vector<DocumentLink>> CB) {
1056 auto Action =
1057 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST) mutable {
1058 if (!InpAST)
1059 return CB(InpAST.takeError());
1060 CB(clangd::getDocumentLinks(InpAST->AST));
1061 };
1062 WorkScheduler->runWithAST("DocumentLinks", File, std::move(Action),
1063 Transient);
1064}
1065
1067 PathRef File, Callback<std::vector<HighlightingToken>> CB) {
1068
1069 auto Action = [CB = std::move(CB),
1070 PublishInactiveRegions = PublishInactiveRegions](
1071 llvm::Expected<InputsAndAST> InpAST) mutable {
1072 if (!InpAST)
1073 return CB(InpAST.takeError());
1074 // Include inactive regions in semantic highlighting tokens only if the
1075 // client doesn't support a dedicated protocol for being informed about
1076 // them.
1077 CB(clangd::getSemanticHighlightings(InpAST->AST, !PublishInactiveRegions));
1078 };
1079 WorkScheduler->runWithAST("SemanticHighlights", File, std::move(Action),
1080 Transient);
1081}
1082
1083void ClangdServer::getAST(PathRef File, std::optional<Range> R,
1084 Callback<std::optional<ASTNode>> CB) {
1085 auto Action =
1086 [R, CB(std::move(CB))](llvm::Expected<InputsAndAST> Inputs) mutable {
1087 if (!Inputs)
1088 return CB(Inputs.takeError());
1089 if (!R) {
1090 // It's safe to pass in the TU, as dumpAST() does not
1091 // deserialize the preamble.
1092 auto Node = DynTypedNode::create(
1093 *Inputs->AST.getASTContext().getTranslationUnitDecl());
1094 return CB(dumpAST(Node, Inputs->AST.getTokens(),
1095 Inputs->AST.getASTContext()));
1096 }
1097 unsigned Start, End;
1098 if (auto Offset = positionToOffset(Inputs->Inputs.Contents, R->start))
1099 Start = *Offset;
1100 else
1101 return CB(Offset.takeError());
1102 if (auto Offset = positionToOffset(Inputs->Inputs.Contents, R->end))
1103 End = *Offset;
1104 else
1105 return CB(Offset.takeError());
1106 bool Success = SelectionTree::createEach(
1107 Inputs->AST.getASTContext(), Inputs->AST.getTokens(), Start, End,
1108 [&](SelectionTree T) {
1109 if (const SelectionTree::Node *N = T.commonAncestor()) {
1110 CB(dumpAST(N->ASTNode, Inputs->AST.getTokens(),
1111 Inputs->AST.getASTContext()));
1112 return true;
1113 }
1114 return false;
1115 });
1116 if (!Success)
1117 CB(std::nullopt);
1118 };
1119 WorkScheduler->runWithAST("GetAST", File, std::move(Action));
1120}
1121
1122void ClangdServer::customAction(PathRef File, llvm::StringRef Name,
1123 Callback<InputsAndAST> Action) {
1124 WorkScheduler->runWithAST(Name, File, std::move(Action));
1125}
1126
1127void ClangdServer::diagnostics(PathRef File, Callback<std::vector<Diag>> CB) {
1128 auto Action =
1129 [CB = std::move(CB)](llvm::Expected<InputsAndAST> InpAST) mutable {
1130 if (!InpAST)
1131 return CB(InpAST.takeError());
1132 return CB(InpAST->AST.getDiagnostics());
1133 };
1134
1135 WorkScheduler->runWithAST("Diagnostics", File, std::move(Action));
1136}
1137
1138llvm::StringMap<TUScheduler::FileStats> ClangdServer::fileStats() const {
1139 return WorkScheduler->fileStats();
1140}
1141
1142[[nodiscard]] bool
1143ClangdServer::blockUntilIdleForTest(std::optional<double> TimeoutSeconds) {
1144 // Order is important here: we don't want to block on A and then B,
1145 // if B might schedule work on A.
1146
1147#if defined(__has_feature) && \
1148 (__has_feature(address_sanitizer) || __has_feature(hwaddress_sanitizer) || \
1149 __has_feature(memory_sanitizer) || __has_feature(thread_sanitizer))
1150 if (TimeoutSeconds.has_value())
1151 (*TimeoutSeconds) *= 10;
1152#endif
1153
1154 // Nothing else can schedule work on TUScheduler, because it's not threadsafe
1155 // and we're blocking the main thread.
1156 if (!WorkScheduler->blockUntilIdle(timeoutSeconds(TimeoutSeconds)))
1157 return false;
1158 // TUScheduler is the only thing that starts background indexing work.
1159 if (IndexTasks && !IndexTasks->wait(timeoutSeconds(TimeoutSeconds)))
1160 return false;
1161
1162 // Unfortunately we don't have strict topological order between the rest of
1163 // the components. E.g. CDB broadcast triggers backrgound indexing.
1164 // This queries the CDB which may discover new work if disk has changed.
1165 //
1166 // So try each one a few times in a loop.
1167 // If there are no tricky interactions then all after the first are no-ops.
1168 // Then on the last iteration, verify they're idle without waiting.
1169 //
1170 // There's a small chance they're juggling work and we didn't catch them :-(
1171 for (std::optional<double> Timeout :
1172 {TimeoutSeconds, TimeoutSeconds, std::optional<double>(0)}) {
1173 if (!CDB.blockUntilIdle(timeoutSeconds(Timeout)))
1174 return false;
1175 if (BackgroundIdx && !BackgroundIdx->blockUntilIdleForTest(Timeout))
1176 return false;
1177 if (FeatureModules && llvm::any_of(*FeatureModules, [&](FeatureModule &M) {
1178 return !M.blockUntilIdle(timeoutSeconds(Timeout));
1179 }))
1180 return false;
1181 }
1182
1183 assert(WorkScheduler->blockUntilIdle(Deadline::zero()) &&
1184 "Something scheduled work while we're blocking the main thread!");
1185 return true;
1186}
1187
1189 if (DynamicIdx)
1190 DynamicIdx->profile(MT.child("dynamic_index"));
1191 if (BackgroundIdx)
1192 BackgroundIdx->profile(MT.child("background_index"));
1193 WorkScheduler->profile(MT.child("tuscheduler"));
1194}
1195
1196void ClangdServer::adjustParseInputs(ParseInputs &Inputs, PathRef File) const {
1197 // FIXME: Don't perform optimization when the TU requires C++20
1198 // named modules. Mixing PCH and modules may cause different issues (incorrect
1199 // diagnostics, crashes) due to instability of such scenario support in the
1200 // clang.
1201 Inputs.Opts.SkipPreambleBuild =
1202 SkipPreambleBuild ||
1203 (ModulesManager && ModulesManager->hasRequiredModules(File));
1204}
1205
1206} // namespace clangd
1207} // namespace clang
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)
Definition Logger.h:61
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.
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 ...
Definition Context.h:69
static const Context & current()
Returns the context for the current thread, creating it if needed.
Definition Context.cpp:27
static Deadline zero()
Definition Threading.h:50
static Deadline infinity()
Definition Threading.h:51
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.
Definition FileIndex.h:110
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...
Definition Index.h:134
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.
Definition Tweak.h:46
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.
Definition Trace.h:143
FIXME: Skip testing on windows temporarily due to the different escaping code mode.
Definition AST.cpp:44
@ Changed
The file got changed.
Definition Protocol.h:816
std::vector< TypeHierarchyItem > subTypes(const TypeHierarchyItem &Item, const SymbolIndex *Index)
Returns direct children of a TypeHierarchyItem.
Definition XRefs.cpp:2333
std::optional< std::vector< TypeHierarchyItem > > superTypes(const TypeHierarchyItem &Item, const SymbolIndex *Index)
Returns direct parents of a TypeHierarchyItem using SymbolIDs stored inside the item.
Definition XRefs.cpp:2312
std::vector< CallHierarchyIncomingCall > incomingCalls(const CallHierarchyItem &Item, const SymbolIndex *Index)
Definition XRefs.cpp:2383
std::vector< HighlightingToken > getSemanticHighlightings(ParsedAST &AST, bool IncludeInactiveRegionTokens)
llvm::Expected< std::unique_ptr< Tweak > > prepareTweak(StringRef ID, const Tweak::Selection &S, const FeatureModuleSet *Modules)
Definition Tweak.cpp:91
ASTNode dumpAST(const DynTypedNode &N, const syntax::TokenBuffer &Tokens, const ASTContext &Ctx)
Definition DumpAST.cpp:408
std::vector< DocumentHighlight > findDocumentHighlights(ParsedAST &AST, Position Pos)
Returns highlights for all usages of a symbol at Pos.
Definition XRefs.cpp:1321
std::vector< DocumentLink > getDocumentLinks(ParsedAST &AST)
Get all document links.
Definition XRefs.cpp:865
std::vector< SymbolDetails > getSymbolInfo(ParsedAST &AST, Position Pos)
Get info about symbols at Pos.
Definition XRefs.cpp:1710
void vlog(const char *Fmt, Ts &&... Vals)
Definition Logger.h:72
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.
Definition XRefs.cpp:2191
llvm::unique_function< void(llvm::Expected< T >)> Callback
A Callback<T> is a void function that accepts Expected<T>.
Definition Function.h:28
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.
Definition Rename.cpp:1076
std::vector< TypeHierarchyItem > getTypeHierarchy(ParsedAST &AST, Position Pos, int ResolveLevels, TypeHierarchyDirection Direction, const SymbolIndex *Index, PathRef TUPath)
Get type hierarchy information at Pos.
Definition XRefs.cpp:2268
llvm::Error error(std::error_code EC, const char *Fmt, Ts &&... Vals)
Definition Logger.h:79
ReferencesResult findReferences(ParsedAST &AST, Position Pos, uint32_t Limit, const SymbolIndex *Index, bool AddContext)
Returns references of the symbol at a specified Pos.
Definition XRefs.cpp:1487
std::optional< HoverInfo > getHover(ParsedAST &AST, Position Pos, const format::FormatStyle &Style, const SymbolIndex *Index)
Get the hover information when hovering at Pos.
Definition Hover.cpp:1295
std::vector< tooling::Replacement > formatIncremental(llvm::StringRef OriginalCode, unsigned OriginalCursor, llvm::StringRef InsertedText, format::FormatStyle Style)
Applies limited formatting around new InsertedText.
Definition Format.cpp:277
std::vector< LocatedSymbol > locateSymbolAt(ParsedAST &AST, Position Pos, const SymbolIndex *Index)
Get definition of symbol at a specified Pos.
Definition XRefs.cpp:784
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)
Definition Logger.h:67
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.
Definition Path.h:29
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.
Definition Tweak.cpp:72
WantDiagnostics
Determines whether diagnostics should be generated for a file snapshot.
Definition TUScheduler.h:53
@ Auto
Diagnostics must not be generated for this snapshot.
Definition TUScheduler.h:56
std::vector< LocatedSymbol > findImplementations(ParsedAST &AST, Position Pos, const SymbolIndex *Index)
Returns implementations at a specified Pos:
Definition XRefs.cpp:1362
std::string Path
A typedef to represent a file path.
Definition Path.h:26
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)
Definition XRefs.cpp:2342
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)
Definition XRefs.cpp:2465
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)
Definition StdLib.cpp:200
std::vector< CallHierarchyItem > prepareCallHierarchy(ParsedAST &AST, Position Pos, PathRef TUPath)
Get call hierarchy information at Pos.
Definition XRefs.cpp:2357
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.
Definition Protocol.h:1615
std::vector< std::string > RequestedActionKinds
Requested kind of actions to return.
std::vector< DiagRef > Diagnostics
Diagnostics attached to the code action request.
std::function< bool(const Tweak &)> TweakFilter
Tweaks where Filter returns false will not be checked or included.
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
Definition Protocol.h:1084
Settings that express user/project preferences and control clangd behavior.
Definition Config.h:44
static clangd::Key< Config > Key
Context key which can be used to set the current Config.
Definition Config.h:48
static const Config & current()
Returns the Config of the current Context, or an empty configuration.
Definition Config.cpp:17
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.
Definition Diagnostics.h:98
std::vector< Fix > Fixes
Alternative fixes for this diagnostic, one should be chosen.
A set of edits generated for a single file.
Definition SourceCode.h:189
std::string InitialCode
Definition SourceCode.h:191
Represents a single fix-it that editor can apply to fix the error.
Definition Diagnostics.h:81
A tree that can be used to represent memory usage of nested components while preserving the hierarchy...
Definition MemoryTree.h:30
MemoryTree & child(llvm::StringLiteral Name)
No copy of the Name.
Definition MemoryTree.h:39
Information required to run clang, e.g. to parse AST or do code completion.
Definition Compiler.h:51
TidyProviderRef ClangTidyProvider
Definition Compiler.h:63
const ThreadsafeFS * TFS
Definition Compiler.h:53
FeatureModuleSet * FeatureModules
Definition Compiler.h:65
ModulesBuilder * ModulesManager
Definition Compiler.h:67
const SymbolIndex * Index
Definition Compiler.h:61
The parsed preamble and associated data.
Definition Preamble.h:97
PrecompiledPreamble Preamble
Definition Preamble.h:107
Position start
The range's start position.
Definition Protocol.h:187
Position end
The range's end position.
Definition Protocol.h:190
bool WantFormat
If true, format the rename edits, only meaningful in ClangdServer layer.
Definition Rename.h:31
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.
Definition Trace.h:38
@ Counter
An aggregate number whose rate of change over time is meaningful.
Definition Trace.h:46
@ Distribution
A distribution of values with a meaningful mean and count.
Definition Trace.h:52
void record(double Value, llvm::StringRef Label="") const
Records a measurement for this metric to active tracer.
Definition Trace.cpp:329