https://github.com/ozontech/testo
Modular testing framework for Go. Featuring plugins, suites, parallel tests and much more!
https://github.com/ozontech/testo
framework go plugins testing testo
Last synced: 4 days ago
JSON representation
Modular testing framework for Go. Featuring plugins, suites, parallel tests and much more!
- Host: GitHub
- URL: https://github.com/ozontech/testo
- Owner: ozontech
- License: apache-2.0
- Created: 2026-05-07T12:46:59.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-26T18:59:38.000Z (8 days ago)
- Last Synced: 2026-05-26T20:23:34.995Z (8 days ago)
- Topics: framework, go, plugins, testing, testo
- Language: Go
- Homepage:
- Size: 162 KB
- Stars: 113
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go-with-stars - Testo - based testing framework with suites, parallel tests, hooks and parametrization. Inspired by Pytest. | 2026-05-18 | (Template Engines / Testing Frameworks)
- fucking-awesome-go - Testo - Plugin-based testing framework with suites, parallel tests, hooks and parametrization. Inspired by Pytest. (Testing / Testing Frameworks)
README
[](https://github.com/ozontech/testo)
# Testo
[](https://pkg.go.dev/github.com/ozontech/testo)
[](https://goreportcard.com/report/github.com/ozontech/testo)
[](https://ozontech.github.io/testo/coverage.html)
[](https://github.com/ozontech/testo/actions/workflows/qa.yml)
Testo is a modular testing framework for Go built on top of `testing.T`
with an extensive plugin system.
> Testo (/tɛstɒ/) is a play on words "test" and "тесто", meaning "dough".
> Just like you can cook anything from dough, you can test anything with Testo!
Add some flavor to your tests with
[toppings - a collection of small, miscellaneous plugins for Testo framework.](https://github.com/ozontech/testo-toppings)
## Features
- [Plugins](./examples/04_plugins/main_test.go) - adapt your tests to any scenario with features you need.
- [Parametrized tests](./examples/03_parametrized/main_test.go) - describe a test once, repeat it with different parameters.
- [Parallel tests](./examples/05_parallel/main_test.go) - make your tests faster by running them all at once.
- [Lifecycle hooks](./examples/02_hooks/main_test.go) - before and after any suite, test & sub-test.
- [Test annotations](./examples/07_annotations/main_test.go) - attach static options to any test.
- [Informative errors and traces](./examples/06_errors/main_test.go) - no need to guess what went wrong.
- Sub-tests & sub-suites - support for nested tests and nested suites.
- Test reflection - deeply inspect test's meta-information.
- Caching - key-value storage persistent between test runs.
- [Zero dependencies](./go.mod).
## Why Testo
At Ozon, Testo powers thousands of end-to-end tests daily in production.
With plugins, it is flexible enough to adapt to diverse requirements,
without leaving the Go ecosystem - just a layer over `testing.T`.
If your needs are outgrowing standard `testing` package, Testo is a great choice.
## Quick Start
```bash
go get github.com/ozontech/testo
```
Your first test with Testo:
```go
package main
import (
"testing"
"github.com/ozontech/testo"
)
func Test(t *testing.T) {
testo.RunTest(t, func(t *testo.T) {
t.Log("Hello, Testo!")
})
}
```
And run it with `go test` as usual:
```bash
go test .
```
But there is more!
Testo supports suites, parametrized tests & plugins, see [Next steps](#next-steps).
See also [VS Code extension for Testo](#vs-code-extension).
### Next steps
- Take [a guided tour of Testo](./docs/tutorial.md) by making simple plugins and running the tests using various features.
- See [test examples](./examples).
- Learn [how to use various Testo features](./docs/how-to.md).
- Read a [brief description and technical overview](./docs/technical-overview.md) of Testo.
- View [API documentation](https://pkg.go.dev/github.com/ozontech/testo).
## Plugins
Testo features a powerful plugin system.
Plugins can:
- Provide `BeforeAll`/`AfterAll`, `BeforeEach`/`AfterEach` & `BeforeSubEach`/`AfterSubEach` hooks.
- Plan tests for execution - filter, duplicate & reorder.
- Override built-in `T` methods, such as `Log`, `Error` and _etc._
- Extend `T` by adding new methods.
- Allow users to configure their behavior through options.
- Communicate with other plugins.
- Add command line flags for `go test` command.
Examples:
- [Testo Allure Plugin](https://github.com/ozontech/testo-allure) - enhance your tests with automatically generated [Allure Reports](https://allurereport.org/).
- [Testo Rerun Plugin](https://github.com/ozontech/testo-toppings/tree/main/rerun) - adds `--last-failed`-like behaviour from Pytest to Testo. Makes it possible to rerun only failed tests.
- [Testo XFail Plugin](https://github.com/ozontech/testo-toppings/tree/main/xfail) - adds `t.XFail()` method to mark a test as "expected to fail".
- [Testo Parallel Plugin](https://github.com/ozontech/testo-toppings/tree/main/parallel) - marks all tests as parallel by default.
## VS Code Extension
Testo has its own [VS Code extension](./vscode-extension).
Makes it easier to run and debug individual suite tests and adds helpful snippets.
## Minimum supported Go version
Testo guarantees to support at least **3 latest major** [Go releases](https://go.dev/doc/devel/release).
Currently, minimum supported Go version is **1.24**
## Contributing
Contributions are welcome!
See [contributing guidelines](./CONTRIBUTING.md).
## License
This project is released under the [Apache-2.0 license](./LICENSE).
---
> [!TIP]
> If you find Testo useful, [consider giving this repository a star](https://github.com/ozontech/testo) to help it reach more people.
> Thank you!