1 //===- llvm/unittest/Support/CommandLineTest.cpp - CommandLine tests ------===// 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 "llvm/Support/CommandLine.h" 10 #include "llvm/ADT/STLExtras.h" 11 #include "llvm/ADT/SmallString.h" 12 #include "llvm/ADT/Triple.h" 13 #include "llvm/Config/config.h" 14 #include "llvm/Support/FileSystem.h" 15 #include "llvm/Support/InitLLVM.h" 16 #include "llvm/Support/MemoryBuffer.h" 17 #include "llvm/Support/Path.h" 18 #include "llvm/Support/Program.h" 19 #include "llvm/Support/StringSaver.h" 20 #include "gtest/gtest.h" 21 #include <fstream> 22 #include <stdlib.h> 23 #include <string> 24 25 using namespace llvm; 26 27 namespace { 28 29 class TempEnvVar { 30 public: 31 TempEnvVar(const char *name, const char *value) 32 : name(name) { 33 const char *old_value = getenv(name); 34 EXPECT_EQ(nullptr, old_value) << old_value; 35 #if HAVE_SETENV 36 setenv(name, value, true); 37 #else 38 # define SKIP_ENVIRONMENT_TESTS 39 #endif 40 } 41 42 ~TempEnvVar() { 43 #if HAVE_SETENV 44 // Assume setenv and unsetenv come together. 45 unsetenv(name); 46 #else 47 (void)name; // Suppress -Wunused-private-field. 48 #endif 49 } 50 51 private: 52 const char *const name; 53 }; 54 55 template <typename T, typename Base = cl::opt<T>> 56 class StackOption : public Base { 57 public: 58 template <class... Ts> 59 explicit StackOption(Ts &&... Ms) : Base(std::forward<Ts>(Ms)...) {} 60 61 ~StackOption() override { this->removeArgument(); } 62 63 template <class DT> StackOption<T> &operator=(const DT &V) { 64 this->setValue(V); 65 return *this; 66 } 67 }; 68 69 class StackSubCommand : public cl::SubCommand { 70 public: 71 StackSubCommand(StringRef Name, 72 StringRef Description = StringRef()) 73 : SubCommand(Name, Description) {} 74 75 StackSubCommand() : SubCommand() {} 76 77 ~StackSubCommand() { unregisterSubCommand(); } 78 }; 79 80 81 cl::OptionCategory TestCategory("Test Options", "Description"); 82 TEST(CommandLineTest, ModifyExisitingOption) { 83 StackOption<int> TestOption("test-option", cl::desc("old description")); 84 85 static const char Description[] = "New description"; 86 static const char ArgString[] = "new-test-option"; 87 static const char ValueString[] = "Integer"; 88 89 StringMap<cl::Option *> &Map = 90 cl::getRegisteredOptions(*cl::TopLevelSubCommand); 91 92 ASSERT_TRUE(Map.count("test-option") == 1) << 93 "Could not find option in map."; 94 95 cl::Option *Retrieved = Map["test-option"]; 96 ASSERT_EQ(&TestOption, Retrieved) << "Retrieved wrong option."; 97 98 ASSERT_EQ(&cl::GeneralCategory,Retrieved->Category) << 99 "Incorrect default option category."; 100 101 Retrieved->setCategory(TestCategory); 102 ASSERT_EQ(&TestCategory,Retrieved->Category) << 103 "Failed to modify option's option category."; 104 105 Retrieved->setDescription(Description); 106 ASSERT_STREQ(Retrieved->HelpStr.data(), Description) 107 << "Changing option description failed."; 108 109 Retrieved->setArgStr(ArgString); 110 ASSERT_STREQ(ArgString, Retrieved->ArgStr.data()) 111 << "Failed to modify option's Argument string."; 112 113 Retrieved->setValueStr(ValueString); 114 ASSERT_STREQ(Retrieved->ValueStr.data(), ValueString) 115 << "Failed to modify option's Value string."; 116 117 Retrieved->setHiddenFlag(cl::Hidden); 118 ASSERT_EQ(cl::Hidden, TestOption.getOptionHiddenFlag()) << 119 "Failed to modify option's hidden flag."; 120 } 121 #ifndef SKIP_ENVIRONMENT_TESTS 122 123 const char test_env_var[] = "LLVM_TEST_COMMAND_LINE_FLAGS"; 124 125 cl::opt<std::string> EnvironmentTestOption("env-test-opt"); 126 TEST(CommandLineTest, ParseEnvironment) { 127 TempEnvVar TEV(test_env_var, "-env-test-opt=hello"); 128 EXPECT_EQ("", EnvironmentTestOption); 129 cl::ParseEnvironmentOptions("CommandLineTest", test_env_var); 130 EXPECT_EQ("hello", EnvironmentTestOption); 131 } 132 133 // This test used to make valgrind complain 134 // ("Conditional jump or move depends on uninitialised value(s)") 135 // 136 // Warning: Do not run any tests after this one that try to gain access to 137 // registered command line options because this will likely result in a 138 // SEGFAULT. This can occur because the cl::opt in the test below is declared 139 // on the stack which will be destroyed after the test completes but the 140 // command line system will still hold a pointer to a deallocated cl::Option. 141 TEST(CommandLineTest, ParseEnvironmentToLocalVar) { 142 // Put cl::opt on stack to check for proper initialization of fields. 143 StackOption<std::string> EnvironmentTestOptionLocal("env-test-opt-local"); 144 TempEnvVar TEV(test_env_var, "-env-test-opt-local=hello-local"); 145 EXPECT_EQ("", EnvironmentTestOptionLocal); 146 cl::ParseEnvironmentOptions("CommandLineTest", test_env_var); 147 EXPECT_EQ("hello-local", EnvironmentTestOptionLocal); 148 } 149 150 #endif // SKIP_ENVIRONMENT_TESTS 151 152 TEST(CommandLineTest, UseOptionCategory) { 153 StackOption<int> TestOption2("test-option", cl::cat(TestCategory)); 154 155 ASSERT_EQ(&TestCategory,TestOption2.Category) << "Failed to assign Option " 156 "Category."; 157 } 158 159 typedef void ParserFunction(StringRef Source, StringSaver &Saver, 160 SmallVectorImpl<const char *> &NewArgv, 161 bool MarkEOLs); 162 163 void testCommandLineTokenizer(ParserFunction *parse, StringRef Input, 164 const char *const Output[], size_t OutputSize) { 165 SmallVector<const char *, 0> Actual; 166 BumpPtrAllocator A; 167 StringSaver Saver(A); 168 parse(Input, Saver, Actual, /*MarkEOLs=*/false); 169 EXPECT_EQ(OutputSize, Actual.size()); 170 for (unsigned I = 0, E = Actual.size(); I != E; ++I) { 171 if (I < OutputSize) { 172 EXPECT_STREQ(Output[I], Actual[I]); 173 } 174 } 175 } 176 177 TEST(CommandLineTest, TokenizeGNUCommandLine) { 178 const char Input[] = 179 "foo\\ bar \"foo bar\" \'foo bar\' 'foo\\\\bar' -DFOO=bar\\(\\) " 180 "foo\"bar\"baz C:\\\\src\\\\foo.cpp \"C:\\src\\foo.cpp\""; 181 const char *const Output[] = { 182 "foo bar", "foo bar", "foo bar", "foo\\bar", 183 "-DFOO=bar()", "foobarbaz", "C:\\src\\foo.cpp", "C:srcfoo.cpp"}; 184 testCommandLineTokenizer(cl::TokenizeGNUCommandLine, Input, Output, 185 array_lengthof(Output)); 186 } 187 188 TEST(CommandLineTest, TokenizeWindowsCommandLine1) { 189 const char Input[] = "a\\b c\\\\d e\\\\\"f g\" h\\\"i j\\\\\\\"k \"lmn\" o pqr " 190 "\"st \\\"u\" \\v"; 191 const char *const Output[] = { "a\\b", "c\\\\d", "e\\f g", "h\"i", "j\\\"k", 192 "lmn", "o", "pqr", "st \"u", "\\v" }; 193 testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input, Output, 194 array_lengthof(Output)); 195 } 196 197 TEST(CommandLineTest, TokenizeWindowsCommandLine2) { 198 const char Input[] = "clang -c -DFOO=\"\"\"ABC\"\"\" x.cpp"; 199 const char *const Output[] = { "clang", "-c", "-DFOO=\"ABC\"", "x.cpp"}; 200 testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input, Output, 201 array_lengthof(Output)); 202 } 203 204 TEST(CommandLineTest, TokenizeConfigFile1) { 205 const char *Input = "\\"; 206 const char *const Output[] = { "\\" }; 207 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 208 array_lengthof(Output)); 209 } 210 211 TEST(CommandLineTest, TokenizeConfigFile2) { 212 const char *Input = "\\abc"; 213 const char *const Output[] = { "abc" }; 214 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 215 array_lengthof(Output)); 216 } 217 218 TEST(CommandLineTest, TokenizeConfigFile3) { 219 const char *Input = "abc\\"; 220 const char *const Output[] = { "abc\\" }; 221 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 222 array_lengthof(Output)); 223 } 224 225 TEST(CommandLineTest, TokenizeConfigFile4) { 226 const char *Input = "abc\\\n123"; 227 const char *const Output[] = { "abc123" }; 228 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 229 array_lengthof(Output)); 230 } 231 232 TEST(CommandLineTest, TokenizeConfigFile5) { 233 const char *Input = "abc\\\r\n123"; 234 const char *const Output[] = { "abc123" }; 235 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 236 array_lengthof(Output)); 237 } 238 239 TEST(CommandLineTest, TokenizeConfigFile6) { 240 const char *Input = "abc\\\n"; 241 const char *const Output[] = { "abc" }; 242 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 243 array_lengthof(Output)); 244 } 245 246 TEST(CommandLineTest, TokenizeConfigFile7) { 247 const char *Input = "abc\\\r\n"; 248 const char *const Output[] = { "abc" }; 249 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 250 array_lengthof(Output)); 251 } 252 253 TEST(CommandLineTest, TokenizeConfigFile8) { 254 SmallVector<const char *, 0> Actual; 255 BumpPtrAllocator A; 256 StringSaver Saver(A); 257 cl::tokenizeConfigFile("\\\n", Saver, Actual, /*MarkEOLs=*/false); 258 EXPECT_TRUE(Actual.empty()); 259 } 260 261 TEST(CommandLineTest, TokenizeConfigFile9) { 262 SmallVector<const char *, 0> Actual; 263 BumpPtrAllocator A; 264 StringSaver Saver(A); 265 cl::tokenizeConfigFile("\\\r\n", Saver, Actual, /*MarkEOLs=*/false); 266 EXPECT_TRUE(Actual.empty()); 267 } 268 269 TEST(CommandLineTest, TokenizeConfigFile10) { 270 const char *Input = "\\\nabc"; 271 const char *const Output[] = { "abc" }; 272 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 273 array_lengthof(Output)); 274 } 275 276 TEST(CommandLineTest, TokenizeConfigFile11) { 277 const char *Input = "\\\r\nabc"; 278 const char *const Output[] = { "abc" }; 279 testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output, 280 array_lengthof(Output)); 281 } 282 283 TEST(CommandLineTest, AliasesWithArguments) { 284 static const size_t ARGC = 3; 285 const char *const Inputs[][ARGC] = { 286 { "-tool", "-actual=x", "-extra" }, 287 { "-tool", "-actual", "x" }, 288 { "-tool", "-alias=x", "-extra" }, 289 { "-tool", "-alias", "x" } 290 }; 291 292 for (size_t i = 0, e = array_lengthof(Inputs); i < e; ++i) { 293 StackOption<std::string> Actual("actual"); 294 StackOption<bool> Extra("extra"); 295 StackOption<std::string> Input(cl::Positional); 296 297 cl::alias Alias("alias", llvm::cl::aliasopt(Actual)); 298 299 cl::ParseCommandLineOptions(ARGC, Inputs[i]); 300 EXPECT_EQ("x", Actual); 301 EXPECT_EQ(0, Input.getNumOccurrences()); 302 303 Alias.removeArgument(); 304 } 305 } 306 307 void testAliasRequired(int argc, const char *const *argv) { 308 StackOption<std::string> Option("option", cl::Required); 309 cl::alias Alias("o", llvm::cl::aliasopt(Option)); 310 311 cl::ParseCommandLineOptions(argc, argv); 312 EXPECT_EQ("x", Option); 313 EXPECT_EQ(1, Option.getNumOccurrences()); 314 315 Alias.removeArgument(); 316 } 317 318 TEST(CommandLineTest, AliasRequired) { 319 const char *opts1[] = { "-tool", "-option=x" }; 320 const char *opts2[] = { "-tool", "-o", "x" }; 321 testAliasRequired(array_lengthof(opts1), opts1); 322 testAliasRequired(array_lengthof(opts2), opts2); 323 } 324 325 TEST(CommandLineTest, HideUnrelatedOptions) { 326 StackOption<int> TestOption1("hide-option-1"); 327 StackOption<int> TestOption2("hide-option-2", cl::cat(TestCategory)); 328 329 cl::HideUnrelatedOptions(TestCategory); 330 331 ASSERT_EQ(cl::ReallyHidden, TestOption1.getOptionHiddenFlag()) 332 << "Failed to hide extra option."; 333 ASSERT_EQ(cl::NotHidden, TestOption2.getOptionHiddenFlag()) 334 << "Hid extra option that should be visable."; 335 336 StringMap<cl::Option *> &Map = 337 cl::getRegisteredOptions(*cl::TopLevelSubCommand); 338 ASSERT_EQ(cl::NotHidden, Map["help"]->getOptionHiddenFlag()) 339 << "Hid default option that should be visable."; 340 } 341 342 cl::OptionCategory TestCategory2("Test Options set 2", "Description"); 343 344 TEST(CommandLineTest, HideUnrelatedOptionsMulti) { 345 StackOption<int> TestOption1("multi-hide-option-1"); 346 StackOption<int> TestOption2("multi-hide-option-2", cl::cat(TestCategory)); 347 StackOption<int> TestOption3("multi-hide-option-3", cl::cat(TestCategory2)); 348 349 const cl::OptionCategory *VisibleCategories[] = {&TestCategory, 350 &TestCategory2}; 351 352 cl::HideUnrelatedOptions(makeArrayRef(VisibleCategories)); 353 354 ASSERT_EQ(cl::ReallyHidden, TestOption1.getOptionHiddenFlag()) 355 << "Failed to hide extra option."; 356 ASSERT_EQ(cl::NotHidden, TestOption2.getOptionHiddenFlag()) 357 << "Hid extra option that should be visable."; 358 ASSERT_EQ(cl::NotHidden, TestOption3.getOptionHiddenFlag()) 359 << "Hid extra option that should be visable."; 360 361 StringMap<cl::Option *> &Map = 362 cl::getRegisteredOptions(*cl::TopLevelSubCommand); 363 ASSERT_EQ(cl::NotHidden, Map["help"]->getOptionHiddenFlag()) 364 << "Hid default option that should be visable."; 365 } 366 367 TEST(CommandLineTest, SetValueInSubcategories) { 368 cl::ResetCommandLineParser(); 369 370 StackSubCommand SC1("sc1", "First subcommand"); 371 StackSubCommand SC2("sc2", "Second subcommand"); 372 373 StackOption<bool> TopLevelOpt("top-level", cl::init(false)); 374 StackOption<bool> SC1Opt("sc1", cl::sub(SC1), cl::init(false)); 375 StackOption<bool> SC2Opt("sc2", cl::sub(SC2), cl::init(false)); 376 377 EXPECT_FALSE(TopLevelOpt); 378 EXPECT_FALSE(SC1Opt); 379 EXPECT_FALSE(SC2Opt); 380 const char *args[] = {"prog", "-top-level"}; 381 EXPECT_TRUE( 382 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 383 EXPECT_TRUE(TopLevelOpt); 384 EXPECT_FALSE(SC1Opt); 385 EXPECT_FALSE(SC2Opt); 386 387 TopLevelOpt = false; 388 389 cl::ResetAllOptionOccurrences(); 390 EXPECT_FALSE(TopLevelOpt); 391 EXPECT_FALSE(SC1Opt); 392 EXPECT_FALSE(SC2Opt); 393 const char *args2[] = {"prog", "sc1", "-sc1"}; 394 EXPECT_TRUE( 395 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 396 EXPECT_FALSE(TopLevelOpt); 397 EXPECT_TRUE(SC1Opt); 398 EXPECT_FALSE(SC2Opt); 399 400 SC1Opt = false; 401 402 cl::ResetAllOptionOccurrences(); 403 EXPECT_FALSE(TopLevelOpt); 404 EXPECT_FALSE(SC1Opt); 405 EXPECT_FALSE(SC2Opt); 406 const char *args3[] = {"prog", "sc2", "-sc2"}; 407 EXPECT_TRUE( 408 cl::ParseCommandLineOptions(3, args3, StringRef(), &llvm::nulls())); 409 EXPECT_FALSE(TopLevelOpt); 410 EXPECT_FALSE(SC1Opt); 411 EXPECT_TRUE(SC2Opt); 412 } 413 414 TEST(CommandLineTest, LookupFailsInWrongSubCommand) { 415 cl::ResetCommandLineParser(); 416 417 StackSubCommand SC1("sc1", "First subcommand"); 418 StackSubCommand SC2("sc2", "Second subcommand"); 419 420 StackOption<bool> SC1Opt("sc1", cl::sub(SC1), cl::init(false)); 421 StackOption<bool> SC2Opt("sc2", cl::sub(SC2), cl::init(false)); 422 423 std::string Errs; 424 raw_string_ostream OS(Errs); 425 426 const char *args[] = {"prog", "sc1", "-sc2"}; 427 EXPECT_FALSE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS)); 428 OS.flush(); 429 EXPECT_FALSE(Errs.empty()); 430 } 431 432 TEST(CommandLineTest, AddToAllSubCommands) { 433 cl::ResetCommandLineParser(); 434 435 StackSubCommand SC1("sc1", "First subcommand"); 436 StackOption<bool> AllOpt("everywhere", cl::sub(*cl::AllSubCommands), 437 cl::init(false)); 438 StackSubCommand SC2("sc2", "Second subcommand"); 439 440 const char *args[] = {"prog", "-everywhere"}; 441 const char *args2[] = {"prog", "sc1", "-everywhere"}; 442 const char *args3[] = {"prog", "sc2", "-everywhere"}; 443 444 std::string Errs; 445 raw_string_ostream OS(Errs); 446 447 EXPECT_FALSE(AllOpt); 448 EXPECT_TRUE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS)); 449 EXPECT_TRUE(AllOpt); 450 451 AllOpt = false; 452 453 cl::ResetAllOptionOccurrences(); 454 EXPECT_FALSE(AllOpt); 455 EXPECT_TRUE(cl::ParseCommandLineOptions(3, args2, StringRef(), &OS)); 456 EXPECT_TRUE(AllOpt); 457 458 AllOpt = false; 459 460 cl::ResetAllOptionOccurrences(); 461 EXPECT_FALSE(AllOpt); 462 EXPECT_TRUE(cl::ParseCommandLineOptions(3, args3, StringRef(), &OS)); 463 EXPECT_TRUE(AllOpt); 464 465 // Since all parsing succeeded, the error message should be empty. 466 OS.flush(); 467 EXPECT_TRUE(Errs.empty()); 468 } 469 470 TEST(CommandLineTest, ReparseCommandLineOptions) { 471 cl::ResetCommandLineParser(); 472 473 StackOption<bool> TopLevelOpt("top-level", cl::sub(*cl::TopLevelSubCommand), 474 cl::init(false)); 475 476 const char *args[] = {"prog", "-top-level"}; 477 478 EXPECT_FALSE(TopLevelOpt); 479 EXPECT_TRUE( 480 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 481 EXPECT_TRUE(TopLevelOpt); 482 483 TopLevelOpt = false; 484 485 cl::ResetAllOptionOccurrences(); 486 EXPECT_FALSE(TopLevelOpt); 487 EXPECT_TRUE( 488 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 489 EXPECT_TRUE(TopLevelOpt); 490 } 491 492 TEST(CommandLineTest, RemoveFromRegularSubCommand) { 493 cl::ResetCommandLineParser(); 494 495 StackSubCommand SC("sc", "Subcommand"); 496 StackOption<bool> RemoveOption("remove-option", cl::sub(SC), cl::init(false)); 497 StackOption<bool> KeepOption("keep-option", cl::sub(SC), cl::init(false)); 498 499 const char *args[] = {"prog", "sc", "-remove-option"}; 500 501 std::string Errs; 502 raw_string_ostream OS(Errs); 503 504 EXPECT_FALSE(RemoveOption); 505 EXPECT_TRUE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS)); 506 EXPECT_TRUE(RemoveOption); 507 OS.flush(); 508 EXPECT_TRUE(Errs.empty()); 509 510 RemoveOption.removeArgument(); 511 512 cl::ResetAllOptionOccurrences(); 513 EXPECT_FALSE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS)); 514 OS.flush(); 515 EXPECT_FALSE(Errs.empty()); 516 } 517 518 TEST(CommandLineTest, RemoveFromTopLevelSubCommand) { 519 cl::ResetCommandLineParser(); 520 521 StackOption<bool> TopLevelRemove( 522 "top-level-remove", cl::sub(*cl::TopLevelSubCommand), cl::init(false)); 523 StackOption<bool> TopLevelKeep( 524 "top-level-keep", cl::sub(*cl::TopLevelSubCommand), cl::init(false)); 525 526 const char *args[] = {"prog", "-top-level-remove"}; 527 528 EXPECT_FALSE(TopLevelRemove); 529 EXPECT_TRUE( 530 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 531 EXPECT_TRUE(TopLevelRemove); 532 533 TopLevelRemove.removeArgument(); 534 535 cl::ResetAllOptionOccurrences(); 536 EXPECT_FALSE( 537 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 538 } 539 540 TEST(CommandLineTest, RemoveFromAllSubCommands) { 541 cl::ResetCommandLineParser(); 542 543 StackSubCommand SC1("sc1", "First Subcommand"); 544 StackSubCommand SC2("sc2", "Second Subcommand"); 545 StackOption<bool> RemoveOption("remove-option", cl::sub(*cl::AllSubCommands), 546 cl::init(false)); 547 StackOption<bool> KeepOption("keep-option", cl::sub(*cl::AllSubCommands), 548 cl::init(false)); 549 550 const char *args0[] = {"prog", "-remove-option"}; 551 const char *args1[] = {"prog", "sc1", "-remove-option"}; 552 const char *args2[] = {"prog", "sc2", "-remove-option"}; 553 554 // It should work for all subcommands including the top-level. 555 EXPECT_FALSE(RemoveOption); 556 EXPECT_TRUE( 557 cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls())); 558 EXPECT_TRUE(RemoveOption); 559 560 RemoveOption = false; 561 562 cl::ResetAllOptionOccurrences(); 563 EXPECT_FALSE(RemoveOption); 564 EXPECT_TRUE( 565 cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls())); 566 EXPECT_TRUE(RemoveOption); 567 568 RemoveOption = false; 569 570 cl::ResetAllOptionOccurrences(); 571 EXPECT_FALSE(RemoveOption); 572 EXPECT_TRUE( 573 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 574 EXPECT_TRUE(RemoveOption); 575 576 RemoveOption.removeArgument(); 577 578 // It should not work for any subcommands including the top-level. 579 cl::ResetAllOptionOccurrences(); 580 EXPECT_FALSE( 581 cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls())); 582 cl::ResetAllOptionOccurrences(); 583 EXPECT_FALSE( 584 cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls())); 585 cl::ResetAllOptionOccurrences(); 586 EXPECT_FALSE( 587 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 588 } 589 590 TEST(CommandLineTest, GetRegisteredSubcommands) { 591 cl::ResetCommandLineParser(); 592 593 StackSubCommand SC1("sc1", "First Subcommand"); 594 StackOption<bool> Opt1("opt1", cl::sub(SC1), cl::init(false)); 595 StackSubCommand SC2("sc2", "Second subcommand"); 596 StackOption<bool> Opt2("opt2", cl::sub(SC2), cl::init(false)); 597 598 const char *args0[] = {"prog", "sc1"}; 599 const char *args1[] = {"prog", "sc2"}; 600 601 EXPECT_TRUE( 602 cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls())); 603 EXPECT_FALSE(Opt1); 604 EXPECT_FALSE(Opt2); 605 for (auto *S : cl::getRegisteredSubcommands()) { 606 if (*S) { 607 EXPECT_EQ("sc1", S->getName()); 608 } 609 } 610 611 cl::ResetAllOptionOccurrences(); 612 EXPECT_TRUE( 613 cl::ParseCommandLineOptions(2, args1, StringRef(), &llvm::nulls())); 614 EXPECT_FALSE(Opt1); 615 EXPECT_FALSE(Opt2); 616 for (auto *S : cl::getRegisteredSubcommands()) { 617 if (*S) { 618 EXPECT_EQ("sc2", S->getName()); 619 } 620 } 621 } 622 623 TEST(CommandLineTest, DefaultOptions) { 624 cl::ResetCommandLineParser(); 625 626 StackOption<std::string> Bar("bar", cl::sub(*cl::AllSubCommands), 627 cl::DefaultOption); 628 StackOption<std::string, cl::alias> Bar_Alias( 629 "b", cl::desc("Alias for -bar"), cl::aliasopt(Bar), cl::DefaultOption); 630 631 StackOption<bool> Foo("foo", cl::init(false), cl::sub(*cl::AllSubCommands), 632 cl::DefaultOption); 633 StackOption<bool, cl::alias> Foo_Alias("f", cl::desc("Alias for -foo"), 634 cl::aliasopt(Foo), cl::DefaultOption); 635 636 StackSubCommand SC1("sc1", "First Subcommand"); 637 // Override "-b" and change type in sc1 SubCommand. 638 StackOption<bool> SC1_B("b", cl::sub(SC1), cl::init(false)); 639 StackSubCommand SC2("sc2", "Second subcommand"); 640 // Override "-foo" and change type in sc2 SubCommand. Note that this does not 641 // affect "-f" alias, which continues to work correctly. 642 StackOption<std::string> SC2_Foo("foo", cl::sub(SC2)); 643 644 const char *args0[] = {"prog", "-b", "args0 bar string", "-f"}; 645 EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args0) / sizeof(char *), args0, 646 StringRef(), &llvm::nulls())); 647 EXPECT_TRUE(Bar == "args0 bar string"); 648 EXPECT_TRUE(Foo); 649 EXPECT_FALSE(SC1_B); 650 EXPECT_TRUE(SC2_Foo.empty()); 651 652 cl::ResetAllOptionOccurrences(); 653 654 const char *args1[] = {"prog", "sc1", "-b", "-bar", "args1 bar string", "-f"}; 655 EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args1) / sizeof(char *), args1, 656 StringRef(), &llvm::nulls())); 657 EXPECT_TRUE(Bar == "args1 bar string"); 658 EXPECT_TRUE(Foo); 659 EXPECT_TRUE(SC1_B); 660 EXPECT_TRUE(SC2_Foo.empty()); 661 for (auto *S : cl::getRegisteredSubcommands()) { 662 if (*S) { 663 EXPECT_EQ("sc1", S->getName()); 664 } 665 } 666 667 cl::ResetAllOptionOccurrences(); 668 669 const char *args2[] = {"prog", "sc2", "-b", "args2 bar string", 670 "-f", "-foo", "foo string"}; 671 EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args2) / sizeof(char *), args2, 672 StringRef(), &llvm::nulls())); 673 EXPECT_TRUE(Bar == "args2 bar string"); 674 EXPECT_TRUE(Foo); 675 EXPECT_FALSE(SC1_B); 676 EXPECT_TRUE(SC2_Foo == "foo string"); 677 for (auto *S : cl::getRegisteredSubcommands()) { 678 if (*S) { 679 EXPECT_EQ("sc2", S->getName()); 680 } 681 } 682 cl::ResetCommandLineParser(); 683 } 684 685 TEST(CommandLineTest, ArgumentLimit) { 686 std::string args(32 * 4096, 'a'); 687 EXPECT_FALSE(llvm::sys::commandLineFitsWithinSystemLimits("cl", args.data())); 688 } 689 690 TEST(CommandLineTest, ResponseFileWindows) { 691 if (!Triple(sys::getProcessTriple()).isOSWindows()) 692 return; 693 694 StackOption<std::string, cl::list<std::string>> InputFilenames( 695 cl::Positional, cl::desc("<input files>"), cl::ZeroOrMore); 696 StackOption<bool> TopLevelOpt("top-level", cl::init(false)); 697 698 // Create response file. 699 int FileDescriptor; 700 SmallString<64> TempPath; 701 std::error_code EC = 702 llvm::sys::fs::createTemporaryFile("resp-", ".txt", FileDescriptor, TempPath); 703 EXPECT_TRUE(!EC); 704 705 std::ofstream RspFile(TempPath.c_str()); 706 EXPECT_TRUE(RspFile.is_open()); 707 RspFile << "-top-level\npath\\dir\\file1\npath/dir/file2"; 708 RspFile.close(); 709 710 llvm::SmallString<128> RspOpt; 711 RspOpt.append(1, '@'); 712 RspOpt.append(TempPath.c_str()); 713 const char *args[] = {"prog", RspOpt.c_str()}; 714 EXPECT_FALSE(TopLevelOpt); 715 EXPECT_TRUE( 716 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 717 EXPECT_TRUE(TopLevelOpt); 718 EXPECT_TRUE(InputFilenames[0] == "path\\dir\\file1"); 719 EXPECT_TRUE(InputFilenames[1] == "path/dir/file2"); 720 721 llvm::sys::fs::remove(TempPath.c_str()); 722 } 723 724 TEST(CommandLineTest, ResponseFiles) { 725 llvm::SmallString<128> TestDir; 726 std::error_code EC = 727 llvm::sys::fs::createUniqueDirectory("unittest", TestDir); 728 EXPECT_TRUE(!EC); 729 730 // Create included response file of first level. 731 llvm::SmallString<128> IncludedFileName; 732 llvm::sys::path::append(IncludedFileName, TestDir, "resp1"); 733 std::ofstream IncludedFile(IncludedFileName.c_str()); 734 EXPECT_TRUE(IncludedFile.is_open()); 735 IncludedFile << "-option_1 -option_2\n" 736 "@incdir/resp2\n" 737 "-option_3=abcd\n"; 738 IncludedFile.close(); 739 740 // Directory for included file. 741 llvm::SmallString<128> IncDir; 742 llvm::sys::path::append(IncDir, TestDir, "incdir"); 743 EC = llvm::sys::fs::create_directory(IncDir); 744 EXPECT_TRUE(!EC); 745 746 // Create included response file of second level. 747 llvm::SmallString<128> IncludedFileName2; 748 llvm::sys::path::append(IncludedFileName2, IncDir, "resp2"); 749 std::ofstream IncludedFile2(IncludedFileName2.c_str()); 750 EXPECT_TRUE(IncludedFile2.is_open()); 751 IncludedFile2 << "-option_21 -option_22\n"; 752 IncludedFile2 << "-option_23=abcd\n"; 753 IncludedFile2.close(); 754 755 // Prepare 'file' with reference to response file. 756 SmallString<128> IncRef; 757 IncRef.append(1, '@'); 758 IncRef.append(IncludedFileName.c_str()); 759 llvm::SmallVector<const char *, 4> Argv = 760 { "test/test", "-flag_1", IncRef.c_str(), "-flag_2" }; 761 762 // Expand response files. 763 llvm::BumpPtrAllocator A; 764 llvm::StringSaver Saver(A); 765 bool Res = llvm::cl::ExpandResponseFiles( 766 Saver, llvm::cl::TokenizeGNUCommandLine, Argv, false, true); 767 EXPECT_TRUE(Res); 768 EXPECT_EQ(Argv.size(), 9U); 769 EXPECT_STREQ(Argv[0], "test/test"); 770 EXPECT_STREQ(Argv[1], "-flag_1"); 771 EXPECT_STREQ(Argv[2], "-option_1"); 772 EXPECT_STREQ(Argv[3], "-option_2"); 773 EXPECT_STREQ(Argv[4], "-option_21"); 774 EXPECT_STREQ(Argv[5], "-option_22"); 775 EXPECT_STREQ(Argv[6], "-option_23=abcd"); 776 EXPECT_STREQ(Argv[7], "-option_3=abcd"); 777 EXPECT_STREQ(Argv[8], "-flag_2"); 778 779 llvm::sys::fs::remove(IncludedFileName2); 780 llvm::sys::fs::remove(IncDir); 781 llvm::sys::fs::remove(IncludedFileName); 782 llvm::sys::fs::remove(TestDir); 783 } 784 785 TEST(CommandLineTest, RecursiveResponseFiles) { 786 SmallString<128> TestDir; 787 std::error_code EC = sys::fs::createUniqueDirectory("unittest", TestDir); 788 EXPECT_TRUE(!EC); 789 790 SmallString<128> ResponseFilePath; 791 sys::path::append(ResponseFilePath, TestDir, "recursive.rsp"); 792 std::string ResponseFileRef = std::string("@") + ResponseFilePath.c_str(); 793 794 std::ofstream ResponseFile(ResponseFilePath.str()); 795 EXPECT_TRUE(ResponseFile.is_open()); 796 ResponseFile << ResponseFileRef << "\n"; 797 ResponseFile << ResponseFileRef << "\n"; 798 ResponseFile.close(); 799 800 // Ensure the recursive expansion terminates. 801 SmallVector<const char *, 4> Argv = {"test/test", ResponseFileRef.c_str()}; 802 BumpPtrAllocator A; 803 StringSaver Saver(A); 804 #ifdef _WIN32 805 cl::TokenizerCallback Tokenizer = cl::TokenizeWindowsCommandLine; 806 #else 807 cl::TokenizerCallback Tokenizer = cl::TokenizeGNUCommandLine; 808 #endif 809 bool Res = cl::ExpandResponseFiles(Saver, Tokenizer, Argv, false, false); 810 EXPECT_FALSE(Res); 811 812 // Ensure some expansion took place. 813 EXPECT_GT(Argv.size(), 2U); 814 EXPECT_STREQ(Argv[0], "test/test"); 815 for (size_t i = 1; i < Argv.size(); ++i) 816 EXPECT_STREQ(Argv[i], ResponseFileRef.c_str()); 817 } 818 819 TEST(CommandLineTest, SetDefautValue) { 820 cl::ResetCommandLineParser(); 821 822 StackOption<std::string> Opt1("opt1", cl::init("true")); 823 StackOption<bool> Opt2("opt2", cl::init(true)); 824 cl::alias Alias("alias", llvm::cl::aliasopt(Opt2)); 825 StackOption<int> Opt3("opt3", cl::init(3)); 826 827 const char *args[] = {"prog", "-opt1=false", "-opt2", "-opt3"}; 828 829 EXPECT_TRUE( 830 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 831 832 EXPECT_TRUE(Opt1 == "false"); 833 EXPECT_TRUE(Opt2); 834 EXPECT_TRUE(Opt3 == 3); 835 836 Opt2 = false; 837 Opt3 = 1; 838 839 cl::ResetAllOptionOccurrences(); 840 841 for (auto &OM : cl::getRegisteredOptions(*cl::TopLevelSubCommand)) { 842 cl::Option *O = OM.second; 843 if (O->ArgStr == "opt2") { 844 continue; 845 } 846 O->setDefault(); 847 } 848 849 EXPECT_TRUE(Opt1 == "true"); 850 EXPECT_TRUE(Opt2); 851 EXPECT_TRUE(Opt3 == 3); 852 Alias.removeArgument(); 853 } 854 855 TEST(CommandLineTest, ReadConfigFile) { 856 llvm::SmallVector<const char *, 1> Argv; 857 858 llvm::SmallString<128> TestDir; 859 std::error_code EC = 860 llvm::sys::fs::createUniqueDirectory("unittest", TestDir); 861 EXPECT_TRUE(!EC); 862 863 llvm::SmallString<128> TestCfg; 864 llvm::sys::path::append(TestCfg, TestDir, "foo"); 865 std::ofstream ConfigFile(TestCfg.c_str()); 866 EXPECT_TRUE(ConfigFile.is_open()); 867 ConfigFile << "# Comment\n" 868 "-option_1\n" 869 "@subconfig\n" 870 "-option_3=abcd\n" 871 "-option_4=\\\n" 872 "cdef\n"; 873 ConfigFile.close(); 874 875 llvm::SmallString<128> TestCfg2; 876 llvm::sys::path::append(TestCfg2, TestDir, "subconfig"); 877 std::ofstream ConfigFile2(TestCfg2.c_str()); 878 EXPECT_TRUE(ConfigFile2.is_open()); 879 ConfigFile2 << "-option_2\n" 880 "\n" 881 " # comment\n"; 882 ConfigFile2.close(); 883 884 // Make sure the current directory is not the directory where config files 885 // resides. In this case the code that expands response files will not find 886 // 'subconfig' unless it resolves nested inclusions relative to the including 887 // file. 888 llvm::SmallString<128> CurrDir; 889 EC = llvm::sys::fs::current_path(CurrDir); 890 EXPECT_TRUE(!EC); 891 EXPECT_TRUE(StringRef(CurrDir) != StringRef(TestDir)); 892 893 llvm::BumpPtrAllocator A; 894 llvm::StringSaver Saver(A); 895 bool Result = llvm::cl::readConfigFile(TestCfg, Saver, Argv); 896 897 EXPECT_TRUE(Result); 898 EXPECT_EQ(Argv.size(), 4U); 899 EXPECT_STREQ(Argv[0], "-option_1"); 900 EXPECT_STREQ(Argv[1], "-option_2"); 901 EXPECT_STREQ(Argv[2], "-option_3=abcd"); 902 EXPECT_STREQ(Argv[3], "-option_4=cdef"); 903 904 llvm::sys::fs::remove(TestCfg2); 905 llvm::sys::fs::remove(TestCfg); 906 llvm::sys::fs::remove(TestDir); 907 } 908 909 TEST(CommandLineTest, PositionalEatArgsError) { 910 StackOption<std::string, cl::list<std::string>> PosEatArgs( 911 "positional-eat-args", cl::Positional, cl::desc("<arguments>..."), 912 cl::ZeroOrMore, cl::PositionalEatsArgs); 913 914 const char *args[] = {"prog", "-positional-eat-args=XXXX"}; 915 const char *args2[] = {"prog", "-positional-eat-args=XXXX", "-foo"}; 916 const char *args3[] = {"prog", "-positional-eat-args", "-foo"}; 917 918 std::string Errs; 919 raw_string_ostream OS(Errs); 920 EXPECT_FALSE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS)); OS.flush(); 921 EXPECT_FALSE(Errs.empty()); Errs.clear(); 922 EXPECT_FALSE(cl::ParseCommandLineOptions(3, args2, StringRef(), &OS)); OS.flush(); 923 EXPECT_FALSE(Errs.empty()); Errs.clear(); 924 EXPECT_TRUE(cl::ParseCommandLineOptions(3, args3, StringRef(), &OS)); OS.flush(); 925 EXPECT_TRUE(Errs.empty()); 926 } 927 928 #ifdef _WIN32 929 TEST(CommandLineTest, GetCommandLineArguments) { 930 int argc = __argc; 931 char **argv = __argv; 932 933 // GetCommandLineArguments is called in InitLLVM. 934 llvm::InitLLVM X(argc, argv); 935 936 EXPECT_EQ(llvm::sys::path::is_absolute(argv[0]), 937 llvm::sys::path::is_absolute(__argv[0])); 938 939 EXPECT_TRUE(llvm::sys::path::filename(argv[0]) 940 .equals_lower("supporttests.exe")) 941 << "Filename of test executable is " 942 << llvm::sys::path::filename(argv[0]); 943 } 944 #endif 945 946 class OutputRedirector { 947 public: 948 OutputRedirector(int RedirectFD) 949 : RedirectFD(RedirectFD), OldFD(dup(RedirectFD)) { 950 if (OldFD == -1 || 951 sys::fs::createTemporaryFile("unittest-redirect", "", NewFD, 952 FilePath) || 953 dup2(NewFD, RedirectFD) == -1) 954 Valid = false; 955 } 956 957 ~OutputRedirector() { 958 dup2(OldFD, RedirectFD); 959 close(OldFD); 960 close(NewFD); 961 } 962 963 SmallVector<char, 128> FilePath; 964 bool Valid = true; 965 966 private: 967 int RedirectFD; 968 int OldFD; 969 int NewFD; 970 }; 971 972 struct AutoDeleteFile { 973 SmallVector<char, 128> FilePath; 974 ~AutoDeleteFile() { 975 if (!FilePath.empty()) 976 sys::fs::remove(std::string(FilePath.data(), FilePath.size())); 977 } 978 }; 979 980 class PrintOptionInfoTest : public ::testing::Test { 981 public: 982 // Return std::string because the output of a failing EXPECT check is 983 // unreadable for StringRef. It also avoids any lifetime issues. 984 template <typename... Ts> std::string runTest(Ts... OptionAttributes) { 985 AutoDeleteFile File; 986 { 987 OutputRedirector Stdout(fileno(stdout)); 988 if (!Stdout.Valid) 989 return ""; 990 File.FilePath = Stdout.FilePath; 991 992 StackOption<OptionValue> TestOption(Opt, cl::desc(HelpText), 993 OptionAttributes...); 994 printOptionInfo(TestOption, 25); 995 outs().flush(); 996 } 997 auto Buffer = MemoryBuffer::getFile(File.FilePath); 998 if (!Buffer) 999 return ""; 1000 return Buffer->get()->getBuffer().str(); 1001 } 1002 1003 enum class OptionValue { Val }; 1004 const StringRef Opt = "some-option"; 1005 const StringRef HelpText = "some help"; 1006 1007 private: 1008 // This is a workaround for cl::Option sub-classes having their 1009 // printOptionInfo functions private. 1010 void printOptionInfo(const cl::Option &O, size_t Width) { 1011 O.printOptionInfo(Width); 1012 } 1013 }; 1014 1015 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithoutSentinel) { 1016 std::string Output = 1017 runTest(cl::ValueOptional, 1018 cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"))); 1019 1020 // clang-format off 1021 EXPECT_EQ(Output, (" -" + Opt + "=<value> - " + HelpText + "\n" 1022 " =v1 - desc1\n") 1023 .str()); 1024 // clang-format on 1025 } 1026 1027 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinel) { 1028 std::string Output = runTest( 1029 cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"), 1030 clEnumValN(OptionValue::Val, "", ""))); 1031 1032 // clang-format off 1033 EXPECT_EQ(Output, 1034 (" -" + Opt + " - " + HelpText + "\n" 1035 " -" + Opt + "=<value> - " + HelpText + "\n" 1036 " =v1 - desc1\n") 1037 .str()); 1038 // clang-format on 1039 } 1040 1041 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinelWithHelp) { 1042 std::string Output = runTest( 1043 cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"), 1044 clEnumValN(OptionValue::Val, "", "desc2"))); 1045 1046 // clang-format off 1047 EXPECT_EQ(Output, (" -" + Opt + " - " + HelpText + "\n" 1048 " -" + Opt + "=<value> - " + HelpText + "\n" 1049 " =v1 - desc1\n" 1050 " =<empty> - desc2\n") 1051 .str()); 1052 // clang-format on 1053 } 1054 1055 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueRequiredWithEmptyValueName) { 1056 std::string Output = runTest( 1057 cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"), 1058 clEnumValN(OptionValue::Val, "", ""))); 1059 1060 // clang-format off 1061 EXPECT_EQ(Output, (" -" + Opt + "=<value> - " + HelpText + "\n" 1062 " =v1 - desc1\n" 1063 " =<empty>\n") 1064 .str()); 1065 // clang-format on 1066 } 1067 1068 TEST_F(PrintOptionInfoTest, PrintOptionInfoEmptyValueDescription) { 1069 std::string Output = runTest( 1070 cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", ""))); 1071 1072 // clang-format off 1073 EXPECT_EQ(Output, 1074 (" -" + Opt + "=<value> - " + HelpText + "\n" 1075 " =v1\n").str()); 1076 // clang-format on 1077 } 1078 1079 class GetOptionWidthTest : public ::testing::Test { 1080 public: 1081 enum class OptionValue { Val }; 1082 1083 template <typename... Ts> 1084 size_t runTest(StringRef ArgName, Ts... OptionAttributes) { 1085 StackOption<OptionValue> TestOption(ArgName, cl::desc("some help"), 1086 OptionAttributes...); 1087 return getOptionWidth(TestOption); 1088 } 1089 1090 private: 1091 // This is a workaround for cl::Option sub-classes having their 1092 // printOptionInfo 1093 // functions private. 1094 size_t getOptionWidth(const cl::Option &O) { return O.getOptionWidth(); } 1095 }; 1096 1097 TEST_F(GetOptionWidthTest, GetOptionWidthArgNameLonger) { 1098 StringRef ArgName("a-long-argument-name"); 1099 size_t ExpectedStrSize = (" -" + ArgName + "=<value> - ").str().size(); 1100 EXPECT_EQ( 1101 runTest(ArgName, cl::values(clEnumValN(OptionValue::Val, "v", "help"))), 1102 ExpectedStrSize); 1103 } 1104 1105 TEST_F(GetOptionWidthTest, GetOptionWidthFirstOptionNameLonger) { 1106 StringRef OptName("a-long-option-name"); 1107 size_t ExpectedStrSize = (" =" + OptName + " - ").str().size(); 1108 EXPECT_EQ( 1109 runTest("a", cl::values(clEnumValN(OptionValue::Val, OptName, "help"), 1110 clEnumValN(OptionValue::Val, "b", "help"))), 1111 ExpectedStrSize); 1112 } 1113 1114 TEST_F(GetOptionWidthTest, GetOptionWidthSecondOptionNameLonger) { 1115 StringRef OptName("a-long-option-name"); 1116 size_t ExpectedStrSize = (" =" + OptName + " - ").str().size(); 1117 EXPECT_EQ( 1118 runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"), 1119 clEnumValN(OptionValue::Val, OptName, "help"))), 1120 ExpectedStrSize); 1121 } 1122 1123 TEST_F(GetOptionWidthTest, GetOptionWidthEmptyOptionNameLonger) { 1124 size_t ExpectedStrSize = StringRef(" =<empty> - ").size(); 1125 // The length of a=<value> (including indentation) is actually the same as the 1126 // =<empty> string, so it is impossible to distinguish via testing the case 1127 // where the empty string is picked from where the option name is picked. 1128 EXPECT_EQ(runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"), 1129 clEnumValN(OptionValue::Val, "", "help"))), 1130 ExpectedStrSize); 1131 } 1132 1133 TEST_F(GetOptionWidthTest, 1134 GetOptionWidthValueOptionalEmptyOptionWithNoDescription) { 1135 StringRef ArgName("a"); 1136 // The length of a=<value> (including indentation) is actually the same as the 1137 // =<empty> string, so it is impossible to distinguish via testing the case 1138 // where the empty string is ignored from where it is not ignored. 1139 // The dash will not actually be printed, but the space it would take up is 1140 // included to ensure a consistent column width. 1141 size_t ExpectedStrSize = (" -" + ArgName + "=<value> - ").str().size(); 1142 EXPECT_EQ(runTest(ArgName, cl::ValueOptional, 1143 cl::values(clEnumValN(OptionValue::Val, "value", "help"), 1144 clEnumValN(OptionValue::Val, "", ""))), 1145 ExpectedStrSize); 1146 } 1147 1148 TEST_F(GetOptionWidthTest, 1149 GetOptionWidthValueRequiredEmptyOptionWithNoDescription) { 1150 // The length of a=<value> (including indentation) is actually the same as the 1151 // =<empty> string, so it is impossible to distinguish via testing the case 1152 // where the empty string is picked from where the option name is picked 1153 size_t ExpectedStrSize = StringRef(" =<empty> - ").size(); 1154 EXPECT_EQ(runTest("a", cl::ValueRequired, 1155 cl::values(clEnumValN(OptionValue::Val, "value", "help"), 1156 clEnumValN(OptionValue::Val, "", ""))), 1157 ExpectedStrSize); 1158 } 1159 1160 TEST(CommandLineTest, PrefixOptions) { 1161 cl::ResetCommandLineParser(); 1162 1163 StackOption<std::string, cl::list<std::string>> IncludeDirs( 1164 "I", cl::Prefix, cl::desc("Declare an include directory")); 1165 1166 // Test non-prefixed variant works with cl::Prefix options. 1167 EXPECT_TRUE(IncludeDirs.empty()); 1168 const char *args[] = {"prog", "-I=/usr/include"}; 1169 EXPECT_TRUE( 1170 cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls())); 1171 EXPECT_TRUE(IncludeDirs.size() == 1); 1172 EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0); 1173 1174 IncludeDirs.erase(IncludeDirs.begin()); 1175 cl::ResetAllOptionOccurrences(); 1176 1177 // Test non-prefixed variant works with cl::Prefix options when value is 1178 // passed in following argument. 1179 EXPECT_TRUE(IncludeDirs.empty()); 1180 const char *args2[] = {"prog", "-I", "/usr/include"}; 1181 EXPECT_TRUE( 1182 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 1183 EXPECT_TRUE(IncludeDirs.size() == 1); 1184 EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0); 1185 1186 IncludeDirs.erase(IncludeDirs.begin()); 1187 cl::ResetAllOptionOccurrences(); 1188 1189 // Test prefixed variant works with cl::Prefix options. 1190 EXPECT_TRUE(IncludeDirs.empty()); 1191 const char *args3[] = {"prog", "-I/usr/include"}; 1192 EXPECT_TRUE( 1193 cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls())); 1194 EXPECT_TRUE(IncludeDirs.size() == 1); 1195 EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0); 1196 1197 StackOption<std::string, cl::list<std::string>> MacroDefs( 1198 "D", cl::AlwaysPrefix, cl::desc("Define a macro"), 1199 cl::value_desc("MACRO[=VALUE]")); 1200 1201 cl::ResetAllOptionOccurrences(); 1202 1203 // Test non-prefixed variant does not work with cl::AlwaysPrefix options: 1204 // equal sign is part of the value. 1205 EXPECT_TRUE(MacroDefs.empty()); 1206 const char *args4[] = {"prog", "-D=HAVE_FOO"}; 1207 EXPECT_TRUE( 1208 cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls())); 1209 EXPECT_TRUE(MacroDefs.size() == 1); 1210 EXPECT_TRUE(MacroDefs.front().compare("=HAVE_FOO") == 0); 1211 1212 MacroDefs.erase(MacroDefs.begin()); 1213 cl::ResetAllOptionOccurrences(); 1214 1215 // Test non-prefixed variant does not allow value to be passed in following 1216 // argument with cl::AlwaysPrefix options. 1217 EXPECT_TRUE(MacroDefs.empty()); 1218 const char *args5[] = {"prog", "-D", "HAVE_FOO"}; 1219 EXPECT_FALSE( 1220 cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls())); 1221 EXPECT_TRUE(MacroDefs.empty()); 1222 1223 cl::ResetAllOptionOccurrences(); 1224 1225 // Test prefixed variant works with cl::AlwaysPrefix options. 1226 EXPECT_TRUE(MacroDefs.empty()); 1227 const char *args6[] = {"prog", "-DHAVE_FOO"}; 1228 EXPECT_TRUE( 1229 cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls())); 1230 EXPECT_TRUE(MacroDefs.size() == 1); 1231 EXPECT_TRUE(MacroDefs.front().compare("HAVE_FOO") == 0); 1232 } 1233 1234 TEST(CommandLineTest, GroupingWithValue) { 1235 cl::ResetCommandLineParser(); 1236 1237 StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag")); 1238 StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag")); 1239 StackOption<bool> OptD("d", cl::Grouping, cl::ValueDisallowed, 1240 cl::desc("ValueDisallowed option")); 1241 StackOption<std::string> OptV("v", cl::Grouping, 1242 cl::desc("ValueRequired option")); 1243 StackOption<std::string> OptO("o", cl::Grouping, cl::ValueOptional, 1244 cl::desc("ValueOptional option")); 1245 1246 // Should be possible to use an option which requires a value 1247 // at the end of a group. 1248 const char *args1[] = {"prog", "-fv", "val1"}; 1249 EXPECT_TRUE( 1250 cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls())); 1251 EXPECT_TRUE(OptF); 1252 EXPECT_STREQ("val1", OptV.c_str()); 1253 OptV.clear(); 1254 cl::ResetAllOptionOccurrences(); 1255 1256 // Should not crash if it is accidentally used elsewhere in the group. 1257 const char *args2[] = {"prog", "-vf", "val2"}; 1258 EXPECT_FALSE( 1259 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 1260 OptV.clear(); 1261 cl::ResetAllOptionOccurrences(); 1262 1263 // Should allow the "opt=value" form at the end of the group 1264 const char *args3[] = {"prog", "-fv=val3"}; 1265 EXPECT_TRUE( 1266 cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls())); 1267 EXPECT_TRUE(OptF); 1268 EXPECT_STREQ("val3", OptV.c_str()); 1269 OptV.clear(); 1270 cl::ResetAllOptionOccurrences(); 1271 1272 // Should allow assigning a value for a ValueOptional option 1273 // at the end of the group 1274 const char *args4[] = {"prog", "-fo=val4"}; 1275 EXPECT_TRUE( 1276 cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls())); 1277 EXPECT_TRUE(OptF); 1278 EXPECT_STREQ("val4", OptO.c_str()); 1279 OptO.clear(); 1280 cl::ResetAllOptionOccurrences(); 1281 1282 // Should assign an empty value if a ValueOptional option is used elsewhere 1283 // in the group. 1284 const char *args5[] = {"prog", "-fob"}; 1285 EXPECT_TRUE( 1286 cl::ParseCommandLineOptions(2, args5, StringRef(), &llvm::nulls())); 1287 EXPECT_TRUE(OptF); 1288 EXPECT_EQ(1, OptO.getNumOccurrences()); 1289 EXPECT_EQ(1, OptB.getNumOccurrences()); 1290 EXPECT_TRUE(OptO.empty()); 1291 cl::ResetAllOptionOccurrences(); 1292 1293 // Should not allow an assignment for a ValueDisallowed option. 1294 const char *args6[] = {"prog", "-fd=false"}; 1295 EXPECT_FALSE( 1296 cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls())); 1297 } 1298 1299 TEST(CommandLineTest, GroupingAndPrefix) { 1300 cl::ResetCommandLineParser(); 1301 1302 StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag")); 1303 StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag")); 1304 StackOption<std::string> OptP("p", cl::Prefix, cl::Grouping, 1305 cl::desc("Prefix and Grouping")); 1306 StackOption<std::string> OptA("a", cl::AlwaysPrefix, cl::Grouping, 1307 cl::desc("AlwaysPrefix and Grouping")); 1308 1309 // Should be possible to use a cl::Prefix option without grouping. 1310 const char *args1[] = {"prog", "-pval1"}; 1311 EXPECT_TRUE( 1312 cl::ParseCommandLineOptions(2, args1, StringRef(), &llvm::nulls())); 1313 EXPECT_STREQ("val1", OptP.c_str()); 1314 OptP.clear(); 1315 cl::ResetAllOptionOccurrences(); 1316 1317 // Should be possible to pass a value in a separate argument. 1318 const char *args2[] = {"prog", "-p", "val2"}; 1319 EXPECT_TRUE( 1320 cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls())); 1321 EXPECT_STREQ("val2", OptP.c_str()); 1322 OptP.clear(); 1323 cl::ResetAllOptionOccurrences(); 1324 1325 // The "-opt=value" form should work, too. 1326 const char *args3[] = {"prog", "-p=val3"}; 1327 EXPECT_TRUE( 1328 cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls())); 1329 EXPECT_STREQ("val3", OptP.c_str()); 1330 OptP.clear(); 1331 cl::ResetAllOptionOccurrences(); 1332 1333 // All three previous cases should work the same way if an option with both 1334 // cl::Prefix and cl::Grouping modifiers is used at the end of a group. 1335 const char *args4[] = {"prog", "-fpval4"}; 1336 EXPECT_TRUE( 1337 cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls())); 1338 EXPECT_TRUE(OptF); 1339 EXPECT_STREQ("val4", OptP.c_str()); 1340 OptP.clear(); 1341 cl::ResetAllOptionOccurrences(); 1342 1343 const char *args5[] = {"prog", "-fp", "val5"}; 1344 EXPECT_TRUE( 1345 cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls())); 1346 EXPECT_TRUE(OptF); 1347 EXPECT_STREQ("val5", OptP.c_str()); 1348 OptP.clear(); 1349 cl::ResetAllOptionOccurrences(); 1350 1351 const char *args6[] = {"prog", "-fp=val6"}; 1352 EXPECT_TRUE( 1353 cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls())); 1354 EXPECT_TRUE(OptF); 1355 EXPECT_STREQ("val6", OptP.c_str()); 1356 OptP.clear(); 1357 cl::ResetAllOptionOccurrences(); 1358 1359 // Should assign a value even if the part after a cl::Prefix option is equal 1360 // to the name of another option. 1361 const char *args7[] = {"prog", "-fpb"}; 1362 EXPECT_TRUE( 1363 cl::ParseCommandLineOptions(2, args7, StringRef(), &llvm::nulls())); 1364 EXPECT_TRUE(OptF); 1365 EXPECT_STREQ("b", OptP.c_str()); 1366 EXPECT_FALSE(OptB); 1367 OptP.clear(); 1368 cl::ResetAllOptionOccurrences(); 1369 1370 // Should be possible to use a cl::AlwaysPrefix option without grouping. 1371 const char *args8[] = {"prog", "-aval8"}; 1372 EXPECT_TRUE( 1373 cl::ParseCommandLineOptions(2, args8, StringRef(), &llvm::nulls())); 1374 EXPECT_STREQ("val8", OptA.c_str()); 1375 OptA.clear(); 1376 cl::ResetAllOptionOccurrences(); 1377 1378 // Should not be possible to pass a value in a separate argument. 1379 const char *args9[] = {"prog", "-a", "val9"}; 1380 EXPECT_FALSE( 1381 cl::ParseCommandLineOptions(3, args9, StringRef(), &llvm::nulls())); 1382 cl::ResetAllOptionOccurrences(); 1383 1384 // With the "-opt=value" form, the "=" symbol should be preserved. 1385 const char *args10[] = {"prog", "-a=val10"}; 1386 EXPECT_TRUE( 1387 cl::ParseCommandLineOptions(2, args10, StringRef(), &llvm::nulls())); 1388 EXPECT_STREQ("=val10", OptA.c_str()); 1389 OptA.clear(); 1390 cl::ResetAllOptionOccurrences(); 1391 1392 // All three previous cases should work the same way if an option with both 1393 // cl::AlwaysPrefix and cl::Grouping modifiers is used at the end of a group. 1394 const char *args11[] = {"prog", "-faval11"}; 1395 EXPECT_TRUE( 1396 cl::ParseCommandLineOptions(2, args11, StringRef(), &llvm::nulls())); 1397 EXPECT_TRUE(OptF); 1398 EXPECT_STREQ("val11", OptA.c_str()); 1399 OptA.clear(); 1400 cl::ResetAllOptionOccurrences(); 1401 1402 const char *args12[] = {"prog", "-fa", "val12"}; 1403 EXPECT_FALSE( 1404 cl::ParseCommandLineOptions(3, args12, StringRef(), &llvm::nulls())); 1405 cl::ResetAllOptionOccurrences(); 1406 1407 const char *args13[] = {"prog", "-fa=val13"}; 1408 EXPECT_TRUE( 1409 cl::ParseCommandLineOptions(2, args13, StringRef(), &llvm::nulls())); 1410 EXPECT_TRUE(OptF); 1411 EXPECT_STREQ("=val13", OptA.c_str()); 1412 OptA.clear(); 1413 cl::ResetAllOptionOccurrences(); 1414 1415 // Should assign a value even if the part after a cl::AlwaysPrefix option 1416 // is equal to the name of another option. 1417 const char *args14[] = {"prog", "-fab"}; 1418 EXPECT_TRUE( 1419 cl::ParseCommandLineOptions(2, args14, StringRef(), &llvm::nulls())); 1420 EXPECT_TRUE(OptF); 1421 EXPECT_STREQ("b", OptA.c_str()); 1422 EXPECT_FALSE(OptB); 1423 OptA.clear(); 1424 cl::ResetAllOptionOccurrences(); 1425 } 1426 1427 } // anonymous namespace 1428