xref: /llvm-project/llvm/unittests/Support/CommandLineTest.cpp (revision c242be40a140df8959ce08bc6d593d9ee14ca319)
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, ResponseFilesAtArguments) {
820   SmallString<128> TestDir;
821   std::error_code EC = sys::fs::createUniqueDirectory("unittest", TestDir);
822   EXPECT_TRUE(!EC);
823 
824   SmallString<128> ResponseFilePath;
825   sys::path::append(ResponseFilePath, TestDir, "test.rsp");
826 
827   std::ofstream ResponseFile(ResponseFilePath.c_str());
828   EXPECT_TRUE(ResponseFile.is_open());
829   ResponseFile << "-foo" << "\n";
830   ResponseFile << "-bar" << "\n";
831   ResponseFile.close();
832 
833   // Ensure we expand rsp files after lots of non-rsp arguments starting with @.
834   constexpr size_t NON_RSP_AT_ARGS = 64;
835   SmallVector<const char *, 4> Argv = {"test/test"};
836   Argv.append(NON_RSP_AT_ARGS, "@non_rsp_at_arg");
837   std::string ResponseFileRef = std::string("@") + ResponseFilePath.c_str();
838   Argv.push_back(ResponseFileRef.c_str());
839 
840   BumpPtrAllocator A;
841   StringSaver Saver(A);
842   bool Res = cl::ExpandResponseFiles(Saver, cl::TokenizeGNUCommandLine, Argv,
843                                      false, false);
844   EXPECT_FALSE(Res);
845 
846   // ASSERT instead of EXPECT to prevent potential out-of-bounds access.
847   ASSERT_EQ(Argv.size(), 1 + NON_RSP_AT_ARGS + 2);
848   size_t i = 0;
849   EXPECT_STREQ(Argv[i++], "test/test");
850   for (; i < 1 + NON_RSP_AT_ARGS; ++i)
851     EXPECT_STREQ(Argv[i], "@non_rsp_at_arg");
852   EXPECT_STREQ(Argv[i++], "-foo");
853   EXPECT_STREQ(Argv[i++], "-bar");
854 }
855 
856 TEST(CommandLineTest, SetDefautValue) {
857   cl::ResetCommandLineParser();
858 
859   StackOption<std::string> Opt1("opt1", cl::init("true"));
860   StackOption<bool> Opt2("opt2", cl::init(true));
861   cl::alias Alias("alias", llvm::cl::aliasopt(Opt2));
862   StackOption<int> Opt3("opt3", cl::init(3));
863 
864   const char *args[] = {"prog", "-opt1=false", "-opt2", "-opt3"};
865 
866   EXPECT_TRUE(
867     cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
868 
869   EXPECT_TRUE(Opt1 == "false");
870   EXPECT_TRUE(Opt2);
871   EXPECT_TRUE(Opt3 == 3);
872 
873   Opt2 = false;
874   Opt3 = 1;
875 
876   cl::ResetAllOptionOccurrences();
877 
878   for (auto &OM : cl::getRegisteredOptions(*cl::TopLevelSubCommand)) {
879     cl::Option *O = OM.second;
880     if (O->ArgStr == "opt2") {
881       continue;
882     }
883     O->setDefault();
884   }
885 
886   EXPECT_TRUE(Opt1 == "true");
887   EXPECT_TRUE(Opt2);
888   EXPECT_TRUE(Opt3 == 3);
889   Alias.removeArgument();
890 }
891 
892 TEST(CommandLineTest, ReadConfigFile) {
893   llvm::SmallVector<const char *, 1> Argv;
894 
895   llvm::SmallString<128> TestDir;
896   std::error_code EC =
897       llvm::sys::fs::createUniqueDirectory("unittest", TestDir);
898   EXPECT_TRUE(!EC);
899 
900   llvm::SmallString<128> TestCfg;
901   llvm::sys::path::append(TestCfg, TestDir, "foo");
902   std::ofstream ConfigFile(TestCfg.c_str());
903   EXPECT_TRUE(ConfigFile.is_open());
904   ConfigFile << "# Comment\n"
905                 "-option_1\n"
906                 "@subconfig\n"
907                 "-option_3=abcd\n"
908                 "-option_4=\\\n"
909                 "cdef\n";
910   ConfigFile.close();
911 
912   llvm::SmallString<128> TestCfg2;
913   llvm::sys::path::append(TestCfg2, TestDir, "subconfig");
914   std::ofstream ConfigFile2(TestCfg2.c_str());
915   EXPECT_TRUE(ConfigFile2.is_open());
916   ConfigFile2 << "-option_2\n"
917                  "\n"
918                  "   # comment\n";
919   ConfigFile2.close();
920 
921   // Make sure the current directory is not the directory where config files
922   // resides. In this case the code that expands response files will not find
923   // 'subconfig' unless it resolves nested inclusions relative to the including
924   // file.
925   llvm::SmallString<128> CurrDir;
926   EC = llvm::sys::fs::current_path(CurrDir);
927   EXPECT_TRUE(!EC);
928   EXPECT_TRUE(StringRef(CurrDir) != StringRef(TestDir));
929 
930   llvm::BumpPtrAllocator A;
931   llvm::StringSaver Saver(A);
932   bool Result = llvm::cl::readConfigFile(TestCfg, Saver, Argv);
933 
934   EXPECT_TRUE(Result);
935   EXPECT_EQ(Argv.size(), 4U);
936   EXPECT_STREQ(Argv[0], "-option_1");
937   EXPECT_STREQ(Argv[1], "-option_2");
938   EXPECT_STREQ(Argv[2], "-option_3=abcd");
939   EXPECT_STREQ(Argv[3], "-option_4=cdef");
940 
941   llvm::sys::fs::remove(TestCfg2);
942   llvm::sys::fs::remove(TestCfg);
943   llvm::sys::fs::remove(TestDir);
944 }
945 
946 TEST(CommandLineTest, PositionalEatArgsError) {
947   cl::ResetCommandLineParser();
948 
949   StackOption<std::string, cl::list<std::string>> PosEatArgs(
950       "positional-eat-args", cl::Positional, cl::desc("<arguments>..."),
951       cl::ZeroOrMore, cl::PositionalEatsArgs);
952   StackOption<std::string, cl::list<std::string>> PosEatArgs2(
953       "positional-eat-args2", cl::Positional, cl::desc("Some strings"),
954       cl::ZeroOrMore, cl::PositionalEatsArgs);
955 
956   const char *args[] = {"prog", "-positional-eat-args=XXXX"};
957   const char *args2[] = {"prog", "-positional-eat-args=XXXX", "-foo"};
958   const char *args3[] = {"prog", "-positional-eat-args", "-foo"};
959   const char *args4[] = {"prog", "-positional-eat-args",
960                          "-foo", "-positional-eat-args2",
961                          "-bar", "foo"};
962 
963   std::string Errs;
964   raw_string_ostream OS(Errs);
965   EXPECT_FALSE(cl::ParseCommandLineOptions(2, args, StringRef(), &OS)); OS.flush();
966   EXPECT_FALSE(Errs.empty()); Errs.clear();
967   EXPECT_FALSE(cl::ParseCommandLineOptions(3, args2, StringRef(), &OS)); OS.flush();
968   EXPECT_FALSE(Errs.empty()); Errs.clear();
969   EXPECT_TRUE(cl::ParseCommandLineOptions(3, args3, StringRef(), &OS)); OS.flush();
970   EXPECT_TRUE(Errs.empty()); Errs.clear();
971 
972   cl::ResetAllOptionOccurrences();
973   EXPECT_TRUE(cl::ParseCommandLineOptions(6, args4, StringRef(), &OS)); OS.flush();
974   EXPECT_TRUE(PosEatArgs.size() == 1);
975   EXPECT_TRUE(PosEatArgs2.size() == 2);
976   EXPECT_TRUE(Errs.empty());
977 }
978 
979 #ifdef _WIN32
980 TEST(CommandLineTest, GetCommandLineArguments) {
981   int argc = __argc;
982   char **argv = __argv;
983 
984   // GetCommandLineArguments is called in InitLLVM.
985   llvm::InitLLVM X(argc, argv);
986 
987   EXPECT_EQ(llvm::sys::path::is_absolute(argv[0]),
988             llvm::sys::path::is_absolute(__argv[0]));
989 
990   EXPECT_TRUE(llvm::sys::path::filename(argv[0])
991               .equals_lower("supporttests.exe"))
992       << "Filename of test executable is "
993       << llvm::sys::path::filename(argv[0]);
994 }
995 #endif
996 
997 class OutputRedirector {
998 public:
999   OutputRedirector(int RedirectFD)
1000       : RedirectFD(RedirectFD), OldFD(dup(RedirectFD)) {
1001     if (OldFD == -1 ||
1002         sys::fs::createTemporaryFile("unittest-redirect", "", NewFD,
1003                                      FilePath) ||
1004         dup2(NewFD, RedirectFD) == -1)
1005       Valid = false;
1006   }
1007 
1008   ~OutputRedirector() {
1009     dup2(OldFD, RedirectFD);
1010     close(OldFD);
1011     close(NewFD);
1012   }
1013 
1014   SmallVector<char, 128> FilePath;
1015   bool Valid = true;
1016 
1017 private:
1018   int RedirectFD;
1019   int OldFD;
1020   int NewFD;
1021 };
1022 
1023 struct AutoDeleteFile {
1024   SmallVector<char, 128> FilePath;
1025   ~AutoDeleteFile() {
1026     if (!FilePath.empty())
1027       sys::fs::remove(std::string(FilePath.data(), FilePath.size()));
1028   }
1029 };
1030 
1031 class PrintOptionInfoTest : public ::testing::Test {
1032 public:
1033   // Return std::string because the output of a failing EXPECT check is
1034   // unreadable for StringRef. It also avoids any lifetime issues.
1035   template <typename... Ts> std::string runTest(Ts... OptionAttributes) {
1036     AutoDeleteFile File;
1037     {
1038       OutputRedirector Stdout(fileno(stdout));
1039       if (!Stdout.Valid)
1040         return "";
1041       File.FilePath = Stdout.FilePath;
1042 
1043       StackOption<OptionValue> TestOption(Opt, cl::desc(HelpText),
1044                                           OptionAttributes...);
1045       printOptionInfo(TestOption, 26);
1046       outs().flush();
1047     }
1048     auto Buffer = MemoryBuffer::getFile(File.FilePath);
1049     if (!Buffer)
1050       return "";
1051     return Buffer->get()->getBuffer().str();
1052   }
1053 
1054   enum class OptionValue { Val };
1055   const StringRef Opt = "some-option";
1056   const StringRef HelpText = "some help";
1057 
1058 private:
1059   // This is a workaround for cl::Option sub-classes having their
1060   // printOptionInfo functions private.
1061   void printOptionInfo(const cl::Option &O, size_t Width) {
1062     O.printOptionInfo(Width);
1063   }
1064 };
1065 
1066 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithoutSentinel) {
1067   std::string Output =
1068       runTest(cl::ValueOptional,
1069               cl::values(clEnumValN(OptionValue::Val, "v1", "desc1")));
1070 
1071   // clang-format off
1072   EXPECT_EQ(Output, ("  --" + Opt + "=<value> - " + HelpText + "\n"
1073                      "    =v1                 -   desc1\n")
1074                         .str());
1075   // clang-format on
1076 }
1077 
1078 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinel) {
1079   std::string Output = runTest(
1080       cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1081                                     clEnumValN(OptionValue::Val, "", "")));
1082 
1083   // clang-format off
1084   EXPECT_EQ(Output,
1085             ("  --" + Opt + "         - " + HelpText + "\n"
1086              "  --" + Opt + "=<value> - " + HelpText + "\n"
1087              "    =v1                 -   desc1\n")
1088                 .str());
1089   // clang-format on
1090 }
1091 
1092 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueOptionalWithSentinelWithHelp) {
1093   std::string Output = runTest(
1094       cl::ValueOptional, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1095                                     clEnumValN(OptionValue::Val, "", "desc2")));
1096 
1097   // clang-format off
1098   EXPECT_EQ(Output, ("  --" + Opt + "         - " + HelpText + "\n"
1099                      "  --" + Opt + "=<value> - " + HelpText + "\n"
1100                      "    =v1                 -   desc1\n"
1101                      "    =<empty>            -   desc2\n")
1102                         .str());
1103   // clang-format on
1104 }
1105 
1106 TEST_F(PrintOptionInfoTest, PrintOptionInfoValueRequiredWithEmptyValueName) {
1107   std::string Output = runTest(
1108       cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", "desc1"),
1109                                     clEnumValN(OptionValue::Val, "", "")));
1110 
1111   // clang-format off
1112   EXPECT_EQ(Output, ("  --" + Opt + "=<value> - " + HelpText + "\n"
1113                      "    =v1                 -   desc1\n"
1114                      "    =<empty>\n")
1115                         .str());
1116   // clang-format on
1117 }
1118 
1119 TEST_F(PrintOptionInfoTest, PrintOptionInfoEmptyValueDescription) {
1120   std::string Output = runTest(
1121       cl::ValueRequired, cl::values(clEnumValN(OptionValue::Val, "v1", "")));
1122 
1123   // clang-format off
1124   EXPECT_EQ(Output,
1125             ("  --" + Opt + "=<value> - " + HelpText + "\n"
1126              "    =v1\n").str());
1127   // clang-format on
1128 }
1129 
1130 class GetOptionWidthTest : public ::testing::Test {
1131 public:
1132   enum class OptionValue { Val };
1133 
1134   template <typename... Ts>
1135   size_t runTest(StringRef ArgName, Ts... OptionAttributes) {
1136     StackOption<OptionValue> TestOption(ArgName, cl::desc("some help"),
1137                                         OptionAttributes...);
1138     return getOptionWidth(TestOption);
1139   }
1140 
1141 private:
1142   // This is a workaround for cl::Option sub-classes having their
1143   // printOptionInfo
1144   // functions private.
1145   size_t getOptionWidth(const cl::Option &O) { return O.getOptionWidth(); }
1146 };
1147 
1148 TEST_F(GetOptionWidthTest, GetOptionWidthArgNameLonger) {
1149   StringRef ArgName("a-long-argument-name");
1150   size_t ExpectedStrSize = ("  --" + ArgName + "=<value> - ").str().size();
1151   EXPECT_EQ(
1152       runTest(ArgName, cl::values(clEnumValN(OptionValue::Val, "v", "help"))),
1153       ExpectedStrSize);
1154 }
1155 
1156 TEST_F(GetOptionWidthTest, GetOptionWidthFirstOptionNameLonger) {
1157   StringRef OptName("a-long-option-name");
1158   size_t ExpectedStrSize = ("    =" + OptName + " - ").str().size();
1159   EXPECT_EQ(
1160       runTest("a", cl::values(clEnumValN(OptionValue::Val, OptName, "help"),
1161                               clEnumValN(OptionValue::Val, "b", "help"))),
1162       ExpectedStrSize);
1163 }
1164 
1165 TEST_F(GetOptionWidthTest, GetOptionWidthSecondOptionNameLonger) {
1166   StringRef OptName("a-long-option-name");
1167   size_t ExpectedStrSize = ("    =" + OptName + " - ").str().size();
1168   EXPECT_EQ(
1169       runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"),
1170                               clEnumValN(OptionValue::Val, OptName, "help"))),
1171       ExpectedStrSize);
1172 }
1173 
1174 TEST_F(GetOptionWidthTest, GetOptionWidthEmptyOptionNameLonger) {
1175   size_t ExpectedStrSize = StringRef("    =<empty> - ").size();
1176   // The length of a=<value> (including indentation) is actually the same as the
1177   // =<empty> string, so it is impossible to distinguish via testing the case
1178   // where the empty string is picked from where the option name is picked.
1179   EXPECT_EQ(runTest("a", cl::values(clEnumValN(OptionValue::Val, "b", "help"),
1180                                     clEnumValN(OptionValue::Val, "", "help"))),
1181             ExpectedStrSize);
1182 }
1183 
1184 TEST_F(GetOptionWidthTest,
1185        GetOptionWidthValueOptionalEmptyOptionWithNoDescription) {
1186   StringRef ArgName("a");
1187   // The length of a=<value> (including indentation) is actually the same as the
1188   // =<empty> string, so it is impossible to distinguish via testing the case
1189   // where the empty string is ignored from where it is not ignored.
1190   // The dash will not actually be printed, but the space it would take up is
1191   // included to ensure a consistent column width.
1192   size_t ExpectedStrSize = ("  -" + ArgName + "=<value> - ").str().size();
1193   EXPECT_EQ(runTest(ArgName, cl::ValueOptional,
1194                     cl::values(clEnumValN(OptionValue::Val, "value", "help"),
1195                                clEnumValN(OptionValue::Val, "", ""))),
1196             ExpectedStrSize);
1197 }
1198 
1199 TEST_F(GetOptionWidthTest,
1200        GetOptionWidthValueRequiredEmptyOptionWithNoDescription) {
1201   // The length of a=<value> (including indentation) is actually the same as the
1202   // =<empty> string, so it is impossible to distinguish via testing the case
1203   // where the empty string is picked from where the option name is picked
1204   size_t ExpectedStrSize = StringRef("    =<empty> - ").size();
1205   EXPECT_EQ(runTest("a", cl::ValueRequired,
1206                     cl::values(clEnumValN(OptionValue::Val, "value", "help"),
1207                                clEnumValN(OptionValue::Val, "", ""))),
1208             ExpectedStrSize);
1209 }
1210 
1211 TEST(CommandLineTest, PrefixOptions) {
1212   cl::ResetCommandLineParser();
1213 
1214   StackOption<std::string, cl::list<std::string>> IncludeDirs(
1215       "I", cl::Prefix, cl::desc("Declare an include directory"));
1216 
1217   // Test non-prefixed variant works with cl::Prefix options.
1218   EXPECT_TRUE(IncludeDirs.empty());
1219   const char *args[] = {"prog", "-I=/usr/include"};
1220   EXPECT_TRUE(
1221       cl::ParseCommandLineOptions(2, args, StringRef(), &llvm::nulls()));
1222   EXPECT_TRUE(IncludeDirs.size() == 1);
1223   EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0);
1224 
1225   IncludeDirs.erase(IncludeDirs.begin());
1226   cl::ResetAllOptionOccurrences();
1227 
1228   // Test non-prefixed variant works with cl::Prefix options when value is
1229   // passed in following argument.
1230   EXPECT_TRUE(IncludeDirs.empty());
1231   const char *args2[] = {"prog", "-I", "/usr/include"};
1232   EXPECT_TRUE(
1233       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1234   EXPECT_TRUE(IncludeDirs.size() == 1);
1235   EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0);
1236 
1237   IncludeDirs.erase(IncludeDirs.begin());
1238   cl::ResetAllOptionOccurrences();
1239 
1240   // Test prefixed variant works with cl::Prefix options.
1241   EXPECT_TRUE(IncludeDirs.empty());
1242   const char *args3[] = {"prog", "-I/usr/include"};
1243   EXPECT_TRUE(
1244       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1245   EXPECT_TRUE(IncludeDirs.size() == 1);
1246   EXPECT_TRUE(IncludeDirs.front().compare("/usr/include") == 0);
1247 
1248   StackOption<std::string, cl::list<std::string>> MacroDefs(
1249       "D", cl::AlwaysPrefix, cl::desc("Define a macro"),
1250       cl::value_desc("MACRO[=VALUE]"));
1251 
1252   cl::ResetAllOptionOccurrences();
1253 
1254   // Test non-prefixed variant does not work with cl::AlwaysPrefix options:
1255   // equal sign is part of the value.
1256   EXPECT_TRUE(MacroDefs.empty());
1257   const char *args4[] = {"prog", "-D=HAVE_FOO"};
1258   EXPECT_TRUE(
1259       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1260   EXPECT_TRUE(MacroDefs.size() == 1);
1261   EXPECT_TRUE(MacroDefs.front().compare("=HAVE_FOO") == 0);
1262 
1263   MacroDefs.erase(MacroDefs.begin());
1264   cl::ResetAllOptionOccurrences();
1265 
1266   // Test non-prefixed variant does not allow value to be passed in following
1267   // argument with cl::AlwaysPrefix options.
1268   EXPECT_TRUE(MacroDefs.empty());
1269   const char *args5[] = {"prog", "-D", "HAVE_FOO"};
1270   EXPECT_FALSE(
1271       cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls()));
1272   EXPECT_TRUE(MacroDefs.empty());
1273 
1274   cl::ResetAllOptionOccurrences();
1275 
1276   // Test prefixed variant works with cl::AlwaysPrefix options.
1277   EXPECT_TRUE(MacroDefs.empty());
1278   const char *args6[] = {"prog", "-DHAVE_FOO"};
1279   EXPECT_TRUE(
1280       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1281   EXPECT_TRUE(MacroDefs.size() == 1);
1282   EXPECT_TRUE(MacroDefs.front().compare("HAVE_FOO") == 0);
1283 }
1284 
1285 TEST(CommandLineTest, GroupingWithValue) {
1286   cl::ResetCommandLineParser();
1287 
1288   StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag"));
1289   StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag"));
1290   StackOption<bool> OptD("d", cl::Grouping, cl::ValueDisallowed,
1291                          cl::desc("ValueDisallowed option"));
1292   StackOption<std::string> OptV("v", cl::Grouping,
1293                                 cl::desc("ValueRequired option"));
1294   StackOption<std::string> OptO("o", cl::Grouping, cl::ValueOptional,
1295                                 cl::desc("ValueOptional option"));
1296 
1297   // Should be possible to use an option which requires a value
1298   // at the end of a group.
1299   const char *args1[] = {"prog", "-fv", "val1"};
1300   EXPECT_TRUE(
1301       cl::ParseCommandLineOptions(3, args1, StringRef(), &llvm::nulls()));
1302   EXPECT_TRUE(OptF);
1303   EXPECT_STREQ("val1", OptV.c_str());
1304   OptV.clear();
1305   cl::ResetAllOptionOccurrences();
1306 
1307   // Should not crash if it is accidentally used elsewhere in the group.
1308   const char *args2[] = {"prog", "-vf", "val2"};
1309   EXPECT_FALSE(
1310       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1311   OptV.clear();
1312   cl::ResetAllOptionOccurrences();
1313 
1314   // Should allow the "opt=value" form at the end of the group
1315   const char *args3[] = {"prog", "-fv=val3"};
1316   EXPECT_TRUE(
1317       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1318   EXPECT_TRUE(OptF);
1319   EXPECT_STREQ("val3", OptV.c_str());
1320   OptV.clear();
1321   cl::ResetAllOptionOccurrences();
1322 
1323   // Should allow assigning a value for a ValueOptional option
1324   // at the end of the group
1325   const char *args4[] = {"prog", "-fo=val4"};
1326   EXPECT_TRUE(
1327       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1328   EXPECT_TRUE(OptF);
1329   EXPECT_STREQ("val4", OptO.c_str());
1330   OptO.clear();
1331   cl::ResetAllOptionOccurrences();
1332 
1333   // Should assign an empty value if a ValueOptional option is used elsewhere
1334   // in the group.
1335   const char *args5[] = {"prog", "-fob"};
1336   EXPECT_TRUE(
1337       cl::ParseCommandLineOptions(2, args5, StringRef(), &llvm::nulls()));
1338   EXPECT_TRUE(OptF);
1339   EXPECT_EQ(1, OptO.getNumOccurrences());
1340   EXPECT_EQ(1, OptB.getNumOccurrences());
1341   EXPECT_TRUE(OptO.empty());
1342   cl::ResetAllOptionOccurrences();
1343 
1344   // Should not allow an assignment for a ValueDisallowed option.
1345   const char *args6[] = {"prog", "-fd=false"};
1346   EXPECT_FALSE(
1347       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1348 }
1349 
1350 TEST(CommandLineTest, GroupingAndPrefix) {
1351   cl::ResetCommandLineParser();
1352 
1353   StackOption<bool> OptF("f", cl::Grouping, cl::desc("Some flag"));
1354   StackOption<bool> OptB("b", cl::Grouping, cl::desc("Another flag"));
1355   StackOption<std::string> OptP("p", cl::Prefix, cl::Grouping,
1356                                 cl::desc("Prefix and Grouping"));
1357   StackOption<std::string> OptA("a", cl::AlwaysPrefix, cl::Grouping,
1358                                 cl::desc("AlwaysPrefix and Grouping"));
1359 
1360   // Should be possible to use a cl::Prefix option without grouping.
1361   const char *args1[] = {"prog", "-pval1"};
1362   EXPECT_TRUE(
1363       cl::ParseCommandLineOptions(2, args1, StringRef(), &llvm::nulls()));
1364   EXPECT_STREQ("val1", OptP.c_str());
1365   OptP.clear();
1366   cl::ResetAllOptionOccurrences();
1367 
1368   // Should be possible to pass a value in a separate argument.
1369   const char *args2[] = {"prog", "-p", "val2"};
1370   EXPECT_TRUE(
1371       cl::ParseCommandLineOptions(3, args2, StringRef(), &llvm::nulls()));
1372   EXPECT_STREQ("val2", OptP.c_str());
1373   OptP.clear();
1374   cl::ResetAllOptionOccurrences();
1375 
1376   // The "-opt=value" form should work, too.
1377   const char *args3[] = {"prog", "-p=val3"};
1378   EXPECT_TRUE(
1379       cl::ParseCommandLineOptions(2, args3, StringRef(), &llvm::nulls()));
1380   EXPECT_STREQ("val3", OptP.c_str());
1381   OptP.clear();
1382   cl::ResetAllOptionOccurrences();
1383 
1384   // All three previous cases should work the same way if an option with both
1385   // cl::Prefix and cl::Grouping modifiers is used at the end of a group.
1386   const char *args4[] = {"prog", "-fpval4"};
1387   EXPECT_TRUE(
1388       cl::ParseCommandLineOptions(2, args4, StringRef(), &llvm::nulls()));
1389   EXPECT_TRUE(OptF);
1390   EXPECT_STREQ("val4", OptP.c_str());
1391   OptP.clear();
1392   cl::ResetAllOptionOccurrences();
1393 
1394   const char *args5[] = {"prog", "-fp", "val5"};
1395   EXPECT_TRUE(
1396       cl::ParseCommandLineOptions(3, args5, StringRef(), &llvm::nulls()));
1397   EXPECT_TRUE(OptF);
1398   EXPECT_STREQ("val5", OptP.c_str());
1399   OptP.clear();
1400   cl::ResetAllOptionOccurrences();
1401 
1402   const char *args6[] = {"prog", "-fp=val6"};
1403   EXPECT_TRUE(
1404       cl::ParseCommandLineOptions(2, args6, StringRef(), &llvm::nulls()));
1405   EXPECT_TRUE(OptF);
1406   EXPECT_STREQ("val6", OptP.c_str());
1407   OptP.clear();
1408   cl::ResetAllOptionOccurrences();
1409 
1410   // Should assign a value even if the part after a cl::Prefix option is equal
1411   // to the name of another option.
1412   const char *args7[] = {"prog", "-fpb"};
1413   EXPECT_TRUE(
1414       cl::ParseCommandLineOptions(2, args7, StringRef(), &llvm::nulls()));
1415   EXPECT_TRUE(OptF);
1416   EXPECT_STREQ("b", OptP.c_str());
1417   EXPECT_FALSE(OptB);
1418   OptP.clear();
1419   cl::ResetAllOptionOccurrences();
1420 
1421   // Should be possible to use a cl::AlwaysPrefix option without grouping.
1422   const char *args8[] = {"prog", "-aval8"};
1423   EXPECT_TRUE(
1424       cl::ParseCommandLineOptions(2, args8, StringRef(), &llvm::nulls()));
1425   EXPECT_STREQ("val8", OptA.c_str());
1426   OptA.clear();
1427   cl::ResetAllOptionOccurrences();
1428 
1429   // Should not be possible to pass a value in a separate argument.
1430   const char *args9[] = {"prog", "-a", "val9"};
1431   EXPECT_FALSE(
1432       cl::ParseCommandLineOptions(3, args9, StringRef(), &llvm::nulls()));
1433   cl::ResetAllOptionOccurrences();
1434 
1435   // With the "-opt=value" form, the "=" symbol should be preserved.
1436   const char *args10[] = {"prog", "-a=val10"};
1437   EXPECT_TRUE(
1438       cl::ParseCommandLineOptions(2, args10, StringRef(), &llvm::nulls()));
1439   EXPECT_STREQ("=val10", OptA.c_str());
1440   OptA.clear();
1441   cl::ResetAllOptionOccurrences();
1442 
1443   // All three previous cases should work the same way if an option with both
1444   // cl::AlwaysPrefix and cl::Grouping modifiers is used at the end of a group.
1445   const char *args11[] = {"prog", "-faval11"};
1446   EXPECT_TRUE(
1447       cl::ParseCommandLineOptions(2, args11, StringRef(), &llvm::nulls()));
1448   EXPECT_TRUE(OptF);
1449   EXPECT_STREQ("val11", OptA.c_str());
1450   OptA.clear();
1451   cl::ResetAllOptionOccurrences();
1452 
1453   const char *args12[] = {"prog", "-fa", "val12"};
1454   EXPECT_FALSE(
1455       cl::ParseCommandLineOptions(3, args12, StringRef(), &llvm::nulls()));
1456   cl::ResetAllOptionOccurrences();
1457 
1458   const char *args13[] = {"prog", "-fa=val13"};
1459   EXPECT_TRUE(
1460       cl::ParseCommandLineOptions(2, args13, StringRef(), &llvm::nulls()));
1461   EXPECT_TRUE(OptF);
1462   EXPECT_STREQ("=val13", OptA.c_str());
1463   OptA.clear();
1464   cl::ResetAllOptionOccurrences();
1465 
1466   // Should assign a value even if the part after a cl::AlwaysPrefix option
1467   // is equal to the name of another option.
1468   const char *args14[] = {"prog", "-fab"};
1469   EXPECT_TRUE(
1470       cl::ParseCommandLineOptions(2, args14, StringRef(), &llvm::nulls()));
1471   EXPECT_TRUE(OptF);
1472   EXPECT_STREQ("b", OptA.c_str());
1473   EXPECT_FALSE(OptB);
1474   OptA.clear();
1475   cl::ResetAllOptionOccurrences();
1476 }
1477 
1478 }  // anonymous namespace
1479