System tests

docs/index.rst

@@ -9,6 +9,7 @@ Welcome to Zocalo's documentation!
    workflows
    siteconfig
    installation
+   systemtest
    contributing
    authors
    history

docs/systemtest.rst

@@ -0,0 +1,29 @@
+============
+System Tests
+============
+
+Test various parts of the zocalo system. Tests are found via the `zocalo.system_tests` 
+entry points. ActiveMQ and Dispatcher tests are included by default.
+
+.. code-block::
+
+    zocalo.run_system_tests (--debug)
+
+Minimum config required to test:
+
+* `ActiveMQ`
+* `Dispatcher`
+
+.. code-block::
+
+    storage:
+        plugin: storage
+
+        system_tests:
+            temp_dir: /tmp/zocalo-test
+
+            dispatcher:
+                ispyb_dcid: 1
+                expected_beamline: bl
+
+`recipes/test-dispatcher.json` needs to be copied to the local recipe path

requirements_dev.txt

@@ -6,3 +6,4 @@ pytest-mock
 pytest==6.2.5
 setuptools==58.2.0
 workflows==2.13
+junit-xml==1.9

setup.cfg

@@ -31,6 +31,7 @@ install_requires =
     marshmallow
     setuptools
     workflows>=2.7
+    junit_xml
 packages = find:
 package_dir =
     =src
@@ -44,6 +45,7 @@ console_scripts =
     zocalo.service = zocalo.service:start_service
     zocalo.shutdown = zocalo.cli.shutdown:run
     zocalo.wrap = zocalo.cli.wrap:run
+    zocalo.run_system_tests = zocalo.cli.system_test:run
 libtbx.dispatcher.script =
     zocalo.go = zocalo.go
     zocalo.queue_drain = zocalo.queue_drain
@@ -61,6 +63,9 @@ zocalo.configuration.plugins =
     jmx = zocalo.configuration.plugin_jmx:JMX
 zocalo.wrappers =
     dummy = zocalo.wrapper:DummyWrapper
+zocalo.system_tests =
+    activemq = zocalo.system_test.tests.activemq:ActiveMQ
+    dispatcher = zocalo.system_test.tests.dispatcher:DispatcherService
 
 [options.packages.find]
 where = src