Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- boas_praticas_de_programacao_shell_script [2018/08/17 14:13] – cartola
+++ boas_praticas_de_programacao_shell_script [2019/08/02 15:16] – [Frameworks] cartola
@@ Linha 1: / Linha 1: @@
+====== Programação Shell Script: boas práticas ======
+Antes veja [[ti_publica:desenvolvimento_de_sistemas:boas_praticas|Desenvolvimento de sistemas: boas práticas]]
 Esse é um guia pessoal de referência. Na maioria dos casos a dica se baseia no **Shell Bash**, mas muitas são genéricas. Anoto aqui dicas que considero úteis, de modo que possa acessá-las de qualquer lugar, aproveitando para compartilhar com quem possa ter interesse.
@@ Linha 5: / Linha 8: @@
 Naturalmente algumas dicas aqui provavelmente servirão pra outras linguagens de programação. A medida que eu perceber isso vou tentar marcá-las como "**DICA GERAL**"
+===== Referências Externas =====
+==== Gerais ====
+  * [[http://kvz.io/blog/2013/11/21/bash-best-practices/|Bash best practices]]
+==== Frameworks ====
+  * [[https://invent.life/project/bash-infinity-framework/|Infinity framework]]
+  * [[http://bashinator.org/|Bashinator]] - lista outros frameworks também
+  * [[https://github.com/sstephenson/bats]] - Testes unitários automatizados
 ======= Documentação =======
@@ Linha 41: / Linha 52: @@
 ======= Testes automatizados =======
+Existem linguagens que tem ferramentas pra facilitar isso, existe alias o [[https://github.com/bats-core/bats-core|BATS]] ([[https://hk.saowen.com/a/76a0859c6dbd6a2ac11c80dada4234fac367fdf43db39cf7e32992e46e8e1ed9|veja também esse guia]]) pro shell Bash, mas trabalhando com o conceito é possível fazer pra qualquer linguagem. Como Bash trabalha com funções, o melhor é refatorar o código de modo que funções recebam e retornem valores ou que executem coisas verificáveis, viabilizando testes externos que não necessariamente precisem executar as tarefas reais ou no ambiente real.
-  *  Refatoração para viabilizar
+Um script muitas vezes é pequeno e, nesses casos, a criação de testes talvez não se justifique. Se começar a crescer, se for complexo, se for ser alterado de tempos em tempos, então pode se considerar essa criação dos testes, que garantirá o funcionamento esperado de cada parte do código, evitando que uma eventual alteração faça com que se crie um bug. Essa é a moral da coisa.
-  *  Script testador
+**Refatoração para viabilizar
+**\\  *  Dividir o código colocando as partes que se quer testar em funções que possam ser testadas separadamente. Sem divisão fica complicado testar todo o código e fica complicado se referir a partes de um código inteiro.
+  *  Funções que recebem e retornam facilitam muito os testes
+  *  Modularizar em outros scripts também pode facilitar, se eles também receberem e retornarem algo
+**script testador X modo teste
+**\\  *  Para criar um script externo que teste o principal, o ideal é que o programa principal só seja executado se não for um teste. Ao colocarmos o código separado em funções podemos testar se o principal deve rodar ou não. Para carregar as funções do script principal no script testador usamos a sintaxe:
+<code>source principal.sh</code>
+e as funções estarão disponíveis dentro do testador, não sendo executada nenhuma. Ao executar o principal diretamente, o programa principal dispara os processos. Como fazer essa diferenciação? Através da variável "$0". Ao chamar um script diretamente, o $0 assume o nome do script. Quando carregamos com o "source" ficamos com "$0 = -bash". A parte principal do script deve, portanto, ter sua execução condicionada:
+  ## PROGRAMA PRINCIPAL
+    if [ "$0" != "-bash" ]; then
+      echo "programa principal"
+    fi
+Os resultados da execução de cada uma das formas é o previsto:
+  $ source principal.sh
+    $ . principal.sh
+    $ ./principal.sh
+    programa principal
+    $ bash principal.sh
+    programa principal
+Notas:
+  *  O comando "." é equivalente ao "source"
+  *  Mesmo chamando outro shell com "bash" o "$0" se mantém como "principal.sh"
+De resto, portanto, é colocar em funções o que é necessário testar no código e chamar elas dentro da parte principal do programa (que não será testada) e dentro do script testador, que promoverá, idealmente, uma série de testes, verificando o comportamento de cada função para N situações diversas, de modo a garantir a estabilidade do código.
@@ Linha 66: / Linha 102: @@
 Exemplo: definindo múltiplas variáveis
   read filesystem total used free perc name < <(df . | tail -1)
+===== Lendo linha a linha e atribuindo colunas a variáveis =====
+  echo "Sistema"
+  echo "  disponivel"
+  df | grep -v "^Filesystem" | while read fs total used avail perc mount; do
+    echo "$fs"
+    echo "        $avail"
+  done
+Resultado da execução:
+  $ ./exemplo.sh
+  Sistema
+          disponivel
+  /dev/mapper/system-root
+          2014976
+  devtmpfs
+          8121660
+  tmpfs
+          8133648
+  *  opção de delimitador
+  *  como jogar linha inteira numa variável
+  *  readarray