KEPLIN Docs

O ambiente de teste

Onde os testes escrevem cada base de dados, o datasource de teste das bases externas com escrita, os utilizadores de teste, as respostas HTTP simuladas, o portão da fusão, a execução agendada e os limites.

O ambiente de teste diz onde os testes escrevem, com que contas entram na app e o que acontece aos efeitos para fora da app. Abre-se no minitab Testes, no botão Ambiente de teste.

O ambiente de teste, num modal de tamanho fixo
O ambiente de teste, num modal de tamanho fixo

Nota

Só um administrador muda o ambiente de teste. Um developer vê-o.

Bases de dados

Cada datasource da app aparece com o tipo, o acesso e o que acontece nos testes:

Datasource Nos testes
Base interna da app Uma cópia nova com o esquema da base, em cada teste.
PostgreSQL interno Uma base temporária no servidor gerido, com o esquema da real, em cada teste.
Base externa com escrita (Leitura e escrita ou Estrutura protegida) O datasource de teste escolhido, obrigatório. As tabelas dos dados de teste esvaziam-se antes de cada teste.
Base externa em Só leitura A base real, só para ler. Os testes lêem-na e nunca escrevem nela.

O datasource de teste das bases externas

Uma base externa com escrita não se pode copiar a cada teste. Os testes usam outro datasource da app, ligado a uma base de teste com a mesma estrutura. As ligações criam-se sempre nos datasources, na secção Dados, e o ambiente de teste só escolhe qual usar.

  1. Na secção Dados, crie um datasource do mesmo tipo, com escrita, ligado à base de teste. Também pode ser um datasource interno.
  2. Abra o Ambiente de teste.
  3. Na linha da base externa, carregue em Escolher o datasource de teste e escolha-o da lista.
  4. Carregue em Gravar.

O estado passa a pronta. Na linha do datasource escolhido, o ambiente diz de que base é o datasource de teste, e os testes usam-no tal como está.

Atenção

Enquanto uma base externa com escrita não tiver o datasource de teste escolhido, nenhum teste da app é executado, nem os que parecem não usar essa base. Um teste chega a qualquer base da app através de um ecrã, de uma API ou de um script, e não há forma segura de saber antes de executar a que bases chega. A execução fica Bloqueada e diz qual base falta.

Uma base externa em Só leitura não precisa de datasource de teste: os testes lêem a base real, e a plataforma recusa qualquer escrita nela, como já faz fora dos testes. A garantia total é ligar essa base com um utilizador que só tenha permissões de leitura.

Utilizadores de teste

Um teste que começa como um papel entra na app com a conta escolhida aqui para esse papel, com todos os papéis dessa conta.

  1. Em Utilizadores de teste, na linha do papel, carregue em Escolher o utilizador.
  2. Procure e escolha uma conta activa que tenha esse papel. Sem utilizador desfaz a escolha.
  3. Carregue em Gravar.

Só se escolhem contas que já existem: as contas e os papéis dão-se em Definições da app › Utilizadores da app. A linha Visitante não tem conta: um teste sem papel não tem sessão e vê só os ecrãs e as APIs públicas, como quem abre a app sem entrar.

Cada linha diz quantos testes usam esse papel. Um teste com um papel sem conta escolhida falha com «O papel … não tem utilizador de teste».

Respostas HTTP simuladas

Nos testes, um pedido HTTP de uma API ou de um workflow nunca sai para a rede: recebe a resposta simulada cujo endereço seja o início do endereço do pedido (e o método, se o disser). Um pedido sem resposta simulada falha o passo com o endereço, para se saber o que falta simular.

Para juntar uma, carregue em Juntar resposta e preencha o método, o endereço (por exemplo https://api.exemplo.pt/v1/), o código e o corpo.

Nota

Os scripts fazem os pedidos no seu próprio processo e não passam pelas respostas simuladas.

Quando são executados sozinhos

  • Antes de fundir no main: com o portão ligado, fundir uma versão no main executa primeiro os testes com as etiquetas indicadas (ou todos, sem etiquetas) na versão de origem. Se não passarem, nada se funde. Ver Executar e ler os resultados.
  • Executar todos os testes à hora desta expressão cron: a execução agendada, por exemplo 0 2 * * * (todas as noites às 02:00). Precisa de o agendador da plataforma estar ligado.

Limites

  • Segundos por passo: quanto um passo pode demorar (e quanto uma verificação de ecrã espera). Por omissão, 30.
  • Minutos por execução: quanto uma execução pode demorar. Por omissão,