desenvolvedor

Documentação do desenvolvedor

Principais funções

TEST_UNITY

RESULT_UNITY

Esta função é chamada ao final da execução da suíte de testes, como estabelecido utilizando o comando trap a seguir:

trap RESULT_UNITY exit

O objetivo da função RESULT_UNITY é exibir a contagem final dos casos de testes, apresentando o total dos testes realizados, os testes que falharam (se houver falha em algum teste) e o número de testes ignorados. Para tanto, a função utiliza os valores armazenados nas variáveis globais $NUMBER_OF_TESTS_UNITY, $NUMBER_OF_FAILURES_UNITY, e $NUMBER_OF_IGNORED_UNITY.

As duas últimas linhas da função RESULT_UNITY, apresentadas a seguir, verificam se todos os testes passaram ou se algum teste falhou, e encerra com o status de execução 0 ou 1, respectivamente. Basta que um dos testes falhe para o status de execução retornado ser 1.

[ "$NUMBER_OF_FAILURES_UNITY" -eq "0" ] && TEST_UNITY 0 && exit 0
TEST_UNITY 1 && exit 1

Variáveis globais

NUMBER_OF_TESTS_UNITY="0" NUMBER_OF_FAILURES_UNITY="0" NUMBER_OF_IGNORED_UNITY="0" FINISHED_ALL_TESTS_UNITY="0" TEST_IGNORE_UNITY="0"

Asserções básicas

TEST_IGNORE

A função TEST_IGNORE é utilizada para ignorar um bloco de testes. Esta funciona por meio de uma chave "on/off" recebida através do parâmetro $1 que altera a variável global TEST_IGNORE_UNITY. Quando a variável TEST_IGNORE_UNITY é igual a 1 os testes são ignorados pela função principal TEST_UNITY, quando esta variável é igual a 0 os testes são realizados e considerados pela função TEST_UNITY. A utilização da função TEST_IGNORE ocorre como no exemplo de uso a seguir:

TEST_IGNORE on # Ligar a chave para ignorar testes
TEST_ASSERT_TRUE "2==2" #... testes ignorado
TEST_ASSERT_FALSE "2==3" #... teste ignorado
TEST_ASSERT_FALSE "3==3" #... teste ignorado
TEST_IGNORE off # Desligar a chave para ignorar testes
# Os testes a seguir serão realizados
TEST_ASSERT_TRUE "2==2" #... testes realizado
TEST_ASSERT_FALSE "3==3" #... teste realizado

Esta manipulação da variável global TEST_IGNORE_UNITY ocorre dentro de um bloco if simples a depender do parâmetro $1 passado a função TEST_IGNORE_UNITY.

TEST_IGNORE(){
        if [ "$1" == "on" ]
        then
                TEST_IGNORE_UNITY="1"
        elif [ "$1" == "off" ]
        then
                TEST_IGNORE_UNITY="0"
        fi
}

⬆️ Voltar ao topo

---

TEST_MESSAGE(){

    echo "$0:$BASH_LINENO:INFO: $1"

}

TEST_FAIL(){ TEST_UNITY 1 "$BASH_LINENO" "$FUNCNAME" }

TEST_FAIL_MESSAGE(){

    echo "$0:$BASH_LINENO:FAIL: $1"
    TEST_UNITY 1 "$BASH_LINENO" "$FUNCNAME"

}

TEST_PASS(){

    TEST_UNITY 0 "$BASH_LINENO" "$FUNCNAME"

}

TEST_PASS_MESSAGE(){

    echo "$0:$BASH_LINENO:PASS: $1"
    TEST_UNITY 0 "$BASH_LINENO" "$FUNCNAME"

}

Asserções

TEST_ASSERT_EQUAL(){ TEST_ASSERT_NOT_EQUAL(){ TEST_ASSERT_TRUE(){ TEST_ASSERT_FALSE(){ TEST_ASSERT_EQUAL_STRING(){ TEST_FILE_FIND(){ TEST_DIR_FIND(){ TEST_FILE_X(){ TEST_FILE_W(){ TEST_FILE_R(){ TEST_ISATTY(){ TEST_FILE_NEWER(){ TEST_FILE_OLDER(){ TEST_FILE_EQUAL(){ TEST_FILE_EMPTY(){