Files
Mirko HollerandClaude Opus 5.5 5e3b4b50d5
CI for csaxs_bec / test (pull_request) Successful in 3m28s
Read the Docs Deploy Trigger / trigger-rtd-webhook (push) Successful in 1s
CI for csaxs_bec / test (push) Successful in 3m20s
feat(flomni): trigger source of the flOMNI loop at every Fermat scan start (soft trigger)
flomni_fermat_scan sets the loop setting trigger_soft before arming ddg1: at the beamline (a real, not simulated,
ddg1 or one of the exposure box motors ebtrx/ebtry/ebtrz/ebsupport configured; a failing check counts as beamline)
the hardware trigger, else the soft trigger with soft_exposure_ms = exp_time x frames_per_trigger. At the beamline
the scan is aborted if the hardware trigger cannot be confirmed; away only a warning. flomni_loop_settings: signals
trigger_soft, soft_exposure_ms, soft_latency_ms. rt_settings.trigger_set_soft(); trigger_show() shows both groups.
Docs + PDF. Needs the flOMNI loop / web HMI with the soft trigger (flOMNI feat/soft-trigger) first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017KicuVBRC7jB1TLG5hLZwx
2026-10-26 21:48:53 +01:00
..

Getting Started with Testing using pytest

BEC is using the pytest framework. It can be installed via

pip install pytest

in your python environment. We note that pytest is part of the optional-dependencies [dev] of the plugin package.

Introduction

Tests in this package should be stored in the tests directory. We suggest to sort tests of different submodules, i.e. scans or devices in the respective folder structure, and to folow a naming convention of <test_module_name.py>. It is mandatory for test files to begin with test_ for pytest to discover them.

To run all tests, navigate to the directory of the plugin from the command line, and run the command

pytest -v --random-order ./tests

Note, the python environment needs to be active. The additional arg -v allows pytest to run in verbose mode which provides more detailed information about the tests being run. The argument --random-order instructs pytest to run the tests in random order, which is the default in the CI pipelines.

Test examples

Writing tests can be quite specific for the given function. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. A very useful class to enable isolated testing is MagicMock. In addition, we also recommend to take a look at the How-to guides from pytest.