testlog

package standard library
go1.23.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 6, 2024 License: BSD-3-Clause Imports: 3 Imported by: 0

Documentation

Overview

Package testlog provides a back-channel communication path between tests and package os, so that cmd/go can see which environment variables and files a test consults.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Getenv

func Getenv(name string)

Getenv calls Logger().Getenv, if a logger has been set.

func Open

func Open(name string)

Open calls Logger().Open, if a logger has been set.

func PanicOnExit0 added in go1.16

func PanicOnExit0() bool

PanicOnExit0 reports whether to panic on a call to os.Exit(0). This is in the testlog package because, like other definitions in package testlog, it is a hook between the testing package and the os package. This is used to ensure that an early call to os.Exit(0) does not cause a test to pass.

func SetLogger

func SetLogger(impl Interface)

SetLogger sets the test logger implementation for the current process. It must be called only once, at process startup.

func SetPanicOnExit0 added in go1.16

func SetPanicOnExit0(v bool)

SetPanicOnExit0 sets panicOnExit0 to v.

SetPanicOnExit0 should be an internal detail, but alternate implementations of go test in other build systems may need to access it using linkname.

Do not remove or change the type signature. See go.dev/issue/67401.

func Stat

func Stat(name string)

Stat calls Logger().Stat, if a logger has been set.

Types

type Interface

type Interface interface {
	Getenv(key string)
	Stat(file string)
	Open(file string)
	Chdir(dir string)
}

Interface is the interface required of test loggers. The os package will invoke the interface's methods to indicate that it is inspecting the given environment variables or files. Multiple goroutines may call these methods simultaneously.

func Logger

func Logger() Interface

Logger returns the current test logger implementation. It returns nil if there is no logger.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL