Testes¶

Instalando o SimpleTest¶

Instalando o SimpleTest

O framework de testes disponível com o CakePHP 1.2 foi construído com base no framework de testes SimleTest. O SimpleTest não é disponibilizado numa instalação padrão do CakePHP, então primeiramente precisamos fazer obtê-lo. Você pode fazer o download do SimpleTest aqui: https://simpletest.sourceforge.net/.

Pegue a versão mais recente e descompacte o conteúdo para sua pasta vendors, ou para app/vendors, dependendo de sua preferência. Agora então deve haver um diretório vendors/simpletest dentro do qual estão todos os arquivos e pastas do SimpleTest. Lembre-se de ter definido o nível de DEBUG de sua aplicação pelo menos em 1 em seu arquivo app/config/core.php antes de executar quaisquer testes!

Se você não tiver uma conexão de testes definida em seu app/config/database.php, as tabelas de testes serão criadas com um prefixo test_suite_ no nome. Você pode criar uma conexão $test na sua base de dados para conter suas tabelas de testes com uma configuração parecida com esta abaixo:

var $test = array(
    'driver' => 'mysql',
    'persistent' => false,
    'host' => 'dbhost',
    'login' => 'dblogin',
    'password' => 'dbpassword',
    'database' => 'databaseName'
);

Se a base de dados test estiver disponível e se o CakePHP puder conectar a ela, todas as tabelas de testes serão criadas nesta base de dados.

Executando casos de teste principais¶

Os pacotes do CakePHP 1.2 não vêm com casos de testes principais do núcleo do framework. Para obter estes testes você precisa fazer o download do pacote do CakePHP disponibilizado diariamente (nightly) disponível em https://cakephp.org/downloads/nightly/1.2.x.x ou obtê-los dos fontes do Subversion, fazendo checkout do ramo 1.2.x.x do repositório. (Para mais detalhes sobre como obter o CakePHP, veja /view/30/Getting-CakePHP

Para adicionar os tests principais do CakePHP à sua aplicação, descompacte o pacote diário (nightly) em algum local temporário. Verifique a subpasta 1.2.x.x_dd.mm.yyyy/cake/tests e copie-a inteiramente para dentro da pasta /cake/tests de sua aplicação CakePHP.

Feito isto, então os testes podem ser acessados via browser acessando-se https://seu.dominio.cake/test.php - dependendo de sua instalação específica do CakePHP. Tente executar um dos grupos de testes do núcleo (Core Tests) clicando no link correspondente. Executr um grupo de testes pode demorar um pouco, mas ao final você eventualmente deve ver algo como «2/2 test cases complete: 49 passes, 0 fails and 0 exceptions.».

Parabéns, agora você está pronto para começar a escrever seus próprios casos de testes para sua aplicação!

Entendendo fixtures¶

Ao testar código que depende de modelos e de dados, pode-se usar o que chamamos de fixtures como uma forma de gerar dados temporários em tabelas carregadas com dados de registros de exemplo que podem ser usados apenas para teste. A vantagem de usar fixtures é que seu teste não tem como corromper dados reais em produção. Além disso, você pode começar a testar seu código antes carregar conteúdo de dados efetivos em sua aplicação.

O CakePHP tenta usar a conexão $test definida em seu arquivo de configuração app/config/database.php. Se esta conexão não existir ou não for possível usá-la, a conexão $default será então utilizada. Neste caso, o CakePHP adicionará «test_suite_» como prefixo de suas próprias tabelas para evitar colisão com de nomes com tabelas existentes.

Durante o curso de um caso de testes baseado em fixtures, o CakePHP realiza os seguintes passos:

1. Cria tabelas para cada um dos fixtures necessários

2. Popula as tabelas com dados, se houver dados definidos no fixture

3. Executa os métodos de teste

4. Empties the fixture tables

5. Remove as tabelas de fixtures da base de dados

Criando fixtures¶

