gdt is a testing library that allows test authors to cleanly describe tests
in a YAML file. gdt reads YAML files that describe a test's assertions and
then builds a set of Golang structures that the standard Golang
testing package and standard go test
tool can execute.
This github.com/gdt-dev/examples (gdt-examples hereafter) repository is a
companion Go library for gdt that contains examples for how to use gdt and
its companion Go libraries like gdt-http and gdt-kube.
The http directory in this repository contains Go code for a simplistic HTTP
web service that lists and creates books (in http/api) along with functional
tests written in YAML using gdt's test file format (in http/tests/api).
gdt was inspired by Gabbi, the excellent
Python declarative testing framework. gdt tries to bring the same clear,
concise test definitions to the world of Go functional testing.
The Go gopher logo, from which gdt's logo was derived, was created by Renee French.
Contributions to gdt-examples are welcomed! Feel free to open a Github issue
or submit a pull request.