got

package module
v0.39.0 Latest Latest
Warning

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

 Go to latest Published: Jan 4, 2024 License: MIT Imports: 32 Imported by: 8

README

Overview

An enjoyable golang test framework.

Features

  • Pretty output using gop and diff
  • Fluent API design that takes the full advantage of IDE
  • Handy assertion helpers
  • Handy utils for testing
  • Value snapshot assertion
  • Customizable assertion error output

Guides

Read the example project to get started.

Got uses itself as the test framework, so the source code itself is the best doc.

Install the vscode extension for snippets like: gp, gt, and gsetup.

To ensure test coverage of your project, you can run the command below:

go test -race -coverprofile=coverage.out ./...
go run github.com/ysmood/got/cmd/check-cov@latest

By default the check-cov requires 100% coverage, run it with the -h flag to see the help doc.

API reference

Link

Documentation

Overview

Package got is an enjoyable golang test framework.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DefaultFlags added in v0.6.2 

func DefaultFlags(flags ...string)

DefaultFlags will set the "go test" flag if not yet presented. It must be executed in the init() function. Such as the timeout: 

DefaultFlags("timeout=10s")

func Each added in v0.0.3 

func Each(t Testable, iteratee interface{}) (count int)

Each runs each exported method Fn on type Ctx as a subtest of t. The iteratee can be a struct Ctx or: 

iteratee(t Testable) (ctx Ctx)

Each Fn will be called like: 

ctx.Fn()

If iteratee is Ctx, its G field will be set to New(t) for each test. Any Fn that has the same name with the embedded one will be ignored.

func EnsureCoverage added in v0.8.7 

func EnsureCoverage(path string, min float64) error

EnsureCoverage via report file generated from, for example: 

go test -coverprofile=coverage.out

Return error if any file's coverage is less than min, min is a percentage value.

func Parallel added in v0.8.1 

func Parallel() (n int)

Parallel config of "go test -parallel"

func Setup added in v0.17.4 

func Setup(init func(g G)) func(t Testable) G

Setup returns a helper to init G instance

Types

type AssertionCtx added in v0.21.0 

type AssertionCtx struct {
	Type    AssertionErrType
	Details []interface{}
	File    string
	Line    int
}

AssertionCtx holds the context of an assertion

type AssertionErrType added in v0.21.0 

type AssertionErrType int

AssertionErrType enum 

const (
	// AssertionEq type
	AssertionEq AssertionErrType = iota
	// AssertionNeqSame type
	AssertionNeqSame
	// AssertionNeq type
	AssertionNeq
	// AssertionGt type
	AssertionGt
	// AssertionGte type
	AssertionGte
	// AssertionLt type
	AssertionLt
	// AssertionLte type
	AssertionLte
	// AssertionInDelta type
	AssertionInDelta
	// AssertionTrue type
	AssertionTrue
	// AssertionFalse type
	AssertionFalse
	// AssertionNil type
	AssertionNil
	// AssertionNoArgs type
	AssertionNoArgs
	// AssertionNotNil type
	AssertionNotNil
	// AssertionNotNilable type
	AssertionNotNilable
	// AssertionNotNilableNil type
	AssertionNotNilableNil
	// AssertionZero type
	AssertionZero
	// AssertionNotZero type
	AssertionNotZero
	// AssertionRegex type
	AssertionRegex
	// AssertionHas type
	AssertionHas
	// AssertionLen type
	AssertionLen
	// AssertionErr type
	AssertionErr
	// AssertionPanic type
	AssertionPanic
	// AssertionIsInChain type
	AssertionIsInChain
	// AssertionIsKind type
	AssertionIsKind
	// AssertionCount type
	AssertionCount
	// AssertionSnapshot type
	AssertionSnapshot
)

type AssertionError added in v0.21.0 

type AssertionError interface {
	Report(*AssertionCtx) string
}

AssertionError handler

func NewDefaultAssertionError added in v0.21.0 

func NewDefaultAssertionError(theme gop.Theme, diffTheme diff.Theme) AssertionError

NewDefaultAssertionError handler

type AssertionErrorReport added in v0.21.0 

type AssertionErrorReport func(*AssertionCtx) string

AssertionErrorReport is used to convert a func to AssertionError

func (AssertionErrorReport) Report added in v0.21.0 

func (ae AssertionErrorReport) Report(ac *AssertionCtx) string

Report interface

type Assertions added in v0.4.1 

type Assertions struct {
	Testable

	ErrorHandler AssertionError
	// contains filtered or unexported fields
}

Assertions helpers

func (Assertions) Count added in v0.8.4 

func (as Assertions) Count(n int) func()

Count asserts that the returned function will be called n times

func (Assertions) Desc added in v0.12.0 

