Compartilhar via


Teste de unidade do Python no ambiente de trabalho

O Azure Databricks fornece um conjunto de ferramentas para descobrir, executar e acompanhar testes de unidade do Python diretamente no workspace. Use o painel lateral de teste, os ícones de execução embutidos e um painel de resultados dedicado para gerenciar seus testes sem sair do espaço de trabalho.

As ferramentas de teste de unidade do Python estão disponíveis quando você tem um arquivo de teste do Python válido aberto.

Arquivos de teste válidos do Python

O Azure Databricks segue convenções de nomenclatura pytest para detectar arquivos de teste, classes e casos.

Os seguintes padrões de nomenclatura de arquivo são reconhecidos como arquivos de teste válidos:

  • test_*.py
  • *_test.py

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

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

Por exemplo:

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

    def test_3(self):
        assert 4 == 3

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

Painel de testes na barra lateral

Quando você abre um arquivo de teste válido do Python, o ícone Experiments. O painel lateral de testes descobre automaticamente os testes no arquivo atual. Quando você estiver dentro de um contexto de criação, a descoberta de teste abrange todos os arquivos nesse contexto.

Na barra lateral de testes, você pode:

  • Disparar ações de teste:
    • Ícone de reprodução dupla. Executar todos os testes
    • Ícone x de atualização. Executar todos os testes com falha
    • Ícone de atualização. Atualizar testes
  • Monitorar o status do teste: Exiba o ícone de círculo de verificação. para status de passe ou ícone de círculo X. para status de falha de cada teste descoberto.
  • Filtrar testes: Filtre a lista de testes por nome ou status. Use a barra de pesquisa para filtrar por texto ou clique no ícone Filtrar. Para filtrar por status.
  • Executar testes individuais: execute testes específicos diretamente do painel. Passe o mouse sobre um teste e clique no ícone Reproduzir..

Painel da barra lateral de testes

Executar testes com glifos integrados

Quando você exibe um arquivo de teste do Python, os botões de execução aparecem embutidos ao lado de cada caso de teste descoberto. Clique no ícone Reproduzir. Para executar esse teste. Após cada execução, o ícone é atualizado para indicar se o teste foi aprovado ou falhou.

Testa glifos embutidos

Exibir indicadores de falha embutida

Se um teste de unidade falhar, um indicador de falha embutida aparecerá na linha que causou a falha. Clique no indicador para abrir um modal que exibe a mensagem de erro completa.

Testa indicadores de falha

Exibir resultados do teste

Quando você estiver em um arquivo de teste do Python válido, uma guia Teste estará disponível no painel inferior. A aba exibe os resultados da execução do teste mais recente, incluindo um resumo completo e resultados de casos de teste individuais.

Passe o mouse sobre um caso de teste para acessar duas opções:

  • Ícone de código de arquivo. Navegar para testar
  • Ícone de play. Executar teste

Painel inferior de teste