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.