go/src/testing
Matt T. Proud 0941dbca6a testing: clarify in docs that TestMain is advanced
Beginner and intermediate Go users periodically use TestMain when
requirements do not necessitate TestMain (exceeding least-mechanism
design). This commit expands package testing's documentation to convey
that the TestMain feature itself is somewhat low-level and potentially
unsuitable for casual testing where ordinary test functions would
suffice.

Fixes #42161
Updates #44200

Change-Id: I91ba0b048c3d6f79110fe8f0fbb58d896edca366
Reviewed-on: https://go-review.googlesource.com/c/go/+/334649
Trust: Ian Lance Taylor <iant@golang.org>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Rob Pike <r@golang.org>
2021-07-15 20:39:22 +00:00
..
fstest io/fs: document that caller can modify slice returned by ReadFile 2021-04-21 16:46:52 +00:00
internal/testdeps
iotest
quick
allocs.go
allocs_test.go
benchmark.go testing: remove data races so that parallel benchmarks can safely call .Fatal* and .Skip* 2021-04-19 22:06:05 +00:00
benchmark_test.go testing: remove data races so that parallel benchmarks can safely call .Fatal* and .Skip* 2021-04-19 22:06:05 +00:00
cover.go
example.go
export_test.go
helper_test.go
helperfuncs_test.go
match.go
match_test.go
panic_test.go
run_example.go
run_example_js.go
sub_test.go
testing.go testing: clarify in docs that TestMain is advanced 2021-07-15 20:39:22 +00:00
testing_test.go testing: drop unusual characters from TempDir directory name 2021-06-17 04:32:50 +00:00