[github/fretlink/squeal-hspec.git] / README.md

# squeal-hspec

Helpers for creating database tests with hspec and squeal, inspired by Jonathan
Fischoff's
[hspec-pg-transact](http://hackage.haskell.org/package/hspec-pg-transact).

This uses @tmp-postgres@ to automatically and connect to a temporary instance of
postgres on a random port.

Current version is done to operate with Squeal 0.4.0.0.

`describeDB` lets you initate a series of `itDB` specs which will operate in the
same context. It takes migrations to run and a series of fixtures to fill the
database.

Setting the env var `TEST_DB_CONNECTION_STRING` will let you use a non-temporary
database if need be. Tear down will run the `migrateDown` to make sure the test
db doesn't get filled with invalid data.
Commit	Line	Data
aa94c1a5	1	# squeal-hspec
8c738ffc	2
d7b45e63 R	3	Helpers for creating database tests with hspec and squeal, inspired by Jonathan
d7b45e63 R	4	Fischoff's
8c738ffc R	5	[hspec-pg-transact](http://hackage.haskell.org/package/hspec-pg-transact).
8c738ffc R	6
d7b45e63 R	7	This uses @tmp-postgres@ to automatically and connect to a temporary instance of
d7b45e63 R	8	postgres on a random port.
8c738ffc R	9
	10	Current version is done to operate with Squeal 0.4.0.0.
	11
d7b45e63 R	12	`describeDB` lets you initate a series of `itDB` specs which will operate in the
	13	same context. It takes migrations to run and a series of fixtures to fill the
	14	database.
	15
	16	Setting the env var `TEST_DB_CONNECTION_STRING` will let you use a non-temporary
	17	database if need be. Tear down will run the `migrateDown` to make sure the test
	18	db doesn't get filled with invalid data.