From 01bc51e7eb19fce29ad3414d9dfb38e574b649c6 Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Wed, 27 Sep 2023 14:50:59 +1000 Subject: [PATCH] Tests: move utilities into their own directory These programs don't run as part of automated tests but can be useful utilities for developers to expose issues or bisecting (in the case of event simulation). --- tests/{python => utils}/bl_run_operators.py | 0 .../bl_run_operators_event_simulate.py | 0 tests/utils/readme.rst | 16 ++++++++++++++++ 3 files changed, 16 insertions(+) rename tests/{python => utils}/bl_run_operators.py (100%) rename tests/{python => utils}/bl_run_operators_event_simulate.py (100%) create mode 100644 tests/utils/readme.rst diff --git a/tests/python/bl_run_operators.py b/tests/utils/bl_run_operators.py similarity index 100% rename from tests/python/bl_run_operators.py rename to tests/utils/bl_run_operators.py diff --git a/tests/python/bl_run_operators_event_simulate.py b/tests/utils/bl_run_operators_event_simulate.py similarity index 100% rename from tests/python/bl_run_operators_event_simulate.py rename to tests/utils/bl_run_operators_event_simulate.py diff --git a/tests/utils/readme.rst b/tests/utils/readme.rst new file mode 100644 index 00000000000..239023e5cad --- /dev/null +++ b/tests/utils/readme.rst @@ -0,0 +1,16 @@ + +Test Utilities +============== + +These tests are not intended to run as part of automated unit testing, +rather they can be used to expose issues though stress testing or other less predictable +actions that aren't practical to include in unit tests. + +Examples include: + +- Loading many blend files from a directory, which can expose issues in file reading. +- Running operators in various contexts which can expose crashes. +- Simulating user input for so ``git bisect`` can be performed on bugs that require user interaction. +- Fuzz testing file importers & file format support. + +Note that we could make reduced versions of these tests into unit tests at some point.