Unit test python nell'area di lavoro

Azure Databricks offre una suite di strumenti per individuare, eseguire e tenere traccia degli unit test Python direttamente nell'area di lavoro. Usare il riquadro laterale per i test, le icone di esecuzione inlinea e un riquadro dei risultati dedicato per gestire i test senza lasciare l'area di lavoro.

Quando si apre un file di test di Python valido, un Tests viene visualizzata nella barra laterale sinistra. Fare clic su di esso per aprire il riquadro della barra laterale di test e accedere ai controlli di esecuzione, agli indicatori di stato e ai risultati.

File di test Python validi

Azure Databricks segue le convenzioni di denominazione pytest per rilevare file di test, classi e case.

I modelli di denominazione dei file seguenti vengono riconosciuti come file di test validi:

• test_*.py
• *_test.py

Le convenzioni di denominazione seguenti rilevano classi e casi di test:

• test-prefixed functions o methods al di fuori di una classe
• Funzioni o metodi con prefisso test all'interno di classi con prefisso Test (senza un metodo __init__)
• Metodi decorati con @staticmethod o @classmethod all'interno di classi prefissate Test

Per esempio:

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

    def test_3(self):
        assert 4 == 3

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

Pannello della barra laterale dei test

Per aprire il riquadro Test, fare clic Icona Test nella barra laterale sinistra. Questa icona viene visualizzata solo quando nell'editor è attivo un file di test Python valido.

Il riquadro individua automaticamente i test nel file corrente. Quando ci si trova all'interno di un contesto di creazione (una sessione del notebook o dell'editor di file con un cluster collegato), l'individuazione dei test copre tutti i file in tale contesto.

Dal riquadro della barra laterale dei test è possibile:

• Attivare le azioni di test:
  • Eseguire tutti i test
  • Esegui tutti i test non superati
  • Aggiornamento test
• Monitorare lo stato del test: Visualizzare lo stato di superato o non superato di ogni test individuato.
• Test di filtro: filtrare l'elenco di test in base al nome o allo stato. Utilizzare la barra di ricerca per filtrare in base al testo o fare clic Per filtrare in base allo stato.
• Eseguire singoli test: eseguire test specifici direttamente dal riquadro. Passare il puntatore del mouse su un test e fare clic

Eseguire test con glifi inline

Quando si visualizza un file di test Python, i pulsanti esegui vengono visualizzati inline accanto a ogni test case individuato. Fare clic eseguire il test. Dopo ogni esecuzione, l'icona viene aggiornata per indicare se il test è stato superato o non riuscito.

Visualizzare gli indicatori di errore in linea

Se uno unit test ha esito negativo, viene visualizzato un indicatore di errore inline sulla riga che ha causato l'errore. Fare clic sull'indicatore per aprire un modale che visualizza il messaggio di errore completo.

Visualizzare i risultati dei test

Quando si usa un file di test Python valido, nel riquadro inferiore è disponibile una scheda Test . Nella scheda vengono visualizzati i risultati dell'esecuzione del test più recente, inclusi un riepilogo completo e i singoli risultati del test case.

Passare il puntatore del mouse su un test case per accedere a due opzioni:

• Vai al test
• Eseguire il test