argbash

Argbash

• Você escreve scripts Bash que devem aceitar argumentos?
• Mas eles não desde que o suporte de argumentos é uma tarefa assustadora, porque ...
• getopt está desanimado, getopts não suporta opções longas, não há um módulo Bash amplamente aceito para realizar a tarefa e algumas soluções não funcionam em todas as plataformas (Linux, OSX, RSW) ...

Experimente Argbash e pare de ser aterrorizado por esses argumentos irritantes! Com o Argbash, você receberá:

• Declaração de argumentos rápida e minimalista que seu script espera (veja abaixo os tipos de argumento suportados).
• Os scripts gerados a partir de definições assim que podem ser usados ​​em todas as plataformas que possuem bash .
• Definições incorporadas em algumas linhas do próprio script (para que você possa usar Argbash para regenerar a parte de análise do seu script facilmente).
• Capacidade de reutilizar os scripts de baixo nível Argbash -eee, envolvendo-os por Argbash de nível mais alto, convenientemente, sem duplicar o código.
• Instalação fácil (opcional). Basta pegar uma versão, descompactar-o, entrar e executar cd resources && make install (convém executar sudo make install PREFIX=/usr para uma instalação em todo o sistema).
• Documentação e exemplos.

Faça o seu script existente alimentado por Argbash em alguns minutos. Explore vários sabores de argbash:

Sabor	Grupo -alvo
Argbash online	Use -o se quiser experimentar o Argbash sem instalá -lo e tiver acesso permanente à Internet.
Argbash CLI	Instale o pacote para preparar argbash localmente o tempo todo.
Argbash Docker	Como o CLI do Argbash, mas você não precisa instalá -lo, basta baixar a imagem.

O que é

Argbash não é uma biblioteca de análise, mas é um gerador de código que gera uma biblioteca de bash personalizada para o seu script. Permite descrever os argumentos que seu script deve tomar e, em seguida, você pode gerar o código de análise bash . Ele permanece no seu script por padrão, mas você pode gerá -lo para um arquivo separado e deixar Argbash para incluí -lo em seu script para você. De qualquer forma, você não precisará Argbash para executar o script.

Argbash é muito simples de usar e o código gerado é relativamente agradável de ler. Além disso, as definições de argumento permanecem incorporadas no script; portanto, quando você precisa atualizar a lógica de análise, basta executar novamente o script argbash no script já gerado.

Então, ao escrever alguns comentários para o seu script e executar o bin/argbash do Argbash, você receberá um script bash com o argumento. Consulte o modelo de origem de exemplo simples e o script de exemplo simples para o resultado. Se você não gosta de leitura longa, deixe bin/argbash-init gerar o modelo para você.

Os tipos de argumento a seguir são suportados:

• Argumentos posicionais (padrões suportados, possibilidade de número fixo, variável ou infinito de argumentos),
• argumentos opcionais que assumem um valor,
• Argumentos opcionais booleanos,
• Argumentos opcionais (ou seja, não-escrita repetidos, ou seja,
• Incrementação (como --verbose ) argumentos opcionais e
• Ação Argumentos opcionais (como --version , --help ).

Os seguintes saídas estão disponíveis:

• Scripts Bash, Bibliotecas de Parsing Bash feitas sob medida.
• Scripts POSIX que usam getopts , também feitos sob medida.
• Conclusão da partida.
• Mensagem de uso compatível com DocOpt.
• Saída da manpra usando RST2man.

A concessionária foi inspirada no Projeto argparse e shflags da Python.

Leia os documentos (mais recente versão estável) para obter mais informações

Requisitos

• bash que pode funcionar com matrizes (provavelmente bash >= 3.0 ) (o único requisito para os usuários - ou seja, pessoas que apenas executam scripts e não os fazem)
• Utilitário autom4te que pode funcionar com conjuntos (parte do autoconf >= 2.63 suíte)
• Utilitários básicos sa sed , grep , cat , test .