Para criar um fixture, você vai definir principalmente duas coisas: como a tabela é criada (quas campos são parte da tabela) e quais registros de testes serão inicialmente populados nas tabelas. Vamos então criar nosso primeiro fixture, que será usado para testar nosso model Article. Crie um arquivo chamado article_fixture.php em seu diretório app/tests/fixtures com o seguinte conteúdo:

<?php
 class ArticleFixture extends CakeTestFixture {
      var $name = 'Article';

      var $fields = array(
          'id' => array('type' => 'integer', 'key' => 'primary'),
          'title' => array('type' => 'string', 'length' => 255, 'null' => false),
          'body' => 'text',
          'published' => array('type' => 'integer', 'default' => '0', 'null' => false),
          'created' => 'datetime',
          'updated' => 'datetime'
      );
      var $records = array(
          array ('id' => 1, 'title' => 'Primeiro artigo', 'body' => 'Texto do primeiro artigo', 'published' => '1', 'created' => '2007-03-18 10:39:23', 'updated' => '2007-03-18 10:41:31'),
          array ('id' => 2, 'title' => 'Segundo artigo', 'body' => 'Texto do segundo artigo', 'published' => '1', 'created' => '2007-03-18 10:41:23', 'updated' => '2007-03-18 10:43:31'),
          array ('id' => 3, 'title' => 'Terceiro artigo', 'body' => 'Texto do terceiro artigo', 'published' => '1', 'created' => '2007-03-18 10:43:23', 'updated' => '2007-03-18 10:45:31')
      );
 }
 ?>

Usamos o atribut $fields para especificar quais campos serão parte desta tabela e como são definidos. O formato usado para definir estes campos é o mesmo usado pela função generateColumnSchema() definida nas classes do mecanismo de base de dados do Cake (por exemplo, no arquivo dbo_mysql.php). Vejamos os atributos disponíveis que um campo pode levar e seus significados:

type

tipo de dados interno do CakePHP. Atulmente são suportdos: string (mapeia para VARCHAR), text (mapeia para TEXT), integer (mapeia para INT), float (mapeia para FLOAT), datetime (mapeia para DATETIME), timestamp (mapeia para TIMESTAMP), time (mapeia para TIME), date (mapeia para DATE) e binary (mapeia para BLOB)

key

defina como «primary» para fazer o campo como AUTO_INCREMENT e seja a PRIMARY KEY da tabela.

length

define o comprimento específico que o campo deve ter.

null

atribua true (para dizer que o campo pode conter valores NULL) ou false (se o campo dever ser NOT NULL)

default

o valor padrão que o campo deve ter se nada for informado.

Por último podemos definir um conjunto de registros que serão populador depois que a tabela de teste for criada. O formato para definição de registros é bastante intuitivo e não precisa de muita explicação. Apenas tenha em mente que cada registro no array $records deve ter um índice para cada um dos campos especificados no array $fields. Se um campo em um dado registro precisar assumir um valor NULL, defina explicitamente o campo específico como índice e seu valor como NULL.

Importando definições e registros das tabelas¶

Sua aplicação pode já ter models funcionando com dados reais associados a eles e você pode decidir testar seus models com tais dados. Seria um grande retrabalho ter de replicar a definição da tabela e/ou os registros presentes para seus fixtures. Felizmente, é possível fazer com que a definição de tabelas e/ou os registros presentes sejam utilizados por um dado fixture a partir de um model exstente ou mesmo a partir diretamente das tabelas no banco de dados.

chamado Article disponível em sua aplicação (referente à tabela no banco chamada articles), modifique o fixture criado na seção anterior (app/tests/fixtures/article_fixture.php) para:

<?php
  class ArticleFixture extends CakeTestFixture {
         var $name = 'Article';
         var $import = 'Article';
  }
  ?>

Esta declaração indica que a suíte de testes deve importar a definição de tabela a partir da tabela que está linkada ao model chamado Article. Você pode usar qualquer model disponível em sua aplicação. A declaração acima não vai importar os registros presentes na tabela, mas se quiser, você pode importar também os dados da tabela alterando o fixture:

