Começando com o Tester

Mesmo os bons programadores cometem erros. A diferença entre um bom programador e um mau programador é que o bom só o fará uma vez e da próxima vez o detectará usando testes automatizados.

  • “Aquele que não testa está condenado a repetir seus próprios erros”. (provérbio sábio)
  • “Quando nos livramos de um erro, aparece outro”. (Lei de Murphy)
  • “Sempre que você se sentir tentado a imprimir uma declaração, escreva-a como um teste”. (Martin Fowler)

Você já escreveu o seguinte código em PHP?

$obj = new MyClass;
$result = $obj->process($input);

var_dump($result);

Então, alguma vez você já deixou uma chamada de função só para verificar a olho se ela retorna o que deveria retornar? Você certamente o faz muitas vezes por dia. Com a mão no coração, se tudo funcionar, você apaga este código e espera que a classe não seja quebrada no futuro? A Lei de Murphy garante o oposto :-)

Na verdade, você escreveu o teste. Precisa de pequenas modificações para não exigir nossa inspeção, simplesmente para poder verificar a si mesmo. E se você não o apagasse, poderíamos executá-lo a qualquer momento no futuro para verificar se tudo ainda funciona como deveria. Você pode criar uma grande quantidade destes testes ao longo do tempo, então seria bom se pudéssemos executá-los automaticamente.

E o Nette Tester ajuda exatamente com isso.

O que torna o testador único?

Os testes de escrita para Nette Tester são únicos, pois ** cada teste é um script PHP padrão que pode ser executado de forma autônoma.**

Assim, quando você escreve um teste, você pode simplesmente executá-lo para ver se há um erro de programação. Se ele funcionar corretamente. Caso contrário, você pode passar facilmente pelo programa em sua IDE e procurar por um bug. Você pode até mesmo abri-lo em um navegador.

E o mais importante – ao executá-lo, você realizará o teste. Você descobrirá imediatamente se ele passou ou não. Como? Vamos aparecer aqui. Vamos escrever um teste trivial para usar o array PHP e salvá-lo no arquivo ArrayTest.php:

<?php
use Tester\Assert;

require __DIR__ . '/vendor/autoload.php';  # load Composer autoloader
Tester\Environment::setup();               # initialization of Nette Tester

$stack = [];
Assert::same(0, count($stack));   # we expect count() to return zero

$stack[] = 'foo';
Assert::same(1, count($stack));   # we expect count() to return one
Assert::contains('foo', $stack);  # verify that the $stack contains the item 'foo'

Como você pode ver, métodos de afirmação como Assert::same() são usados para afirmar que um valor real corresponde a um valor esperado.

O teste é escrito, podemos executá-lo a partir da linha de comando. A primeira execução revelará quaisquer erros de sintaxe, e se você não fez um erro de digitação, você vai ver:

$ php ArrayTest.php

OK

Tente mudar a declaração para Assert::contains('XXX', $stack); no teste e veja o que acontece quando é executado:

$ php ArrayTest.php

Failed: ['foo'] should contain 'XXX'

in ArrayTest.php(17) Assert::contains('XXX', $stack);

FAILURE

Continuamos a escrever no capítulo Testes de Escrita.

Instalação e requisitos

A versão mínima exigida pelo Tester é 7.1 (para mais detalhes, veja a tabela de versões em PHP suportadas ). A forma preferida de instalação é por Composer:

composer require --dev nette/tester

Tente executar o Nette Tester a partir da linha de comando (sem nenhum argumento, ele mostrará apenas um resumo da ajuda):

vendor/bin/tester

Testes em andamento

À medida que nossa aplicação cresce, uma série de testes cresce com ela. Não seria prático realizar testes um a um. Portanto, o Tester tem um testador em série, que nós invocamos da linha de comando. O parâmetro é o diretório no qual os testes estão localizados. O ponto indica o diretório atual.

vendor/bin/tester .

O corredor do Nette Tester procura no diretório especificado e em todos os subdiretórios e procura por testes, que são arquivos *.phpt e *Test.php. Ele também encontrará nosso teste ArrayTest.php, pois ele combina com a máscara.

Em seguida, começa os testes. Ele executa cada teste como um novo processo PHP, de modo que ele corre completamente isolado dos outros. Ele roda em paralelo em vários fios, tornando-o extremamente rápido. E primeiro executa testes que falharam durante a execução anterior, assim você saberá imediatamente se corrigiu o erro.

Para cada teste feito, o corredor imprime um caractere para indicar o progresso:

  • . – teste aprovado
  • s – o teste foi pulado
  • F – teste falhou

A saída pode ser assim:

 _____ ___  ___ _____ ___  ___
|_   _/ __)( __/_   _/ __)| _ )
  |_| \___ /___) |_| \___ |_|_\  v2.5.2

Note: No php.ini is used.
PHP 8.3.2 (cli) | php -n | 8 threads

........s................F.........

-- FAILED: greeting.phpt
   Failed: 'Hello John' should be
       ... 'Hello Peter'

   in greeting.phpt(19) Assert::same('Hello Peter', $o->say('John'));

FAILURES! (35 tests, 1 failures, 1 skipped, 1.7 seconds)

Foram realizados 35 testes, um falhou, outro foi pulado.

Continuamos no capítulo Testes em andamento.

Modo de relógio

Você está refatorando o código? Ou você está mesmo desenvolvendo de acordo com a metodologia TDD (Test Driven Development)? Então você vai gostar do modo relógio. O Tester monitora os códigos fonte e executa-se a si mesmo quando é alterado.

Durante o desenvolvimento, você tem um terminal no canto do monitor, onde a barra de status verde acende em você, e quando de repente fica vermelha, você sabe que acabou de fazer algo indesejado. Na verdade, é um grande jogo onde você programa e tenta se manter fiel à cor.

O modo de relógio é iniciado usando o parâmetro –watch.

Relatórios de Cobertura de Código

O Tester pode gerar relatórios com uma visão geral de quanto o código fonte os testes cobrem. O relatório pode ser em formato HTML legível por humanos ou em XML Clover para processamento posterior na máquina.

Veja o relatório HTML de amostra com cobertura de código.

Versões PHP suportadas

versão compatível com PHP
Tester 2.5 PHP 8.0 – 8.3
Tester 2.4 PHP 7.2 – 8.2
Tester 2.3 PHP 7.1 – 8.0
Tester 2.1 – 2.2 PHP 7.1 – 7.3
Tester 2.0 PHP 5.6 – 7.3
Tester 1.7 PHP 5.3 – 7.3 + HHVM 3.3+
Tester 1.6 PHP 5.3 – 7.0 + HHVM
Tester 1.3 – 1.5 PHP 5.3 – 5.6 + HHVM
Tester 0,9 – 1,2 PHP 5,3 – 5,6

Aplica-se às últimas versões de remendos.

Até a versão 1.7 Tester suportada HHVM 3.3.0 ou mais recente (usando tester -p hhvm). O suporte foi abandonado desde o Tester 2.0. O uso era simples: