RetroSearch Browse

int

cont_indent = -1)

const

;

171 bool

using_help_command)

const

;

173 const string

& name_for_synopsis,

const string

& name_for_usage)

const

;

213 const string

& program_name,

214 const string

& program_summary,

215 const string

& program_description,

216 const string

& version_info) :

218

m_ProgramName(program_name),

219

m_VersionInfo(version_info),

236 int indent

const string

int

cont_indent)

const 238 if

(

.empty()) {

243 const char

* line =

.data();

244 const char

* text_end = line +

.length();

247 if

(topic_len > 0 && (

offset

-= topic_len) < 1) {

256 const char

* next_line =

;

258 const char

* next_line;

261 const char

* line_end;

264 const char

* pos = line;

270 while

(pos < text_end && pos[1] ==

' '

)

273

}

else if

(*pos ==

'\n'

) {

274

next_line = (line_end = pos) + 1;

277 if

(++pos > max_pos && line_end !=

)

279 if

(pos == text_end) {

280

next_line = line_end = pos;

286

line_end = strchr(line,

'\n'

);

287

next_line = (line_end ==

? line_end = text_end : line_end + 1);

289 int

line_len =

int

(line_end - line);

291

printf(

"%*.*s\n"

offset

+ line_len, line_len, line);

295

}

while

((line = next_line) < text_end);

299 bool

using_help_command)

const 303 string

opt_name(option_value->first->GetNameVariants());

304 if

(using_help_command)

305 Throw

(

"command 'help' doesn't accept option '"

306

opt_name +

"'"

s_Help

);

308 Throw

(

"'--help' cannot be combined with option '"

309

opt_name +

"'"

"--help"

);

314 else if

(commands.empty()) {

315

printf(

"Usage: %s <command> [options] [args]\n"

m_ProgramName

.c_str());

317

printf(

"Type '%s help <command>' for help on a specific command.\n" 318 "Type '%s --version' to see the program version.\n"

325 if

(!category->second->m_Commands.empty()) {

326

printf(

"\n%s:\n\n"

, category->second->m_Title.c_str());

329

(*cmd)->GetNameVariants().c_str()),

337 "Describe the usage of this program or its commands."

kEmptyStr

);

347

command_info =

cmd

->second;

348 else if

(*cmd_name ==

s_Help

)

349

command_info = &help_command;

351

printf(

"'%s': unknown command.\n\n"

, *cmd_name);

362 const string

& name_for_synopsis,

const string

& name_for_usage)

const 364 int

text_len = printf(

"%s:"

, name_for_synopsis.c_str());

371

args.push_back(

' '

);

372 switch

((*arg)->m_Type) {

374

args.append((*arg)->GetPrimaryName());

377

args.push_back(

'['

);

378

args.append((*arg)->GetPrimaryName());

379

args.push_back(

']'

);

382

args.push_back(

'['

);

383

args.append((*arg)->GetPrimaryName());

384

args.append(

"...]"

);

387

args.append((*arg)->GetPrimaryName());

388

args.append(

"..."

);

391

text_len = printf(

"Usage: %s"

, name_for_usage.c_str());

394 if

(!common_parts->

m_Usage

.empty()) {

400

printf(

"\nValid options:\n"

);

403

(*opt)->GetNameVariants().c_str()),

416

message.append(

": "

);

417

message.append(

error

);

419

message.append(

"\nType '"

);

423

message.append(

" --help' for usage.\n"

);

424 else if

(

cmd

.empty())

425

message.append(

" help' for usage.\n"

);

427

message.append(

" help "

);

428

message.append(

cmd

);

429

message.append(

"' for usage.\n"

);

431 throw

runtime_error(message);

438

string::size_type basename_pos =

m_ProgramName

.find_last_of(

"/\\:"

);

439 if

(basename_pos != string::npos)

447 const char

* arg = *++argv;

450 if

(*arg !=

'-'

|| arg[1] ==

'\0'

)

451

positional_arguments.push_back(arg);

456 const char

* opt_param;

457 if

(*++arg ==

'-'

) {

461 if

(*++arg ==

'\0'

) {

463

positional_arguments.push_back(*++argv);

467

opt_param = strchr(arg,

'='

);

469 if

(opt_param !=

)

470

opt_name.assign(arg, opt_param++);

472

opt_name.assign(arg);

476 Throw

(

"unknown option '--"

+ opt_name +

"'"

);

477

option_info = opt_info->second;

481 if

(opt_param !=

)

482 Throw

(

"option '--"

+ opt_name +

483 "' does not expect a parameter"

);

487 if

(opt_param ==

) {

492 Throw

(

"option '--"

+ opt_name +

493 "' requires a parameter"

);

499 char

opt_letter = *arg++;

501

(

unsigned

char) opt_letter];

502 if

(option_info ==

)

503 Throw

(

string

(

"unknown option '-"

) + opt_letter +

"'"

);

517 Throw

(

string

(

"option '-"

) + opt_letter +

518 "' requires a parameter"

);

526

option_info, opt_param));

537 switch

(option_value->first->m_Id) {

544 Help

(positional_arguments,

false

);

559 if

(positional_arguments.empty())

562

command_name = positional_arguments.front();

563

positional_arguments.pop_front();

569 if

(command_name ==

s_Help

) {

570 Help

(positional_arguments,

true

);

573 Throw

(

"unknown command '"

+ command_name +

"'"

);

582 Throw

(

"command '"

+ command_name +

"' doesn't accept option '"

583

it->first->GetNameVariants() +

"'"

587

ret_val = command_info->

m_Id

;

590

TPositionalArgumentList::const_iterator arg_value =

591

positional_arguments.begin();

592

TOptionInfoList::const_iterator expected_arg =

593

expected_positional_arguments->begin();

596 if

(expected_arg != expected_positional_arguments->end())

597 if

(arg_value == positional_arguments.end())

598 switch

((*expected_arg)->m_Type) {

601 Throw

(

"missing argument '"

602

(*expected_arg)->GetPrimaryName() +

"'"

, command_name);

605 switch

((*expected_arg)->m_Type) {

609

*expected_arg, *arg_value));

616

*expected_arg, *arg_value));

617 while

(++arg_value != positional_arguments.end());

620 if

(arg_value != positional_arguments.end())

621 Throw

(

"too many positional arguments"

, command_name);

631 const string

& program_name,

632 const string

& version_info,

633 const string

& program_summary,

634 const string

& program_description) :

636

program_name, program_summary, program_description, version_info))

