Add liquid handling capabilities

pylabrobot/capabilities/liquid_handling/__init__.py

@@ -0,0 +1,18 @@
+from .errors import ChannelizedError, NoChannelError
+from .head96 import Head96Capability
+from .head96_backend import Head96Backend
+from .pip import PIP
+from .pip_backend import PIPBackend
+from .standard import (
+  Aspiration,
+  Dispense,
+  DropTipRack,
+  Mix,
+  MultiHeadAspirationContainer,
+  MultiHeadAspirationPlate,
+  MultiHeadDispenseContainer,
+  MultiHeadDispensePlate,
+  Pickup,
+  PickupTipRack,
+  TipDrop,
+)

pylabrobot/capabilities/liquid_handling/errors.py

@@ -0,0 +1,26 @@
+"""Errors for liquid handling operations."""
+
+from typing import Dict
+
+
+class NoChannelError(Exception):
+  """Raised when no channel is available."""
+
+
+class BlowOutVolumeError(Exception):
+  """Raised when blow-out air volume is invalid."""
+
+
+class ChannelizedError(Exception):
+  """Raised by multi-channel operations. Contains per-channel errors."""
+
+  def __init__(self, errors: Dict[int, Exception], **kwargs):
+    self.errors = errors
+    self.kwargs = kwargs
+
+  def __str__(self) -> str:
+    kwarg_string = ", ".join([f"{k}={v}" for k, v in self.kwargs.items()])
+    return f"ChannelizedError(errors={self.errors}, {kwarg_string})"
+
+  def __len__(self) -> int:
+    return len(self.errors)