ddargparse 0.1.3

Dataclass driven argparse handling

ddargparse

A small Python library that simplifies command-line argument parsing by leveraging dataclasses. It allows developers to define their command-line interfaces using dataclass fields, making the code more concise and easier to maintain. With ddargparse, you can easily create complex command-line applications with minimal boilerplate code. It puts a particular focus on properly handling type annotations and defaults, minimizing additional required annotation and maintaining interoperability with the standard argparse.

Installation

pip install ddargparse

Usage

Subclass OptionsBase and annotate fields with standard argparse metadata via the dataclasses.field function (help, required, positional, metavar). Then call register_cli_args to populate an ArgumentParser and from_cli_args to instantiate your options from the parsed result.

from argparse import ArgumentParser
from dataclasses import dataclass, field
import ddargparse

@dataclass
class Options(ddargparse.OptionsBase):
    input: str = field(
        metadata={"help": "Input file", "required": True, "metavar": "FILE"},
    )
    verbose: bool = field(
        metadata={"help": "Enable verbose output"},
    )
    tags: list[str] = field(
        default_factory=list,
        metadata={"help": "One or more tags"},
    )

parser = ArgumentParser()
Options.register_cli_args(parser)
args = parser.parse_args()
options = Options.from_cli_args(args)

Features

• Declare CLI arguments as typed dataclass fields — no repetitive add_argument calls, no need for the type argument.
• Booleans (store_true / store_false), and list arguments (nargs="+") are inferred automatically from the dataclass field definitions.
• Custom parse methods: define a parse_<field_name> classmethod to override the argument type converter.
• Mark options as positional ("positional": True).
• Automatic and natural inference whether option is required (no field(default=...) and no | None in type annotation).
• No additional dependencies.

Requirements

• Python ≥ 3.11

License

See LICENSE.