xref: /llvm-project/llvm/unittests/Support/CommandLineTest.cpp (revision c1728a40aae31abc0a5d4d07f6f6a6773d803f2c)
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/StringRef.h"
13 #include "llvm/ADT/Triple.h"
14 #include "llvm/Config/config.h"
15 #include "llvm/Support/Allocator.h"
16 #include "llvm/Support/FileSystem.h"
17 #include "llvm/Support/Host.h"
18 #include "llvm/Support/InitLLVM.h"
19 #include "llvm/Support/MemoryBuffer.h"
20 #include "llvm/Support/Path.h"
21 #include "llvm/Support/Program.h"
22 #include "llvm/Support/StringSaver.h"
23 #include "llvm/Support/VirtualFileSystem.h"
24 #include "llvm/Support/raw_ostream.h"
25 #include "llvm/Testing/Support/SupportHelpers.h"
26 #include "gmock/gmock.h"
27 #include "gtest/gtest.h"
28 #include <fstream>
29 #include <stdlib.h>
30 #include <string>
31 #include <tuple>
32 
33 using namespace llvm;
34 using llvm::unittest::TempDir;
35 using llvm::unittest::TempFile;
36 
37 namespace {
38 
39 MATCHER(StringEquality, "Checks if two char* are equal as strings") {
40   return std::string(std::get<0>(arg)) == std::string(std::get<1>(arg));
41 }
42 
43 class TempEnvVar {
44  public:
45   TempEnvVar(const char *name, const char *value)
46       : name(name) {
47     const char *old_value = getenv(name);
48     EXPECT_EQ(nullptr, old_value) << old_value;
49 #if HAVE_SETENV
50     setenv(name, value, true);
51 #endif
52   }
53 
54   ~TempEnvVar() {
55 #if HAVE_SETENV
56     // Assume setenv and unsetenv come together.
57     unsetenv(name);
58 #else
59     (void)name; // Suppress -Wunused-private-field.
60 #endif
61   }
62 
63  private:
64   const char *const name;
65 };
66 
67 template <typename T, typename Base = cl::opt<T>>
68 class StackOption : public Base {
69 public:
70   template <class... Ts>
71   explicit StackOption(Ts &&... Ms) : Base(std::forward<Ts>(Ms)...) {}
72 
73   ~StackOption() override { this->removeArgument(); }
74 
75   template <class DT> StackOption<T> &operator=(const DT &V) {
76     Base::operator=(V);
77     return *this;
78   }
79 };
80 
81 class StackSubCommand : public cl::SubCommand {
82 public:
83   StackSubCommand(StringRef Name,
84                   StringRef Description = StringRef())
85       : SubCommand(Name, Description) {}
86 
87   StackSubCommand() : SubCommand() {}
88 
89   ~StackSubCommand() { unregisterSubCommand(); }
90 };
91 
92 
93 cl::OptionCategory TestCategory("Test Options", "Description");
94 TEST(CommandLineTest, ModifyExisitingOption) {
95   StackOption<int> TestOption("test-option", cl::desc("old description"));
96 
97   static const char Description[] = "New description";
98   static const char ArgString[] = "new-test-option";
99   static const char ValueString[] = "Integer";
100 
101   StringMap<cl::Option *> &Map =
102       cl::getRegisteredOptions(cl::SubCommand::getTopLevel());
103 
104   ASSERT_EQ(Map.count("test-option"), 1u) << "Could not find option in map.";
105 
106   cl::Option *Retrieved = Map["test-option"];
107   ASSERT_EQ(&TestOption, Retrieved) << "Retrieved wrong option.";
108 
109   ASSERT_NE(Retrieved->Categories.end(),
110             find_if(Retrieved->Categories,
111                     [&](const llvm::cl::OptionCategory *Cat) {
112                       return Cat == &cl::getGeneralCategory();
113                     }))
114       << "Incorrect default option category.";
115 
116   Retrieved->addCategory(TestCategory);
117   ASSERT_NE(Retrieved->Categories.end(),
118             find_if(Retrieved->Categories,
119                     [&](const llvm::cl::OptionCategory *Cat) {
120                       return Cat == &TestCategory;
121                     }))
122       << "Failed to modify option's option category.";
123 
124   Retrieved->setDescription(Description);
125   ASSERT_STREQ(Retrieved->HelpStr.data(), Description)
126       << "Changing option description failed.";
127 
128   Retrieved->setArgStr(ArgString);
129   ASSERT_STREQ(ArgString, Retrieved->ArgStr.data())
130       << "Failed to modify option's Argument string.";
131 
132   Retrieved->setValueStr(ValueString);
133   ASSERT_STREQ(Retrieved->ValueStr.data(), ValueString)
134       << "Failed to modify option's Value string.";
135 
136   Retrieved->setHiddenFlag(cl::Hidden);
137   ASSERT_EQ(cl::Hidden, TestOption.getOptionHiddenFlag()) <<
138     "Failed to modify option's hidden flag.";
139 }
140 
141 TEST(CommandLineTest, UseOptionCategory) {
142   StackOption<int> TestOption2("test-option", cl::cat(TestCategory));
143 
144   ASSERT_NE(TestOption2.Categories.end(),
145             find_if(TestOption2.Categories,
146                          [&](const llvm::cl::OptionCategory *Cat) {
147                            return Cat == &TestCategory;
148                          }))
149       << "Failed to assign Option Category.";
150 }
151 
152 TEST(CommandLineTest, UseMultipleCategories) {
153   StackOption<int> TestOption2("test-option2", cl::cat(TestCategory),
154                                cl::cat(cl::getGeneralCategory()),
155                                cl::cat(cl::getGeneralCategory()));
156 
157   // Make sure cl::getGeneralCategory() wasn't added twice.
158   ASSERT_EQ(TestOption2.Categories.size(), 2U);
159 
160   ASSERT_NE(TestOption2.Categories.end(),
161             find_if(TestOption2.Categories,
162                          [&](const llvm::cl::OptionCategory *Cat) {
163                            return Cat == &TestCategory;
164                          }))
165       << "Failed to assign Option Category.";
166   ASSERT_NE(TestOption2.Categories.end(),
167             find_if(TestOption2.Categories,
168                     [&](const llvm::cl::OptionCategory *Cat) {
169                       return Cat == &cl::getGeneralCategory();
170                     }))
171       << "Failed to assign General Category.";
172 
173   cl::OptionCategory AnotherCategory("Additional test Options", "Description");
174   StackOption<int> TestOption("test-option", cl::cat(TestCategory),
175                               cl::cat(AnotherCategory));
176   ASSERT_EQ(TestOption.Categories.end(),
177             find_if(TestOption.Categories,
178                     [&](const llvm::cl::OptionCategory *Cat) {
179                       return Cat == &cl::getGeneralCategory();
180                     }))
181       << "Failed to remove General Category.";
182   ASSERT_NE(TestOption.Categories.end(),
183             find_if(TestOption.Categories,
184                          [&](const llvm::cl::OptionCategory *Cat) {
185                            return Cat == &TestCategory;
186                          }))
187       << "Failed to assign Option Category.";
188   ASSERT_NE(TestOption.Categories.end(),
189             find_if(TestOption.Categories,
190                          [&](const llvm::cl::OptionCategory *Cat) {
191                            return Cat == &AnotherCategory;
192                          }))
193       << "Failed to assign Another Category.";
194 }
195 
196 typedef void ParserFunction(StringRef Source, StringSaver &Saver,
197                             SmallVectorImpl<const char *> &NewArgv,
198                             bool MarkEOLs);
199 
200 void testCommandLineTokenizer(ParserFunction *parse, StringRef Input,
201                               ArrayRef<const char *> Output,
202                               bool MarkEOLs = false) {
203   SmallVector<const char *, 0> Actual;
204   BumpPtrAllocator A;
205   StringSaver Saver(A);
206   parse(Input, Saver, Actual, MarkEOLs);
207   EXPECT_EQ(Output.size(), Actual.size());
208   for (unsigned I = 0, E = Actual.size(); I != E; ++I) {
209     if (I < Output.size()) {
210       EXPECT_STREQ(Output[I], Actual[I]);
211     }
212   }
213 }
214 
215 TEST(CommandLineTest, TokenizeGNUCommandLine) {
216   const char Input[] =
217       "foo\\ bar \"foo bar\" \'foo bar\' 'foo\\\\bar' -DFOO=bar\\(\\) "
218       "foo\"bar\"baz C:\\\\src\\\\foo.cpp \"C:\\src\\foo.cpp\"";
219   const char *const Output[] = {
220       "foo bar",     "foo bar",   "foo bar",          "foo\\bar",
221       "-DFOO=bar()", "foobarbaz", "C:\\src\\foo.cpp", "C:srcfoo.cpp"};
222   testCommandLineTokenizer(cl::TokenizeGNUCommandLine, Input, Output);
223 }
224 
225 TEST(CommandLineTest, TokenizeWindowsCommandLine1) {
226   const char Input[] =
227       R"(a\b c\\d e\\"f g" h\"i j\\\"k "lmn" o pqr "st \"u" \v)";
228   const char *const Output[] = { "a\\b", "c\\\\d", "e\\f g", "h\"i", "j\\\"k",
229                                  "lmn", "o", "pqr", "st \"u", "\\v" };
230   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input, Output);
231 }
232 
233 TEST(CommandLineTest, TokenizeWindowsCommandLine2) {
234   const char Input[] = "clang -c -DFOO=\"\"\"ABC\"\"\" x.cpp";
235   const char *const Output[] = { "clang", "-c", "-DFOO=\"ABC\"", "x.cpp"};
236   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input, Output);
237 }
238 
239 TEST(CommandLineTest, TokenizeWindowsCommandLineQuotedLastArgument) {
240   // Whitespace at the end of the command line doesn't cause an empty last word
241   const char Input0[] = R"(a b c d )";
242   const char *const Output0[] = {"a", "b", "c", "d"};
243   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input0, Output0);
244 
245   // But an explicit "" does
246   const char Input1[] = R"(a b c d "")";
247   const char *const Output1[] = {"a", "b", "c", "d", ""};
248   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input1, Output1);
249 
250   // An unterminated quoted string is also emitted as an argument word, empty
251   // or not
252   const char Input2[] = R"(a b c d ")";
253   const char *const Output2[] = {"a", "b", "c", "d", ""};
254   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input2, Output2);
255   const char Input3[] = R"(a b c d "text)";
256   const char *const Output3[] = {"a", "b", "c", "d", "text"};
257   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input3, Output3);
258 }
259 
260 TEST(CommandLineTest, TokenizeWindowsCommandLineExeName) {
261   const char Input1[] =
262       R"("C:\Program Files\Whatever\"clang.exe z.c -DY=\"x\")";
263   const char *const Output1[] = {"C:\\Program Files\\Whatever\\clang.exe",
264                                  "z.c", "-DY=\"x\""};
265   testCommandLineTokenizer(cl::TokenizeWindowsCommandLineFull, Input1, Output1);
266 
267   const char Input2[] = "\"a\\\"b c\\\"d\n\"e\\\"f g\\\"h\n";
268   const char *const Output2[] = {"a\\b", "c\"d", nullptr,
269                                  "e\\f", "g\"h", nullptr};
270   testCommandLineTokenizer(cl::TokenizeWindowsCommandLineFull, Input2, Output2,
271                            /*MarkEOLs=*/true);
272 
273   const char Input3[] = R"(\\server\share\subdir\clang.exe)";
274   const char *const Output3[] = {"\\\\server\\share\\subdir\\clang.exe"};
275   testCommandLineTokenizer(cl::TokenizeWindowsCommandLineFull, Input3, Output3);
276 }
277 
278 TEST(CommandLineTest, TokenizeAndMarkEOLs) {
279   // Clang uses EOL marking in response files to support options that consume
280   // the rest of the arguments on the current line, but do not consume arguments
281   // from subsequent lines. For example, given these rsp files contents:
282   // /c /Zi /O2
283   // /Oy- /link /debug /opt:ref
284   // /Zc:ThreadsafeStatics-
285   //
286   // clang-cl needs to treat "/debug /opt:ref" as linker flags, and everything
287   // else as compiler flags. The tokenizer inserts nullptr sentinels into the
288   // output so that clang-cl can find the end of the current line.
289   const char Input[] = "clang -Xclang foo\n\nfoo\"bar\"baz\n x.cpp\n";
290   const char *const Output[] = {"clang", "-Xclang", "foo",
291                                 nullptr, nullptr,   "foobarbaz",
292                                 nullptr, "x.cpp",   nullptr};
293   testCommandLineTokenizer(cl::TokenizeWindowsCommandLine, Input, Output,
294                            /*MarkEOLs=*/true);
295   testCommandLineTokenizer(cl::TokenizeGNUCommandLine, Input, Output,
296                            /*MarkEOLs=*/true);
297 }
298 
299 TEST(CommandLineTest, TokenizeConfigFile1) {
300   const char *Input = "\\";
301   const char *const Output[] = { "\\" };
302   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
303 }
304 
305 TEST(CommandLineTest, TokenizeConfigFile2) {
306   const char *Input = "\\abc";
307   const char *const Output[] = { "abc" };
308   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
309 }
310 
311 TEST(CommandLineTest, TokenizeConfigFile3) {
312   const char *Input = "abc\\";
313   const char *const Output[] = { "abc\\" };
314   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
315 }
316 
317 TEST(CommandLineTest, TokenizeConfigFile4) {
318   const char *Input = "abc\\\n123";
319   const char *const Output[] = { "abc123" };
320   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
321 }
322 
323 TEST(CommandLineTest, TokenizeConfigFile5) {
324   const char *Input = "abc\\\r\n123";
325   const char *const Output[] = { "abc123" };
326   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
327 }
328 
329 TEST(CommandLineTest, TokenizeConfigFile6) {
330   const char *Input = "abc\\\n";
331   const char *const Output[] = { "abc" };
332   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
333 }
334 
335 TEST(CommandLineTest, TokenizeConfigFile7) {
336   const char *Input = "abc\\\r\n";
337   const char *const Output[] = { "abc" };
338   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
339 }
340 
341 TEST(CommandLineTest, TokenizeConfigFile8) {
342   SmallVector<const char *, 0> Actual;
343   BumpPtrAllocator A;
344   StringSaver Saver(A);
345   cl::tokenizeConfigFile("\\\n", Saver, Actual, /*MarkEOLs=*/false);
346   EXPECT_TRUE(Actual.empty());
347 }
348 
349 TEST(CommandLineTest, TokenizeConfigFile9) {
350   SmallVector<const char *, 0> Actual;
351   BumpPtrAllocator A;
352   StringSaver Saver(A);
353   cl::tokenizeConfigFile("\\\r\n", Saver, Actual, /*MarkEOLs=*/false);
354   EXPECT_TRUE(Actual.empty());
355 }
356 
357 TEST(CommandLineTest, TokenizeConfigFile10) {
358   const char *Input = "\\\nabc";
359   const char *const Output[] = { "abc" };
360   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
361 }
362 
363 TEST(CommandLineTest, TokenizeConfigFile11) {
364   const char *Input = "\\\r\nabc";
365   const char *const Output[] = { "abc" };
366   testCommandLineTokenizer(cl::tokenizeConfigFile, Input, Output);
367 }
368 
369 TEST(CommandLineTest, AliasesWithArguments) {
370   static const size_t ARGC = 3;
371   const char *const Inputs[][ARGC] = {
372     { "-tool", "-actual=x", "-extra" },
373     { "-tool", "-actual", "x" },
374     { "-tool", "-alias=x", "-extra" },
375     { "-tool", "-alias", "x" }
376   };
377 
378   for (size_t i = 0, e = std::size(Inputs); i < e; ++i) {
379     StackOption<std::string> Actual("actual");
380     StackOption<bool> Extra("extra");
381     StackOption<std::string> Input(cl::Positional);
382 
383     cl::alias Alias("alias", llvm::cl::aliasopt(Actual));
384 
385     cl::ParseCommandLineOptions(ARGC, Inputs[i]);
386     EXPECT_EQ("x", Actual);
387     EXPECT_EQ(0, Input.getNumOccurrences());
388 
389     Alias.removeArgument();
390   }
391 }
392 
393 void testAliasRequired(int argc, const char *const *argv) {
394   StackOption<std::string> Option("option", cl::Required);
395   cl::alias Alias("o", llvm::cl::aliasopt(Option));
396 
397   cl::ParseCommandLineOptions(argc, argv);
398   EXPECT_EQ("x", Option);
399   EXPECT_EQ(1, Option.getNumOccurrences());
400 
401   Alias.removeArgument();
402 }
403 
404 TEST(CommandLineTest, AliasRequired) {
405   const char *opts1[] = { "-tool", "-option=x" };
406   const char *opts2[] = { "-tool", "-o", "x" };
407   testAliasRequired(std::size(opts1), opts1);
408   testAliasRequired(std::size(opts2), opts2);
409 }
410 
411 TEST(CommandLineTest, HideUnrelatedOptions) {
412   StackOption<int> TestOption1("hide-option-1");
413   StackOption<int> TestOption2("hide-option-2", cl::cat(TestCategory));
414 
415   cl::HideUnrelatedOptions(TestCategory);
416 
417   ASSERT_EQ(cl::ReallyHidden, TestOption1.getOptionHiddenFlag())
418       << "Failed to hide extra option.";
419   ASSERT_EQ(cl::NotHidden, TestOption2.getOptionHiddenFlag())
420       << "Hid extra option that should be visable.";
421 
422   StringMap<cl::Option *> &Map =
423       cl::getRegisteredOptions(cl::SubCommand::getTopLevel());
424   ASSERT_TRUE(Map.count("help") == (size_t)0 ||
425               cl::NotHidden == Map["help"]->getOptionHiddenFlag())
426       << "Hid default option that should be visable.";
427 }
428 
429 cl::OptionCategory TestCategory2("Test Options set 2", "Description");
430 
431 TEST(CommandLineTest, HideUnrelatedOptionsMulti) {
432   StackOption<int> TestOption1("multi-hide-option-1");
433   StackOption<int> TestOption2("multi-hide-option-2", cl::cat(TestCategory));
434   StackOption<int> TestOption3("multi-hide-option-3", cl::cat(TestCategory2));
435 
436   const cl::OptionCategory *VisibleCategories[] = {&TestCategory,
437                                                    &TestCategory2};
438 
439   cl::HideUnrelatedOptions(makeArrayRef(VisibleCategories));
440 
441   ASSERT_EQ(cl::ReallyHidden, TestOption1.getOptionHiddenFlag())
442       << "Failed to hide extra option.";
443   ASSERT_EQ(cl::NotHidden, TestOption2.getOptionHiddenFlag())
444       << "Hid extra option that should be visable.";
445   ASSERT_EQ(cl::NotHidden, TestOption3.getOptionHiddenFlag())
446       << "Hid extra option that should be visable.";
447 
448   StringMap<cl::Option *> &Map =
449       cl::getRegisteredOptions(cl::SubCommand::getTopLevel());
450   ASSERT_TRUE(Map.count("help") == (size_t)0 ||
451               cl::NotHidden == Map["help"]->getOptionHiddenFlag())
452       << "Hid default option that should be visable.";
453 }
454 
455 TEST(CommandLineTest, SetMultiValues) {
456   StackOption<int> Option("option");
457   const char *args[] = {"prog", "-option=1", "-option=2"};
458   EXPECT_TRUE(cl::ParseCommandLineOptions(std::size(args), args, StringRef(),
459                                           &llvm::nulls()));
460   EXPECT_EQ(Option, 2);
461 }
462 
463 TEST(CommandLineTest, SetValueInSubcategories) {
464   cl::ResetCommandLineParser();
465 
466   StackSubCommand SC1("sc1", "First subcommand");
467   StackSubCommand SC2("sc2", "Second subcommand");
468 
469   StackOption<bool> TopLevelOpt("top-level", cl::init(false));
470   StackOption<bool> SC1Opt("sc1", cl::sub(SC1), cl::init(false));
471   StackOption<bool> SC2Opt("sc2", cl::sub(SC2), cl::init(false));
472 
473   EXPECT_FALSE(TopLevelOpt);
474   EXPECT_FALSE(SC1Opt);
475   EXPECT_FALSE(SC2Opt);
476   const char *args[] = {"prog", "-top-level"};
477   EXPECT_TRUE(
478       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
479   EXPECT_TRUE(TopLevelOpt);
480   EXPECT_FALSE(SC1Opt);
481   EXPECT_FALSE(SC2Opt);
482 
483   TopLevelOpt = false;
484 
485   cl::ResetAllOptionOccurrences();
486   EXPECT_FALSE(TopLevelOpt);
487   EXPECT_FALSE(SC1Opt);
488   EXPECT_FALSE(SC2Opt);
489   const char *args2[] = {"prog", "sc1", "-sc1"};
490   EXPECT_TRUE(
491       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
492   EXPECT_FALSE(TopLevelOpt);
493   EXPECT_TRUE(SC1Opt);
494   EXPECT_FALSE(SC2Opt);
495 
496   SC1Opt = false;
497 
498   cl::ResetAllOptionOccurrences();
499   EXPECT_FALSE(TopLevelOpt);
500   EXPECT_FALSE(SC1Opt);
501   EXPECT_FALSE(SC2Opt);
502   const char *args3[] = {"prog", "sc2", "-sc2"};
503   EXPECT_TRUE(
504       cl::ParseCommandLineOptions(3, args3, StringRef(), &llvm::nulls()));
505   EXPECT_FALSE(TopLevelOpt);
506   EXPECT_FALSE(SC1Opt);
507   EXPECT_TRUE(SC2Opt);
508 }
509 
510 TEST(CommandLineTest, LookupFailsInWrongSubCommand) {
511   cl::ResetCommandLineParser();
512 
513   StackSubCommand SC1("sc1", "First subcommand");
514   StackSubCommand SC2("sc2", "Second subcommand");
515 
516   StackOption<bool> SC1Opt("sc1", cl::sub(SC1), cl::init(false));
517   StackOption<bool> SC2Opt("sc2", cl::sub(SC2), cl::init(false));
518 
519   std::string Errs;
520   raw_string_ostream OS(Errs);
521 
522   const char *args[] = {"prog", "sc1", "-sc2"};
523   EXPECT_FALSE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS));
524   OS.flush();
525   EXPECT_FALSE(Errs.empty());
526 }
527 
528 TEST(CommandLineTest, AddToAllSubCommands) {
529   cl::ResetCommandLineParser();
530 
531   StackSubCommand SC1("sc1", "First subcommand");
532   StackOption<bool> AllOpt("everywhere", cl::sub(cl::SubCommand::getAll()),
533                            cl::init(false));
534   StackSubCommand SC2("sc2", "Second subcommand");
535 
536   const char *args[] = {"prog", "-everywhere"};
537   const char *args2[] = {"prog", "sc1", "-everywhere"};
538   const char *args3[] = {"prog", "sc2", "-everywhere"};
539 
540   std::string Errs;
541   raw_string_ostream OS(Errs);
542 
543   EXPECT_FALSE(AllOpt);
544   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS));
545   EXPECT_TRUE(AllOpt);
546 
547   AllOpt = false;
548 
549   cl::ResetAllOptionOccurrences();
550   EXPECT_FALSE(AllOpt);
551   EXPECT_TRUE(cl::ParseCommandLineOptions(3, args2, StringRef(), &OS));
552   EXPECT_TRUE(AllOpt);
553 
554   AllOpt = false;
555 
556   cl::ResetAllOptionOccurrences();
557   EXPECT_FALSE(AllOpt);
558   EXPECT_TRUE(cl::ParseCommandLineOptions(3, args3, StringRef(), &OS));
559   EXPECT_TRUE(AllOpt);
560 
561   // Since all parsing succeeded, the error message should be empty.
562   OS.flush();
563   EXPECT_TRUE(Errs.empty());
564 }
565 
566 TEST(CommandLineTest, ReparseCommandLineOptions) {
567   cl::ResetCommandLineParser();
568 
569   StackOption<bool> TopLevelOpt(
570       "top-level", cl::sub(cl::SubCommand::getTopLevel()), cl::init(false));
571 
572   const char *args[] = {"prog", "-top-level"};
573 
574   EXPECT_FALSE(TopLevelOpt);
575   EXPECT_TRUE(
576       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
577   EXPECT_TRUE(TopLevelOpt);
578 
579   TopLevelOpt = false;
580 
581   cl::ResetAllOptionOccurrences();
582   EXPECT_FALSE(TopLevelOpt);
583   EXPECT_TRUE(
584       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
585   EXPECT_TRUE(TopLevelOpt);
586 }
587 
588 TEST(CommandLineTest, RemoveFromRegularSubCommand) {
589   cl::ResetCommandLineParser();
590 
591   StackSubCommand SC("sc", "Subcommand");
592   StackOption<bool> RemoveOption("remove-option", cl::sub(SC), cl::init(false));
593   StackOption<bool> KeepOption("keep-option", cl::sub(SC), cl::init(false));
594 
595   const char *args[] = {"prog", "sc", "-remove-option"};
596 
597   std::string Errs;
598   raw_string_ostream OS(Errs);
599 
600   EXPECT_FALSE(RemoveOption);
601   EXPECT_TRUE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS));
602   EXPECT_TRUE(RemoveOption);
603   OS.flush();
604   EXPECT_TRUE(Errs.empty());
605 
606   RemoveOption.removeArgument();
607 
608   cl::ResetAllOptionOccurrences();
609   EXPECT_FALSE(cl::ParseCommandLineOptions(3, args, StringRef(), &OS));
610   OS.flush();
611   EXPECT_FALSE(Errs.empty());
612 }
613 
614 TEST(CommandLineTest, RemoveFromTopLevelSubCommand) {
615   cl::ResetCommandLineParser();
616 
617   StackOption<bool> TopLevelRemove("top-level-remove",
618                                    cl::sub(cl::SubCommand::getTopLevel()),
619                                    cl::init(false));
620   StackOption<bool> TopLevelKeep("top-level-keep",
621                                  cl::sub(cl::SubCommand::getTopLevel()),
622                                  cl::init(false));
623 
624   const char *args[] = {"prog", "-top-level-remove"};
625 
626   EXPECT_FALSE(TopLevelRemove);
627   EXPECT_TRUE(
628       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
629   EXPECT_TRUE(TopLevelRemove);
630 
631   TopLevelRemove.removeArgument();
632 
633   cl::ResetAllOptionOccurrences();
634   EXPECT_FALSE(
635       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
636 }
637 
638 TEST(CommandLineTest, RemoveFromAllSubCommands) {
639   cl::ResetCommandLineParser();
640 
641   StackSubCommand SC1("sc1", "First Subcommand");
642   StackSubCommand SC2("sc2", "Second Subcommand");
643   StackOption<bool> RemoveOption(
644       "remove-option", cl::sub(cl::SubCommand::getAll()), cl::init(false));
645   StackOption<bool> KeepOption("keep-option", cl::sub(cl::SubCommand::getAll()),
646                                cl::init(false));
647 
648   const char *args0[] = {"prog", "-remove-option"};
649   const char *args1[] = {"prog", "sc1", "-remove-option"};
650   const char *args2[] = {"prog", "sc2", "-remove-option"};
651 
652   // It should work for all subcommands including the top-level.
653   EXPECT_FALSE(RemoveOption);
654   EXPECT_TRUE(
655       cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls()));
656   EXPECT_TRUE(RemoveOption);
657 
658   RemoveOption = false;
659 
660   cl::ResetAllOptionOccurrences();
661   EXPECT_FALSE(RemoveOption);
662   EXPECT_TRUE(
663       cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls()));
664   EXPECT_TRUE(RemoveOption);
665 
666   RemoveOption = false;
667 
668   cl::ResetAllOptionOccurrences();
669   EXPECT_FALSE(RemoveOption);
670   EXPECT_TRUE(
671       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
672   EXPECT_TRUE(RemoveOption);
673 
674   RemoveOption.removeArgument();
675 
676   // It should not work for any subcommands including the top-level.
677   cl::ResetAllOptionOccurrences();
678   EXPECT_FALSE(
679       cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls()));
680   cl::ResetAllOptionOccurrences();
681   EXPECT_FALSE(
682       cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls()));
683   cl::ResetAllOptionOccurrences();
684   EXPECT_FALSE(
685       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
686 }
687 
688 TEST(CommandLineTest, GetRegisteredSubcommands) {
689   cl::ResetCommandLineParser();
690 
691   StackSubCommand SC1("sc1", "First Subcommand");
692   StackOption<bool> Opt1("opt1", cl::sub(SC1), cl::init(false));
693   StackSubCommand SC2("sc2", "Second subcommand");
694   StackOption<bool> Opt2("opt2", cl::sub(SC2), cl::init(false));
695 
696   const char *args0[] = {"prog", "sc1"};
697   const char *args1[] = {"prog", "sc2"};
698 
699   EXPECT_TRUE(
700       cl::ParseCommandLineOptions(2, args0, StringRef(), &llvm::nulls()));
701   EXPECT_FALSE(Opt1);
702   EXPECT_FALSE(Opt2);
703   for (auto *S : cl::getRegisteredSubcommands()) {
704     if (*S) {
705       EXPECT_EQ("sc1", S->getName());
706     }
707   }
708 
709   cl::ResetAllOptionOccurrences();
710   EXPECT_TRUE(
711       cl::ParseCommandLineOptions(2, args1, StringRef(), &llvm::nulls()));
712   EXPECT_FALSE(Opt1);
713   EXPECT_FALSE(Opt2);
714   for (auto *S : cl::getRegisteredSubcommands()) {
715     if (*S) {
716       EXPECT_EQ("sc2", S->getName());
717     }
718   }
719 }
720 
721 TEST(CommandLineTest, DefaultOptions) {
722   cl::ResetCommandLineParser();
723 
724   StackOption<std::string> Bar("bar", cl::sub(cl::SubCommand::getAll()),
725                                cl::DefaultOption);
726   StackOption<std::string, cl::alias> Bar_Alias(
727       "b", cl::desc("Alias for -bar"), cl::aliasopt(Bar), cl::DefaultOption);
728 
729   StackOption<bool> Foo("foo", cl::init(false),
730                         cl::sub(cl::SubCommand::getAll()), cl::DefaultOption);
731   StackOption<bool, cl::alias> Foo_Alias("f", cl::desc("Alias for -foo"),
732                                          cl::aliasopt(Foo), cl::DefaultOption);
733 
734   StackSubCommand SC1("sc1", "First Subcommand");
735   // Override "-b" and change type in sc1 SubCommand.
736   StackOption<bool> SC1_B("b", cl::sub(SC1), cl::init(false));
737   StackSubCommand SC2("sc2", "Second subcommand");
738   // Override "-foo" and change type in sc2 SubCommand.  Note that this does not
739   // affect "-f" alias, which continues to work correctly.
740   StackOption<std::string> SC2_Foo("foo", cl::sub(SC2));
741 
742   const char *args0[] = {"prog", "-b", "args0 bar string", "-f"};
743   EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args0) / sizeof(char *), args0,
744                                           StringRef(), &llvm::nulls()));
745   EXPECT_EQ(Bar, "args0 bar string");
746   EXPECT_TRUE(Foo);
747   EXPECT_FALSE(SC1_B);
748   EXPECT_TRUE(SC2_Foo.empty());
749 
750   cl::ResetAllOptionOccurrences();
751 
752   const char *args1[] = {"prog", "sc1", "-b", "-bar", "args1 bar string", "-f"};
753   EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args1) / sizeof(char *), args1,
754                                           StringRef(), &llvm::nulls()));
755   EXPECT_EQ(Bar, "args1 bar string");
756   EXPECT_TRUE(Foo);
757   EXPECT_TRUE(SC1_B);
758   EXPECT_TRUE(SC2_Foo.empty());
759   for (auto *S : cl::getRegisteredSubcommands()) {
760     if (*S) {
761       EXPECT_EQ("sc1", S->getName());
762     }
763   }
764 
765   cl::ResetAllOptionOccurrences();
766 
767   const char *args2[] = {"prog", "sc2", "-b", "args2 bar string",
768                          "-f", "-foo", "foo string"};
769   EXPECT_TRUE(cl::ParseCommandLineOptions(sizeof(args2) / sizeof(char *), args2,
770                                           StringRef(), &llvm::nulls()));
771   EXPECT_EQ(Bar, "args2 bar string");
772   EXPECT_TRUE(Foo);
773   EXPECT_FALSE(SC1_B);
774   EXPECT_EQ(SC2_Foo, "foo string");
775   for (auto *S : cl::getRegisteredSubcommands()) {
776     if (*S) {
777       EXPECT_EQ("sc2", S->getName());
778     }
779   }
780   cl::ResetCommandLineParser();
781 }
782 
783 TEST(CommandLineTest, ArgumentLimit) {
784   std::string args(32 * 4096, 'a');
785   EXPECT_FALSE(llvm::sys::commandLineFitsWithinSystemLimits("cl", args.data()));
786   std::string args2(256, 'a');
787   EXPECT_TRUE(llvm::sys::commandLineFitsWithinSystemLimits("cl", args2.data()));
788 }
789 
790 TEST(CommandLineTest, ArgumentLimitWindows) {
791   if (!Triple(sys::getProcessTriple()).isOSWindows())
792     GTEST_SKIP();
793   // We use 32000 as a limit for command line length. Program name ('cl'),
794   // separating spaces and termination null character occupy 5 symbols.
795   std::string long_arg(32000 - 5, 'b');
796   EXPECT_TRUE(
797       llvm::sys::commandLineFitsWithinSystemLimits("cl", long_arg.data()));
798   long_arg += 'b';
799   EXPECT_FALSE(
800       llvm::sys::commandLineFitsWithinSystemLimits("cl", long_arg.data()));
801 }
802 
803 TEST(CommandLineTest, ResponseFileWindows) {
804   if (!Triple(sys::getProcessTriple()).isOSWindows())
805     GTEST_SKIP();
806 
807   StackOption<std::string, cl::list<std::string>> InputFilenames(
808       cl::Positional, cl::desc("<input files>"));
809   StackOption<bool> TopLevelOpt("top-level", cl::init(false));
810 
811   // Create response file.
812   TempFile ResponseFile("resp-", ".txt",
813                         "-top-level\npath\\dir\\file1\npath/dir/file2",
814                         /*Unique*/ true);
815 
816   llvm::SmallString<128> RspOpt;
817   RspOpt.append(1, '@');
818   RspOpt.append(ResponseFile.path());
819   const char *args[] = {"prog", RspOpt.c_str()};
820   EXPECT_FALSE(TopLevelOpt);
821   EXPECT_TRUE(
822       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
823   EXPECT_TRUE(TopLevelOpt);
824   EXPECT_EQ(InputFilenames[0], "path\\dir\\file1");
825   EXPECT_EQ(InputFilenames[1], "path/dir/file2");
826 }
827 
828 TEST(CommandLineTest, ResponseFiles) {
829   vfs::InMemoryFileSystem FS;
830 #ifdef _WIN32
831   const char *TestRoot = "C:\\";
832 #else
833   const char *TestRoot = "/";
834 #endif
835   FS.setCurrentWorkingDirectory(TestRoot);
836 
837   // Create included response file of first level.
838   llvm::StringRef IncludedFileName = "resp1";
839   FS.addFile(IncludedFileName, 0,
840              llvm::MemoryBuffer::getMemBuffer("-option_1 -option_2\n"
841                                               "@incdir/resp2\n"
842                                               "-option_3=abcd\n"
843                                               "@incdir/resp3\n"
844                                               "-option_4=efjk\n"));
845 
846   // Directory for included file.
847   llvm::StringRef IncDir = "incdir";
848 
849   // Create included response file of second level.
850   llvm::SmallString<128> IncludedFileName2;
851   llvm::sys::path::append(IncludedFileName2, IncDir, "resp2");
852   FS.addFile(IncludedFileName2, 0,
853              MemoryBuffer::getMemBuffer("-option_21 -option_22\n"
854                                         "-option_23=abcd\n"));
855 
856   // Create second included response file of second level.
857   llvm::SmallString<128> IncludedFileName3;
858   llvm::sys::path::append(IncludedFileName3, IncDir, "resp3");
859   FS.addFile(IncludedFileName3, 0,
860              MemoryBuffer::getMemBuffer("-option_31 -option_32\n"
861                                         "-option_33=abcd\n"));
862 
863   // Prepare 'file' with reference to response file.
864   SmallString<128> IncRef;
865   IncRef.append(1, '@');
866   IncRef.append(IncludedFileName);
867   llvm::SmallVector<const char *, 4> Argv = {"test/test", "-flag_1",
868                                              IncRef.c_str(), "-flag_2"};
869 
870   // Expand response files.
871   llvm::BumpPtrAllocator A;
872   llvm::cl::ExpansionContext ECtx(A, llvm::cl::TokenizeGNUCommandLine);
873   ECtx.setVFS(&FS).setCurrentDir(TestRoot).setRelativeNames(true);
874   ASSERT_TRUE(ECtx.expandResponseFiles(Argv));
875   EXPECT_THAT(Argv, testing::Pointwise(
876                         StringEquality(),
877                         {"test/test", "-flag_1", "-option_1", "-option_2",
878                          "-option_21", "-option_22", "-option_23=abcd",
879                          "-option_3=abcd", "-option_31", "-option_32",
880                          "-option_33=abcd", "-option_4=efjk", "-flag_2"}));
881 }
882 
883 TEST(CommandLineTest, RecursiveResponseFiles) {
884   vfs::InMemoryFileSystem FS;
885 #ifdef _WIN32
886   const char *TestRoot = "C:\\";
887 #else
888   const char *TestRoot = "/";
889 #endif
890   FS.setCurrentWorkingDirectory(TestRoot);
891 
892   StringRef SelfFilePath = "self.rsp";
893   std::string SelfFileRef = ("@" + SelfFilePath).str();
894 
895   StringRef NestedFilePath = "nested.rsp";
896   std::string NestedFileRef = ("@" + NestedFilePath).str();
897 
898   StringRef FlagFilePath = "flag.rsp";
899   std::string FlagFileRef = ("@" + FlagFilePath).str();
900 
901   std::string SelfFileContents;
902   raw_string_ostream SelfFile(SelfFileContents);
903   SelfFile << "-option_1\n";
904   SelfFile << FlagFileRef << "\n";
905   SelfFile << NestedFileRef << "\n";
906   SelfFile << SelfFileRef << "\n";
907   FS.addFile(SelfFilePath, 0, MemoryBuffer::getMemBuffer(SelfFile.str()));
908 
909   std::string NestedFileContents;
910   raw_string_ostream NestedFile(NestedFileContents);
911   NestedFile << "-option_2\n";
912   NestedFile << FlagFileRef << "\n";
913   NestedFile << SelfFileRef << "\n";
914   NestedFile << NestedFileRef << "\n";
915   FS.addFile(NestedFilePath, 0, MemoryBuffer::getMemBuffer(NestedFile.str()));
916 
917   std::string FlagFileContents;
918   raw_string_ostream FlagFile(FlagFileContents);
919   FlagFile << "-option_x\n";
920   FS.addFile(FlagFilePath, 0, MemoryBuffer::getMemBuffer(FlagFile.str()));
921 
922   // Ensure:
923   // Recursive expansion terminates
924   // Recursive files never expand
925   // Non-recursive repeats are allowed
926   SmallVector<const char *, 4> Argv = {"test/test", SelfFileRef.c_str(),
927                                        "-option_3"};
928   BumpPtrAllocator A;
929 #ifdef _WIN32
930   cl::TokenizerCallback Tokenizer = cl::TokenizeWindowsCommandLine;
931 #else
932   cl::TokenizerCallback Tokenizer = cl::TokenizeGNUCommandLine;
933 #endif
934   llvm::cl::ExpansionContext ECtx(A, Tokenizer);
935   ECtx.setVFS(&FS).setCurrentDir(TestRoot);
936   ASSERT_FALSE(ECtx.expandResponseFiles(Argv));
937 
938   EXPECT_THAT(Argv,
939               testing::Pointwise(StringEquality(),
940                                  {"test/test", "-option_1", "-option_x",
941                                   "-option_2", "-option_x", SelfFileRef.c_str(),
942                                   NestedFileRef.c_str(), SelfFileRef.c_str(),
943                                   "-option_3"}));
944 }
945 
946 TEST(CommandLineTest, ResponseFilesAtArguments) {
947   vfs::InMemoryFileSystem FS;
948 #ifdef _WIN32
949   const char *TestRoot = "C:\\";
950 #else
951   const char *TestRoot = "/";
952 #endif
953   FS.setCurrentWorkingDirectory(TestRoot);
954 
955   StringRef ResponseFilePath = "test.rsp";
956 
957   std::string ResponseFileContents;
958   raw_string_ostream ResponseFile(ResponseFileContents);
959   ResponseFile << "-foo" << "\n";
960   ResponseFile << "-bar" << "\n";
961   FS.addFile(ResponseFilePath, 0,
962              MemoryBuffer::getMemBuffer(ResponseFile.str()));
963 
964   // Ensure we expand rsp files after lots of non-rsp arguments starting with @.
965   constexpr size_t NON_RSP_AT_ARGS = 64;
966   SmallVector<const char *, 4> Argv = {"test/test"};
967   Argv.append(NON_RSP_AT_ARGS, "@non_rsp_at_arg");
968   std::string ResponseFileRef = ("@" + ResponseFilePath).str();
969   Argv.push_back(ResponseFileRef.c_str());
970 
971   BumpPtrAllocator A;
972   llvm::cl::ExpansionContext ECtx(A, cl::TokenizeGNUCommandLine);
973   ECtx.setVFS(&FS).setCurrentDir(TestRoot);
974   ASSERT_FALSE(ECtx.expandResponseFiles(Argv));
975 
976   // ASSERT instead of EXPECT to prevent potential out-of-bounds access.
977   ASSERT_EQ(Argv.size(), 1 + NON_RSP_AT_ARGS + 2);
978   size_t i = 0;
979   EXPECT_STREQ(Argv[i++], "test/test");
980   for (; i < 1 + NON_RSP_AT_ARGS; ++i)
981     EXPECT_STREQ(Argv[i], "@non_rsp_at_arg");
982   EXPECT_STREQ(Argv[i++], "-foo");
983   EXPECT_STREQ(Argv[i++], "-bar");
984 }
985 
986 TEST(CommandLineTest, ResponseFileRelativePath) {
987   vfs::InMemoryFileSystem FS;
988 #ifdef _WIN32
989   const char *TestRoot = "C:\\";
990 #else
991   const char *TestRoot = "//net";
992 #endif
993   FS.setCurrentWorkingDirectory(TestRoot);
994 
995   StringRef OuterFile = "dir/outer.rsp";
996   StringRef OuterFileContents = "@inner.rsp";
997   FS.addFile(OuterFile, 0, MemoryBuffer::getMemBuffer(OuterFileContents));
998 
999   StringRef InnerFile = "dir/inner.rsp";
1000   StringRef InnerFileContents = "-flag";
1001   FS.addFile(InnerFile, 0, MemoryBuffer::getMemBuffer(InnerFileContents));
1002 
1003   SmallVector<const char *, 2> Argv = {"test/test", "@dir/outer.rsp"};
1004 
1005   BumpPtrAllocator A;
1006   llvm::cl::ExpansionContext ECtx(A, cl::TokenizeGNUCommandLine);
1007   ECtx.setVFS(&FS).setCurrentDir(TestRoot).setRelativeNames(true);
1008   ASSERT_TRUE(ECtx.expandResponseFiles(Argv));
1009   EXPECT_THAT(Argv,
1010               testing::Pointwise(StringEquality(), {"test/test", "-flag"}));
1011 }
1012 
1013 TEST(CommandLineTest, ResponseFileEOLs) {
1014   vfs::InMemoryFileSystem FS;
1015 #ifdef _WIN32
1016   const char *TestRoot = "C:\\";
1017 #else
1018   const char *TestRoot = "//net";
1019 #endif
1020   FS.setCurrentWorkingDirectory(TestRoot);
1021   FS.addFile("eols.rsp", 0,
1022              MemoryBuffer::getMemBuffer("-Xclang -Wno-whatever\n input.cpp"));
1023   SmallVector<const char *, 2> Argv = {"clang", "@eols.rsp"};
1024   BumpPtrAllocator A;
1025   llvm::cl::ExpansionContext ECtx(A, cl::TokenizeWindowsCommandLine);
1026   ECtx.setVFS(&FS).setCurrentDir(TestRoot).setMarkEOLs(true).setRelativeNames(
1027       true);
1028   ASSERT_TRUE(ECtx.expandResponseFiles(Argv));
1029   const char *Expected[] = {"clang", "-Xclang", "-Wno-whatever", nullptr,
1030                             "input.cpp"};
1031   ASSERT_EQ(std::size(Expected), Argv.size());
1032   for (size_t I = 0, E = std::size(Expected); I < E; ++I) {
1033     if (Expected[I] == nullptr) {
1034       ASSERT_EQ(Argv[I], nullptr);
1035     } else {
1036       ASSERT_STREQ(Expected[I], Argv[I]);
1037     }
1038   }
1039 }
1040 
1041 TEST(CommandLineTest, SetDefaultValue) {
1042   cl::ResetCommandLineParser();
1043 
1044   StackOption<std::string> Opt1("opt1", cl::init("true"));
1045   StackOption<bool> Opt2("opt2", cl::init(true));
1046   cl::alias Alias("alias", llvm::cl::aliasopt(Opt2));
1047   StackOption<int> Opt3("opt3", cl::init(3));
1048 
1049   llvm::SmallVector<int, 3> IntVals = {1, 2, 3};
1050   llvm::SmallVector<std::string, 3> StrVals = {"foo", "bar", "baz"};
1051 
1052   StackOption<int, cl::list<int>> List1(
1053       "list1", cl::list_init<int>(llvm::ArrayRef<int>(IntVals)),
1054       cl::CommaSeparated);
1055   StackOption<std::string, cl::list<std::string>> List2(
1056       "list2", cl::list_init<std::string>(llvm::ArrayRef<std::string>(StrVals)),
1057       cl::CommaSeparated);
1058   cl::alias ListAlias("list-alias", llvm::cl::aliasopt(List2));
1059 
1060   const char *args[] = {"prog",   "-opt1=false", "-list1", "4",
1061                         "-list1", "5,6",         "-opt2",  "-opt3"};
1062 
1063   EXPECT_TRUE(
1064       cl::ParseCommandLineOptions(7, args, StringRef(), &llvm::nulls()));
1065 
1066   EXPECT_EQ(Opt1, "false");
1067   EXPECT_TRUE(Opt2);
1068   EXPECT_EQ(Opt3, 3);
1069 
1070   for (size_t I = 0, E = IntVals.size(); I < E; ++I) {
1071     EXPECT_EQ(IntVals[I] + 3, List1[I]);
1072     EXPECT_EQ(StrVals[I], List2[I]);
1073   }
1074 
1075   Opt2 = false;
1076   Opt3 = 1;
1077 
1078   cl::ResetAllOptionOccurrences();
1079 
1080   for (auto &OM : cl::getRegisteredOptions(cl::SubCommand::getTopLevel())) {
1081     cl::Option *O = OM.second;
1082     if (O->ArgStr == "opt2") {
1083       continue;
1084     }
1085     O->setDefault();
1086   }
1087 
1088   EXPECT_EQ(Opt1, "true");
1089   EXPECT_TRUE(Opt2);
1090   EXPECT_EQ(Opt3, 3);
1091   for (size_t I = 0, E = IntVals.size(); I < E; ++I) {
1092     EXPECT_EQ(IntVals[I], List1[I]);
1093     EXPECT_EQ(StrVals[I], List2[I]);
1094   }
1095 
1096   Alias.removeArgument();
1097   ListAlias.removeArgument();
1098 }
1099 
1100 TEST(CommandLineTest, ReadConfigFile) {
1101   llvm::SmallVector<const char *, 1> Argv;
1102 
1103   TempDir TestDir("unittest", /*Unique*/ true);
1104   TempDir TestSubDir(TestDir.path("subdir"), /*Unique*/ false);
1105 
1106   llvm::SmallString<128> TestCfg = TestDir.path("foo");
1107   TempFile ConfigFile(TestCfg, "",
1108                       "# Comment\n"
1109                       "-option_1\n"
1110                       "-option_2=<CFGDIR>/dir1\n"
1111                       "-option_3=<CFGDIR>\n"
1112                       "-option_4 <CFGDIR>\n"
1113                       "-option_5=<CFG\\\n"
1114                       "DIR>\n"
1115                       "-option_6=<CFGDIR>/dir1,<CFGDIR>/dir2\n"
1116                       "@subconfig\n"
1117                       "-option_11=abcd\n"
1118                       "-option_12=\\\n"
1119                       "cdef\n");
1120 
1121   llvm::SmallString<128> TestCfg2 = TestDir.path("subconfig");
1122   TempFile ConfigFile2(TestCfg2, "",
1123                        "-option_7\n"
1124                        "-option_8=<CFGDIR>/dir2\n"
1125                        "@subdir/subfoo\n"
1126                        "\n"
1127                        "   # comment\n");
1128 
1129   llvm::SmallString<128> TestCfg3 = TestSubDir.path("subfoo");
1130   TempFile ConfigFile3(TestCfg3, "",
1131                        "-option_9=<CFGDIR>/dir3\n"
1132                        "@<CFGDIR>/subfoo2\n");
1133 
1134   llvm::SmallString<128> TestCfg4 = TestSubDir.path("subfoo2");
1135   TempFile ConfigFile4(TestCfg4, "", "-option_10\n");
1136 
1137   // Make sure the current directory is not the directory where config files
1138   // resides. In this case the code that expands response files will not find
1139   // 'subconfig' unless it resolves nested inclusions relative to the including
1140   // file.
1141   llvm::SmallString<128> CurrDir;
1142   std::error_code EC = llvm::sys::fs::current_path(CurrDir);
1143   EXPECT_TRUE(!EC);
1144   EXPECT_NE(CurrDir.str(), TestDir.path());
1145 
1146   llvm::BumpPtrAllocator A;
1147   llvm::cl::ExpansionContext ECtx(A, cl::tokenizeConfigFile);
1148   bool Result = ECtx.readConfigFile(ConfigFile.path(), Argv);
1149 
1150   EXPECT_TRUE(Result);
1151   EXPECT_EQ(Argv.size(), 13U);
1152   EXPECT_STREQ(Argv[0], "-option_1");
1153   EXPECT_STREQ(Argv[1],
1154                ("-option_2=" + TestDir.path() + "/dir1").str().c_str());
1155   EXPECT_STREQ(Argv[2], ("-option_3=" + TestDir.path()).str().c_str());
1156   EXPECT_STREQ(Argv[3], "-option_4");
1157   EXPECT_STREQ(Argv[4], TestDir.path().str().c_str());
1158   EXPECT_STREQ(Argv[5], ("-option_5=" + TestDir.path()).str().c_str());
1159   EXPECT_STREQ(Argv[6], ("-option_6=" + TestDir.path() + "/dir1," +
1160                          TestDir.path() + "/dir2")
1161                             .str()
1162                             .c_str());
1163   EXPECT_STREQ(Argv[7], "-option_7");
1164   EXPECT_STREQ(Argv[8],
1165                ("-option_8=" + TestDir.path() + "/dir2").str().c_str());
1166   EXPECT_STREQ(Argv[9],
1167                ("-option_9=" + TestSubDir.path() + "/dir3").str().c_str());
1168   EXPECT_STREQ(Argv[10], "-option_10");
1169   EXPECT_STREQ(Argv[11], "-option_11=abcd");
1170   EXPECT_STREQ(Argv[12], "-option_12=cdef");
1171 }
1172 
1173 TEST(CommandLineTest, PositionalEatArgsError) {
1174   cl::ResetCommandLineParser();
1175 
1176   StackOption<std::string, cl::list<std::string>> PosEatArgs(
1177       "positional-eat-args", cl::Positional, cl::desc("<arguments>..."),
1178       cl::PositionalEatsArgs);
1179   StackOption<std::string, cl::list<std::string>> PosEatArgs2(
1180       "positional-eat-args2", cl::Positional, cl::desc("Some strings"),
1181       cl::PositionalEatsArgs);
1182 
1183   const char *args[] = {"prog", "-positional-eat-args=XXXX"};
1184   const char *args2[] = {"prog", "-positional-eat-args=XXXX", "-foo"};
1185   const char *args3[] = {"prog", "-positional-eat-args", "-foo"};
1186   const char *args4[] = {"prog", "-positional-eat-args",
1187                          "-foo", "-positional-eat-args2",
1188                          "-bar", "foo"};
1189 
1190   std::string Errs;
1191   raw_string_ostream OS(Errs);
1192   EXPECT_FALSE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS)); OS.flush();
1193   EXPECT_FALSE(Errs.empty()); Errs.clear();
1194   EXPECT_FALSE(cl::ParseCommandLineOptions(3, args2, StringRef(), &OS)); OS.flush();
1195   EXPECT_FALSE(Errs.empty()); Errs.clear();
1196   EXPECT_TRUE(cl::ParseCommandLineOptions(3, args3, StringRef(), &OS)); OS.flush();
1197   EXPECT_TRUE(Errs.empty()); Errs.clear();
1198 
1199   cl::ResetAllOptionOccurrences();
1200   EXPECT_TRUE(cl::ParseCommandLineOptions(6, args4, StringRef(), &OS)); OS.flush();
1201   EXPECT_EQ(PosEatArgs.size(), 1u);
1202   EXPECT_EQ(PosEatArgs2.size(), 2u);
1203   EXPECT_TRUE(Errs.empty());
1204 }
1205 
1206 #ifdef _WIN32
1207 void checkSeparators(StringRef Path) {
1208   char UndesiredSeparator = sys::path::get_separator()[0] == '/' ? '\\' : '/';
1209   ASSERT_EQ(Path.find(UndesiredSeparator), StringRef::npos);
1210 }
1211 
1212 TEST(CommandLineTest, GetCommandLineArguments) {
1213   int argc = __argc;
1214   char **argv = __argv;
1215 
1216   // GetCommandLineArguments is called in InitLLVM.
1217   llvm::InitLLVM X(argc, argv);
1218 
1219   EXPECT_EQ(llvm::sys::path::is_absolute(argv[0]),
1220             llvm::sys::path::is_absolute(__argv[0]));
1221   checkSeparators(argv[0]);
1222 
1223   EXPECT_TRUE(
1224       llvm::sys::path::filename(argv[0]).equals_insensitive("supporttests.exe"))
1225       << "Filename of test executable is "
1226       << llvm::sys::path::filename(argv[0]);
1227 }
1228 #endif
1229 
1230 class OutputRedirector {
1231 public:
1232   OutputRedirector(int RedirectFD)
1233       : RedirectFD(RedirectFD), OldFD(dup(RedirectFD)) {
1234     if (OldFD == -1 ||
1235         sys::fs::createTemporaryFile("unittest-redirect", "", NewFD,
1236                                      FilePath) ||
1237         dup2(NewFD, RedirectFD) == -1)
1238       Valid = false;
1239   }
1240 
1241   ~OutputRedirector() {
1242     dup2(OldFD, RedirectFD);
1243     close(OldFD);
1244     close(NewFD);
1245   }
1246 
1247   SmallVector<char, 128> FilePath;
1248   bool Valid = true;
1249 
1250 private:
1251   int RedirectFD;
1252   int OldFD;
1253   int NewFD;
1254 };
1255 
1256 struct AutoDeleteFile {
1257   SmallVector<char, 128> FilePath;
1258   ~AutoDeleteFile() {
1259     if (!FilePath.empty())
1260       sys::fs::remove(std::string(FilePath.data(), FilePath.size()));
1261   }
1262 };
1263 
1264 class PrintOptionInfoTest : public ::testing::Test {
1265 public:
1266   // Return std::string because the output of a failing EXPECT check is
1267   // unreadable for StringRef. It also avoids any lifetime issues.
1268   template <typename... Ts> std::string runTest(Ts... OptionAttributes) {
1269     outs().flush();  // flush any output from previous tests
1270     AutoDeleteFile File;
1271     {
1272       OutputRedirector Stdout(fileno(stdout));
1273       if (!Stdout.Valid)
1274         return "";
1275       File.FilePath = Stdout.FilePath;
1276 
1277       StackOption<OptionValue> TestOption(Opt, cl::desc(HelpText),
1278                                           OptionAttributes...);
1279       printOptionInfo(TestOption, 26);
1280       outs().flush();
1281     }
1282     auto Buffer = MemoryBuffer::getFile(File.FilePath);
1283     if (!Buffer)
1284       return "";
1285     return Buffer->get()->getBuffer().str();
1286   }
1287 
1288   enum class OptionValue { Val };
1289   const StringRef Opt = "some-option";
1290   const StringRef HelpText = "some help";
1291 
1292 private:
1293   // This is a workaround for cl::Option sub-classes having their
1294   // printOptionInfo functions private.
1295   void printOptionInfo(const cl::Option &O, size_t Width) {
1296     O.printOptionInfo(Width);
1297   }
1298 };
1299 
1300 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithoutSentinel) {
1301   std::string Output =
1302       runTest(cl::ValueOptional,
1303               cl::values(clEnumValN(OptionValue::Val, "v1", "desc1")));
1304 
1305   // clang-format off
1306   EXPECT_EQ(Output, ("  --" + Opt + "=<value> - " + HelpText + "\n"
1307                      "    =v1                 -   desc1\n")
1308                         .str());
1309   // clang-format on
1310 }
1311 
1312 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinel) {
1313   std::string Output = runTest(
1314       cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1315                                     clEnumValN(OptionValue::Val, "", "")));
1316 
1317   // clang-format off
1318   EXPECT_EQ(Output,
1319             ("  --" + Opt + "         - " + HelpText + "\n"
1320              "  --" + Opt + "=<value> - " + HelpText + "\n"
1321              "    =v1                 -   desc1\n")
1322                 .str());
1323   // clang-format on
1324 }
1325 
1326 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinelWithHelp) {
1327   std::string Output = runTest(
1328       cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1329                                     clEnumValN(OptionValue::Val, "", "desc2")));
1330 
1331   // clang-format off
1332   EXPECT_EQ(Output, ("  --" + Opt + "         - " + HelpText + "\n"
1333                      "  --" + Opt + "=<value> - " + HelpText + "\n"
1334                      "    =v1                 -   desc1\n"
1335                      "    =<empty>            -   desc2\n")
1336                         .str());
1337   // clang-format on
1338 }
1339 
1340 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueRequiredWithEmptyValueName) {
1341   std::string Output = runTest(
1342       cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1343                                     clEnumValN(OptionValue::Val, "", "")));
1344 
1345   // clang-format off
1346   EXPECT_EQ(Output, ("  --" + Opt + "=<value> - " + HelpText + "\n"
1347                      "    =v1                 -   desc1\n"
1348                      "    =<empty>\n")
1349                         .str());
1350   // clang-format on
1351 }
1352 
1353 TEST_F(PrintOptionInfoTest, PrintOptionInfoEmptyValueDescription) {
1354   std::string Output = runTest(
1355       cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", "")));
1356 
1357   // clang-format off
1358   EXPECT_EQ(Output,
1359             ("  --" + Opt + "=<value> - " + HelpText + "\n"
1360              "    =v1\n").str());
1361   // clang-format on
1362 }
1363 
1364 TEST_F(PrintOptionInfoTest, PrintOptionInfoMultilineValueDescription) {
1365   std::string Output =
1366       runTest(cl::ValueRequired,
1367               cl::values(clEnumValN(OptionValue::Val, "v1",
1368                                     "This is the first enum value\n"
1369                                     "which has a really long description\n"
1370                                     "thus it is multi-line."),
1371                          clEnumValN(OptionValue::Val, "",
1372                                     "This is an unnamed enum value option\n"
1373                                     "Should be indented as well")));
1374 
1375   // clang-format off
1376   EXPECT_EQ(Output,
1377             ("  --" + Opt + "=<value> - " + HelpText + "\n"
1378              "    =v1                 -   This is the first enum value\n"
1379              "                            which has a really long description\n"
1380              "                            thus it is multi-line.\n"
1381              "    =<empty>            -   This is an unnamed enum value option\n"
1382              "                            Should be indented as well\n").str());
1383   // clang-format on
1384 }
1385 
1386 class GetOptionWidthTest : public ::testing::Test {
1387 public:
1388   enum class OptionValue { Val };
1389 
1390   template <typename... Ts>
1391   size_t runTest(StringRef ArgName, Ts... OptionAttributes) {
1392     StackOption<OptionValue> TestOption(ArgName, cl::desc("some help"),
1393                                         OptionAttributes...);
1394     return getOptionWidth(TestOption);
1395   }
1396 
1397 private:
1398   // This is a workaround for cl::Option sub-classes having their
1399   // printOptionInfo
1400   // functions private.
1401   size_t getOptionWidth(const cl::Option &O) { return O.getOptionWidth(); }
1402 };
1403 
1404 TEST_F(GetOptionWidthTest, GetOptionWidthArgNameLonger) {
1405   StringRef ArgName("a-long-argument-name");
1406   size_t ExpectedStrSize = ("  --" + ArgName + "=<value> - ").str().size();
1407   EXPECT_EQ(
1408       runTest(ArgName, cl::values(clEnumValN(OptionValue::Val, "v", "help"))),
1409       ExpectedStrSize);
1410 }
1411 
1412 TEST_F(GetOptionWidthTest, GetOptionWidthFirstOptionNameLonger) {
1413   StringRef OptName("a-long-option-name");
1414   size_t ExpectedStrSize = ("    =" + OptName + " - ").str().size();
1415   EXPECT_EQ(
1416       runTest("a", cl::values(clEnumValN(OptionValue::Val, OptName, "help"),
1417                               clEnumValN(OptionValue::Val, "b", "help"))),
1418       ExpectedStrSize);
1419 }
1420 
1421 TEST_F(GetOptionWidthTest, GetOptionWidthSecondOptionNameLonger) {
1422   StringRef OptName("a-long-option-name");
1423   size_t ExpectedStrSize = ("    =" + OptName + " - ").str().size();
1424   EXPECT_EQ(
1425       runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"),
1426                               clEnumValN(OptionValue::Val, OptName, "help"))),
1427       ExpectedStrSize);
1428 }
1429 
1430 TEST_F(GetOptionWidthTest, GetOptionWidthEmptyOptionNameLonger) {
1431   size_t ExpectedStrSize = StringRef("    =<empty> - ").size();
1432   // The length of a=<value> (including indentation) is actually the same as the
1433   // =<empty> string, so it is impossible to distinguish via testing the case
1434   // where the empty string is picked from where the option name is picked.
1435   EXPECT_EQ(runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"),
1436                                     clEnumValN(OptionValue::Val, "", "help"))),
1437             ExpectedStrSize);
1438 }
1439 
1440 TEST_F(GetOptionWidthTest,
1441        GetOptionWidthValueOptionalEmptyOptionWithNoDescription) {
1442   StringRef ArgName("a");
1443   // The length of a=<value> (including indentation) is actually the same as the
1444   // =<empty> string, so it is impossible to distinguish via testing the case
1445   // where the empty string is ignored from where it is not ignored.
1446   // The dash will not actually be printed, but the space it would take up is
1447   // included to ensure a consistent column width.
1448   size_t ExpectedStrSize = ("  -" + ArgName + "=<value> - ").str().size();
1449   EXPECT_EQ(runTest(ArgName, cl::ValueOptional,
1450                     cl::values(clEnumValN(OptionValue::Val, "value", "help"),
1451                                clEnumValN(OptionValue::Val, "", ""))),
1452             ExpectedStrSize);
1453 }
1454 
1455 TEST_F(GetOptionWidthTest,
1456        GetOptionWidthValueRequiredEmptyOptionWithNoDescription) {
1457   // The length of a=<value> (including indentation) is actually the same as the
1458   // =<empty> string, so it is impossible to distinguish via testing the case
1459   // where the empty string is picked from where the option name is picked
1460   size_t ExpectedStrSize = StringRef("    =<empty> - ").size();
1461   EXPECT_EQ(runTest("a", cl::ValueRequired,
1462                     cl::values(clEnumValN(OptionValue::Val, "value", "help"),
1463                                clEnumValN(OptionValue::Val, "", ""))),
1464             ExpectedStrSize);
1465 }
1466 
1467 TEST(CommandLineTest, PrefixOptions) {
1468   cl::ResetCommandLineParser();
1469 
1470   StackOption<std::string, cl::list<std::string>> IncludeDirs(
1471       "I", cl::Prefix, cl::desc("Declare an include directory"));
1472 
1473   // Test non-prefixed variant works with cl::Prefix options.
1474   EXPECT_TRUE(IncludeDirs.empty());
1475   const char *args[] = {"prog", "-I=/usr/include"};
1476   EXPECT_TRUE(
1477       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
1478   EXPECT_EQ(IncludeDirs.size(), 1u);
1479   EXPECT_EQ(IncludeDirs.front().compare("/usr/include"), 0);
1480 
1481   IncludeDirs.erase(IncludeDirs.begin());
1482   cl::ResetAllOptionOccurrences();
1483 
1484   // Test non-prefixed variant works with cl::Prefix options when value is
1485   // passed in following argument.
1486   EXPECT_TRUE(IncludeDirs.empty());
1487   const char *args2[] = {"prog", "-I", "/usr/include"};
1488   EXPECT_TRUE(
1489       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1490   EXPECT_EQ(IncludeDirs.size(), 1u);
1491   EXPECT_EQ(IncludeDirs.front().compare("/usr/include"), 0);
1492 
1493   IncludeDirs.erase(IncludeDirs.begin());
1494   cl::ResetAllOptionOccurrences();
1495 
1496   // Test prefixed variant works with cl::Prefix options.
1497   EXPECT_TRUE(IncludeDirs.empty());
1498   const char *args3[] = {"prog", "-I/usr/include"};
1499   EXPECT_TRUE(
1500       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1501   EXPECT_EQ(IncludeDirs.size(), 1u);
1502   EXPECT_EQ(IncludeDirs.front().compare("/usr/include"), 0);
1503 
1504   StackOption<std::string, cl::list<std::string>> MacroDefs(
1505       "D", cl::AlwaysPrefix, cl::desc("Define a macro"),
1506       cl::value_desc("MACRO[=VALUE]"));
1507 
1508   cl::ResetAllOptionOccurrences();
1509 
1510   // Test non-prefixed variant does not work with cl::AlwaysPrefix options:
1511   // equal sign is part of the value.
1512   EXPECT_TRUE(MacroDefs.empty());
1513   const char *args4[] = {"prog", "-D=HAVE_FOO"};
1514   EXPECT_TRUE(
1515       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1516   EXPECT_EQ(MacroDefs.size(), 1u);
1517   EXPECT_EQ(MacroDefs.front().compare("=HAVE_FOO"), 0);
1518 
1519   MacroDefs.erase(MacroDefs.begin());
1520   cl::ResetAllOptionOccurrences();
1521 
1522   // Test non-prefixed variant does not allow value to be passed in following
1523   // argument with cl::AlwaysPrefix options.
1524   EXPECT_TRUE(MacroDefs.empty());
1525   const char *args5[] = {"prog", "-D", "HAVE_FOO"};
1526   EXPECT_FALSE(
1527       cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls()));
1528   EXPECT_TRUE(MacroDefs.empty());
1529 
1530   cl::ResetAllOptionOccurrences();
1531 
1532   // Test prefixed variant works with cl::AlwaysPrefix options.
1533   EXPECT_TRUE(MacroDefs.empty());
1534   const char *args6[] = {"prog", "-DHAVE_FOO"};
1535   EXPECT_TRUE(
1536       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1537   EXPECT_EQ(MacroDefs.size(), 1u);
1538   EXPECT_EQ(MacroDefs.front().compare("HAVE_FOO"), 0);
1539 }
1540 
1541 TEST(CommandLineTest, GroupingWithValue) {
1542   cl::ResetCommandLineParser();
1543 
1544   StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag"));
1545   StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag"));
1546   StackOption<bool> OptD("d", cl::Grouping, cl::ValueDisallowed,
1547                          cl::desc("ValueDisallowed option"));
1548   StackOption<std::string> OptV("v", cl::Grouping,
1549                                 cl::desc("ValueRequired option"));
1550   StackOption<std::string> OptO("o", cl::Grouping, cl::ValueOptional,
1551                                 cl::desc("ValueOptional option"));
1552 
1553   // Should be possible to use an option which requires a value
1554   // at the end of a group.
1555   const char *args1[] = {"prog", "-fv", "val1"};
1556   EXPECT_TRUE(
1557       cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls()));
1558   EXPECT_TRUE(OptF);
1559   EXPECT_STREQ("val1", OptV.c_str());
1560   OptV.clear();
1561   cl::ResetAllOptionOccurrences();
1562 
1563   // Should not crash if it is accidentally used elsewhere in the group.
1564   const char *args2[] = {"prog", "-vf", "val2"};
1565   EXPECT_FALSE(
1566       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1567   OptV.clear();
1568   cl::ResetAllOptionOccurrences();
1569 
1570   // Should allow the "opt=value" form at the end of the group
1571   const char *args3[] = {"prog", "-fv=val3"};
1572   EXPECT_TRUE(
1573       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1574   EXPECT_TRUE(OptF);
1575   EXPECT_STREQ("val3", OptV.c_str());
1576   OptV.clear();
1577   cl::ResetAllOptionOccurrences();
1578 
1579   // Should allow assigning a value for a ValueOptional option
1580   // at the end of the group
1581   const char *args4[] = {"prog", "-fo=val4"};
1582   EXPECT_TRUE(
1583       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1584   EXPECT_TRUE(OptF);
1585   EXPECT_STREQ("val4", OptO.c_str());
1586   OptO.clear();
1587   cl::ResetAllOptionOccurrences();
1588 
1589   // Should assign an empty value if a ValueOptional option is used elsewhere
1590   // in the group.
1591   const char *args5[] = {"prog", "-fob"};
1592   EXPECT_TRUE(
1593       cl::ParseCommandLineOptions(2, args5, StringRef(), &llvm::nulls()));
1594   EXPECT_TRUE(OptF);
1595   EXPECT_EQ(1, OptO.getNumOccurrences());
1596   EXPECT_EQ(1, OptB.getNumOccurrences());
1597   EXPECT_TRUE(OptO.empty());
1598   cl::ResetAllOptionOccurrences();
1599 
1600   // Should not allow an assignment for a ValueDisallowed option.
1601   const char *args6[] = {"prog", "-fd=false"};
1602   EXPECT_FALSE(
1603       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1604 }
1605 
1606 TEST(CommandLineTest, GroupingAndPrefix) {
1607   cl::ResetCommandLineParser();
1608 
1609   StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag"));
1610   StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag"));
1611   StackOption<std::string> OptP("p", cl::Prefix, cl::Grouping,
1612                                 cl::desc("Prefix and Grouping"));
1613   StackOption<std::string> OptA("a", cl::AlwaysPrefix, cl::Grouping,
1614                                 cl::desc("AlwaysPrefix and Grouping"));
1615 
1616   // Should be possible to use a cl::Prefix option without grouping.
1617   const char *args1[] = {"prog", "-pval1"};
1618   EXPECT_TRUE(
1619       cl::ParseCommandLineOptions(2, args1, StringRef(), &llvm::nulls()));
1620   EXPECT_STREQ("val1", OptP.c_str());
1621   OptP.clear();
1622   cl::ResetAllOptionOccurrences();
1623 
1624   // Should be possible to pass a value in a separate argument.
1625   const char *args2[] = {"prog", "-p", "val2"};
1626   EXPECT_TRUE(
1627       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1628   EXPECT_STREQ("val2", OptP.c_str());
1629   OptP.clear();
1630   cl::ResetAllOptionOccurrences();
1631 
1632   // The "-opt=value" form should work, too.
1633   const char *args3[] = {"prog", "-p=val3"};
1634   EXPECT_TRUE(
1635       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1636   EXPECT_STREQ("val3", OptP.c_str());
1637   OptP.clear();
1638   cl::ResetAllOptionOccurrences();
1639 
1640   // All three previous cases should work the same way if an option with both
1641   // cl::Prefix and cl::Grouping modifiers is used at the end of a group.
1642   const char *args4[] = {"prog", "-fpval4"};
1643   EXPECT_TRUE(
1644       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1645   EXPECT_TRUE(OptF);
1646   EXPECT_STREQ("val4", OptP.c_str());
1647   OptP.clear();
1648   cl::ResetAllOptionOccurrences();
1649 
1650   const char *args5[] = {"prog", "-fp", "val5"};
1651   EXPECT_TRUE(
1652       cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls()));
1653   EXPECT_TRUE(OptF);
1654   EXPECT_STREQ("val5", OptP.c_str());
1655   OptP.clear();
1656   cl::ResetAllOptionOccurrences();
1657 
1658   const char *args6[] = {"prog", "-fp=val6"};
1659   EXPECT_TRUE(
1660       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1661   EXPECT_TRUE(OptF);
1662   EXPECT_STREQ("val6", OptP.c_str());
1663   OptP.clear();
1664   cl::ResetAllOptionOccurrences();
1665 
1666   // Should assign a value even if the part after a cl::Prefix option is equal
1667   // to the name of another option.
1668   const char *args7[] = {"prog", "-fpb"};
1669   EXPECT_TRUE(
1670       cl::ParseCommandLineOptions(2, args7, StringRef(), &llvm::nulls()));
1671   EXPECT_TRUE(OptF);
1672   EXPECT_STREQ("b", OptP.c_str());
1673   EXPECT_FALSE(OptB);
1674   OptP.clear();
1675   cl::ResetAllOptionOccurrences();
1676 
1677   // Should be possible to use a cl::AlwaysPrefix option without grouping.
1678   const char *args8[] = {"prog", "-aval8"};
1679   EXPECT_TRUE(
1680       cl::ParseCommandLineOptions(2, args8, StringRef(), &llvm::nulls()));
1681   EXPECT_STREQ("val8", OptA.c_str());
1682   OptA.clear();
1683   cl::ResetAllOptionOccurrences();
1684 
1685   // Should not be possible to pass a value in a separate argument.
1686   const char *args9[] = {"prog", "-a", "val9"};
1687   EXPECT_FALSE(
1688       cl::ParseCommandLineOptions(3, args9, StringRef(), &llvm::nulls()));
1689   cl::ResetAllOptionOccurrences();
1690 
1691   // With the "-opt=value" form, the "=" symbol should be preserved.
1692   const char *args10[] = {"prog", "-a=val10"};
1693   EXPECT_TRUE(
1694       cl::ParseCommandLineOptions(2, args10, StringRef(), &llvm::nulls()));
1695   EXPECT_STREQ("=val10", OptA.c_str());
1696   OptA.clear();
1697   cl::ResetAllOptionOccurrences();
1698 
1699   // All three previous cases should work the same way if an option with both
1700   // cl::AlwaysPrefix and cl::Grouping modifiers is used at the end of a group.
1701   const char *args11[] = {"prog", "-faval11"};
1702   EXPECT_TRUE(
1703       cl::ParseCommandLineOptions(2, args11, StringRef(), &llvm::nulls()));
1704   EXPECT_TRUE(OptF);
1705   EXPECT_STREQ("val11", OptA.c_str());
1706   OptA.clear();
1707   cl::ResetAllOptionOccurrences();
1708 
1709   const char *args12[] = {"prog", "-fa", "val12"};
1710   EXPECT_FALSE(
1711       cl::ParseCommandLineOptions(3, args12, StringRef(), &llvm::nulls()));
1712   cl::ResetAllOptionOccurrences();
1713 
1714   const char *args13[] = {"prog", "-fa=val13"};
1715   EXPECT_TRUE(
1716       cl::ParseCommandLineOptions(2, args13, StringRef(), &llvm::nulls()));
1717   EXPECT_TRUE(OptF);
1718   EXPECT_STREQ("=val13", OptA.c_str());
1719   OptA.clear();
1720   cl::ResetAllOptionOccurrences();
1721 
1722   // Should assign a value even if the part after a cl::AlwaysPrefix option
1723   // is equal to the name of another option.
1724   const char *args14[] = {"prog", "-fab"};
1725   EXPECT_TRUE(
1726       cl::ParseCommandLineOptions(2, args14, StringRef(), &llvm::nulls()));
1727   EXPECT_TRUE(OptF);
1728   EXPECT_STREQ("b", OptA.c_str());
1729   EXPECT_FALSE(OptB);
1730   OptA.clear();
1731   cl::ResetAllOptionOccurrences();
1732 }
1733 
1734 TEST(CommandLineTest, LongOptions) {
1735   cl::ResetCommandLineParser();
1736 
1737   StackOption<bool> OptA("a", cl::desc("Some flag"));
1738   StackOption<bool> OptBLong("long-flag", cl::desc("Some long flag"));
1739   StackOption<bool, cl::alias> OptB("b", cl::desc("Alias to --long-flag"),
1740                                     cl::aliasopt(OptBLong));
1741   StackOption<std::string> OptAB("ab", cl::desc("Another long option"));
1742 
1743   std::string Errs;
1744   raw_string_ostream OS(Errs);
1745 
1746   const char *args1[] = {"prog", "-a", "-ab", "val1"};
1747   const char *args2[] = {"prog", "-a", "--ab", "val1"};
1748   const char *args3[] = {"prog", "-ab", "--ab", "val1"};
1749 
1750   //
1751   // The following tests treat `-` and `--` the same, and always match the
1752   // longest string.
1753   //
1754 
1755   EXPECT_TRUE(
1756       cl::ParseCommandLineOptions(4, args1, StringRef(), &OS)); OS.flush();
1757   EXPECT_TRUE(OptA);
1758   EXPECT_FALSE(OptBLong);
1759   EXPECT_STREQ("val1", OptAB.c_str());
1760   EXPECT_TRUE(Errs.empty()); Errs.clear();
1761   cl::ResetAllOptionOccurrences();
1762 
1763   EXPECT_TRUE(
1764       cl::ParseCommandLineOptions(4, args2, StringRef(), &OS)); OS.flush();
1765   EXPECT_TRUE(OptA);
1766   EXPECT_FALSE(OptBLong);
1767   EXPECT_STREQ("val1", OptAB.c_str());
1768   EXPECT_TRUE(Errs.empty()); Errs.clear();
1769   cl::ResetAllOptionOccurrences();
1770 
1771   // Fails because `-ab` and `--ab` are treated the same and appear more than
1772   // once.  Also, `val1` is unexpected.
1773   EXPECT_FALSE(
1774       cl::ParseCommandLineOptions(4, args3, StringRef(), &OS)); OS.flush();
1775   outs()<< Errs << "\n";
1776   EXPECT_FALSE(Errs.empty()); Errs.clear();
1777   cl::ResetAllOptionOccurrences();
1778 
1779   //
1780   // The following tests treat `-` and `--` differently, with `-` for short, and
1781   // `--` for long options.
1782   //
1783 
1784   // Fails because `-ab` is treated as `-a -b`, so `-a` is seen twice, and
1785   // `val1` is unexpected.
1786   EXPECT_FALSE(cl::ParseCommandLineOptions(4, args1, StringRef(),
1787                                            &OS, nullptr, true)); OS.flush();
1788   EXPECT_FALSE(Errs.empty()); Errs.clear();
1789   cl::ResetAllOptionOccurrences();
1790 
1791   // Works because `-a` is treated differently than `--ab`.
1792   EXPECT_TRUE(cl::ParseCommandLineOptions(4, args2, StringRef(),
1793                                            &OS, nullptr, true)); OS.flush();
1794   EXPECT_TRUE(Errs.empty()); Errs.clear();
1795   cl::ResetAllOptionOccurrences();
1796 
1797   // Works because `-ab` is treated as `-a -b`, and `--ab` is a long option.
1798   EXPECT_TRUE(cl::ParseCommandLineOptions(4, args3, StringRef(),
1799                                            &OS, nullptr, true));
1800   EXPECT_TRUE(OptA);
1801   EXPECT_TRUE(OptBLong);
1802   EXPECT_STREQ("val1", OptAB.c_str());
1803   OS.flush();
1804   EXPECT_TRUE(Errs.empty()); Errs.clear();
1805   cl::ResetAllOptionOccurrences();
1806 }
1807 
1808 TEST(CommandLineTest, OptionErrorMessage) {
1809   // When there is an error, we expect some error message like:
1810   //   prog: for the -a option: [...]
1811   //
1812   // Test whether the "for the -a option"-part is correctly formatted.
1813   cl::ResetCommandLineParser();
1814 
1815   StackOption<bool> OptA("a", cl::desc("Some option"));
1816   StackOption<bool> OptLong("long", cl::desc("Some long option"));
1817 
1818   std::string Errs;
1819   raw_string_ostream OS(Errs);
1820 
1821   OptA.error("custom error", OS);
1822   OS.flush();
1823   EXPECT_NE(Errs.find("for the -a option:"), std::string::npos);
1824   Errs.clear();
1825 
1826   OptLong.error("custom error", OS);
1827   OS.flush();
1828   EXPECT_NE(Errs.find("for the --long option:"), std::string::npos);
1829   Errs.clear();
1830 
1831   cl::ResetAllOptionOccurrences();
1832 }
1833 
1834 TEST(CommandLineTest, OptionErrorMessageSuggest) {
1835   // When there is an error, and the edit-distance is not very large,
1836   // we expect some error message like:
1837   //   prog: did you mean '--option'?
1838   //
1839   // Test whether this message is well-formatted.
1840   cl::ResetCommandLineParser();
1841 
1842   StackOption<bool> OptLong("aluminium", cl::desc("Some long option"));
1843 
1844   const char *args[] = {"prog", "--aluminum"};
1845 
1846   std::string Errs;
1847   raw_string_ostream OS(Errs);
1848 
1849   EXPECT_FALSE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS));
1850   OS.flush();
1851   EXPECT_NE(Errs.find("prog: Did you mean '--aluminium'?\n"),
1852             std::string::npos);
1853   Errs.clear();
1854 
1855   cl::ResetAllOptionOccurrences();
1856 }
1857 
1858 TEST(CommandLineTest, OptionErrorMessageSuggestNoHidden) {
1859   // We expect that 'really hidden' option do not show up in option
1860   // suggestions.
1861   cl::ResetCommandLineParser();
1862 
1863   StackOption<bool> OptLong("aluminium", cl::desc("Some long option"));
1864   StackOption<bool> OptLong2("aluminum", cl::desc("Bad option"),
1865                              cl::ReallyHidden);
1866 
1867   const char *args[] = {"prog", "--alumnum"};
1868 
1869   std::string Errs;
1870   raw_string_ostream OS(Errs);
1871 
1872   EXPECT_FALSE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS));
1873   OS.flush();
1874   EXPECT_NE(Errs.find("prog: Did you mean '--aluminium'?\n"),
1875             std::string::npos);
1876   Errs.clear();
1877 
1878   cl::ResetAllOptionOccurrences();
1879 }
1880 
1881 TEST(CommandLineTest, Callback) {
1882   cl::ResetCommandLineParser();
1883 
1884   StackOption<bool> OptA("a", cl::desc("option a"));
1885   StackOption<bool> OptB(
1886       "b", cl::desc("option b -- This option turns on option a"),
1887       cl::callback([&](const bool &) { OptA = true; }));
1888   StackOption<bool> OptC(
1889       "c", cl::desc("option c -- This option turns on options a and b"),
1890       cl::callback([&](const bool &) { OptB = true; }));
1891   StackOption<std::string, cl::list<std::string>> List(
1892       "list",
1893       cl::desc("option list -- This option turns on options a, b, and c when "
1894                "'foo' is included in list"),
1895       cl::CommaSeparated,
1896       cl::callback([&](const std::string &Str) {
1897         if (Str == "foo")
1898           OptC = true;
1899       }));
1900 
1901   const char *args1[] = {"prog", "-a"};
1902   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args1));
1903   EXPECT_TRUE(OptA);
1904   EXPECT_FALSE(OptB);
1905   EXPECT_FALSE(OptC);
1906   EXPECT_EQ(List.size(), 0u);
1907   cl::ResetAllOptionOccurrences();
1908 
1909   const char *args2[] = {"prog", "-b"};
1910   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args2));
1911   EXPECT_TRUE(OptA);
1912   EXPECT_TRUE(OptB);
1913   EXPECT_FALSE(OptC);
1914   EXPECT_EQ(List.size(), 0u);
1915   cl::ResetAllOptionOccurrences();
1916 
1917   const char *args3[] = {"prog", "-c"};
1918   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args3));
1919   EXPECT_TRUE(OptA);
1920   EXPECT_TRUE(OptB);
1921   EXPECT_TRUE(OptC);
1922   EXPECT_EQ(List.size(), 0u);
1923   cl::ResetAllOptionOccurrences();
1924 
1925   const char *args4[] = {"prog", "--list=foo,bar"};
1926   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args4));
1927   EXPECT_TRUE(OptA);
1928   EXPECT_TRUE(OptB);
1929   EXPECT_TRUE(OptC);
1930   EXPECT_EQ(List.size(), 2u);
1931   cl::ResetAllOptionOccurrences();
1932 
1933   const char *args5[] = {"prog", "--list=bar"};
1934   EXPECT_TRUE(cl::ParseCommandLineOptions(2, args5));
1935   EXPECT_FALSE(OptA);
1936   EXPECT_FALSE(OptB);
1937   EXPECT_FALSE(OptC);
1938   EXPECT_EQ(List.size(), 1u);
1939 
1940   cl::ResetAllOptionOccurrences();
1941 }
1942 
1943 enum Enum { Val1, Val2 };
1944 static cl::bits<Enum> ExampleBits(
1945     cl::desc("An example cl::bits to ensure it compiles"),
1946     cl::values(
1947       clEnumValN(Val1, "bits-val1", "The Val1 value"),
1948       clEnumValN(Val1, "bits-val2", "The Val2 value")));
1949 
1950 TEST(CommandLineTest, ConsumeAfterOnePositional) {
1951   cl::ResetCommandLineParser();
1952 
1953   // input [args]
1954   StackOption<std::string, cl::opt<std::string>> Input(cl::Positional,
1955                                                        cl::Required);
1956   StackOption<std::string, cl::list<std::string>> ExtraArgs(cl::ConsumeAfter);
1957 
1958   const char *Args[] = {"prog", "input", "arg1", "arg2"};
1959 
1960   std::string Errs;
1961   raw_string_ostream OS(Errs);
1962   EXPECT_TRUE(cl::ParseCommandLineOptions(4, Args, StringRef(), &OS));
1963   OS.flush();
1964   EXPECT_EQ("input", Input);
1965   EXPECT_EQ(ExtraArgs.size(), 2u);
1966   EXPECT_EQ(ExtraArgs[0], "arg1");
1967   EXPECT_EQ(ExtraArgs[1], "arg2");
1968   EXPECT_TRUE(Errs.empty());
1969 }
1970 
1971 TEST(CommandLineTest, ConsumeAfterTwoPositionals) {
1972   cl::ResetCommandLineParser();
1973 
1974   // input1 input2 [args]
1975   StackOption<std::string, cl::opt<std::string>> Input1(cl::Positional,
1976                                                         cl::Required);
1977   StackOption<std::string, cl::opt<std::string>> Input2(cl::Positional,
1978                                                         cl::Required);
1979   StackOption<std::string, cl::list<std::string>> ExtraArgs(cl::ConsumeAfter);
1980 
1981   const char *Args[] = {"prog", "input1", "input2", "arg1", "arg2"};
1982 
1983   std::string Errs;
1984   raw_string_ostream OS(Errs);
1985   EXPECT_TRUE(cl::ParseCommandLineOptions(5, Args, StringRef(), &OS));
1986   OS.flush();
1987   EXPECT_EQ("input1", Input1);
1988   EXPECT_EQ("input2", Input2);
1989   EXPECT_EQ(ExtraArgs.size(), 2u);
1990   EXPECT_EQ(ExtraArgs[0], "arg1");
1991   EXPECT_EQ(ExtraArgs[1], "arg2");
1992   EXPECT_TRUE(Errs.empty());
1993 }
1994 
1995 TEST(CommandLineTest, ResetAllOptionOccurrences) {
1996   cl::ResetCommandLineParser();
1997 
1998   // -option -str -enableA -enableC [sink] input [args]
1999   StackOption<bool> Option("option");
2000   StackOption<std::string> Str("str");
2001   enum Vals { ValA, ValB, ValC };
2002   StackOption<Vals, cl::bits<Vals>> Bits(
2003       cl::values(clEnumValN(ValA, "enableA", "Enable A"),
2004                  clEnumValN(ValB, "enableB", "Enable B"),
2005                  clEnumValN(ValC, "enableC", "Enable C")));
2006   StackOption<std::string, cl::list<std::string>> Sink(cl::Sink);
2007   StackOption<std::string> Input(cl::Positional);
2008   StackOption<std::string, cl::list<std::string>> ExtraArgs(cl::ConsumeAfter);
2009 
2010   const char *Args[] = {"prog",     "-option",  "-str=STR", "-enableA",
2011                         "-enableC", "-unknown", "input",    "-arg"};
2012 
2013   std::string Errs;
2014   raw_string_ostream OS(Errs);
2015   EXPECT_TRUE(cl::ParseCommandLineOptions(8, Args, StringRef(), &OS));
2016   EXPECT_TRUE(OS.str().empty());
2017 
2018   EXPECT_TRUE(Option);
2019   EXPECT_EQ("STR", Str);
2020   EXPECT_EQ((1u << ValA) | (1u << ValC), Bits.getBits());
2021   EXPECT_EQ(1u, Sink.size());
2022   EXPECT_EQ("-unknown", Sink[0]);
2023   EXPECT_EQ("input", Input);
2024   EXPECT_EQ(1u, ExtraArgs.size());
2025   EXPECT_EQ("-arg", ExtraArgs[0]);
2026 
2027   cl::ResetAllOptionOccurrences();
2028   EXPECT_FALSE(Option);
2029   EXPECT_EQ("", Str);
2030   EXPECT_EQ(0u, Bits.getBits());
2031   EXPECT_EQ(0u, Sink.size());
2032   EXPECT_EQ(0, Input.getNumOccurrences());
2033   EXPECT_EQ(0u, ExtraArgs.size());
2034 }
2035 
2036 TEST(CommandLineTest, DefaultValue) {
2037   cl::ResetCommandLineParser();
2038 
2039   StackOption<bool> BoolOption("bool-option");
2040   StackOption<std::string> StrOption("str-option");
2041   StackOption<bool> BoolInitOption("bool-init-option", cl::init(true));
2042   StackOption<std::string> StrInitOption("str-init-option",
2043                                          cl::init("str-default-value"));
2044 
2045   const char *Args[] = {"prog"}; // no options
2046 
2047   std::string Errs;
2048   raw_string_ostream OS(Errs);
2049   EXPECT_TRUE(cl::ParseCommandLineOptions(1, Args, StringRef(), &OS));
2050   EXPECT_TRUE(OS.str().empty());
2051 
2052   EXPECT_TRUE(!BoolOption);
2053   EXPECT_FALSE(BoolOption.Default.hasValue());
2054   EXPECT_EQ(0, BoolOption.getNumOccurrences());
2055 
2056   EXPECT_EQ("", StrOption);
2057   EXPECT_FALSE(StrOption.Default.hasValue());
2058   EXPECT_EQ(0, StrOption.getNumOccurrences());
2059 
2060   EXPECT_TRUE(BoolInitOption);
2061   EXPECT_TRUE(BoolInitOption.Default.hasValue());
2062   EXPECT_EQ(0, BoolInitOption.getNumOccurrences());
2063 
2064   EXPECT_EQ("str-default-value", StrInitOption);
2065   EXPECT_TRUE(StrInitOption.Default.hasValue());
2066   EXPECT_EQ(0, StrInitOption.getNumOccurrences());
2067 
2068   const char *Args2[] = {"prog", "-bool-option", "-str-option=str-value",
2069                          "-bool-init-option=0",
2070                          "-str-init-option=str-init-value"};
2071 
2072   EXPECT_TRUE(cl::ParseCommandLineOptions(5, Args2, StringRef(), &OS));
2073   EXPECT_TRUE(OS.str().empty());
2074 
2075   EXPECT_TRUE(BoolOption);
2076   EXPECT_FALSE(BoolOption.Default.hasValue());
2077   EXPECT_EQ(1, BoolOption.getNumOccurrences());
2078 
2079   EXPECT_EQ("str-value", StrOption);
2080   EXPECT_FALSE(StrOption.Default.hasValue());
2081   EXPECT_EQ(1, StrOption.getNumOccurrences());
2082 
2083   EXPECT_FALSE(BoolInitOption);
2084   EXPECT_TRUE(BoolInitOption.Default.hasValue());
2085   EXPECT_EQ(1, BoolInitOption.getNumOccurrences());
2086 
2087   EXPECT_EQ("str-init-value", StrInitOption);
2088   EXPECT_TRUE(StrInitOption.Default.hasValue());
2089   EXPECT_EQ(1, StrInitOption.getNumOccurrences());
2090 }
2091 
2092 } // anonymous namespace
2093