[prog.c++] Полку парсеров аргументов командной строки для современного C++ прибыло

Давеча на глаза попалась информация о двух новых библиотеках для работы с аргументами командной строки в современном C++. Поскольку в G+ ленте нет возможности поиска по своим же собственным постам (что печально), то зафиксирую информацию об этих библиотеках в блоге, дабы было проще найти при случае. Сразу скажу, я эти библиотеки пока не использовал, даже в код не заглядывал. Но судя по тому, что видно на поверхности, выглядит очень вкусно.

Итак, первая библиотека -- Clara от автора отличного инструмента для TDD и BDD в C++, Catch/Catch2 (с недавних пор библиотека называется именно Catch2). Clara изначально развивалась внутри Catch, но при подготовке Catch2 ее выделили в отдельный проект. Получается, что Clara является более-менее проверенной библиотекой, все-таки Catch2 используется весьма активно. Плюс работает на разных платформах и с разными компиляторами. Но, с другой стороны, документация пока оставляет желать много лучшего.

Пример того, как может выглядеть работа с Clara я выдрал из unit-тестов для нее:

using namespace clara; struct TestOpt {     std::string processName;     std::string fileName;     int number = 0;     int index = 0;     bool flag = false;     std::string firstPos;     std::string secondPos;     std::vector<std::string> unpositional;     auto makeCli() -> Parser {         return ExeName( processName )           | Opt( fileName, "filename" )               ["-o"]["--output"]               ( "specifies output file" )           | Opt( number, "an integral value" )               ["-n"]           | Opt( [&]( int i ) {                     if (i < 0 || i > 10)                         return ParserResult::runtimeError("index must be between 0 and 10");                     else {                         index = i;                         return ParserResult::ok( ParseResultType::Matched );                     }                 }, "index" )               ["-i"]               ( "An index, which is an integer between 0 and 10, inclusive" )           | Opt( flag )               ["-f"]               ( "A flag" )           | Arg( firstPos, "first arg" )               ( "First position" )           | Arg( secondPos, "second arg" )               ( "Second position" );     } };

Здесь метод TestOpt::makeCli как раз и создает парсер аргументов командной строки, который сохраняет разобранные значения внутри экземпляра структуры TestOpt.

Как и положено такого рода инструментам Clara автоматически генерирует usage-string, который можно отобразить пользователю.

---

Второй инструмент -- это clipp. Так же header-only, так же ему достаточно только стандартной библиотеки современного C++. Средства описания аргументов командной строки похожи на таковые в Clara, но, как мне показалось, здесь все более продвинуто:

#include <iostream> #include "clipp.h" using namespace clipp; using std::cout; using std::string; int main(int argc, char* argv[]) {      bool rec = false, utf16 = false;     string infile = "", fmt = "csv";     auto cli = (         value("input file", infile),         option("-r", "--recursive").set(rec).doc("convert files recursively"),         option("-o") & value("output format", fmt),         option("-utf16").set(utf16).doc("use UTF-16 encoding")     );     if(!parse(argc, argv, cli)) cout << make_man_page(cli, argv[0]);     // ... }

Если с аргументами что-то не так, то можно автоматически сгенерировать вот такой текст:

SYNOPSIS
    convert <input file> [-r] [-o <output format>] [-utf16]

OPTIONS
    -r, --recursive  convert files recursively
    -utf16           use UTF-16 encoding

Библиотека использует перегрузку операторов, что позволяет записывать вот такие-вот DSL-и:

auto cli = (      option("-b")          % "activates b"   >> b,                  option("-c", "--noc") % "deactivates c" >> set(c,false),     option("--hi")        % "says hi"       >> []{cout << "hi!\n";} );

Вообще, документация оставляет самые приятные впечатления. А вот по поводу кода на Reddit-е высказали замечания. С которыми автор библиотеки согласился и пояснил, что разработка еще не завершена и, например, под MSVC он пока особо ничего не проверял. Так что дока хорошая, а вот либа еще сырая. Хотя желание попробовать вызывает.