docs: Add information on running the regression suite locally

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2019-06-23 17:58:27 -04:00
parent 4bb0b6defd
commit d9bddc35a1
1 changed files with 21 additions and 0 deletions

View File

@ -174,3 +174,24 @@ The script will extract the printer config file and will extract MCU
shutdown information. The information dumps from an MCU shutdown (if shutdown information. The information dumps from an MCU shutdown (if
present) will be reordered by timestamp to assist in diagnosing cause present) will be reordered by timestamp to assist in diagnosing cause
and effect scenarios. and effect scenarios.
Running the regression tests
============================
The main Klipper GitHub repository uses TravisCI to run a series of
regression tests. It can be useful to run some of these tests locally.
The source code "whitespace check" can be run with:
```
./scripts/check_whitespace.sh
```
The Klippy regression test suite requires "data dictionaries" from
many platforms. The easiest way to obtain them is to
[download them from github](https://github.com/KevinOConnor/klipper/issues/1438).
Once the data dictionaries are downloaded, use the following to run
the regression suite:
```
tar xfz klipper-dict-20??????.tar.gz
~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test
```