<?php
class ArticleFixture extends CakeTestFixture {
    var $name = 'Article';
    var $import = array('model' => 'Article', 'records' => true);
}
?>

Se por outro lado você já tiver uma tabela criada mas sem o respectivo model para ela, você pode então fazer com que que as informações sejam importadas diretamente da tabela. Por exemplo:

<?php
  class ArticleFixture extends CakeTestFixture {
         var $name = 'Article';
         var $import = array('table' => 'articles');
  }
?>

Isto irá importar a definição de tabela para o fixture a partir de uma tabela chamada “articles” usando a conexão “default” do CakePHP. Se você quiser trocar a conexão a ser utilizada, você pode faze:

<?php
  class ArticleFixture extends CakeTestFixture {
  var $name = 'Article';
  var $import = array('table' => 'articles', 'connection' => 'other');
  }
  ?>

Como é usada a conexão da base de dados do CakePHP, caso haja algum prefixo de tabela ele será usado automaticamente quando as informações forem lidas da tabela. Os dois exemplos de código mostrados acima não importam os registros da tabela. Para forçar que o fixture importe também os registros de dados, modifique-o para:

<?php
  class ArticleFixture extends CakeTestFixture {
         var $name = 'Article';
         var $import = array('table' => 'articles', 'records' => true);
  }
?>

Você também pode importar suas definições de tabelas a partir de um model ou de uma tabela existentes mas tendo seus registros definidos diretamente no fixture tal como visto na seção anterior. Por exemplo:

<?php
  class ArticleFixture extends CakeTestFixture {
         var $name = 'Article';
         var $import = 'Article';

         var $records = array(
             array ('id' => 1, 'title' => 'Primeiro artigo', 'body' => 'Texto do primeiro artigo', 'published' => '1', 'created' => '2007-03-18 10:39:23', 'updated' => '2007-03-18 10:41:31'),
             array ('id' => 2, 'title' => 'Segundo artigo', 'body' => 'Texto do segundo artigo', 'published' => '1', 'created' => '2007-03-18 10:41:23', 'updated' => '2007-03-18 10:43:31'),
             array ('id' => 3, 'title' => 'Terceiro artigo', 'body' => 'Texto do terceiro artigo', 'published' => '1', 'created' => '2007-03-18 10:43:23', 'updated' => '2007-03-18 10:45:31')
         );
  }
?>

Métodos de Callback do CakeTestCase¶

Se você quiser definir alguma lógica logo antes ou depois de um método individual do CakeTestCase, ou mesmo antes ou depois de seu CakeTestCase todo, os seguintes callbacks estão disponíveis:

start()

end()

Último método chamado em um caso de teste.

startCase()

endCase()

before($method)

after($method)

startTest($method)

endTest($method)

Criando um caso de teste¶

Digamos que já temos nosso model Article definido em app/models/article.php, parecido com isto:

<?php
  class Article extends AppModel {
         var $name = 'Article';

         function published($fields = null) {
             $conditions = array(
                 $this->name . '.published' => 1
             );

             return $this->findAll($conditions, $fields);
         }
  }
?>

Agora queremos configurar um teste que iremos usar para este model, mas através de fixtures, para testar alguma funcionalidade no model. A suíte de teste do CakePHP carrega um conjunto mínimo de arquivos (para manter os testes isolados), assim temos de começar carregando o model em questão a ser testado (neste caso, o model Article) e então informar a suíte de teste que queremos testar este model especificando que configuração de banco de dados deve ser usada. A suíte de teste do CakePHP habilita uma configuração de banco de dados chamada test_suite que é usada por todos os models que dependem de fixtures. Definir $useDbConfig para esta configuração fará com que o CakePHP saiba que este model usa a conexão de banco de dados da suíte de teste.

