aboutsummaryrefslogtreecommitdiffstats
path: root/docs/Debugging.md
diff options
context:
space:
mode:
authorKevin O'Connor <kevin@koconnor.net>2019-06-23 17:58:27 -0400
committerKevin O'Connor <kevin@koconnor.net>2019-06-23 17:59:23 -0400
commitd9bddc35a1fe16cb737f9499873c38893a3f0c73 (patch)
treee26ade31764a907784865f81b84f22f8720ef767 /docs/Debugging.md
parent4bb0b6defdf9f78507ba5646b64c4876f5b429d0 (diff)
downloadkutter-d9bddc35a1fe16cb737f9499873c38893a3f0c73.tar.gz
kutter-d9bddc35a1fe16cb737f9499873c38893a3f0c73.tar.xz
kutter-d9bddc35a1fe16cb737f9499873c38893a3f0c73.zip
docs: Add information on running the regression suite locally
Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
Diffstat (limited to 'docs/Debugging.md')
-rw-r--r--docs/Debugging.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/Debugging.md b/docs/Debugging.md
index 6158ec85..605c288b 100644
--- a/docs/Debugging.md
+++ b/docs/Debugging.md
@@ -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
present) will be reordered by timestamp to assist in diagnosing cause
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
+```