Save copies of support files so we can view gold files properly

Author: nedbat

MANIFEST.in

@@ -28,21 +28,21 @@ include tox_wheels.ini
 include .editorconfig
 include .readthedocs.yml
 
-recursive-include ci *.*
+recursive-include ci *
 exclude ci/*.token
 
 recursive-include coverage/fullcoverage *.py
 recursive-include coverage/ctracer *.c *.h
 
 recursive-include doc *.py *.pip *.rst *.txt *.png
-recursive-include doc/_static *.*
+recursive-include doc/_static *
 prune doc/_build
 
 recursive-include requirements *.pip
 
 recursive-include tests *.py *.tok
-recursive-include tests/gold *.*
-recursive-include tests js/*.* qunit/*.*
+recursive-include tests/gold *
+recursive-include tests js/* qunit/*
 prune tests/eggsrc/build
 
 global-exclude *.py[co]

Makefile

@@ -28,6 +28,7 @@ clean:
 	-rm -rf .tox_kits
 	-rm -rf .cache .pytest_cache .hypothesis
 	-rm -rf $$TMPDIR/coverage_test
+	-make -C tests/gold/html clean
 
 sterile: clean
 	-rm -rf .tox*

tests/gold/README.rst

@@ -0,0 +1,18 @@
+.. Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
+.. For details: https://github.com/nedbat/coveragepy/blob/master/NOTICE.txt
+
+Gold files
+==========
+
+These are files used in comparisons for some of the tests.  Code to support
+these comparisons is in tests/goldtest.py.
+
+If gold tests are failing, it can useful to set the COVERAGE_KEEP_TMP
+environment variable.  If set, the test working directories at
+$TMPDIR/coverage_test are kept after the tests are run, so that you can
+manually inspect the differences.
+
+The saved HTML files in the html directories can't be viewed properly without
+the supporting CSS and Javascript files. But we don't want to save copies of
+those files in every subdirectory.  There's a Makefile in the html directory
+for working with the saved copies of the support files.

tests/gold/html/Makefile

@@ -0,0 +1,21 @@
+# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
+# For details: https://github.com/nedbat/coveragepy/blob/master/NOTICE.txt
+
+help:
+	@echo "Available targets:"
+	@grep '^[a-zA-Z]' $(MAKEFILE_LIST) | sort | awk -F ':.*?## ' 'NF==2 {printf "\033[36m  %-25s\033[0m %s\n", $$1, $$2}'
+
+complete: 	## Copy support files into directories so the HTML can be viewed properly.
+	@for sub in *; do \
+		if [[ -f $$sub/index.html ]]; then \
+			echo Copying into $$sub ; \
+			cp -n support/* $$sub ; \
+		fi ; \
+	done ; \
+	true	# because the for loop exits with 1 for some reason.
+
+clean:		## Remove the effects of this Makefile.
+	git clean -fq .
+
+update-support:	## Copy latest support files here for posterity.
+	cp ../../../coverage/htmlfiles/*.{css,js,png} support