Revised CalCat API

This is based on our discussion last week, but it's still a WIP. In particular, I haven't implemented actually loading the constants yet.

I've tweaked the design slightly: rather than having CalibrationData subclasses for each detector type, you use CalibrationData.from_conditions() with a detector specific object like AGIPDConditions. Jump to the tests to see what this looks like.

Questions:

• How to deal with missing modules?
  • A module may be missing for one type of constant but not for another
  • How do we even tell if modules are missing - should we query the PDUs so we know how many modules to expect?
• How to deal with missing calibration types (e.g. SlopesPC)
  • Especially if one group (e.g. illuminated) not found - this currently raises an error, even if we have other constants we could return
• Naming:
  • 'Calibrations' vs 'calibration' types vs 'constant types' (e.g. Offset, SlopesPC
  • 'Modules' vs 'aggregators'
• How many of SingleConstantVersion fields do we actually want?
• Should .select_modules() and .select_calibrations() take *args or a list?

cc @schmidtp @ahmedk @hammerd

src/cal_tools/calcat_interface.py

@@ -221,7 +221,7 @@ class CalCatApi(metaclass=ClientWrapper):
             detector_name: str,
             calibration_ids: Sequence[int],
             condition: dict,
-            karabo_da: Optional[str]=None,
+            karabo_da: Optional[str] = None,
             event_at=None,
             pdu_snapshot_at=None,
     ):
@@ -236,6 +236,9 @@ class CalCatApi(metaclass=ClientWrapper):
         )
 
         if not resp["success"]:
+            if resp["status_code"] == 200:
+                # calibration_client turns empty response into an error
+                return []
             raise CalCatError(resp)
 
         return resp["data"]