golang/go

testing: document rules for using TB

Open

#41.269 aperta il 8 set 2020

Vedi su GitHub
 (3 commenti) (0 reazioni) (0 assegnatari)Go (19.008 fork)batch import
DocumentationNeedsInvestigationhelp wanted

Metriche repository

Star
 (133.883 star)
Metriche merge PR
 (Nessuna PR mergiata in 30 g)

Descrizione

There's rules about what a TestFoo may do with the *testing.T it is given. Some are documented (e.g. https://golang.org/pkg/testing/#T puts restrictions on invoking Fatalf and friends), but some are not (e.g. Logf and probably most other methods should not be called after TestFoo returns). Same applies to *testing.B and any future such values/types.

I came across this while trying to diagnose a problem that seems to be due to #40908, but realised I couldn't find the rules written down anywhere.

Guida contributor

Direzione di ricerca
Rivedere la documentazione del pacchetto di test Go all'indirizzo https://golang.org/pkg/testing/ e l'issue collegato #40908 per comprendere le restrizioni attuali. Esaminare il codice sorgente di testing.T e testing.B per identificare le regole non documentate sulle chiamate ai metodi dopo il return. Compilare un insieme chiaro di regole da aggiungere alla documentazione ufficiale.
Tech stack
go
Dominio
documentation
Tipo issue
Documentazione
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Go
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
75