641 int

cmd_descr_indent,

int

opt_descr_indent)

643 m_Impl

->m_MaxHelpTextWidth = help_text_width;

644 m_Impl

->m_CmdDescrIndent = cmd_descr_indent;

645 m_Impl

->m_OptDescrIndent = opt_descr_indent;

649 int

opt_id,

const string

& name_variants,

const string

& description)

651 _ASSERT

(opt_id >= 0 &&

->m_OptIdToOptionInfoMap.find(opt_id) ==

652 m_Impl

->m_OptIdToOptionInfoMap.end() &&

"Option IDs must be unique"

);

660 "Positional arguments do not allow name variants"

);

662 m_Impl

->m_PositionalArguments.push_back(option_info);

668 if

(name->length() == 1)

669 m_Impl

->m_SingleLetterOptions[

670

(

unsigned

char) name->at(0)] = option_info;

672 m_Impl

->m_OptionToOptInfoMap[*name] = option_info;

674 m_Impl

->m_AcceptedOptions.push_back(option_info);

680 _ASSERT

(cat_id >= 0 &&

->m_CatIdToCatInfoMap.find(cat_id) ==

681 m_Impl

->m_CatIdToCatInfoMap.end() &&

"Category IDs must be unique"

);

687 const string

& synopsis,

const string

usage

int

cat_id)

689 _ASSERT

(cmd_id >= 0 &&

->m_CmdIdToCommandInfoMap.find(cmd_id) ==

690 m_Impl

->m_CmdIdToCommandInfoMap.end() &&

"Command IDs must be unique"

);

693 m_Impl

->m_CatIdToCatInfoMap.end() &&

"No such category ID"

);

698 m_Impl

->m_CatIdToCatInfoMap[cat_id]->m_Commands.push_back(command_info);

701 m_Impl

->m_CommandNameToCommandInfoMap[*name] = command_info;

707 m_Impl

->m_CmdIdToCommandInfoMap.end() &&

"No such command ID"

);

710 m_Impl

->m_OptIdToOptionInfoMap.end() &&

"No such option ID"

);

715 switch

(opt_info->

m_Type

) {

722 _ASSERT

(

"Invalid sequence of optional positional arguments"

736 return m_Impl

->ParseAndValidate(argc, argv);

741 return m_Impl

->m_ProgramName;

746 if

(

->m_NextOptionValue ==

->m_OptionValues.end())

749

*opt_id =

->m_NextOptionValue->first->m_Id;

750

*opt_value =

->m_NextOptionValue->second;

752