func (as Assertions) Desc(format string, args ...interface{}) Assertions

Desc returns a clone with the format description. The description will be printed before the error message.

func (Assertions) E added in v0.4.1 

func (as Assertions) E(args ...interface{})

E is a shortcut for Must().Nil(args...)

func (Assertions) Eq added in v0.4.1 

func (as Assertions) Eq(x, y interface{})

Eq asserts that x equals y when converted to the same type, such as compare float 1.0 and integer 1 . For strict value and type comparison use Assertions.Equal . For how comparison works, see utils.SmartCompare .

func (Assertions) Equal added in v0.4.1 

func (as Assertions) Equal(x, y interface{})

Equal asserts that x equals y. For loose type comparison use Assertions.Eq, such as compare float 1.0 and integer 1 .

func (Assertions) Err added in v0.4.1 

func (as Assertions) Err(args ...interface{})

Err asserts that the last item in args is error

func (Assertions) False added in v0.4.1 

func (as Assertions) False(x bool)

False asserts that x is false.

func (Assertions) Gt added in v0.4.1 

func (as Assertions) Gt(x, y interface{})

Gt asserts that x is greater than y. For how comparison works, see utils.SmartCompare .

func (Assertions) Gte added in v0.4.1 

func (as Assertions) Gte(x, y interface{})

Gte asserts that x is greater than or equal to y. For how comparison works, see utils.SmartCompare .

func (Assertions) Has added in v0.4.1 

func (as Assertions) Has(container, item interface{})

Has asserts that container has item. The container can be a string, []byte, slice, array, or map. For how comparison works, see utils.SmartCompare .

func (Assertions) InDelta added in v0.16.1 

func (as Assertions) InDelta(x, y interface{}, delta float64)

InDelta asserts that x and y are within the delta of each other. For how comparison works, see utils.SmartCompare .

func (Assertions) Is added in v0.4.1 

func (as Assertions) Is(x, y interface{})

Is asserts that x is kind of y, it uses reflect.Kind to compare. If x and y are both error type, it will use errors.Is to compare.

func (Assertions) Len added in v0.4.1 

func (as Assertions) Len(list interface{}, l int)

Len asserts that the length of list equals l

func (Assertions) Lt added in v0.4.1 

func (as Assertions) Lt(x, y interface{})

Lt asserts that x is less than y. For how comparison works, see utils.SmartCompare .

func (Assertions) Lte added in v0.4.1 

func (as Assertions) Lte(x, y interface{})

Lte asserts that x is less than or equal to b. For how comparison works, see utils.SmartCompare .

func (Assertions) Must added in v0.12.0 

func (as Assertions) Must() Assertions

Must returns a clone with the FailNow enabled. It will exit the current goroutine if the assertion fails.

func (Assertions) Neq added in v0.4.1 

func (as Assertions) Neq(x, y interface{})

Neq asserts that x not equals y even when converted to the same type. For how comparison works, see utils.SmartCompare .

func (Assertions) Nil added in v0.4.1 

func (as Assertions) Nil(args ...interface{})

Nil asserts that the last item in args is nilable and nil

func (Assertions) NotNil added in v0.4.1 

func (as Assertions) NotNil(args ...interface{})

NotNil asserts that the last item in args is nilable and not nil

func (Assertions) NotZero added in v0.15.0 

func (as Assertions) NotZero(x interface{})

NotZero asserts that x is not zero value for its type.

func (Assertions) Panic added in v0.4.1 

func (as Assertions) Panic(fn func()) (val interface{})

Panic executes fn and asserts that fn panics

func (Assertions) Regex added in v0.4.1 

func (as Assertions) Regex(pattern, str string)

Regex asserts that str matches the regex pattern

func (Assertions) True added in v0.4.1 

func (as Assertions) True(x bool)

True asserts that x is true.

func (Assertions) Zero added in v0.15.0 

func (as Assertions) Zero(x interface{})

Zero asserts x is zero value for its type.

type Context added in v0.3.3 

type Context struct {
	context.Context
	Cancel func()
}

Context helper

type G added in v0.2.0 

type G struct {
	Testable
	Assertions
	Utils
	// contains filtered or unexported fields
}

G is the helper context, it provides some handy helpers for testing

func New added in v0.0.3 

func New(t Testable) G

New G instance

func T added in v0.17.4 

func T(t Testable) G

T is the shortcut for New

func (G) Snapshot added in v0.36.2 

func (g G) Snapshot(name string, x interface{})

Snapshot asserts that x equals the snapshot with the specified name, name should be unique under the same test case. It will create a new snapshot file if the name is not found. The snapshot file will be saved to ".got/snapshots/{TEST_NAME}". To update the snapshot, just change the name of the snapshot or remove the corresponding snapshot file. It will auto-remove the unused snapshot files after the test. The snapshot files should be version controlled. The format of the snapshot file is json.

