tesls

README

tesls

Lists tests in the given Go package without running them.

Installation

go get github.com/jszwec/tesls/cmd/tesls
go install github.com/jszwec/tesls/cmd/tesls

Usage

tesls .
> tesls     TestTests     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls ./...
> main      TestDirs      /Users/jszwec/src/github.com/jszwec/tesls/cmd/tesls/tesls_test.go
> tesls     TestTests     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls github.com/jszwec/tesls
> tesls     TestTests     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls github.com/jszwec/tesls/...
> main      TestDirs      /Users/jszwec/src/github.com/jszwec/tesls/cmd/tesls/tesls_test.go
> tesls     TestTests     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls github.com/jszwec/tesls github.com/jszwec/tesls/cmd/tesls
> main      TestDirs      /Users/jszwec/src/github.com/jszwec/tesls/cmd/tesls/tesls_test.go
> tesls     TestTests     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls -f='json' github.com/jszwec/tesls
> [{"name":"TestTests","file":"/Users/jszwec/src/github.com/jszwec/tesls/tests_test.go","pkg":"tesls"}]

tesls -f='Pkg: {{.Pkg}} | TestName: {{.Name}} | File: {{.File}}' github.com/jszwec/tesls
> Pkg:     main      |     TestName:     TestDirs      |     File:     /Users/jszwec/src/github.com/jszwec/tesls/cmd/tesls/tesls_test.go
> Pkg:     tesls     |     TestName:     TestTests     |     File:     /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

tesls -tabs=false ./...
> main TestDirs /Users/jszwec/src/github.com/jszwec/tesls/cmd/tesls/tesls_test.go
> tesls TestTests /Users/jszwec/src/github.com/jszwec/tesls/tests_test.go

Documentation

Index

• type Test
  • func (t *Test) String() string
• type TestSlice
  • func Tests(dir string) (tests TestSlice, err error)
  • func (s TestSlice) Len() int
  • func (s TestSlice) Less(i, j int) bool
  • func (s TestSlice) Sort()
  • func (s TestSlice) Swap(i, j int)

Types

type Test

type Test struct {
	Name string `json:"name"`
	File string `json:"file"`
	Pkg  string `json:"pkg"`
}

Test describes a single test found in the *_test.go file

func (*Test) String

func (t *Test) String() string

String returns a string representation of the Test in the form of 'package.Test filename'

type TestSlice

type TestSlice []Test

TestSlice attaches the methods of sort.Interface to []Test. Sorting in increasing order comparing package+testname.

func Tests

func Tests(dir string) (tests TestSlice, err error)

Tests function searches for test function declarations in the given directory.

func (TestSlice) Len

func (s TestSlice) Len() int

func (TestSlice) Less

func (s TestSlice) Less(i, j int) bool

func (TestSlice) Sort

func (s TestSlice) Sort()

Sort is a convenience method.

func (TestSlice) Swap

func (s TestSlice) Swap(i, j int)