debian-skyfield/test-docs.sh

#!/bin/bash

set -e
cd "$(dirname ${BASH_SOURCE[0]})"

# Copy in files that would otherwise need to download.
ln -f ci/*.* skyfield/documentation

function cleanup {
    cd skyfield/documentation
    rm -f $(cd ../../ci; ls *.*)
}
trap cleanup EXIT

make -C skyfield/documentation doctest
Make it vastly easier to test the documentation! I thought “can Sphinx really be this bad” and added `--help` to the “doctest:” command and, lo! and behold!, its terrible verbose output that scrolls actual errors of the screen can be replaced with useful output showing the first error it comes across. I am suddenly a much happier Sphinx user! 2018-06-30 10:01:22 +02:00			`#!/bin/bash`

			`set -e`
			`cd "$(dirname ${BASH_SOURCE[0]})"`
Repair Travis CI: shouldn't have changed directory 2019-12-20 18:44:35 +01:00
			`# Copy in files that would otherwise need to download.`
Use hard links during Sphinx documentation tests Hard linking the large files in ci/ should be faster than copying them each time. Also, let’s only remove them once; the “cleanup” routine was duplicating work also done at the bottom of the file. 2020-04-02 15:48:09 +02:00			`ln -f ci/. skyfield/documentation`
Add script to update deltat data files 2019-07-21 13:59:58 +02:00
			`function cleanup {`
			`cd skyfield/documentation`
Use hard links during Sphinx documentation tests Hard linking the large files in ci/ should be faster than copying them each time. Also, let’s only remove them once; the “cleanup” routine was duplicating work also done at the bottom of the file. 2020-04-02 15:48:09 +02:00			`rm -f $(cd ../../ci; ls .)`
Add script to update deltat data files 2019-07-21 13:59:58 +02:00			`}`
			`trap cleanup EXIT`

Make it vastly easier to test the documentation! I thought “can Sphinx really be this bad” and added `--help` to the “doctest:” command and, lo! and behold!, its terrible verbose output that scrolls actual errors of the screen can be replaced with useful output showing the first error it comes across. I am suddenly a much happier Sphinx user! 2018-06-30 10:01:22 +02:00			`make -C skyfield/documentation doctest`