type Only added in v0.1.2 

type Only struct{}

Only run tests with it

type ReqMIME added in v0.11.0 

type ReqMIME string

ReqMIME option type, it should be like ".json", "test.json", "a/b/c.jpg", etc

type ResHelper added in v0.2.0 

type ResHelper struct {
	*http.Response
	// contains filtered or unexported fields
}

ResHelper of the request

func (*ResHelper) Bytes added in v0.2.0 

func (res *ResHelper) Bytes() *bytes.Buffer

Bytes parses body as *bytes.Buffer and returns the result

func (*ResHelper) Err added in v0.35.1 

func (res *ResHelper) Err() error

Err of request protocol

func (*ResHelper) JSON added in v0.2.0 

func (res *ResHelper) JSON() (v interface{})

JSON parses body as json and returns the result

func (*ResHelper) String added in v0.2.0 

func (res *ResHelper) String() string

String parses body as string and returns the result

func (*ResHelper) Unmarshal added in v0.38.2 

func (res *ResHelper) Unmarshal(v interface{})

Unmarshal body to v as json, it's like json.Unmarshal.

type Router added in v0.2.0 

type Router struct {
	HostURL *url.URL
	Server  *http.Server
	Mux     *http.ServeMux
	// contains filtered or unexported fields
}

Router of a http server

func (*Router) Route added in v0.2.0 

func (rt *Router) Route(pattern, file string, value ...interface{}) *Router

Route on the pattern. Check the doc of http.ServeMux for the syntax of pattern. It will use Utils.HandleHTTP to handle each request.

func (*Router) URL added in v0.2.0 

func (rt *Router) URL(path ...string) string

URL will prefix the path with the server's host

type Skip added in v0.1.2 

type Skip struct{}

Skip the current test

type Testable added in v0.0.3 

type Testable interface {
	Name() string                            // same as testing.common.Name
	Skipped() bool                           // same as testing.common.Skipped
	Failed() bool                            // same as testing.common.Failed
	Cleanup(func())                          // same as testing.common.Cleanup
	FailNow()                                // same as testing.common.FailNow
	Fail()                                   // same as testing.common.Fail
	Helper()                                 // same as testing.common.Helper
	Logf(format string, args ...interface{}) // same as testing.common.Logf
	SkipNow()                                // same as testing.common.Skip
}

Testable interface. Usually, you use *testing.T as it.

type Utils added in v0.4.2 

type Utils struct {
	Testable
}

Utils for commonly used methods

func (Utils) Chdir added in v0.33.3 

func (ut Utils) Chdir(dir string)

Chdir is like os.Chdir but will restore the dir after test.

func (Utils) Context added in v0.4.2 

func (ut Utils) Context() Context

Context that will be canceled after the test

func (Utils) DoAfter added in v0.8.2 

func (ut Utils) DoAfter(d time.Duration, do func()) (cancel func())

DoAfter d duration if the test is still running

func (Utils) Error added in v0.4.2 

func (ut Utils) Error(args ...interface{})

Error is the same as [testing.common.Error]

func (Utils) Errorf added in v0.4.2 

func (ut Utils) Errorf(format string, args ...interface{})

Errorf is the same as [testing.common.Errorf]

func (Utils) Fatal added in v0.4.2 

func (ut Utils) Fatal(args ...interface{})

Fatal is the same as [testing.common.Fatal]

func (Utils) Fatalf added in v0.4.2 

func (ut Utils) Fatalf(format string, args ...interface{})

Fatalf is the same as [testing.common.Fatalf]

func (Utils) Go added in v0.38.3 

func (ut Utils) Go(f func())

Go runs f in a goroutine and wait for it to finish before the test ends.

func (Utils) HandleHTTP added in v0.4.2 

func (ut Utils) HandleHTTP(file string, value ...interface{}) func(http.ResponseWriter, *http.Request)

HandleHTTP handles a request. If file exists serve the file content. The file will be used to set the Content-Type header. If the file doesn't exist, the value will be encoded by Utils.Write and used as the response body.

func (Utils) JSON added in v0.4.2 

func (ut Utils) JSON(src interface{}) (v interface{})

JSON from string, []byte, or io.Reader

func (Utils) Log added in v0.4.2 

func (ut Utils) Log(args ...interface{})

Log is the same as [testing.common.Log]

func (Utils) MkdirAll added in v0.32.0 

func (ut Utils) MkdirAll(perm fs.FileMode, path string)

MkdirAll is like os.MkdirAll but will remove the dir after test and fail the test if error. The default perm is 0755.