criar um model de teste que estenda de Article, definindo $useDbConfig e $name apropriadamente. Agora crie um arquivo chamado article.test.php em seu diretório app/tests/cases/models, com o seguinte conteúdo:

<?php
  App::import('Model','Article');

  class ArticleTestCase extends CakeTestCase {
         var $fixtures = array( 'app.article' );
  }
?>

Criamos assim o ArticleTestCase. Na veriável $fixtures, definimos o conjunto de fixtures que iremos usar.

Se seu model estiver associado com outros models, você precisará incluir TODOS os fixtures para cada model associado, mesmo se você não for utilzá-los. Por exemplo: dados os models A, B, C e D, se tivermos os relacionamentos que A hasMany B, B hasMany C e C hasMany D, ao criar um caso de teste ATestCase, você terá que incluir fixtures para os models A, B, C e D.

Criando um método de teste¶

Vamos agora adicionar um método para testar a função published() no model Article. Edite o arquivo app/tests/cases/models/article.test.php deixando-o para algo como o mostrado abaixo:

<?php
  App::import('Model', 'Article');

  class ArticleTestCase extends CakeTestCase {
      var $fixtures = array( 'app.article' );

      function testPublished() {
          $this->Article = ClassRegistry::init('Article');

          $result = $this->Article->published(array('id', 'title'));
          $expected = array(
              array('Article' => array( 'id' => 1, 'title' => 'Primeiro artigo' )),
              array('Article' => array( 'id' => 2, 'title' => 'Segundo artigo' )),
              array('Article' => array( 'id' => 3, 'title' => 'Terceiro artigo' ))
          );

          $this->assertEqual($result, $expected);
      }
  }
  ?>

Como você pode ver, adicionamos um método chamado testPublished() ao nosso caso de teste. Começamos criando uma instância de nosso fixture baseada no model Article, e então executamos nosso método published(). Atribuímos à $expected aquilo que esperamos ser o resultado correto (que já sabemos, uma vez que nós mesmos definimos quais registros são inicialmente populados na tabela articles). Então verificamos se o resultado é igual a o que esperamos com uma chamada ao método assertEqual. Veja a seção Criando testes para informações sobre como executar os testes.

Criando um caso de teste¶

Digamos que você tenha um típico ArticlesController, com seu model correspondente, como algo parecido com isto:

<?php
class ArticlesController extends AppController {
   var $name = 'Articles';
   var $helpers = array('Ajax', 'Form', 'Html');

   function index($short = null) {
     if (!empty($this->data)) {
       $this->Article->save($this->data);
     }
     if (!empty($short)) {
       $result = $this->Article->findAll(null, array('id',
          'title'));
     } else {
       $result = $this->Article->findAll();
     }

     if (isset($this->params['requested'])) {
       return $result;
     }

     $this->set('title', 'Articles');
     $this->set('articles', $result);
   }
}
?>

Crie um arquivo chamado articles_controller.test.php no seu diretório app/tests/cases/controllers com o seguinte código:

<?php
class ArticlesControllerTest extends CakeTestCase {
   function startCase() {
     echo '<h1>Iniciando Caso de Teste</h1>';
   }
   function endCase() {
     echo '<h1>Terminando Caso de Teste</h1>';
   }
   function startTest($method) {
     echo '<h3>Iniciando método ' . $method . '</h3>';
   }
   function endTest($method) {
     echo '<hr />';
   }
   function testIndex() {
     $result = $this->testAction('/articles/index');
     debug($result);
   }
   function testIndexShort() {
     $result = $this->testAction('/articles/index/short');
     debug($result);
   }
   function testIndexShortGetRenderedHtml() {
     $result = $this->testAction('/articles/index/short',
     array('return' => 'render'));
     debug(htmlentities($result));
   }
   function testIndexShortGetViewVars() {
     $result = $this->testAction('/articles/index/short',
     array('return' => 'vars'));
     debug($result);
   }
   function testIndexFixturized() {
     $result = $this->testAction('/articles/index/short',
     array('fixturize' => true));
     debug($result);
   }
   function testIndexPostFixturized() {
     $data = array('Article' => array('user_id' => 1, 'published'
          => 1, 'slug'=>'new-article', 'title' => 'Novo Artigo', 'body' => 'Novo Texto de Artigo'));
     $result = $this->testAction('/articles/index',
     array('fixturize' => true, 'data' => $data, 'method' => 'post'));
     debug($result);
   }
}
?>

