summaryrefslogtreecommitdiff
path: root/HACKING.rst
diff options
context:
space:
mode:
Diffstat (limited to 'HACKING.rst')
-rw-r--r--HACKING.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/HACKING.rst b/HACKING.rst
index e89e28211..3b209a3c3 100644
--- a/HACKING.rst
+++ b/HACKING.rst
@@ -226,6 +226,20 @@ the frontend tests you can do::
./setup.py test --addopts '-k tests/frontend/'
+We also have a set of slow integration tests that are disabled by
+default - you will notice most of them marked with SKIP in the pytest
+output. To run them, you can use::
+
+ ./setup.py test --addopts '--integration'
+
+By default, buildstream also runs pylint on all files. Should you want
+to run just pylint (these checks are a lot faster), you can do so
+with::
+
+ ./setup.py test --addopts '-m pylint'
+
+Alternatively, any IDE plugin that uses pytest should automatically
+detect the ``.pylintrc`` in the project's root directory.
Adding Tests
~~~~~~~~~~~~
@@ -247,6 +261,11 @@ to decorate your test case (again, examples exist in the existing
tests for this), documentation on the datafiles extension can
be found here: https://pypi.python.org/pypi/pytest-datafiles
+Tests that run a sandbox should be decorated with::
+
+ @pytest.mark.integration
+
+and use the integration cli helper.
Measuring BuildStream performance
---------------------------------