Menú

Mostrar Mensajes

Esta sección te permite ver todos los mensajes escritos por este usuario. Ten en cuenta que sólo puedes ver los mensajes escritos en zonas a las que tienes acceso en este momento.

Mostrar Mensajes Menú

Temas - tt0ne'

#1
Buenas, underc0ders.
Hoy les traigo un framework para bash que permite probar que los scripts que escriben para UNIX funcionen de la manera esperada.

De manera muy basica explicaré como funciona:

Como primer paso, tenemos que instalar bats en la maquina que correrá los tests:

Código: bash
$ git clone https://github.com/sstephenson/bats.git
$ cd bats
$ ./install.sh /usr/local


Luego definimos un archivo bats, el cual deberá ser escrito con una sintaxis particular para definir los test cases.

En mi caso, llamaré el archivo addition.bats

Código: bash
$ touch addition.bats


Utilizando el ejemplo del repositorio oficial, unos tests cases muy simples se definirian así:
Nota: tenemos que avisarle al archivo bats que el interprete que tiene que utilizar es bats y no bash:

Código: bash

#!/usr/bin/env bats

@test "addition using bc" {
  result="$(echo 2+2 | bc)"
  [ "$result" -eq 4 ]
}

@test "addition using dc" {
  result="$(echo 2 2+p | dc)"
  [ "$result" -eq 4 ]
}


Luego, utilizamos bats para ejecutar el file con los tests:

Código: bash
$ bats addition.bats
✓ addition using bc
✓ addition using dc

2 tests, 0 failures


Personalmente, me sirvió mucho para probar que los outputs de un CLI personalizado fueran los esperados y además que se pudiera instalar en la maquina de forma exitosa (si se utiliza la función setup  de bats, se ejecutará una función para setupear el ambiente cada vez que se corran los tests y fallará si la salida del script es igual a 1).

El framework ofrece muchisimas cosas mas como librerias que se pueden cargar con un load que permiten hacer asserts muchos mas complicados.

Un test un poco mas producido podria ser, un test que crea un virtual environment en python3 y llama a un paquete para que corra determinados comandos desde un cli:
NOTA: las librerias de assert deben ser descargadas e incluidas en el proyecto para poder ser cargadas con un load

Código: bash
#!/usr/bin/env bats

load 'test_helper/bats-support/load'
load 'test_helper/bats-assert/load'

setup() {
  apt install -y python3-venv
  python3 -m venv my_env
  source my_env/bin/activate
  apt install python3-pip
  python3 -m pip install --index-url https://pypi.org/simple/ custom-cli
}

@test "Invoking get command from custom CLI should list custom data types" {
  export CUSTOM_URL="https://custom-api-url.com/"
  SECRET_KEY=$(sops -d --extract '["secret-key"]' file.enc)
  export CUSTOM_SECRET_KEY="$SECRET_KEY"
  run python3 -m custom-cli get object --type "*"
  assert_output -p "type1"
  assert_output -p "type2"
  assert_output -p "type3"
  assert_output -p "type4"
  assert_output -p "type5"
  [ "$status" -eq 0 ]
}


Espero sea util para alguien, saludos!

Link del repositorio oficial: No tienes permitido ver los links. Registrarse o Entrar a mi cuenta