O método testAction¶

A novidade agora é o método testAction. O primeiro argumento deste método é a url (no formato do Cake) do controller e da action a ser testada, como em “/articles/index/short”.

O segundo argumento é um array de parâmetros, contendo:

return

defina para o que você quer retornar.

Valores válidos são:

• “vars” - Devolve os valores das variáveis da view (view vars) atribuídas após da execução da action

• “view” - Devolve o conteúdo da view renderizada em si, sem o layout

• “contents” - Devolve o conteúdo html completo da view, incluindo o layout

• “result” - Devolve o valor retornado quando a action utiliza $this->params[“requested”].

O default é “result”.

fixturize

defina como true se você quiser que seus models sejam autofixturizados (ou seja, que as tabelas de sua aplicação sejam copiadas juntamente com seus dados, para testar tabelas; assim se você modificar seus dados eles não irão afetar sua aplicação real). Se você definir “fixturize” para um array de models, apenas os models discriminados serão autofixturizados enquanto que os demais continuarão usando dados das tabelas reais. Entretanto, se você quiser usar seus arquivos de fixtures com o método testAction() então não utilize este recurso de fixturize. Ao invés disso, apenas utilize fixtures como você faria normalmente.

method

atribua para “post” ou “get” informando como você quer passar os dados para o controller

data

os dados a serem passados. Defina-o como um array associativo contendo pares campo => valor. Dê uma olhada no método function testIndexPostFixturized() no caso de teste acima para ver como emulamos dados do formulário para submissão de um novo artigo.

Problemas conhecidos¶

Se você usar testAction para testar um método que faça um redirect em um controller, seu teste irá encerrar imediatamente sem sequem mostrar nenhum resultado.

https://trac.cakephp.org/ticket/4154 para uma possível correção.

Criando testes de helper, parte I¶

Antes de mais nada, nós vamos definir as responsabilidades de nosso CurrencyRendererHelper. Basicamente, este helper terá dois métodos apenas para fins de demonstração:

function usd($amount)

Este método irá receber o total a renderizar. Ele leva 2 casa decimais, preenchendo espaços vazios com zeros e incluindo o prefixo “USD”.

function euro($amount)

Este método fará o mesmo que o usd() exceto que o prefixo incluído na saída será “EUR”. Só para deixar as cosas um pouco mais complexas, também vamos exibir o resultado dentro de uma tag span:

<span class="euro"></span>

Vamos criar os testes primeiro:

<?php

// Importa o helper a ser testado.
// Se o helper testado estiver usando outros helpers, como Html,
// estes também devem ser importados nesta linha e inicializados em startTest().
App::import('Helper', 'CurrencyRenderer');

class CurrencyRendererTest extends CakeTestCase {
    private $currencyRenderer = null;

    // Aqui instanciamos nosso helper, bem como todos os outros helpers que precisarmos.
    public function startTest() {
        $this->currencyRenderer = new CurrencyRendererHelper();
    }