func (Utils) Open added in v0.4.2 

func (ut Utils) Open(create bool, path string) (f *os.File)

Open a file. Override it if create is true. Directories will be auto-created. If the directory and file doesn't exist, it will be removed after the test.

func (Utils) PanicAfter added in v0.7.0 

func (ut Utils) PanicAfter(d time.Duration) (cancel func())

PanicAfter d duration if the test is still running

func (Utils) Parallel added in v0.4.2 

func (ut Utils) Parallel() Utils

Parallel is the same as testing.T.Parallel

func (Utils) PathExists added in v0.32.0 

func (ut Utils) PathExists(path string) bool

PathExists checks if path exists

func (Utils) RandBytes added in v0.34.1 

func (ut Utils) RandBytes(l int) []byte

RandBytes generates a random byte array with the specified length

func (Utils) RandInt added in v0.19.0 

func (ut Utils) RandInt(min, max int) int

RandInt generates a random integer within [min, max)

func (Utils) RandStr added in v0.19.0 

func (ut Utils) RandStr(l int) string

RandStr generates a random string with the specified length

func (Utils) Read added in v0.4.2 

func (ut Utils) Read(value interface{}) *bytes.Buffer

Read all from value. If the value is string and it's a file path, the file content will be read, or the string will be returned. If the value is io.Reader, the reader will be read. If the value is []byte, the value will be returned. Others will be converted to string and returned.

func (Utils) Render added in v0.32.0 

func (ut Utils) Render(value interface{}, data interface{}) *bytes.Buffer

Render template. It will use Utils.Read to read the value as the template string.

func (Utils) Req added in v0.4.2 

func (ut Utils) Req(method, url string, options ...interface{}) *ResHelper

Req is a helper method to send http request. It will handle errors automatically, so you don't need to check errors. The method is the http method, default value is "GET". If an option is http.Header, it will be used as the request header. If an option is ReqMIME, it will be used to set the Content-Type header. If an option is context.Context, it will be used as the request context. Other option type will be treat as request body, it will be encoded by Utils.Write. Some request examples: 

Req("GET", "http://example.com")
Req("GET", "http://example.com", context.TODO())
Req("POST", "http://example.com", map[string]any{"a": 1})
Req("POST", "http://example.com", http.Header{"Host": "example.com"}, ReqMIME(".json"), map[string]any{"a": 1})

func (Utils) Run added in v0.12.0 

func (ut Utils) Run(name string, f func(t G)) bool

Run f as a sub-test

func (Utils) Serve added in v0.4.2 

func (ut Utils) Serve() *Router

Serve http on a random port. The server will be auto-closed after the test.

func (Utils) ServeWith added in v0.31.7 

func (ut Utils) ServeWith(network, address string) *Router

ServeWith specified network and address

func (Utils) Setenv added in v0.34.0 

func (ut Utils) Setenv(key, value string)

Setenv is like os.Setenv but will restore the env after test.

func (Utils) Skip added in v0.4.2 

func (ut Utils) Skip(args ...interface{})

Skip is the same as [testing.common.Skip]

func (Utils) Skipf added in v0.4.2 

func (ut Utils) Skipf(format string, args ...interface{})

Skipf is the same as [testing.common.Skipf]

func (Utils) Timeout added in v0.4.2 

func (ut Utils) Timeout(d time.Duration) Context

Timeout context that will be canceled after the test

func (Utils) ToJSON added in v0.10.0 

func (ut Utils) ToJSON(obj interface{}) *bytes.Buffer

ToJSON convert obj to JSON bytes

func (Utils) ToJSONString added in v0.10.0 

func (ut Utils) ToJSONString(obj interface{}) string

ToJSONString convert obj to JSON string

func (Utils) Write added in v0.4.2 

func (ut Utils) Write(obj interface{}) (writer func(io.Writer))

Write obj to the writer. Encode obj to []byte and cache it for writer. If obj is not []byte, string, or io.Reader, it will be encoded as JSON.

func (Utils) WriteFile added in v0.31.2 

func (ut Utils) WriteFile(path string, content interface{})

WriteFile at path with content, it uses Utils.Open to open the file.

Source Files

View all Source files

Directories

Path Synopsis
cmd
check-cov
Package main ...
 Package main ...
fixtures
coverage
Package coverage ...
 Package coverage ...
lib
diff
Package diff ...
 Package diff ...
got-vscode-extension/snippets
Package main ...
 Package main ...
lcs
Package lcs ...
 Package lcs ...
mock
Package mock provides a simple way to stub struct methods.
 Package mock provides a simple way to stub struct methods.
utils
Package utils ...
 Package utils ...
benchmark Module
example Module

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.