1 //===- FileCheck.cpp - Check that File's Contents match what is expected --===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // FileCheck does a line-by line check of a file that validates whether it 11 // contains the expected content. This is useful for regression tests etc. 12 // 13 // This program exits with an error status of 2 on error, exit status of 0 if 14 // the file matched the expected contents, and exit status of 1 if it did not 15 // contain the expected contents. 16 // 17 //===----------------------------------------------------------------------===// 18 19 #include "llvm/ADT/OwningPtr.h" 20 #include "llvm/Support/CommandLine.h" 21 #include "llvm/Support/MemoryBuffer.h" 22 #include "llvm/Support/PrettyStackTrace.h" 23 #include "llvm/Support/Regex.h" 24 #include "llvm/Support/SourceMgr.h" 25 #include "llvm/Support/raw_ostream.h" 26 #include "llvm/Support/Signals.h" 27 #include "llvm/Support/system_error.h" 28 #include "llvm/ADT/SmallString.h" 29 #include "llvm/ADT/StringExtras.h" 30 #include "llvm/ADT/StringMap.h" 31 #include <algorithm> 32 #include <map> 33 #include <string> 34 #include <vector> 35 using namespace llvm; 36 37 static cl::opt<std::string> 38 CheckFilename(cl::Positional, cl::desc("<check-file>"), cl::Required); 39 40 static cl::opt<std::string> 41 InputFilename("input-file", cl::desc("File to check (defaults to stdin)"), 42 cl::init("-"), cl::value_desc("filename")); 43 44 static cl::opt<std::string> 45 CheckPrefix("check-prefix", cl::init("CHECK"), 46 cl::desc("Prefix to use from check file (defaults to 'CHECK')")); 47 48 static cl::opt<bool> 49 NoCanonicalizeWhiteSpace("strict-whitespace", 50 cl::desc("Do not treat all horizontal whitespace as equivalent")); 51 52 //===----------------------------------------------------------------------===// 53 // Pattern Handling Code. 54 //===----------------------------------------------------------------------===// 55 56 class Pattern { 57 SMLoc PatternLoc; 58 59 /// MatchEOF - When set, this pattern only matches the end of file. This is 60 /// used for trailing CHECK-NOTs. 61 bool MatchEOF; 62 63 /// FixedStr - If non-empty, this pattern is a fixed string match with the 64 /// specified fixed string. 65 StringRef FixedStr; 66 67 /// RegEx - If non-empty, this is a regex pattern. 68 std::string RegExStr; 69 70 /// \brief Contains the number of line this pattern is in. 71 unsigned LineNumber; 72 73 /// VariableUses - Entries in this vector map to uses of a variable in the 74 /// pattern, e.g. "foo[[bar]]baz". In this case, the RegExStr will contain 75 /// "foobaz" and we'll get an entry in this vector that tells us to insert the 76 /// value of bar at offset 3. 77 std::vector<std::pair<StringRef, unsigned> > VariableUses; 78 79 /// VariableDefs - Maps definitions of variables to their parenthesized 80 /// capture numbers. 81 /// E.g. for the pattern "foo[[bar:.*]]baz", VariableDefs will map "bar" to 1. 82 std::map<StringRef, unsigned> VariableDefs; 83 84 public: 85 86 Pattern(bool matchEOF = false) : MatchEOF(matchEOF) { } 87 88 /// ParsePattern - Parse the given string into the Pattern. SM provides the 89 /// SourceMgr used for error reports, and LineNumber is the line number in 90 /// the input file from which the pattern string was read. 91 /// Returns true in case of an error, false otherwise. 92 bool ParsePattern(StringRef PatternStr, SourceMgr &SM, unsigned LineNumber); 93 94 /// Match - Match the pattern string against the input buffer Buffer. This 95 /// returns the position that is matched or npos if there is no match. If 96 /// there is a match, the size of the matched string is returned in MatchLen. 97 /// 98 /// The VariableTable StringMap provides the current values of filecheck 99 /// variables and is updated if this match defines new values. 100 size_t Match(StringRef Buffer, size_t &MatchLen, 101 StringMap<StringRef> &VariableTable) const; 102 103 /// PrintFailureInfo - Print additional information about a failure to match 104 /// involving this pattern. 105 void PrintFailureInfo(const SourceMgr &SM, StringRef Buffer, 106 const StringMap<StringRef> &VariableTable) const; 107 108 private: 109 static void AddFixedStringToRegEx(StringRef FixedStr, std::string &TheStr); 110 bool AddRegExToRegEx(StringRef RS, unsigned &CurParen, SourceMgr &SM); 111 void AddBackrefToRegEx(unsigned BackrefNum); 112 113 /// ComputeMatchDistance - Compute an arbitrary estimate for the quality of 114 /// matching this pattern at the start of \arg Buffer; a distance of zero 115 /// should correspond to a perfect match. 116 unsigned ComputeMatchDistance(StringRef Buffer, 117 const StringMap<StringRef> &VariableTable) const; 118 119 /// \brief Evaluates expression and stores the result to \p Value. 120 /// \return true on success. false when the expression has invalid syntax. 121 bool EvaluateExpression(StringRef Expr, std::string &Value) const; 122 }; 123 124 125 bool Pattern::ParsePattern(StringRef PatternStr, SourceMgr &SM, 126 unsigned LineNumber) { 127 this->LineNumber = LineNumber; 128 PatternLoc = SMLoc::getFromPointer(PatternStr.data()); 129 130 // Ignore trailing whitespace. 131 while (!PatternStr.empty() && 132 (PatternStr.back() == ' ' || PatternStr.back() == '\t')) 133 PatternStr = PatternStr.substr(0, PatternStr.size()-1); 134 135 // Check that there is something on the line. 136 if (PatternStr.empty()) { 137 SM.PrintMessage(PatternLoc, SourceMgr::DK_Error, 138 "found empty check string with prefix '" + 139 CheckPrefix+":'"); 140 return true; 141 } 142 143 // Check to see if this is a fixed string, or if it has regex pieces. 144 if (PatternStr.size() < 2 || 145 (PatternStr.find("{{") == StringRef::npos && 146 PatternStr.find("[[") == StringRef::npos)) { 147 FixedStr = PatternStr; 148 return false; 149 } 150 151 // Paren value #0 is for the fully matched string. Any new parenthesized 152 // values add from there. 153 unsigned CurParen = 1; 154 155 // Otherwise, there is at least one regex piece. Build up the regex pattern 156 // by escaping scary characters in fixed strings, building up one big regex. 157 while (!PatternStr.empty()) { 158 // RegEx matches. 159 if (PatternStr.startswith("{{")) { 160 // This is the start of a regex match. Scan for the }}. 161 size_t End = PatternStr.find("}}"); 162 if (End == StringRef::npos) { 163 SM.PrintMessage(SMLoc::getFromPointer(PatternStr.data()), 164 SourceMgr::DK_Error, 165 "found start of regex string with no end '}}'"); 166 return true; 167 } 168 169 // Enclose {{}} patterns in parens just like [[]] even though we're not 170 // capturing the result for any purpose. This is required in case the 171 // expression contains an alternation like: CHECK: abc{{x|z}}def. We 172 // want this to turn into: "abc(x|z)def" not "abcx|zdef". 173 RegExStr += '('; 174 ++CurParen; 175 176 if (AddRegExToRegEx(PatternStr.substr(2, End-2), CurParen, SM)) 177 return true; 178 RegExStr += ')'; 179 180 PatternStr = PatternStr.substr(End+2); 181 continue; 182 } 183 184 // Named RegEx matches. These are of two forms: [[foo:.*]] which matches .* 185 // (or some other regex) and assigns it to the FileCheck variable 'foo'. The 186 // second form is [[foo]] which is a reference to foo. The variable name 187 // itself must be of the form "[a-zA-Z_][0-9a-zA-Z_]*", otherwise we reject 188 // it. This is to catch some common errors. 189 if (PatternStr.startswith("[[")) { 190 // Verify that it is terminated properly. 191 size_t End = PatternStr.find("]]"); 192 if (End == StringRef::npos) { 193 SM.PrintMessage(SMLoc::getFromPointer(PatternStr.data()), 194 SourceMgr::DK_Error, 195 "invalid named regex reference, no ]] found"); 196 return true; 197 } 198 199 StringRef MatchStr = PatternStr.substr(2, End-2); 200 PatternStr = PatternStr.substr(End+2); 201 202 // Get the regex name (e.g. "foo"). 203 size_t NameEnd = MatchStr.find(':'); 204 StringRef Name = MatchStr.substr(0, NameEnd); 205 206 if (Name.empty()) { 207 SM.PrintMessage(SMLoc::getFromPointer(Name.data()), SourceMgr::DK_Error, 208 "invalid name in named regex: empty name"); 209 return true; 210 } 211 212 // Verify that the name/expression is well formed. FileCheck currently 213 // supports @LINE, @LINE+number, @LINE-number expressions. The check here 214 // is relaxed, more strict check is performed in \c EvaluateExpression. 215 bool IsExpression = false; 216 for (unsigned i = 0, e = Name.size(); i != e; ++i) { 217 if (i == 0 && Name[i] == '@') { 218 if (NameEnd != StringRef::npos) { 219 SM.PrintMessage(SMLoc::getFromPointer(Name.data()), 220 SourceMgr::DK_Error, 221 "invalid name in named regex definition"); 222 return true; 223 } 224 IsExpression = true; 225 continue; 226 } 227 if (Name[i] != '_' && !isalnum(Name[i]) && 228 (!IsExpression || (Name[i] != '+' && Name[i] != '-'))) { 229 SM.PrintMessage(SMLoc::getFromPointer(Name.data()+i), 230 SourceMgr::DK_Error, "invalid name in named regex"); 231 return true; 232 } 233 } 234 235 // Name can't start with a digit. 236 if (isdigit(Name[0])) { 237 SM.PrintMessage(SMLoc::getFromPointer(Name.data()), SourceMgr::DK_Error, 238 "invalid name in named regex"); 239 return true; 240 } 241 242 // Handle [[foo]]. 243 if (NameEnd == StringRef::npos) { 244 // Handle variables that were defined earlier on the same line by 245 // emitting a backreference. 246 if (VariableDefs.find(Name) != VariableDefs.end()) { 247 unsigned VarParenNum = VariableDefs[Name]; 248 if (VarParenNum < 1 || VarParenNum > 9) { 249 SM.PrintMessage(SMLoc::getFromPointer(Name.data()), 250 SourceMgr::DK_Error, 251 "Can't back-reference more than 9 variables"); 252 return true; 253 } 254 AddBackrefToRegEx(VarParenNum); 255 } else { 256 VariableUses.push_back(std::make_pair(Name, RegExStr.size())); 257 } 258 continue; 259 } 260 261 // Handle [[foo:.*]]. 262 VariableDefs[Name] = CurParen; 263 RegExStr += '('; 264 ++CurParen; 265 266 if (AddRegExToRegEx(MatchStr.substr(NameEnd+1), CurParen, SM)) 267 return true; 268 269 RegExStr += ')'; 270 } 271 272 // Handle fixed string matches. 273 // Find the end, which is the start of the next regex. 274 size_t FixedMatchEnd = PatternStr.find("{{"); 275 FixedMatchEnd = std::min(FixedMatchEnd, PatternStr.find("[[")); 276 AddFixedStringToRegEx(PatternStr.substr(0, FixedMatchEnd), RegExStr); 277 PatternStr = PatternStr.substr(FixedMatchEnd); 278 } 279 280 return false; 281 } 282 283 void Pattern::AddFixedStringToRegEx(StringRef FixedStr, std::string &TheStr) { 284 // Add the characters from FixedStr to the regex, escaping as needed. This 285 // avoids "leaning toothpicks" in common patterns. 286 for (unsigned i = 0, e = FixedStr.size(); i != e; ++i) { 287 switch (FixedStr[i]) { 288 // These are the special characters matched in "p_ere_exp". 289 case '(': 290 case ')': 291 case '^': 292 case '$': 293 case '|': 294 case '*': 295 case '+': 296 case '?': 297 case '.': 298 case '[': 299 case '\\': 300 case '{': 301 TheStr += '\\'; 302 // FALL THROUGH. 303 default: 304 TheStr += FixedStr[i]; 305 break; 306 } 307 } 308 } 309 310 bool Pattern::AddRegExToRegEx(StringRef RS, unsigned &CurParen, 311 SourceMgr &SM) { 312 Regex R(RS); 313 std::string Error; 314 if (!R.isValid(Error)) { 315 SM.PrintMessage(SMLoc::getFromPointer(RS.data()), SourceMgr::DK_Error, 316 "invalid regex: " + Error); 317 return true; 318 } 319 320 RegExStr += RS.str(); 321 CurParen += R.getNumMatches(); 322 return false; 323 } 324 325 void Pattern::AddBackrefToRegEx(unsigned BackrefNum) { 326 assert(BackrefNum >= 1 && BackrefNum <= 9 && "Invalid backref number"); 327 std::string Backref = std::string("\\") + 328 std::string(1, '0' + BackrefNum); 329 RegExStr += Backref; 330 } 331 332 bool Pattern::EvaluateExpression(StringRef Expr, std::string &Value) const { 333 // The only supported expression is @LINE([\+-]\d+)? 334 if (!Expr.startswith("@LINE")) 335 return false; 336 Expr = Expr.substr(StringRef("@LINE").size()); 337 int Offset = 0; 338 if (!Expr.empty()) { 339 if (Expr[0] == '+') 340 Expr = Expr.substr(1); 341 else if (Expr[0] != '-') 342 return false; 343 if (Expr.getAsInteger(10, Offset)) 344 return false; 345 } 346 Value = llvm::itostr(LineNumber + Offset); 347 return true; 348 } 349 350 /// Match - Match the pattern string against the input buffer Buffer. This 351 /// returns the position that is matched or npos if there is no match. If 352 /// there is a match, the size of the matched string is returned in MatchLen. 353 size_t Pattern::Match(StringRef Buffer, size_t &MatchLen, 354 StringMap<StringRef> &VariableTable) const { 355 // If this is the EOF pattern, match it immediately. 356 if (MatchEOF) { 357 MatchLen = 0; 358 return Buffer.size(); 359 } 360 361 // If this is a fixed string pattern, just match it now. 362 if (!FixedStr.empty()) { 363 MatchLen = FixedStr.size(); 364 return Buffer.find(FixedStr); 365 } 366 367 // Regex match. 368 369 // If there are variable uses, we need to create a temporary string with the 370 // actual value. 371 StringRef RegExToMatch = RegExStr; 372 std::string TmpStr; 373 if (!VariableUses.empty()) { 374 TmpStr = RegExStr; 375 376 unsigned InsertOffset = 0; 377 for (unsigned i = 0, e = VariableUses.size(); i != e; ++i) { 378 std::string Value; 379 380 if (VariableUses[i].first[0] == '@') { 381 if (!EvaluateExpression(VariableUses[i].first, Value)) 382 return StringRef::npos; 383 } else { 384 StringMap<StringRef>::iterator it = 385 VariableTable.find(VariableUses[i].first); 386 // If the variable is undefined, return an error. 387 if (it == VariableTable.end()) 388 return StringRef::npos; 389 390 // Look up the value and escape it so that we can plop it into the regex. 391 AddFixedStringToRegEx(it->second, Value); 392 } 393 394 // Plop it into the regex at the adjusted offset. 395 TmpStr.insert(TmpStr.begin()+VariableUses[i].second+InsertOffset, 396 Value.begin(), Value.end()); 397 InsertOffset += Value.size(); 398 } 399 400 // Match the newly constructed regex. 401 RegExToMatch = TmpStr; 402 } 403 404 405 SmallVector<StringRef, 4> MatchInfo; 406 if (!Regex(RegExToMatch, Regex::Newline).match(Buffer, &MatchInfo)) 407 return StringRef::npos; 408 409 // Successful regex match. 410 assert(!MatchInfo.empty() && "Didn't get any match"); 411 StringRef FullMatch = MatchInfo[0]; 412 413 // If this defines any variables, remember their values. 414 for (std::map<StringRef, unsigned>::const_iterator I = VariableDefs.begin(), 415 E = VariableDefs.end(); 416 I != E; ++I) { 417 assert(I->second < MatchInfo.size() && "Internal paren error"); 418 VariableTable[I->first] = MatchInfo[I->second]; 419 } 420 421 MatchLen = FullMatch.size(); 422 return FullMatch.data()-Buffer.data(); 423 } 424 425 unsigned Pattern::ComputeMatchDistance(StringRef Buffer, 426 const StringMap<StringRef> &VariableTable) const { 427 // Just compute the number of matching characters. For regular expressions, we 428 // just compare against the regex itself and hope for the best. 429 // 430 // FIXME: One easy improvement here is have the regex lib generate a single 431 // example regular expression which matches, and use that as the example 432 // string. 433 StringRef ExampleString(FixedStr); 434 if (ExampleString.empty()) 435 ExampleString = RegExStr; 436 437 // Only compare up to the first line in the buffer, or the string size. 438 StringRef BufferPrefix = Buffer.substr(0, ExampleString.size()); 439 BufferPrefix = BufferPrefix.split('\n').first; 440 return BufferPrefix.edit_distance(ExampleString); 441 } 442 443 void Pattern::PrintFailureInfo(const SourceMgr &SM, StringRef Buffer, 444 const StringMap<StringRef> &VariableTable) const{ 445 // If this was a regular expression using variables, print the current 446 // variable values. 447 if (!VariableUses.empty()) { 448 for (unsigned i = 0, e = VariableUses.size(); i != e; ++i) { 449 SmallString<256> Msg; 450 raw_svector_ostream OS(Msg); 451 StringRef Var = VariableUses[i].first; 452 if (Var[0] == '@') { 453 std::string Value; 454 if (EvaluateExpression(Var, Value)) { 455 OS << "with expression \""; 456 OS.write_escaped(Var) << "\" equal to \""; 457 OS.write_escaped(Value) << "\""; 458 } else { 459 OS << "uses incorrect expression \""; 460 OS.write_escaped(Var) << "\""; 461 } 462 } else { 463 StringMap<StringRef>::const_iterator it = VariableTable.find(Var); 464 465 // Check for undefined variable references. 466 if (it == VariableTable.end()) { 467 OS << "uses undefined variable \""; 468 OS.write_escaped(Var) << "\""; 469 } else { 470 OS << "with variable \""; 471 OS.write_escaped(Var) << "\" equal to \""; 472 OS.write_escaped(it->second) << "\""; 473 } 474 } 475 476 SM.PrintMessage(SMLoc::getFromPointer(Buffer.data()), SourceMgr::DK_Note, 477 OS.str()); 478 } 479 } 480 481 // Attempt to find the closest/best fuzzy match. Usually an error happens 482 // because some string in the output didn't exactly match. In these cases, we 483 // would like to show the user a best guess at what "should have" matched, to 484 // save them having to actually check the input manually. 485 size_t NumLinesForward = 0; 486 size_t Best = StringRef::npos; 487 double BestQuality = 0; 488 489 // Use an arbitrary 4k limit on how far we will search. 490 for (size_t i = 0, e = std::min(size_t(4096), Buffer.size()); i != e; ++i) { 491 if (Buffer[i] == '\n') 492 ++NumLinesForward; 493 494 // Patterns have leading whitespace stripped, so skip whitespace when 495 // looking for something which looks like a pattern. 496 if (Buffer[i] == ' ' || Buffer[i] == '\t') 497 continue; 498 499 // Compute the "quality" of this match as an arbitrary combination of the 500 // match distance and the number of lines skipped to get to this match. 501 unsigned Distance = ComputeMatchDistance(Buffer.substr(i), VariableTable); 502 double Quality = Distance + (NumLinesForward / 100.); 503 504 if (Quality < BestQuality || Best == StringRef::npos) { 505 Best = i; 506 BestQuality = Quality; 507 } 508 } 509 510 // Print the "possible intended match here" line if we found something 511 // reasonable and not equal to what we showed in the "scanning from here" 512 // line. 513 if (Best && Best != StringRef::npos && BestQuality < 50) { 514 SM.PrintMessage(SMLoc::getFromPointer(Buffer.data() + Best), 515 SourceMgr::DK_Note, "possible intended match here"); 516 517 // FIXME: If we wanted to be really friendly we would show why the match 518 // failed, as it can be hard to spot simple one character differences. 519 } 520 } 521 522 //===----------------------------------------------------------------------===// 523 // Check Strings. 524 //===----------------------------------------------------------------------===// 525 526 /// CheckString - This is a check that we found in the input file. 527 struct CheckString { 528 /// Pat - The pattern to match. 529 Pattern Pat; 530 531 /// Loc - The location in the match file that the check string was specified. 532 SMLoc Loc; 533 534 /// IsCheckNext - This is true if this is a CHECK-NEXT: directive (as opposed 535 /// to a CHECK: directive. 536 bool IsCheckNext; 537 538 /// NotStrings - These are all of the strings that are disallowed from 539 /// occurring between this match string and the previous one (or start of 540 /// file). 541 std::vector<std::pair<SMLoc, Pattern> > NotStrings; 542 543 CheckString(const Pattern &P, SMLoc L, bool isCheckNext) 544 : Pat(P), Loc(L), IsCheckNext(isCheckNext) {} 545 }; 546 547 /// CanonicalizeInputFile - Remove duplicate horizontal space from the specified 548 /// memory buffer, free it, and return a new one. 549 static MemoryBuffer *CanonicalizeInputFile(MemoryBuffer *MB) { 550 SmallString<128> NewFile; 551 NewFile.reserve(MB->getBufferSize()); 552 553 for (const char *Ptr = MB->getBufferStart(), *End = MB->getBufferEnd(); 554 Ptr != End; ++Ptr) { 555 // Eliminate trailing dosish \r. 556 if (Ptr <= End - 2 && Ptr[0] == '\r' && Ptr[1] == '\n') { 557 continue; 558 } 559 560 // If current char is not a horizontal whitespace, dump it to output as is. 561 if (*Ptr != ' ' && *Ptr != '\t') { 562 NewFile.push_back(*Ptr); 563 continue; 564 } 565 566 // Otherwise, add one space and advance over neighboring space. 567 NewFile.push_back(' '); 568 while (Ptr+1 != End && 569 (Ptr[1] == ' ' || Ptr[1] == '\t')) 570 ++Ptr; 571 } 572 573 // Free the old buffer and return a new one. 574 MemoryBuffer *MB2 = 575 MemoryBuffer::getMemBufferCopy(NewFile.str(), MB->getBufferIdentifier()); 576 577 delete MB; 578 return MB2; 579 } 580 581 582 /// ReadCheckFile - Read the check file, which specifies the sequence of 583 /// expected strings. The strings are added to the CheckStrings vector. 584 /// Returns true in case of an error, false otherwise. 585 static bool ReadCheckFile(SourceMgr &SM, 586 std::vector<CheckString> &CheckStrings) { 587 OwningPtr<MemoryBuffer> File; 588 if (error_code ec = 589 MemoryBuffer::getFileOrSTDIN(CheckFilename.c_str(), File)) { 590 errs() << "Could not open check file '" << CheckFilename << "': " 591 << ec.message() << '\n'; 592 return true; 593 } 594 MemoryBuffer *F = File.take(); 595 596 // If we want to canonicalize whitespace, strip excess whitespace from the 597 // buffer containing the CHECK lines. 598 if (!NoCanonicalizeWhiteSpace) 599 F = CanonicalizeInputFile(F); 600 601 SM.AddNewSourceBuffer(F, SMLoc()); 602 603 // Find all instances of CheckPrefix followed by : in the file. 604 StringRef Buffer = F->getBuffer(); 605 std::vector<std::pair<SMLoc, Pattern> > NotMatches; 606 607 // LineNumber keeps track of the line on which CheckPrefix instances are 608 // found. 609 unsigned LineNumber = 1; 610 611 while (1) { 612 // See if Prefix occurs in the memory buffer. 613 size_t PrefixLoc = Buffer.find(CheckPrefix); 614 // If we didn't find a match, we're done. 615 if (PrefixLoc == StringRef::npos) 616 break; 617 618 LineNumber += Buffer.substr(0, PrefixLoc).count('\n'); 619 620 Buffer = Buffer.substr(PrefixLoc); 621 622 const char *CheckPrefixStart = Buffer.data(); 623 624 // When we find a check prefix, keep track of whether we find CHECK: or 625 // CHECK-NEXT: 626 bool IsCheckNext = false, IsCheckNot = false; 627 628 // Verify that the : is present after the prefix. 629 if (Buffer[CheckPrefix.size()] == ':') { 630 Buffer = Buffer.substr(CheckPrefix.size()+1); 631 } else if (Buffer.size() > CheckPrefix.size()+6 && 632 memcmp(Buffer.data()+CheckPrefix.size(), "-NEXT:", 6) == 0) { 633 Buffer = Buffer.substr(CheckPrefix.size()+6); 634 IsCheckNext = true; 635 } else if (Buffer.size() > CheckPrefix.size()+5 && 636 memcmp(Buffer.data()+CheckPrefix.size(), "-NOT:", 5) == 0) { 637 Buffer = Buffer.substr(CheckPrefix.size()+5); 638 IsCheckNot = true; 639 } else { 640 Buffer = Buffer.substr(1); 641 continue; 642 } 643 644 // Okay, we found the prefix, yay. Remember the rest of the line, but 645 // ignore leading and trailing whitespace. 646 Buffer = Buffer.substr(Buffer.find_first_not_of(" \t")); 647 648 // Scan ahead to the end of line. 649 size_t EOL = Buffer.find_first_of("\n\r"); 650 651 // Remember the location of the start of the pattern, for diagnostics. 652 SMLoc PatternLoc = SMLoc::getFromPointer(Buffer.data()); 653 654 // Parse the pattern. 655 Pattern P; 656 if (P.ParsePattern(Buffer.substr(0, EOL), SM, LineNumber)) 657 return true; 658 659 Buffer = Buffer.substr(EOL); 660 661 // Verify that CHECK-NEXT lines have at least one CHECK line before them. 662 if (IsCheckNext && CheckStrings.empty()) { 663 SM.PrintMessage(SMLoc::getFromPointer(CheckPrefixStart), 664 SourceMgr::DK_Error, 665 "found '"+CheckPrefix+"-NEXT:' without previous '"+ 666 CheckPrefix+ ": line"); 667 return true; 668 } 669 670 // Handle CHECK-NOT. 671 if (IsCheckNot) { 672 NotMatches.push_back(std::make_pair(SMLoc::getFromPointer(Buffer.data()), 673 P)); 674 continue; 675 } 676 677 // Okay, add the string we captured to the output vector and move on. 678 CheckStrings.push_back(CheckString(P, 679 PatternLoc, 680 IsCheckNext)); 681 std::swap(NotMatches, CheckStrings.back().NotStrings); 682 } 683 684 // Add an EOF pattern for any trailing CHECK-NOTs. 685 if (!NotMatches.empty()) { 686 CheckStrings.push_back(CheckString(Pattern(true), 687 SMLoc::getFromPointer(Buffer.data()), 688 false)); 689 std::swap(NotMatches, CheckStrings.back().NotStrings); 690 } 691 692 if (CheckStrings.empty()) { 693 errs() << "error: no check strings found with prefix '" << CheckPrefix 694 << ":'\n"; 695 return true; 696 } 697 698 return false; 699 } 700 701 static void PrintCheckFailed(const SourceMgr &SM, const CheckString &CheckStr, 702 StringRef Buffer, 703 StringMap<StringRef> &VariableTable) { 704 // Otherwise, we have an error, emit an error message. 705 SM.PrintMessage(CheckStr.Loc, SourceMgr::DK_Error, 706 "expected string not found in input"); 707 708 // Print the "scanning from here" line. If the current position is at the 709 // end of a line, advance to the start of the next line. 710 Buffer = Buffer.substr(Buffer.find_first_not_of(" \t\n\r")); 711 712 SM.PrintMessage(SMLoc::getFromPointer(Buffer.data()), SourceMgr::DK_Note, 713 "scanning from here"); 714 715 // Allow the pattern to print additional information if desired. 716 CheckStr.Pat.PrintFailureInfo(SM, Buffer, VariableTable); 717 } 718 719 /// CountNumNewlinesBetween - Count the number of newlines in the specified 720 /// range. 721 static unsigned CountNumNewlinesBetween(StringRef Range) { 722 unsigned NumNewLines = 0; 723 while (1) { 724 // Scan for newline. 725 Range = Range.substr(Range.find_first_of("\n\r")); 726 if (Range.empty()) return NumNewLines; 727 728 ++NumNewLines; 729 730 // Handle \n\r and \r\n as a single newline. 731 if (Range.size() > 1 && 732 (Range[1] == '\n' || Range[1] == '\r') && 733 (Range[0] != Range[1])) 734 Range = Range.substr(1); 735 Range = Range.substr(1); 736 } 737 } 738 739 int main(int argc, char **argv) { 740 sys::PrintStackTraceOnErrorSignal(); 741 PrettyStackTraceProgram X(argc, argv); 742 cl::ParseCommandLineOptions(argc, argv); 743 744 SourceMgr SM; 745 746 // Read the expected strings from the check file. 747 std::vector<CheckString> CheckStrings; 748 if (ReadCheckFile(SM, CheckStrings)) 749 return 2; 750 751 // Open the file to check and add it to SourceMgr. 752 OwningPtr<MemoryBuffer> File; 753 if (error_code ec = 754 MemoryBuffer::getFileOrSTDIN(InputFilename.c_str(), File)) { 755 errs() << "Could not open input file '" << InputFilename << "': " 756 << ec.message() << '\n'; 757 return 2; 758 } 759 MemoryBuffer *F = File.take(); 760 761 if (F->getBufferSize() == 0) { 762 errs() << "FileCheck error: '" << InputFilename << "' is empty.\n"; 763 return 2; 764 } 765 766 // Remove duplicate spaces in the input file if requested. 767 if (!NoCanonicalizeWhiteSpace) 768 F = CanonicalizeInputFile(F); 769 770 SM.AddNewSourceBuffer(F, SMLoc()); 771 772 /// VariableTable - This holds all the current filecheck variables. 773 StringMap<StringRef> VariableTable; 774 775 // Check that we have all of the expected strings, in order, in the input 776 // file. 777 StringRef Buffer = F->getBuffer(); 778 779 const char *LastMatch = Buffer.data(); 780 781 for (unsigned StrNo = 0, e = CheckStrings.size(); StrNo != e; ++StrNo) { 782 const CheckString &CheckStr = CheckStrings[StrNo]; 783 784 StringRef SearchFrom = Buffer; 785 786 // Find StrNo in the file. 787 size_t MatchLen = 0; 788 size_t MatchPos = CheckStr.Pat.Match(Buffer, MatchLen, VariableTable); 789 Buffer = Buffer.substr(MatchPos); 790 791 // If we didn't find a match, reject the input. 792 if (MatchPos == StringRef::npos) { 793 PrintCheckFailed(SM, CheckStr, SearchFrom, VariableTable); 794 return 1; 795 } 796 797 StringRef SkippedRegion(LastMatch, Buffer.data()-LastMatch); 798 799 // If this check is a "CHECK-NEXT", verify that the previous match was on 800 // the previous line (i.e. that there is one newline between them). 801 if (CheckStr.IsCheckNext) { 802 // Count the number of newlines between the previous match and this one. 803 assert(LastMatch != F->getBufferStart() && 804 "CHECK-NEXT can't be the first check in a file"); 805 806 unsigned NumNewLines = CountNumNewlinesBetween(SkippedRegion); 807 if (NumNewLines == 0) { 808 SM.PrintMessage(CheckStr.Loc, SourceMgr::DK_Error, 809 CheckPrefix+"-NEXT: is on the same line as previous match"); 810 SM.PrintMessage(SMLoc::getFromPointer(Buffer.data()), 811 SourceMgr::DK_Note, "'next' match was here"); 812 SM.PrintMessage(SMLoc::getFromPointer(LastMatch), SourceMgr::DK_Note, 813 "previous match was here"); 814 return 1; 815 } 816 817 if (NumNewLines != 1) { 818 SM.PrintMessage(CheckStr.Loc, SourceMgr::DK_Error, CheckPrefix+ 819 "-NEXT: is not on the line after the previous match"); 820 SM.PrintMessage(SMLoc::getFromPointer(Buffer.data()), 821 SourceMgr::DK_Note, "'next' match was here"); 822 SM.PrintMessage(SMLoc::getFromPointer(LastMatch), SourceMgr::DK_Note, 823 "previous match was here"); 824 return 1; 825 } 826 } 827 828 // If this match had "not strings", verify that they don't exist in the 829 // skipped region. 830 for (unsigned ChunkNo = 0, e = CheckStr.NotStrings.size(); 831 ChunkNo != e; ++ChunkNo) { 832 size_t MatchLen = 0; 833 size_t Pos = CheckStr.NotStrings[ChunkNo].second.Match(SkippedRegion, 834 MatchLen, 835 VariableTable); 836 if (Pos == StringRef::npos) continue; 837 838 SM.PrintMessage(SMLoc::getFromPointer(LastMatch+Pos), SourceMgr::DK_Error, 839 CheckPrefix+"-NOT: string occurred!"); 840 SM.PrintMessage(CheckStr.NotStrings[ChunkNo].first, SourceMgr::DK_Note, 841 CheckPrefix+"-NOT: pattern specified here"); 842 return 1; 843 } 844 845 846 // Otherwise, everything is good. Step over the matched text and remember 847 // the position after the match as the end of the last match. 848 Buffer = Buffer.substr(MatchLen); 849 LastMatch = Buffer.data(); 850 } 851 852 return 0; 853 } 854