    // testando o método usd().
    public function testUsd() {
        $this->assertEqual('USD 5.30', $this->currencyRenderer->usd(5.30));
        // Devemos sempre ter 2 casas decimais.
        $this->assertEqual('USD 1.00', $this->currencyRenderer->usd(1));
        $this->assertEqual('USD 2.05', $this->currencyRenderer->usd(2.05));
        // Testando o separador de milhar.
        $this->assertEqual('USD 12,000.70', $this->currencyRenderer->usd(12000.70));
    }

Aqui, chamamos usd() com diferentes parâmetros e dizemos para a suíte de testes checar se os valores retornados são iguais aos esperados.

Executar o teste agora irá resultar em erros (já que o currencyRendererHelper nem sequer existe ainda), mostrando que temos 3 falhas.

Uma vez que saibamos o que nosso método deve fazer, podemos escrever o método propriamente dito:

<?php
class CurrencyRendererHelper extends AppHelper {
    public function usd($amount) {
        return 'USD ' . number_format($amount, 2, '.', ',');
    }
}

Aqui definimos a quantidade de casas decimais como sendo 2, o separador decimal sendo o ponto, o separador de milhar como a vírgula e o prefixo do número formatado como a string “USD”.

Salve este código em app/views/helpers/currency_renderer.php e então execute o teste. Você deve ver uma barra verde e uma mensagem indicando 4 itens que passaram.

Inicializando o componente¶

Como o CakePHP não recomenda importar models diretamente dentro de componentes, nós precisamos de um controller para acessar os dados no model.

Se o método startup() do componente for parecido com isto:

public function startup(&$controller){
          $this->Transporter = $controller->Transporter;
 }

…então nós podemos criar uma classe falsa bem simples:

class FakeTransporterController {}

…e associar valores nela dessa forma:

$this->TransporterComponentTest = new TransporterComponent();
$controller = new FakeTransporterController();
$controller->Transporter = new TransporterTest();
$this->TransporterComponentTest->startup(&$controller);

Criando um método de teste¶

Apenas crie uma classe que estenda CakeTestCase e comece a escrever seus testes!

class TransporterTestCase extends CakeTestCase {
    var $fixtures = array('transporter');
    function testGetTransporter() {
          $this->TransporterComponentTest = new TransporterComponent();
          $controller = new FakeTransporterController();
          $controller->Transporter = new TransporterTest();
          $this->TransporterComponentTest->startup(&$controller);

          $result = $this->TransporterComponentTest->getTransporter("12345", "Sweden", "54321", "Sweden");
          $this->assertEqual($result, 1, "SP is best for 1xxxx-5xxxx");

          $result = $this->TransporterComponentTest->getTransporter("41234", "Sweden", "44321", "Sweden");
          $this->assertEqual($result, 2, "WSTS is best for 41xxx-44xxx");

          $result = $this->TransporterComponentTest->getTransporter("41001", "Sweden", "41870", "Sweden");
          $this->assertEqual($result, 3, "GL is best for 410xx-419xx");

          $result = $this->TransporterComponentTest->getTransporter("12345", "Sweden", "54321", "Norway");
          $this->assertEqual($result, 0, "Noone can service Norway");
   }
}

Sobre a CakeWebTestCase¶

CakeWebTestCase é uma extensão direta da classe WebTestCase do SimpleTest, sem qualquer funcionalidade extra. Toda a funcionalidade encontrada na documentação do SimpleTest para testes Web também está disponível. Isto também significa que nenhuma funcionalidade além das presentes no SimpleTest está disponível. Isso quer dizer que você não pode usar fixtures, e que todos os casos de teste que envolvam atualizar/inserir registros na base de dados irá modificar permanentemente os registros em sua base de dados. Os resultados dos testes quase sempre serão baseados nos valores presentes na base de dados, então uma etapa para certificar-se de que sua base de dados contenha os valores que você espera faz parte de seu procedimento de teste.

Criando um teste¶

Para se ater às prévias convenções de testes, você deve criar seus testes de views na pasta tests/cases/views. Obviamente você pode colocar estes testes em qualquer lugar, mas seguir as convenções sempre que possível é sempre uma boa ideia. Então vamos criar o arquivo tests/cases/views/complete_web.test.php

Primeiramente, quando você quiser criar testes web, você deve se lembrar de estender CakeWebTestCase ao invés de CakeTestCase:

class CompleteWebTestCase extends CakeWebTestCase

Se você precisar de algum preparativo antes de iniciar o teste, crie um construtor:

function CompleteWebTestCase(){
  // Seus preparativos iniciais aqui
}

Para escrever casos para testes web, a primeira coisa que você precisa fazer é obter alguma saída à qual analisar. Isto pode ser feito com uma requisição get ou post, usando-se os métodos get() ou post(), respectivamente. Ambos métodos recebem uma url completa como primeiro parâmetro. Esta url pode ser obtida dinamicamente. Neste caso, supondo que o script de teste esteja localizado em https://seu.dominio/cake/pasta/webroot/test.php , poder-se-ia obter esta url com:

$this->baseurl = current(split("webroot", $_SERVER['PHP_SELF']));

Você pode, então, fazer requisições gets e posts usando urls no formato do Cake, como por exemplo:

$this->get($this->baseurl."/products/index/");
$this->post($this->baseurl."/customers/login", $data);

O segundo parâmetro para o método post, $data, é um array associativo contendo os dados para a requisição no formato do Cake:

$data = array(
  "data[Customer][mail]" => "[email protected]",
  "data[Customer][password]" => "userpass");

Quando você tiver requisitado a página, você pode fazer diversos tipos de asserções com ela, usando os métodos disponíveis por padrão no próprio SimpleTest.

Navegando-se por uma página¶

A classe CakeWebTest também permite navegar-se por uma página, clicando em links ou imagens, preenchendo formulários e clicando em botões. Por favor, confira a documentação do SimpleTest para mais informações sobre isto.

Personalizando o relatório de testes¶

O relatório de testes padrão é muito minimalista. Se você quiser uma saída mais elaborada para impressionar alguém, não tema. Atualmente é muito fácil estender a saída do relatório de testes do CakePHP.

do núcleo do Cake, especificamente o /cake/tests/libs/cake_reporter.php.

Para modificar a saída dos testes você pode sobrescrever os seguintes métodos:

paintHeader()

Exibe conteúdo antes do teste ser iniciado.

paintPass()

Exibe conteúdo a cada caso de teste que passe. Utilize $this->getTestList() para obter um array de informações pertinentes ao teste, e $message para obter o resultado do teste. Lembre-se de fazer uma chamada a parent::paintPass($message).

paintFail()

Exibe conteúdo a cada caso de teste que falhe. Lembre-se de fazer uma chamada a parent::paintFail($message).

paintFooter()

Exibe conteúdo quando o texte tiver terminado, i.e., quando todos os casos de teste tiverem sido executados.

Se, ao chamar paintPass e paintFail, você quiser esconder a saída um nível acima, faça a chamada dentro de tags html de comentário, como em:

echo "\n<!-- ";
parent::paintFail($message);
echo " -->\n";

Uma configuração de exemplo de cake_reporter.php que cria uma tabela para armazenar os resultados dos testes poderia ser a seguinte:

<?php
 /**
 * CakePHP(tm) Tests <https://trac.cakephp.org/wiki/Developement/TestSuite>
 * Copyright 2005-2008, Cake Software Foundation, Inc.
 *                              1785 E. Sahara Avenue, Suite 490-204
 *                              Las Vegas, Nevada 89104
 *
 *  Licensed under The Open Group Test Suite License
 *  Redistributions of files must retain the above copyright notice.
 */
 class CakeHtmlReporter extends HtmlReporter {
 function CakeHtmlReporter($characterSet = 'UTF-8') {
 parent::HtmlReporter($characterSet);
 }

function paintHeader($testName) {
  $this->sendNoCacheHeaders();
  $baseUrl = BASE;
  print "<h2>$testName</h2>\n";
  print "<table style=\"\"><th>Res.</th><th>Test case</th><th>Message</th>\n";
  flush();
 }

