got

package module
v0.29.3 Latest Latest
Warning

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

 Go to latest Published: May 24, 2022 License: MIT Imports: 31 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
  • Customizable assertion error output
  • No dependency, and 100% test coverage

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

Index

Constants

This section is empty.

Variables

View Source 
var Any = struct{}{}

Any intput

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
)

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 description for failure enabled

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 .

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.

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.

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

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.

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.

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.

func (Assertions) Must added in v0.12.0 

func (as Assertions) Must() Assertions

Must returns a clone with the FailNow enabled

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.

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
}

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

type Mock added in v0.26.0 

type Mock struct {
	// contains filtered or unexported fields
}

Mock helper for interface stubbing

func (*Mock) Fallback added in v0.26.0 

func (m *Mock) Fallback(fb interface{})

Fallback the methods that are not stubbed to fb.

func (*Mock) On added in v0.26.0 

func (m *Mock) On(target interface{}, method string) *StubOn

On helper

func (*Mock) Proxy added in v0.26.0 

func (m *Mock) Proxy(method string) interface{}

Proxy a interface

func (*Mock) Stop added in v0.26.0 

func (m *Mock) Stop(method string)

Stop the stub

func (*Mock) Stub added in v0.26.0 

func (m *Mock) Stub(method string, fn interface{})

Stub the target's method with fn

func (*Mock) StubFn added in v0.26.0 

func (m *Mock) StubFn(target interface{}, method string, fn func(args []reflect.Value) []reflect.Value)

StubFn helper

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 body

func (*ResHelper) JSON added in v0.2.0 

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

JSON body

func (*ResHelper) String added in v0.2.0 

func (res *ResHelper) String() string

String body

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 G.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 StubOn added in v0.26.0 

type StubOn struct {
	// contains filtered or unexported fields
}

StubOn utils

func (*StubOn) When added in v0.26.0 

func (s *StubOn) When(in ...interface{}) *StubWhen

When input args matches

type StubReturn added in v0.26.0 

type StubReturn struct {
	// contains filtered or unexported fields
}

StubReturn utils

func (*StubReturn) Once added in v0.26.0 

func (s *StubReturn) Once() *StubOn

Once specifies stubs only once before stop

func (*StubReturn) Times added in v0.26.0 

func (s *StubReturn) Times(n int) *StubOn

Times specifies how how many stubs before stop, if n <= 0 it will never stop.

type StubTimes added in v0.26.0 

type StubTimes struct {
	// contains filtered or unexported fields
}

StubTimes utils

type StubWhen added in v0.26.0 

type StubWhen struct {
	// contains filtered or unexported fields
}

StubWhen utils

func (*StubWhen) Return added in v0.26.0 

func (s *StubWhen) Return(out ...interface{}) *StubReturn

Return values for each stub

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) 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) 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 G.Write(value) 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) 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. path will be joined with filepath.Join so that it's cross-platform

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) 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(r io.Reader) *bytes.Buffer

Read all from r

func (Utils) Req added in v0.4.2 

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

Req the url. 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 Utils.ReqMIME, it will be used to set the Content-Type header. Other option type will be treat as request body, it will be encoded by Utils.Write .

func (Utils) Run added in v0.12.0 

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

Run f as a subtest

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) 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.

Source Files

View all Source files

Directories

Path Synopsis
cmd
check-cov
fixtures
coverage
lib
diff
gop
gop/example
got-vscode-extension/snippets
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.