testutil

Documentation

Index

• Constants
• func Context(t *testing.T, dur time.Duration) context.Context
• func CreateTemp(t *testing.T, dir, pattern string) *os.File
• func Eventually(ctx context.Context, t testing.TB, ...) (done bool)
• func GenerateTLSCertificate(t testing.TB, commonName string) tls.Certificate
• func InCI() bool
• func SkipIfNotTiming(t *testing.T)
• func TempFile(t *testing.T, dir, pattern string) string
• type OAuth2Config
  • func (*OAuth2Config) AuthCodeURL(state string, _ ...oauth2.AuthCodeOption) string
  • func (c *OAuth2Config) Exchange(_ context.Context, _ string, _ ...oauth2.AuthCodeOption) (*oauth2.Token, error)
  • func (c *OAuth2Config) TokenSource(_ context.Context, _ *oauth2.Token) oauth2.TokenSource
• type OAuth2TokenSource
  • func (o OAuth2TokenSource) Token() (*oauth2.Token, error)

Constants

const (
	WaitShort     = 5 * time.Second
	WaitMedium    = 10 * time.Second
	WaitLong      = 15 * time.Second
	WaitSuperLong = 60 * time.Second
)

Constants for timing out operations, usable for creating contexts that timeout or in require.Eventually.

const (
	IntervalFast   = 25 * time.Millisecond
	IntervalMedium = 250 * time.Millisecond
	IntervalSlow   = time.Second
)

Constants for delaying repeated operations, e.g. in require.Eventually.

Functions

func Context

func Context(t *testing.T, dur time.Duration) context.Context

func CreateTemp

func CreateTemp(t *testing.T, dir, pattern string) *os.File

CreateTemp is a convenience function for creating a temporary file, like os.CreateTemp, but it also registers a cleanup function to close and remove the file.

func Eventually

func Eventually(ctx context.Context, t testing.TB, condition func(ctx context.Context) (done bool), tick time.Duration, msgAndArgs ...interface{}) (done bool)

Eventually is like require.Eventually except it allows passing a context into the condition. It is safe to use with `require.*`.

If ctx times out, the test will fail, but not immediately. It is the caller's responsibility to exit early if required.

It is the caller's responsibility to ensure that ctx has a deadline or timeout set. Eventually will panic if this is not the case in order to avoid potentially waiting forever.

condition is not run in a goroutine; use the provided context argument for cancellation if required.

func GenerateTLSCertificate

func GenerateTLSCertificate(t testing.TB, commonName string) tls.Certificate

func InCI

func InCI() bool

func SkipIfNotTiming

func SkipIfNotTiming(t *testing.T)

func TempFile

func TempFile(t *testing.T, dir, pattern string) string

TempFile returns the name of a temporary file that does not exist.

Types

type OAuth2Config

type OAuth2Config struct {
	Token           *oauth2.Token
	TokenSourceFunc OAuth2TokenSource
}

func (*OAuth2Config) AuthCodeURL

func (*OAuth2Config) AuthCodeURL(state string, _ ...oauth2.AuthCodeOption) string

func (*OAuth2Config) Exchange

func (c *OAuth2Config) Exchange(_ context.Context, _ string, _ ...oauth2.AuthCodeOption) (*oauth2.Token, error)

func (*OAuth2Config) TokenSource

func (c *OAuth2Config) TokenSource(_ context.Context, _ *oauth2.Token) oauth2.TokenSource

type OAuth2TokenSource

type OAuth2TokenSource func() (*oauth2.Token, error)

func (OAuth2TokenSource) Token

func (o OAuth2TokenSource) Token() (*oauth2.Token, error)