 function paintFooter($testName) {
   $colour = ($this->getFailCount() + $this->getExceptionCount() > 0 ? "red" : "green");
   print "</table>\n";
   print "<div style=\"";
   print "padding: 8px; margin-top: 1em; background-color: $colour; color: white;";
   print "\">";
   print $this->getTestCaseProgress() . "/" . $this->getTestCaseCount();
   print " test cases complete:\n";
   print "<strong>" . $this->getPassCount() . "</strong> passes, ";
   print "<strong>" . $this->getFailCount() . "</strong> fails and ";
   print "<strong>" . $this->getExceptionCount() . "</strong> exceptions.";
   print "</div>\n";
 }

 function paintPass($message) {
   parent::paintPass($message);
   echo "<tr>\n\t<td width=\"20\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden;                  border-right: hidden\">\n";
   print "\t\t<span style=\"color: green;\">Pass</span>: \n";
   echo "\t</td>\n\t<td width=\"40%\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden; border-right: hidden\">\n";
   $breadcrumb = $this->getTestList();
   array_shift($breadcrumb);
   array_shift($breadcrumb);
   print implode("-&gt;", $breadcrumb);
   echo "\n\t</td>\n\t<td width=\"40%\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden; border-right: hidden\">\n";
   $message = split('at \[', $message);
   print "-&gt;$message[0]<br />\n\n";
   echo "\n\t</td>\n</tr>\n\n";
 }

