Add docker files for local test environment (#250)

Add a `DockerFile` and compose file, along with instructions for running it to simplify testing.

Author: wolfgangwalther

Changes

@@ -28,6 +28,8 @@ Revision history for pgTAP
   for the report (#277).
 * Added `isnt_member_of()` (#38, #204). Thanks to Wolfgang Walther for the
   pull request (#249).
+* Added docker files for local test environment. Thanks to Wolfgang Walther for
+  the pull request (#250).
 
 1.1.0 2019-11-25T19:05:38Z
 --------------------------

doc/pgtap.mmd

@@ -152,6 +152,19 @@ You can use it to run the test suite as a database super user like so:
 
     make test PGUSER=postgres
 
+To run the tests in a local docker environment for development, run:
+
+    cd test
+    docker-compose build test
+    # start the postgres server in a docker container in the background
+    docker-compose up -d test
+    # run the regression tests
+    docker-compose exec test make install installcheck
+    # run the tests with pg_proove
+    # "run" builds and installs pgTAP, runs "CREATE EXTENSION"
+    # and then runs make test
+    docker-compose exec test run
+
 Adding pgTAP to a Database
 --------------------------
 

test/Dockerfile

@@ -0,0 +1,9 @@
+FROM postgres:13.0-alpine
+ENV POSTGRES_HOST_AUTH_METHOD trust
+
+RUN apk --no-cache add make perl-dev patch \
+ && cpan TAP::Parser::SourceHandler::pgTAP
+ENV PGUSER postgres
+
+WORKDIR /pgtap
+ENV PATH /pgtap/test:$PATH

test/docker-compose.yml

@@ -0,0 +1,15 @@
+version: "3"
+
+services:
+  test:
+    build: .
+    volumes:
+      - ../:/pgtap
+      - postgres:/var/lib/postgresql/data
+
+volumes:
+  postgres:
+    driver_opts:
+      type: tmpfs
+      device: tmpfs
+

test/run

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+
+set -e -u -o pipefail 
+
+make install
+psql -Ec 'DROP EXTENSION IF EXISTS pgtap; CREATE EXTENSION pgtap;'
+make test