https://github.com/moul/testman
😎 `go test` wrapper for advanced testing workflows in Go
https://github.com/moul/testman
golang test testing
Last synced: 12 months ago
JSON representation
😎 `go test` wrapper for advanced testing workflows in Go
- Host: GitHub
- URL: https://github.com/moul/testman
- Owner: moul
- License: other
- Created: 2020-09-04T22:21:12.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-04-05T19:53:33.000Z (about 1 year ago)
- Last Synced: 2025-04-05T20:29:54.563Z (about 1 year ago)
- Topics: golang, test, testing
- Language: Go
- Homepage: https://manfred.life/golang
- Size: 133 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: .github/SUPPORT.md
- Authors: AUTHORS
Awesome Lists containing this project
README
# testman
😎 `go test` wrapper for advanced testing workflows in Go
[](https://pkg.go.dev/moul.io/testman)
[](https://github.com/moul/testman/blob/master/COPYRIGHT)
[](https://github.com/moul/testman/releases)
[](https://microbadger.com/images/moul/testman)
[](https://manfred.life/)
[](https://github.com/moul/testman/actions?query=workflow%3AGo)
[](https://github.com/moul/testman/actions?query=workflow%3ARelease)
[](https://github.com/moul/testman/actions?query=workflow%3APR)
[](https://golangci.com/r/github.com/moul/testman)
[](https://codecov.io/gh/moul/testman)
[](https://goreportcard.com/report/moul.io/testman)
[](https://www.codefactor.io/repository/github/moul/testman)
## Usage
*testman -h*
[embedmd]:# (.tmp/root-usage.txt)
```txt
USAGE
testman [flags]
SUBCOMMANDS
test advanced go test workflows
list list available tests
```
*testman test -h*
[embedmd]:# (.tmp/test-usage.txt)
```txt
USAGE
testman test [flags] [packages]
EXAMPLES
testman test ./...
testman test -v ./...
testman test -run ^TestUnstable -timeout=300s -retry=50 ./...
testman test -run ^TestBroken -test.timeout=30s -retry=10 --continue-on-error ./...
testman test -test.timeout=10s -test.v -test.count=2 -test.race
FLAGS
-continue-on-error false continue on error (but still fails at the end)
-retry 0 fail after N retries
-run ^(Test|Example) regex to filter out tests and examples
-test.count 1 `go test -count=VAL`
-test.race false `go test -race`
-test.timeout 0s `go test -timeout=VAL`
-test.v false `go test -v`
-timeout 0s program max duration
-v false verbose
```
*testman list -h*
[embedmd]:# (.tmp/list-usage.txt)
```txt
USAGE
testman list [packages]
EXAMPLES
testman list ./...
testman list -v ./...
testman list -run ^TestStable ./...
FLAGS
-run ^(Test|Example) regex to filter out tests and examples
-v false verbose
```
## Install
### Using go
```console
$ go get -u moul.io/testman
```
### Releases
See https://github.com/moul/testman/releases
## Contribute
I really welcome contributions. Your input is the most precious material. I'm well aware of that and I thank you in advance. Everyone is encouraged to look at what they can do on their own scale; no effort is too small.
Everything on contribution is sum up here: [CONTRIBUTING.md](./CONTRIBUTING.md)
### Contributors ✨
[](#contributors)
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Manfred Touron
🚧 📖 ⚠️ 💻
moul-bot
🚧
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
### Stargazers over time
[](https://starchart.cc/moul/testman)
## License
© 2020-2021 [Manfred Touron](https://manfred.life)
Licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0) ([`LICENSE-APACHE`](LICENSE-APACHE)) or the [MIT license](https://opensource.org/licenses/MIT) ([`LICENSE-MIT`](LICENSE-MIT)), at your option. See the [`COPYRIGHT`](COPYRIGHT) file for more details.
`SPDX-License-Identifier: (Apache-2.0 OR MIT)`