 function paintFail($message) {
   echo "\n<!-- ";
   parent::paintFail($message);
   echo " -->\n";
   echo "<tr>\n\t<td width=\"20\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden; border-right: hidden\">\n";
   print "\t\t<span style=\"color: red;\">Fail</span>: \n";
   echo "\n\t</td>\n\t<td width=\"40%\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden; border-right: hidden\">\n";
   $breadcrumb = $this->getTestList();
   print implode("-&gt;", $breadcrumb);
   echo "\n\t</td>\n\t<td width=\"40%\" style=\"border: dotted 1px; border-top: hidden; border-left: hidden; border-right: hidden\">\n";
   print "$message";
   echo "\n\t</td>\n</tr>\n\n";
 }

 function _getCss() {
   return parent::_getCss() . ' .pass { color: green; }';
 }

 }
 ?>

Test Reporter methods¶

Reporters have a number of methods used to generate the various parts of a Test suite response.

paintDocumentStart()

Paints the start of the response from the test suite. Used to paint things like head elements in an html page.

paintTestMenu()

Paints a menu of available test cases.

testCaseList()

Retrieves and paints the list of tests cases.

groupCaseList()

Retrieves and paints the list of group tests.

paintHeader()

Prints before the test case/group test is started.

paintPass()

Prints everytime a test case has passed. Use $this->getTestList() to get an array of information pertaining to the test, and $message to get the test result. Remember to call parent::paintPass($message).

paintFail()

Prints everytime a test case has failed. Remember to call parent::paintFail($message).

paintSkip()

Prints everytime a test case has been skipped. Remember to call parent::paintSkip($message).

paintException()

Prints everytime there is an uncaught exception. Remember to call parent::paintException($message). Prints everytime an error is raised. Remember to call parent::paintError($message).

paintFooter()

Prints when the test case/group test is over, i.e. when all test cases has been executed.

paintDocumentEnd()

Paints the end of the response from the test suite. Used to paint things like footer elements in an html page.

Agrupando testes¶

Se você quiser que vários de seus testes sejam executados ao mesmo tempo, você pode tentar criar um grupo de testes. Crie um arquivo em /app/tests/groups/ e dê-lhe um nome como nome_de_seu_grupo_de_teste.group.php. Neste arquivo, estenda a classe GroupTest e importe seus testes como se segue:

<?php
class TryGroupTest extends GroupTest {
  var $label = 'try';
  function tryGroupTest() {
    TestManager::addTestCasesFromDirectory($this, APP_TEST_CASES . DS . 'models');
  }
}
?>

O código acima irá agrupar todos os casos de teste encontrados na pasta /app/tests/cases/models/. Para adicionar um arquivo individual, utilize TestManager::addTestFile($this, filename).