12 #include "clang/ASTMatchers/Dynamic/Parser.h" 13 #include "clang/Basic/CharInfo.h" 14 #include "llvm/ADT/StringRef.h" 15 #include "llvm/ADT/StringSwitch.h" 28 StringRef QueryParser::lexWord() {
31 return StringRef(
" \t\v\f\r").contains(c);
41 if (
Line.front() ==
'#')
42 Word =
Line.substr(0, 1);
44 Word =
Line.take_until(isWhitespace);
65 : Word(P->lexWord()), Switch(Word), P(P),
66 WordCompletionPos(StringRef::npos) {
68 if (P->CompletionPos && P->CompletionPos <= Word.data() + Word.size()) {
69 if (P->CompletionPos < Word.data())
70 WordCompletionPos = 0;
72 WordCompletionPos = P->CompletionPos - Word.data();
77 bool IsCompletion =
true) {
79 if (WordCompletionPos == StringRef::npos)
80 Switch.
Case(CaseStr, Value);
81 else if (CaseStr.size() != 0 && IsCompletion && WordCompletionPos <= CaseStr.size() &&
82 CaseStr.substr(0, WordCompletionPos) ==
83 Word.substr(0, WordCompletionPos))
84 P->Completions.push_back(LineEditor::Completion(
85 (CaseStr.substr(WordCompletionPos) +
" ").str(), CaseStr));
89 T
Default(T Value) {
return Switch.Default(Value); }
99 return new InvalidQuery(
"expected 'true' or 'false', got '" + ValStr +
"'");
104 template <
typename QueryType>
QueryRef QueryParser::parseSetOutputKind() {
112 if (OutKind == ~0u) {
114 "expected 'diag', 'print', 'detailed-ast' or 'dump', got '" + ValStr +
120 return new QueryType(&QuerySession::DetailedASTOutput);
122 return new QueryType(&QuerySession::DiagOutput);
124 return new QueryType(&QuerySession::PrintOutput);
127 llvm_unreachable(
"Invalid output kind");
131 StringRef Extra =
Line;
132 StringRef ExtraTrimmed = Extra.drop_while(
133 [](
char c) {
return StringRef(
" \t\v\f\r").contains(c); });
135 if ((!ExtraTrimmed.empty() && ExtraTrimmed[0] ==
'\n') ||
136 (ExtraTrimmed.size() >= 2 && ExtraTrimmed[0] ==
'\r' &&
137 ExtraTrimmed[1] ==
'\n'))
138 Q->RemainingContent = Extra;
140 StringRef TrailingWord = lexWord();
141 if (!TrailingWord.empty() && TrailingWord.front() ==
'#') {
142 Line =
Line.drop_until([](
char c) {
return c ==
'\n'; });
143 Line =
Line.drop_while([](
char c) {
return c ==
'\n'; });
146 if (!TrailingWord.empty()) {
147 return new InvalidQuery(
"unexpected extra input: '" + Extra +
"'");
176 QueryRef makeInvalidQueryFromDiagnostics(
const Diagnostics &Diag) {
178 llvm::raw_string_ostream OS(ErrStr);
179 Diag.printToStreamFull(OS);
185 QueryRef QueryParser::completeMatcherExpression() {
186 std::vector<MatcherCompletion> Comps = Parser::completeExpression(
187 Line, CompletionPos -
Line.begin(),
nullptr, &QS.NamedValues);
188 for (
auto I = Comps.begin(),
E = Comps.end(); I !=
E; ++I) {
189 Completions.push_back(LineEditor::Completion(I->TypedText, I->MatcherDecl));
195 StringRef CommandStr;
196 ParsedQueryKind QKind = LexOrCompleteWord<ParsedQueryKind>(
this, CommandStr)
198 .Case(
"#", PQK_Comment,
false)
199 .Case(
"help", PQK_Help)
200 .Case(
"l", PQK_Let,
false)
201 .Case(
"let", PQK_Let)
202 .Case(
"m", PQK_Match,
false)
203 .Case(
"match", PQK_Match)
204 .Case(
"q", PQK_Quit,
false)
205 .Case(
"quit", PQK_Quit)
206 .Case(
"set", PQK_Set)
207 .Case(
"enable", PQK_Enable)
208 .Case(
"disable", PQK_Disable)
209 .Case(
"unlet", PQK_Unlet)
210 .Default(PQK_Invalid);
215 Line =
Line.drop_until([](
char c) {
return c ==
'\n'; });
216 Line =
Line.drop_while([](
char c) {
return c ==
'\n'; });
228 StringRef
Name = lexWord();
234 return completeMatcherExpression();
237 ast_matchers::dynamic::VariantValue Value;
238 if (!Parser::parseExpression(
Line,
nullptr, &QS.NamedValues, &Value,
240 return makeInvalidQueryFromDiagnostics(Diag);
243 auto *Q =
new LetQuery(Name, Value);
244 Q->RemainingContent =
Line;
250 return completeMatcherExpression();
253 auto MatcherSource =
Line.ltrim();
254 auto OrigMatcherSource = MatcherSource;
255 Optional<DynTypedMatcher> Matcher = Parser::parseMatcherExpression(
256 MatcherSource,
nullptr, &QS.NamedValues, &Diag);
258 return makeInvalidQueryFromDiagnostics(Diag);
260 auto ActualSource = OrigMatcherSource.slice(0, OrigMatcherSource.size() -
261 MatcherSource.size());
262 auto *Q =
new MatchQuery(ActualSource, *Matcher);
263 Q->RemainingContent = MatcherSource;
270 LexOrCompleteWord<ParsedQueryVariable>(
this, VarStr)
271 .Case(
"output", PQV_Output)
272 .Case(
"bind-root", PQV_BindRoot)
273 .Case(
"print-matcher", PQV_PrintMatcher)
274 .Default(PQV_Invalid);
277 if (Var == PQV_Invalid)
278 return new InvalidQuery(
"unknown variable: '" + VarStr +
"'");
283 Q = parseSetOutputKind<SetExclusiveOutputQuery>();
286 Q = parseSetBool(&QuerySession::BindRoot);
288 case PQV_PrintMatcher:
289 Q = parseSetBool(&QuerySession::PrintMatcher);
292 llvm_unreachable(
"Invalid query kind");
301 LexOrCompleteWord<ParsedQueryVariable>(
this, VarStr)
302 .Case(
"output", PQV_Output)
303 .Default(PQV_Invalid);
306 if (Var == PQV_Invalid)
307 return new InvalidQuery(
"unknown variable: '" + VarStr +
"'");
311 if (QKind == PQK_Enable)
312 Q = parseSetOutputKind<EnableOutputQuery>();
313 else if (QKind == PQK_Disable)
314 Q = parseSetOutputKind<DisableOutputQuery>();
316 llvm_unreachable(
"Invalid query kind");
321 StringRef
Name = lexWord();
326 return endQuery(
new LetQuery(Name, VariantValue()));
330 return new InvalidQuery(
"unknown command: " + CommandStr);
333 llvm_unreachable(
"Invalid query kind");
340 std::vector<LineEditor::Completion>
343 P.CompletionPos = Line.data() +
Pos;
346 return P.Completions;
Some operations such as code completion produce a set of candidates.
No-op query (i.e. a blank line).
Represents the state for a particular clang-query session.
Any query which resulted in a parse error. The error message is in ErrStr.
llvm::IntrusiveRefCntPtr< Query > QueryRef
Query for "match MATCHER".
static constexpr llvm::StringLiteral Name
===– Representation.cpp - ClangDoc Representation --------—*- C++ -*-===//
LexOrCompleteWord & Case(llvm::StringLiteral CaseStr, const T &Value, bool IsCompletion=true)
Query for "set VAR VALUE".
LexOrCompleteWord(QueryParser *P, StringRef &OutWord)