Testing

As noted elsewhere in the documentation, there is a wealth of examples and test cases in the tests subdirectory. To invoke all of them in sequence, simply type make test from either the top of the repository or within the tests directory itself. Each of the major tools will be exercised, in addition to other basic features. The tools and other feature tests may be executed individually, as well, via test_mirror or test_dice et cetera, but they must be run in the usual order (mirror --> dice --> loadfile -->report).

At present the regression test metadata is synced to GDC data release v6. The first mirror will take about 5-10 minutes to download (depending upon your network connection), but re-running any of the tests subsequently will use the local mirror instead of re-downloading. To redo the mirror and/or any of the other steps in the full make test suite, either delete the tests/sandbox directory entirely or specific subdirectories within.

Note that GDCtools aims to support both major Python versions, v2 and v3. By default make test will execute against Python v2, while make test3 will attempt to exercise the code against Python v3.