How do I create subcommands like git with argparse?

Use add_subparser() to define commands such as add or commit, each with their own arguments. The library automatically handles nested parsing, help generation, and checks with is_subcommand_used(), as shown in the Subcommands section.

argparse C++ vs Boost.ProgramOptions: which is better?

argparse is lighter and header-only, ideal for modern C++ projects with no dependencies, while Boost.ProgramOptions offers more maturity and Boost integration but requires linking against Boost libraries. Choose based on project constraints and feature needs.

Can argparse parse negative numbers and scientific notation?

Yes, it handles negative integers, floats, and scientific notation seamlessly using the scan method with shape specifiers like 'g' for general form, as demonstrated in the Negative Numbers and Converting to Numeric Types sections.

How to customize the help message layout in argparse?

Use methods like set_usage_max_line_width to control line breaks, add_usage_newline for forced new lines, and add_group to separate optional arguments, all detailed in the Advanced usage formatting example.

What's the best way to integrate argparse into a CMake project?

Use FetchContent to include the repository directly, then target_link_libraries your executable to argparse, as shown in the CMake Integration section. This avoids manual copying and ensures version control.

How does argparse handle optional arguments with default values?

Chain .default_value() to set fallbacks and .implicit_value() for flags, or use .flag() for boolean switches. Check user input with .is_used(), as explained in the Optional Arguments and Deciding if the value was given by the user parts.

Open-Awesome

argparse

MITC++v3.2

A single-header argument parsing library for modern C++17 applications.

GitHub

3.5k stars308 forks0 contributors

What is argparse?

argparse is a single-header argument parsing library for modern C++ that simplifies handling command-line arguments in applications. It provides a declarative API to define positional arguments, optional flags, subcommands, and complex parsing logic, replacing manual argc/argv processing with a robust, type-safe solution.

Target Audience

C++ developers building command-line tools, utilities, or applications that require sophisticated argument parsing, especially those using C++17 or newer standards.

Value Proposition

Developers choose argparse for its ease of use, modern C++ design, and comprehensive feature set—including subcommands, custom actions, and automatic help—all in a single header with no external dependencies.

Overview

Argument Parser for Modern C++

Use Cases

Best For

Building command-line tools with subcommands (like git)
Parsing complex argument structures with mutual exclusivity
Applications requiring automatic help generation and usage formatting
Tools that need to handle positional and optional arguments flexibly
Projects wanting a lightweight, header-only argument parser
C++17/20 codebases seeking modern, type-safe argument handling

Not Ideal For

Projects constrained to C++14 or earlier compiler toolchains
Applications where immediate program exit on --help/--version is unacceptable for proper resource cleanup
Tools with only a handful of static, hardcoded arguments that don't benefit from dynamic parsing features

Pros & Cons

Pros

Single-Header Simplicity

Just include argparse.hpp for instant integration, eliminating build system complexity and external dependencies, as highlighted in the Quick Start section.

Modern C++ Type Safety

Leverages C++17 features like scanning to numeric types and std::optional via .present(), ensuring compile-time checks and reducing runtime errors, as shown in argument handling examples.

Comprehensive Feature Set

Supports subcommands, mutually exclusive groups, parent parsers, and custom actions, matching the flexibility of Python's argparse, detailed in sections like Subcommands and Advanced Parsing.

Automatic Help Generation

Generates well-formatted usage messages with descriptions and epilogs, customizable via methods like set_usage_max_line_width and add_group, demonstrated in the help formatting examples.

Cons

Destructor-Skipping Exit

Default --help and --version actions exit the program immediately without calling destructors, which the README admits can bypass resource cleanup in the Default Arguments section.

Non-Copyable Design

ArgumentParser copy and move constructors are deleted since v3.0, restricting usage patterns and requiring setup in a single scope, as noted in the Developer Notes on copying and moving.

C++17 Mandate

Requires C++17 or newer, making it incompatible with legacy codebases or environments with older compiler toolchains, as stated in the Supported Toolchains table.

Frequently Asked Questions

Related Projects

FTXUI

:computer: C++ Functional Terminal User Interface. :heart:

Stars10,462

Forks607

Last commit4 days ago

cxxopts

Lightweight C++ command line option parser

Stars4,794

Forks650

Last commit11 days ago

CLI11

CLI11 is a command line parser for C++11 and beyond that provides a rich feature set with a simple and intuitive interface.

Stars4,376

Forks457

Last commit15 days ago

linenoise

A small self-contained alternative to readline and libedit

Stars4,320

Forks736

Last commit2 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub