Skip to content

Latest commit

 

History

History
30 lines (20 loc) · 930 Bytes

README.md

File metadata and controls

30 lines (20 loc) · 930 Bytes

pgtest

Go library to spawn single-use PostgreSQL servers for unit testing

Build Status GoDoc

Spawns a PostgreSQL server with a single database configured. Ideal for unit tests where you want a clean instance each time. Then clean up afterwards.

Features:

  • Starts a clean isolated PostgreSQL database
  • Tested on Fedora, Ubuntu and Alpine
  • Optimized for in-memory execution, to speed up unit tests
  • Less than 1 second startup / initialization time
  • Automatically drops permissions when testing as root

Usage

In your unit test:

pg, err := pgtest.Start()
defer pg.Stop()

// Do something with pg.DB (which is a *sql.DB)

License

This library is distributed under the MIT license.