[FEATURE] Add --help / -h flag (currently exits with File not found)

Abierto Apto para principiantes
#34 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Tranquilo
Stack tecnológico
python
Área
cli

Línea de trabajo

Empieza en maithili_dsl/cli.py, en main(), y copia la rama existente de -V / --version para manejar -h y --help antes de que la ruta del archivo se trate como nombre de archivo. Ejecuta primero python_maithili --help para ver el comportamiento actual con código de salida 3 'File not found'. Está terminado cuando ambos flags salen con código 0 e imprimen el uso en maithili e inglés, enumerando las formas de invocación, los flags y los códigos de salida, con pruebas en tests/test_cli.py que cubran ambos flags. No cambies a argparse sin discutirlo antes, como pide el issue.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

area:cli enhancement good first issue P3

python_maithili --help currently prints Error: File '--help' not found. and exits 3 (verified) — there is no help flag at all.

Fix: in maithili_dsl/cli.py main(), handle -h / --help before the file path (same pattern as the existing -V / --version branch). Print usage in both Maithili and English, listing:

  • invocation forms (python_maithili <file.dmai>, python -m maithili_dsl <file.dmai>)
  • available flags (--version, --help, plus any added by other issues)
  • the documented exit codes (EXIT_OK 0, usage 2, not-found 3, lint 4, import-blocked 5, runtime 6)

Tests: tests/test_cli.py — --help and -h return exit 0 and contain the usage string.

Good first issue: pure CLI plumbing, no transpiler knowledge needed. (If you prefer migrating the hand-rolled arg handling to argparse, propose it in a comment first — it touches --version behavior too.)

Lenguaje dominante
Python
Estrellas
1
Forks
4
Merge medio
12 d 21 h
PR fusionados (30 d)
1

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de alphacrack/python-maithili-dsl

Todos los issues de alphacrack/python-maithili-dsl

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.