Go test

As explained in Go by Example

go test is the Go command that builds and runs tests for Go packages.

go test builds and runs Go package tests, reports their results, and removes the compiled test binary afterward. It also supports benchmarks and profiling. section 1.7 section 2.3.2

Use go test to:

• Run package tests such as `go test ./url`. section 2.3.2
• Rerun tests with `-count=1` when cached results should be skipped. section 2.3.2
• Display individual test names and logs with `-v`. section 2.3.2
• Shuffle test order with `-shuffle=on`, then reproduce an order with its seed. section 2.3.2

Run a package test

From the Go module directory, run `go test ./url`. A passing run reports `PASS` and the package path; a repeated run may report `(cached)`. Add `-v` to inspect individual tests such as `TestParse` and `TestURLString`.

Figure 2.2 The go test tool and the testing package collaborate on running tests. Tests get a *T, which has methods for tests to call, log, report failures, and so on.

Shows how go test collaborates with the testing package: test functions receive *testing.T for logging and failure reporting. section 2.3

How Go by Example covers it

How deep it goes

Explains compilation, result caching, verbose output, and shuffle seeds, but defers detailed benchmark and profiling procedures.

Examples

Uses the url package with TestParse and TestURLString, plus cached, verbose, shuffled, and seed-reproduced command output.

What it assumes

Assumes Go package and module familiarity while teaching test-file naming, Test functions, and *testing.T conventions.

What you can do after

Operate go test to run, inspect, rerun, shuffle, and reproduce Go package tests from the module directory.

How it connects

Connects testing package, test files, subtests, table-driven tests, benchmarks, profiling, and Go modules.

liveBookmanning.com

Read Go by Example on liveBook Get the book at manning.com

Also explained in

• 

  liveBookmanning.com
  Go in Action, Second Editiongo test -cover is the Go test command mode that runs package tests and reports the percentage of statements they execute.
• 

  liveBookmanning.com
  Learn Go with Pocket-Sized ProjectsThe Go test framework is the standard framework that discovers, executes, and reports Go package tests.
• 

  liveBookmanning.com
  Go in Practice, Second Editiongo test is a Go command that compiles and runs tests for Go packages.

Compare how 4 books explain go test →

Related concepts

• benchmarkused by · A benchmark is a defined task, dataset, workload, procedure, or reference measure used to assess or compare performance or capability under specified criteria or conditions.
• race conditionmeasures · A race condition is a concurrency defect in which program behavior or results depend on the relative timing or ordering of interacting operations.
• testing packageuses · The testing package is Go’s standard-library package for defining, running, and reporting automated tests and benchmarks.
• code coveragemeasures · Code coverage measures the extent to which a test suite exercises a program’s code elements, execution paths, or behaviors.
• regular expressionuses · A formal pattern notation that describes sets of strings and enables text to be matched, searched, extracted, or transformed.
• testuses · A test is a procedure or check that evaluates behavior using specified inputs or evidence against expected results or criteria.

This explainer was generated by Manning's knowledge graph from the text of Go by Example. The section links point to the parts of the book it draws on.