https://github.com/cofyc/argparse

Command-line arguments parsing library.
https://github.com/cofyc/argparse

argparse argument-parsing c cli

Last synced: 11 days ago
JSON representation

Command-line arguments parsing library.

• Host: GitHub
• URL: https://github.com/cofyc/argparse
• Owner: cofyc
• License: mit
• Created: 2012-03-10T11:05:34.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2023-08-17T15:44:11.000Z (11 months ago)
• Last Synced: 2024-03-01T10:33:03.119Z (4 months ago)
• Topics: argparse, argument-parsing, c, cli
• Language: C
• Homepage:
• Size: 134 KB
• Stars: 622
• Watchers: 26
• Forks: 117
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - argparse - Command-line arguments parsing library. (C)
• awesome - argparse - Command-line arguments parsing library. (C)
• awesome-c-zh - argparse - 命令行参数解析库，灵感来自Python的argparse模块。[](https://spdx.org/licenses/MIT.html) (公用事业 / YAML)
• awesome-stars - cofyc/argparse - Command-line arguments parsing library. (C)

README

        
# argparse

[![Build Status](https://github.com/cofyc/argparse/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/cofyc/argparse/actions/workflows/ci.yaml)

argparse - A command line arguments parsing library in C (compatible with C++).

## Description

This module is inspired by parse-options.c (git) and python's argparse

module.

Arguments parsing is common task in cli program, but traditional `getopt`

libraries are not easy to use. This library provides high-level arguments

parsing solutions.

The program defines what arguments it requires, and `argparse` will figure

out how to parse those out of `argc` and `argv`, it also automatically

generates help and usage messages and issues errors when users give the

program invalid arguments.

## Features

 - handles both optional and positional arguments

 - produces highly informative usage messages

 - issues errors when given invalid arguments

There are basically three types of options:

 - boolean options

 - options with mandatory argument

 - options with optional argument

There are basically two forms of options:

 - short option consist of one dash (`-`) and one alphanumeric character.

 - long option begin with two dashes (`--`) and some alphanumeric characters.

Short options may be bundled, e.g. `-a -b` can be specified as `-ab`.

Options are case-sensitive.

Options and non-option arguments can clearly be separated using the `--` option.

## Examples

- [basic](tests/basic.c)

- [subcommands](tests/subcommands.c)