argbash

argbash

• ¿Escribes scripts Bash que deberían aceptar argumentos?
• Pero no lo hacen, ya que el apoyo a los argumentos es una tarea desalentadora, porque ...
• getopt se desanima, getopts no admite opciones largas, no hay un módulo Bash ampliamente aceptado para hacer la tarea y algunas soluciones no funcionan en todas las plataformas (Linux, OSX, MSW) ...

¡Prueba Argbash y deja de ser aterrorizado por esos molestos argumentos! Con Argbash, obtendrás:

• Declaración rápida y minimalista de argumentos que su script espera (consulte a continuación los tipos de argumentos compatibles).
• Scripts generados a partir de definiciones una vez que se pueden usar en todas las plataformas que tienen bash .
• Definiciones integradas en pocas líneas del script en sí (por lo que puede usar Argbash para regenerar la parte de análisis de su script fácilmente).
• Capacidad para reutilizar los scripts de Argbash de bajo nivel envolviéndolos por Argbash de nivel superior con conveniencia, sin duplicar el código.
• Instalación fácil (opcional). Simplemente tome un lanzamiento, descomprima, entra y ejecuta cd resources && make install (es posible que desee ejecutar sudo make install PREFIX=/usr para una instalación de todo el sistema).
• Documentación y ejemplos.

Haga que su guión existente funcione con Argbash en un par de minutos. Explore varios sabores Argbash:

Sabor	Grupo objetivo
Argbash en línea	Úselo si desea probar Argbash sin instalarlo y tiene acceso permanente a Internet.
Argbash cli	Instale el paquete para tener argbash listo localmente todo el tiempo.
Argbash Docker	Casi como Argbash CLI, pero no tiene que instalarlo, simplemente descargue la imagen.

Que es

Argbash no es una biblioteca de análisis, pero es más bien un generador de código que genera una biblioteca bash hecha a medida para su script. Le permite describir argumentos que su script debe tomar y luego, puede generar el código de análisis bash . Se mantiene en su script de forma predeterminada, pero puede generarlo en un archivo separado y dejar que Argbash lo incluya en su script por usted. En cualquier caso, no necesitará Argbash para ejecutar el script.

Argbash es muy simple de usar y el código generado es relativamente agradable de leer. Además, las definiciones de argumentos permanecen integradas en el script, por lo que cuando necesita actualizar la lógica de análisis, solo vuelve a ejecutar el script argbash en el script ya generado.

Entonces, al escribir pocos comentarios a su guión y ejecutar el bin/argbash de Argbash sobre él, obtendrá un guión bash con análisis de argumentos. Consulte la plantilla de origen de ejemplo simple y el script de ejemplo simple para el resultado. Si no está en la lectura larga, deje que bin/argbash-init genere la plantilla para usted.

Se admiten los siguientes tipos de argumentos:

• Argumentos posicionales (valores predeterminados, posibilidad de un número de argumentos fijos, variables o infinitos),
• argumentos opcionales que toman un valor,
• argumentos opcionales booleanos,
• argumentos opcionales repetidos (es decir, no sobrewriting),
• incrementamiento (como --verbose ) argumentos opcionales y
• Argumentos opcionales de acción (como --version , --help ).

Las siguientes salidas están disponibles:

• Scripts bash, bibliotecas de análisis de bash hechas a medida.
• Scripts Posix que usan getopts , también a medida.
• Finalización de bash.
• Mensaje de uso que cumple con Docopt.
• Salida de la página de manejo utilizando RST2MAN.

La utilidad se ha inspirado en el argparse y el Proyecto shflags de Python.

Lea los documentos (última versión estable) para obtener más información

Requisitos

• bash que puede funcionar con matrices (probablemente bash >= 3.0 ) (el único requisito para los usuarios , es decir, las personas que solo ejecutan scripts y no los hacen)
• Utilidad autom4te que puede funcionar con conjuntos (parte de autoconf >= 2.63 Suite)
• Utilidades básicas Sa sed , grep , cat , test .