[Gotthard2][Dark] Sort dark runs

Description

Sort dark runs for Gotthard2 by checking RUN/.../settings

This addresses GH2 part of this issue: https://git.xfel.eu/calibration/planning/-/issues/192

How Has This Been Tested?

Relevant Documents (optional)

gh2_sort_darks_fxe.pdf

gh2_sort_darks_hirex.pdf

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

• I added tests where appropriate. Can't be used now because of permissions

Reviewers

@schmidtp @kluyvert

tests/test_gotthard2lib.py

+import pytest
+
+from cal_tools.gotthard2.gotthard2lib import sort_dark_runs_by_gain
+
+
+def test_sort_dark_runs_by_gain():
+    # TODO: update used raw data to test data when available.
+    raw_folder = "/gpfs/exfel/exp/FXE/202231/p900298/raw"
+    ctrl_src = "FXE_XAD_G2XES/DET/CONTROL"
+    runs = [9, 8, 7]
+    sorted_runs = sort_dark_runs_by_gain(raw_folder, runs, ctrl_src)
+    assert sorted_runs == [7, 8, 9]
+
+
+def test_raise_sort_dark_runs_by_gain():
+    # TODO: update used raw data to test data when available.
+    raw_folder = "/gpfs/exfel/exp/SA1/202331/p900384/raw"
+    ctrl_src = "SA1_XTD9_HIREX/DET/GOTTHARD2_CTRL"
+    runs = [60, 61, 62, 63]
+    with pytest.raises(AssertionError) as err:
+        sort_dark_runs_by_gain(raw_folder, runs, ctrl_src)
+
+    runs = [89, 61, 63]  # dynamicgain, dynamicgain, fixgain2
+    with pytest.raises(ValueError) as err:
+        sort_dark_runs_by_gain(raw_folder, runs, ctrl_src)
\ No newline at end of file