Testes unitários em Python no espaço de trabalho

O Azure Databricks fornece um conjunto de ferramentas para descobrir, executar e acompanhar testes unitários Python diretamente no espaço de trabalho. Use o painel lateral de testes, glifos de execução em linha e um painel dedicado de resultados para gerir os seus testes sem sair do espaço de trabalho.

Quando abres um ficheiro de teste Python válido, aparece um ícone Experiments.Tests na barra lateral esquerda. Clica nele para abrir o painel lateral de testes e aceder aos controlos de execução, indicadores de estado e resultados.

Ficheiros de teste válidos em Python

O Azure Databricks segue as convenções de nomenclatura pytest para detetar ficheiros de teste, classes e casos.

Os seguintes padrões de nomeação de ficheiros são reconhecidos como ficheiros de teste válidos:

  • test_*.py
  • *_test.py

As seguintes convenções de nomenclatura detetam classes e casos de teste:

  • test- funções ou métodos prefixados fora de uma classe
  • test-funções ou métodos com prefixo dentro Testde classes -prefixadas (sem método __init__ )
  • Métodos decorados com @staticmethod ou @classmethod dentro de classes com prefixo Test

Por exemplo:

Note

Se o ícone Experiências.ícone Testes não aparecer após abrir um ficheiro que corresponda a estes padrões, confirme que o ficheiro está ativo no separador do editor e que não está na vista só de leitura.

class TestClass():
    def test_1(self):
        assert True

    def test_3(self):
        assert 4 == 3

def test_foo():
    assert "foo" == "bar"

Painel lateral de testes

Para abrir o painel de Testes, clique no ícone de Experiências. Ícone de testes na barra lateral esquerda. Este ícone só aparece quando tens um ficheiro de teste Python válido ativo no editor.

O painel descobre automaticamente testes no ficheiro atual. Quando está dentro de um contexto de autoria (um caderno ou sessão de editor de ficheiros com um cluster anexado), a descoberta de testes cobre todos os ficheiros nesse contexto.

A partir do painel lateral dos testes, pode:

  • Ações do teste de gatilho:
    • Ativar ícone duplo. Executar todos os testes
    • Atualizar ícone x. Executa todos os testes falhados
    • Ícone de atualização. Testes de atualização
  • Monitorizar o estado do teste: Veja o ícone do círculo de verificação. Passe ou ícone do círculo X. Estado de reprovação de cada teste descoberto.
  • Filtrar testes: Filtrar a lista de testes por nome ou estado. Use a barra de pesquisa para filtrar por texto ou clique no ícone Filtrar para filtrar por estado.
  • Execute testes individuais: Execute testes específicos diretamente a partir do painel. Passe o rato sobre um teste e clique no ícone Play..

Painel lateral de testes

Executar testes com glifos em linha

Quando visualiza um ficheiro de teste em Python, os botões de execução aparecem em linha ao lado de cada caso de teste descoberto. Clique no ícone de Play para executar o teste. Após cada execução, o ícone atualiza-se para indicar se o teste passou ou falhou.

Testa glifos em linha

Ver os indicadores de falha integrados

Se um teste unitário falhar, aparece um indicador de falha em linha na linha que causou a falha. Clique no indicador para abrir um modal que mostra a mensagem de erro completa.

Indicadores de falha de testes

Ver resultados do teste

Quando estiver num ficheiro de teste Python válido, um separador Testes está disponível no painel inferior. O separador apresenta os resultados do teste mais recente, incluindo um resumo completo e resultados individuais do caso de teste.

Passe o rato sobre um caso de teste para aceder a duas opções:

  • Ícone de código de ficheiro. Navegar para testar
  • Ícone de reprodução. Executar teste

Teste do painel inferior