From 4035beb98848153b535ddfa746271ee2d4658699 Mon Sep 17 00:00:00 2001
From: Clare Macrae <github@cfmacrae.fastmail.co.uk>
Date: Fri, 23 Oct 2020 19:40:42 +0100
Subject: [PATCH] Add a script - buildAndTest.sh

This contains the currently-documented steps for a developer build.
Also, make git ignore its output directory.
---
 .gitignore                    |  1 +
 tools/scripts/buildAndTest.sh | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100755 tools/scripts/buildAndTest.sh

diff --git a/.gitignore b/.gitignore
index 417b9e49..1b3934bf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,3 +30,4 @@ benchmark-dir
 .conan/test_package/build
 bazel-*
 build-fuzzers
+debug-build
diff --git a/tools/scripts/buildAndTest.sh b/tools/scripts/buildAndTest.sh
new file mode 100755
index 00000000..42a7f6e1
--- /dev/null
+++ b/tools/scripts/buildAndTest.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+
+# Start at the root of the Catch project directory, for example:
+# cd Catch2
+
+# 1. Regenerate the amalgamated distribution
+./tools/scripts/generateAmalgamatedFiles.py
+
+# 2. Configure the full test build
+cmake -Bdebug-build -H. -DCMAKE_BUILD_TYPE=Debug -DCATCH_BUILD_EXAMPLES=ON -DCATCH_BUILD_EXTRA_TESTS=ON
+
+# 3. Run the actual build
+cmake --build debug-build
+
+# 4. Run the tests using CTest
+cd debug-build
+ctest -j 4 --output-on-failure -C Debug