mock

Documentation

Index

• Variables
• type Method
  • func MethodFor(ctx context.Context, receiver Mock, name string, typ *ast.FuncType) Method
  • func (m Method) Ast(ctx context.Context) *ast.FuncDecl
  • func (m Method) Fields(ctx context.Context) []*ast.Field
  • func (m Method) PrependLocalPackage(ctx context.Context, name string) error
• type Mock
  • func For(ctx context.Context, name string, params []*ast.Field, typ *ast.InterfaceType) (Mock, error)
  • func (m Mock) Ast(ctx context.Context, chanSize int) []ast.Decl
  • func (m Mock) Constructor(ctx context.Context, chanSize int) *ast.FuncDecl
  • func (m Mock) Decl(ctx context.Context) *ast.GenDecl
  • func (m Mock) Methods(ctx context.Context) (methods []Method)
  • func (m Mock) Name(ctx context.Context) string
  • func (m Mock) PrependLocalPackage(ctx context.Context, name string) error
• type Mocks
  • func Generate(ctx context.Context, finder TypeFinder, opts ...Opt) (*Mocks, error)
  • func (m *Mocks) Index(ctx context.Context, i int) Mock
  • func (m *Mocks) Len(ctx context.Context) int
  • func (m *Mocks) Output(ctx context.Context, pkg, dir string, chanSize int, dest io.Writer) error
  • func (m *Mocks) PrependLocalPackage(ctx context.Context, name string)
• type Opt
  • func ForConcreteDependencies() Opt
  • func ForLocalInterfaces() Opt
• type TypeFinder

Variables

var ErrUnexported = errors.New("must be exported")

Types

type Method

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

Method represents a method that is being mocked.

func MethodFor

func MethodFor(ctx context.Context, receiver Mock, name string, typ *ast.FuncType) Method

MethodFor returns a Method representing typ, using receiver as the Method's receiver type and name as the method name.

func (Method) Ast

func (m Method) Ast(ctx context.Context) *ast.FuncDecl

Ast returns the ast representation of m.

func (Method) Fields

func (m Method) Fields(ctx context.Context) []*ast.Field

Fields returns the fields that need to be a part of the receiver struct for this method.

func (Method) PrependLocalPackage

func (m Method) PrependLocalPackage(ctx context.Context, name string) error

PrependLocalPackage prepends name as the package name for local types in m's signature. This is most often used when mocking types that are imported by the local package.

type Mock

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

Mock is a mock of an interface type.

func For

func For(ctx context.Context, name string, params []*ast.Field, typ *ast.InterfaceType) (Mock, error)

For returns a Mock representing typ. An error will be returned if a mock cannot be created from typ.

func (Mock) Ast

func (m Mock) Ast(ctx context.Context, chanSize int) []ast.Decl

Ast returns all declaration AST for m.

func (Mock) Constructor

func (m Mock) Constructor(ctx context.Context, chanSize int) *ast.FuncDecl

Constructor returns a function AST to construct m. chanSize will be the buffer size for all channels initialized in the constructor.

func (Mock) Decl

func (m Mock) Decl(ctx context.Context) *ast.GenDecl

Decl returns the declaration AST for m.

func (Mock) Methods

func (m Mock) Methods(ctx context.Context) (methods []Method)

Methods returns the methods that need to be created with m as a receiver.

func (Mock) Name

func (m Mock) Name(ctx context.Context) string

Name returns the type name for m.

func (Mock) PrependLocalPackage

func (m Mock) PrependLocalPackage(ctx context.Context, name string) error

PrependLocalPackage prepends name as the package name for local types in m's signature. This is most often used when mocking types that are imported by the local package.

type Mocks

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

Mocks is a set of mocks generated from a go package.

func Generate

func Generate(ctx context.Context, finder TypeFinder, opts ...Opt) (*Mocks, error)

Generate generates a Mocks value for all interface types that are required, according to finder.

func (*Mocks) Index

func (m *Mocks) Index(ctx context.Context, i int) Mock

func (*Mocks) Len

func (m *Mocks) Len(ctx context.Context) int

func (*Mocks) Output

func (m *Mocks) Output(ctx context.Context, pkg, dir string, chanSize int, dest io.Writer) error

Output writes the go code representing m to dest. pkg will be the package name; dir is the destination directory (needed for formatting the file); chanSize is the buffer size of any channels created in constructors.

func (*Mocks) PrependLocalPackage

func (m *Mocks) PrependLocalPackage(ctx context.Context, name string)

PrependLocalPackage prepends name as the package name for local types in m's signature. This is most often used when mocking types that are imported by the local package.

type Opt

type Opt func(genPrefs) genPrefs

Opt is an option function that can apply preferences for generating mocks.

func ForConcreteDependencies

func ForConcreteDependencies() Opt

ForConcreteDependencies tells Generate to generate mocks for any interface types that are depended on by functions, methods, or struct fields in exported code.

If none of the For* options are included, the default will be to generate mocks for all strategies.

func ForLocalInterfaces

func ForLocalInterfaces() Opt

ForLocalInterfaces tells Generate to generate mocks for local interface types.

If none of the For* options are included, the default will be to generate mocks for all strategies.

type TypeFinder

type TypeFinder interface {
	Decls(context.Context) []ast.Decl
	Dependencies(ctx context.Context, name string) []typ.Dependency
}

TypeFinder represents a type which knows about types and dependencies.