summaryrefslogtreecommitdiffstats
path: root/test/README.md
blob: 1d37f2d5ca9a82dfaecc63ce004773f653c85996 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
The test directory contains tests of the Go tool chain and runtime.
It includes black box tests, regression tests, and error output tests.
They are run as part of all.bash.

To run just these tests, execute:

	../bin/go test cmd/internal/testdir

To run just tests from specified files in this directory, execute:

	../bin/go test cmd/internal/testdir -run='Test/(file1.go|file2.go|...)'

Standard library tests should be written as regular Go tests in the appropriate package.

The tool chain and runtime also have regular Go tests in their packages.
The main reasons to add a new test to this directory are:

* it is most naturally expressed using the test runner; or
* it is also applicable to `gccgo` and other Go tool chains.