argparse y configparser

argparse crea interfaces CLI con --flags, subcomandos y texto de ayuda. configparser lee archivos estilo INI para valores predeterminados en capas; combínalo con variables de entorno para aplicaciones de doce factores.

Receta

import argparse
 
parser = argparse.ArgumentParser(description="Demo CLI")
parser.add_argument("--verbose", action="store_true")
parser.add_argument("name")
args = parser.parse_args(["Ada", "--verbose"])

Cuándo recurrir a esto:

• Herramientas CLI internas y scripts de desarrollo
• Configuración INI heredada (setup.cfg, logging.ini)
• Typer/click aún no justificados
• Herramientas basadas en subcomandos (estilo git)
• Patrón de archivo de configuración predeterminado + anulación de CLI

Ejemplo de trabajo

import argparse
import configparser
from pathlib import Path
 
def build_parser() -> argparse.ArgumentParser:
    p = argparse.ArgumentParser()
    p.add_argument("--config", type=Path, default=Path("app.ini"))
    p.add_argument("--port", type=int)
    return p
 
def load_config(path: Path) -> configparser.ConfigParser:
    cfg = configparser.ConfigParser()
    if path.exists():
        cfg.read(path, encoding="utf-8")
    return cfg
 
def resolve_port(args: argparse.Namespace, cfg: configparser.ConfigParser) -> int:
    if args.port is not None:
        return args.port
    if cfg.has_option("server", "port"):
        return cfg.getint("server", "port")
    return 8000
 
args = build_parser().parse_args(["--port", "9000"])
cfg = load_config(args.config)
print(resolve_port(args, cfg))

Lo que esto demuestra:

• Las anulaciones de la CLI superan la configuración del archivo, que supera los valores predeterminados
• Secciones de configparser y obtentores tipados (getint)
• Tipo Path para rutas de argparse
• Codificación explícita en la lectura para portabilidad

Inmersión profunda

Características de argparse

• nargs, choices, metavar
• add_subparsers para subcomandos
• ArgumentDefaultsHelpFormatter muestra los valores predeterminados

Notas de configparser

• Interpolación %(section)s opcional
• ConfigParser no admite TOML completo; usa tomllib para pyproject

Trampas comunes

• Flags booleanos incorrectos - type=bool está roto. Solución: action="store_true".
• Confusión entre opcional y requerido - documenta claramente los argumentos posicionales vs. opcionales.
• Configuración faltante silenciosamente - los valores predeterminados vacíos sorprenden. Solución: valida las secciones requeridas después de la lectura.
• Secretos en INI - archivos legibles por cualquiera. Solución: usa variables de entorno para secretos, no configures archivos que se suban al repositorio.
• argparse en la importación de la biblioteca - parse_args como efecto secundario en la importación. Solución: protégelo dentro de main().

Alternativas

Preguntas frecuentes

Relacionado

• subprocess - Las herramientas CLI inician procesos
• pathlib & os - Rutas de configuración
• Descripción general de la biblioteca estándar - Mapa
• Mejores prácticas de la biblioteca estándar - Política de CLI/configuración

Versiones de la pila: Esta página se escribió para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ y uv 0.6+.