introduzione

Doctest è un metodo di test semplice ma utile per i programmi Python. Rispetto allo unit test , doctest non richiede uno script indipendente per scrivere casi di test. I casi di test possono essere scritti semplicemente nelle informazioni del documento (contenuti tra virgolette triple / doppie) di una funzione Python. Quindi questi casi possono testare la funzione utilizzando il doctestmodulo.

Il doctestmodulo cerca parti di testo che assomigliano a sessioni interattive di Python, quindi esegue quelle sessioni per verificare che funzionino esattamente come mostrato. ( documento python )

Un semplice esempio

Usiamo doctest per una abs()funzione sbagliata :

Il risultato è il seguente:

Come mostrato nell'esempio sopra, il doctest è davvero un modo comodo e semplice per testare la funzione.

In poche parole, ci sono solo 3 passaggi:

• doctestmodulo di importazione
• scrivere i casi di test tra virgolette triple / doppie utilizzando
• utilizzare doctest.testmod()per eseguire doctest

Se tutti i casi di test vengono superati, non doctestverrà stampato nulla.

Altri suggerimenti di Doctest

1. Per stampare ulteriori informazioni

In doctest.testmod, c'è un parametro importante chiamato verbose.

È impostato su Falseper impostazione predefinita, il che significa che durante l'esecuzione del test, solo i casi non riusciti produrranno informazioni dettagliate. Se desideri ottenere informazioni complete su ogni caso, impostalo su True.

if __name__ == '__main__':
    doctest.testmod(verbose=True)

In realtà, non dobbiamo scrivere il if __name__ == '__main__':blocco. Possiamo eseguire doctest direttamente nel terminale:

$ python -m doctest wrong_abs.py

$ python -m doctest -v wrong_abs.py

A volte, potrebbe essere un po 'complicato se mettiamo sia commenti che casi di test sotto la funzione. Nessun problema, possiamo mettere tutti i casi di test in un file indipendente ed eseguire comunque doctest perfettamente.

Ad esempio, creiamo un file chiamato test_cases.txte inseriamo i casi di test "stile doctest":

Quindi esegui il doctest con questo comando:

python -m doctest test_cases.txt

Conclusione

Doctest è un metodo di test facile da usare per i programmi Python. Usare bene questa tecnica può aiutarti a ottenere un codice privo di bug.

Grazie per aver letto.

Post correlati:

Sei tecniche di debug per programmatori Python

Altri tutorial su Python:

The Ultimate Python Tutorial (continua ad aggiornare)