puda-drivers 0.0.12__py3-none-any.whl → 0.0.13__py3-none-any.whl

puda_drivers/core/__init__.py

@@ -1,5 +1,6 @@
 from .serialcontroller import SerialController, list_serial_ports
 from .logging import setup_logging
 from .position import Position
+from .nats_machine_client import NATSMachineClient, ExecutionState
 
-__all__ = ["SerialController", "list_serial_ports", "setup_logging", "Position"]
+__all__ = ["SerialController", "list_serial_ports", "setup_logging", "Position", "NATSMachineClient", "ExecutionState"]

puda_drivers/machines/first.py

@@ -159,8 +159,34 @@ class First:
         self.camera.disconnect()
         self._logger.info("Machine shutdown complete")
         
+    def get_position(self) -> Dict[str, float]:
+        """
+        Get the current position of the machine. Both QuBot and Sartorius are queried.
+        
+        Args:
+            None
+        Returns:
+            Dictionary containing the current position of the machine and it's components.
+        """
+        qubot_position = self.qubot.get_position()
+        sartorius_position = self.pipette.get_position()
+
+        return {
+            "qubot": qubot_position.to_dict(),
+            "pipette": sartorius_position,
+        }
+        
     def load_labware(self, slot: str, labware_name: str):
-        """Load a labware object into a slot."""
+        """
+        Load a labware object into a slot.
+        
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            labware_name: Name of the labware class to load
+        
+        Raises:
+            KeyError: If slot is not found in deck
+        """
         self._logger.info("Loading labware '%s' into slot '%s'", labware_name, slot)
         self.deck.load_labware(slot=slot, labware_name=labware_name)
         self._logger.debug("Labware '%s' loaded into slot '%s'", labware_name, slot)
@@ -186,10 +212,20 @@ class First:
         self._logger.info("Deck layout loaded successfully")
         
     def attach_tip(self, slot: str, well: Optional[str] = None):
-        """Attach a tip from a slot."""
+        """
+        Attach a tip from a slot.
+
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            well: Optional well name within the slot (e.g., 'A1' for a well in a tiprack)
+        
+        Note:
+            This method is idempotent - if a tip is already attached, it will
+            log a warning and return successfully without raising an error.
+        """
         if self.pipette.is_tip_attached():
-            self._logger.error("Cannot attach tip: tip already attached")
-            raise ValueError("Tip already attached")
+            self._logger.warning("Tip already attached - skipping attachment (idempotent operation)")
+            return
         
         self._logger.info("Attaching tip from slot '%s'%s", slot, f", well '{well}'" if well else "")
         pos = self.get_absolute_z_position(slot, well)
@@ -361,6 +397,13 @@ class First:
     def get_absolute_a_position(self, slot: str, well: Optional[str] = None) -> Position:
         """
         Get the absolute position for a slot (and optionally a well within that slot) based on the origin
+        
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            well: Optional well name within the slot (e.g., 'A1' for a well in a tiprack)
+            
+        Returns:
+            Position with absolute coordinates
         """
         pos = self.get_slot_origin(slot)
         

puda_drivers/move/gcode.py

@@ -508,9 +508,9 @@ class GCodeController(SerialController):
         
         return self._current_position
 
-    def query_position(self) -> Position:
+    def get_position(self) -> Position:
         """
-        Query the current machine position (M114 command).
+        Get the current machine position (M114 command).
 
         Returns:
             Position containing X, Y, Z, and A positions
@@ -560,7 +560,7 @@ class GCodeController(SerialController):
         self._logger.info("Starting position synchronization check (M114).")
 
         # Query the actual machine position
-        queried_position = self.query_position()
+        queried_position = self.get_position()
 
         if not queried_position.get_axes():
             self._logger.error("Query position failed. Cannot synchronize.")

puda_drivers/transfer/liquid/sartorius/__init__.py

@@ -1,2 +1,2 @@
-from .sartorius import SartoriusController, SartoriusDeviceError
+from .rLine import SartoriusController, SartoriusDeviceError
 from .constants import STATUS_CODES

puda_drivers/transfer/liquid/sartorius/{sartorius.py → rLine.py}

@@ -7,6 +7,7 @@ pipettes and robotic dispensers via serial communication.
 Reference: https://api.sartorius.com/document-hub/dam/download/34901/Sartorius-rLine-technical-user-manual-v1.1.pdf
 """
 
+import json
 import logging
 from typing import Optional
 from puda_drivers.core.serialcontroller import SerialController
@@ -62,14 +63,14 @@ class SartoriusController(SerialController):
             timeout: Timeout in seconds for operations. Defaults to 10.
         """
         super().__init__(port_name, baudrate, timeout)
-        self._logger = logging.getLogger(__name__)
+        self._logger = logging.getLogger('puda_drivers.transfer.liquid.sartorius')
         self._logger.info(
             "Sartorius Controller initialized with port='%s', baudrate=%s, timeout=%s",
             port_name,
             baudrate,
             timeout,
         )
-        self._tip_attached: bool
+        self._tip_attached: bool = False
         self._volume: int = 0
 
     def _build_command(self, command: str, value: Optional[str] = None) -> str:
@@ -337,7 +338,10 @@ class SartoriusController(SerialController):
         Query the current status of the pipette (DS command).
 
         Returns:
-            Status code character (single character string)
+            JSON string containing status information with keys:
+            - status_code: Status code character
+            - status_message: Human-readable status message (if known)
+            - is_known: Boolean indicating if status code is recognized
 
         Raises:
             SartoriusDeviceError: If the status query fails
@@ -351,15 +355,22 @@ class SartoriusController(SerialController):
             )
 
         status_code = response[1]
+        status_data = {
+            "status_code": status_code,
+            "is_known": status_code in STATUS_CODES
+        }
+        
         if status_code in STATUS_CODES:
             status_message = STATUS_CODES[status_code]
+            status_data["status_message"] = status_message
             self._logger.info("Pipette Status Code [%s]: %s\n", status_code, status_message)
         else:
+            status_data["status_message"] = None
             self._logger.warning(
                 "Pipette Status Code [%s]: Unknown Status Code\n", status_code
             )
 
-        return status_code
+        return json.dumps(status_data)
     
     def get_position(self) -> int:
         """

{puda_drivers-0.0.12.dist-info → puda_drivers-0.0.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: puda-drivers
-Version: 0.0.12
+Version: 0.0.13
 Summary: Hardware drivers for the PUDA platform.
 Project-URL: Homepage, https://github.com/zhao-bears/puda-drivers
 Project-URL: Issues, https://github.com/zhao-bears/puda-drivers/issues
@@ -14,7 +14,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Hardware
-Requires-Python: >=3.8
+Requires-Python: >=3.10
+Requires-Dist: nats-py>=2.12.0
 Requires-Dist: opencv-python>=4.12.0.88
 Requires-Dist: pyserial~=3.5
 Description-Content-Type: text/markdown
@@ -188,7 +189,7 @@ sartorius_ports = list_serial_ports(filter_desc="Sartorius")
 
 ## Requirements
 
-- Python >= 3.14
+- Python >= 3.8
 - pyserial >= 3.5
 - See `pyproject.toml` for full dependency list
 

{puda_drivers-0.0.12.dist-info → puda_drivers-0.0.13.dist-info}/RECORD

@@ -1,6 +1,6 @@
 puda_drivers/__init__.py,sha256=rcF5xCkMgyLlJLN3gWwJnUoW0ShPyISeyENvaqwg4Ik,503
 puda_drivers/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-puda_drivers/core/__init__.py,sha256=XbCdXsU6NMDsmEAtavAGiSZZPla5d7zc2L7Qx9qKHdY,214
+puda_drivers/core/__init__.py,sha256=1T5jL8SXz_4jz1TGa3tSupwF5vg-wuN2efhulVClHaI,320
 puda_drivers/core/logging.py,sha256=prOeJ3CGEbm37TtMRyAOTQQiMU5_ImZTRXmcUJxkenc,2892
 puda_drivers/core/position.py,sha256=f4efmDSrKKCtqrR-GUJxVitPG20MiuGSDOWt-9TVISk,12628
 puda_drivers/core/serialcontroller.py,sha256=38mKas1iJaOkAE0_V4tmqgZz7RxMMEWfGqA0Ma_Dt2A,8604
@@ -12,18 +12,18 @@ puda_drivers/labware/opentrons_96_tiprack_300ul.json,sha256=jmNaworu688GEgFdxMxN
 puda_drivers/labware/polyelectric_8_wellplate_30000ul.json,sha256=esu2tej0ORs7Pfd4HwoQVUpU5mPvp2AYzE3zsCC2FDk,3104
 puda_drivers/labware/trash_bin.json,sha256=Hk4MXO48P28jG7F87DUd9Ja4c_P7kAy3karPQ965i9Y,580
 puda_drivers/machines/__init__.py,sha256=zmIk_r2T8nbPA68h3Cko8N6oL7ncoBpmvhNcAqzHmc4,45
-puda_drivers/machines/first.py,sha256=yk_Kh9f_yjSlRHjYEOzvrMxADBvlTH0AIV1VLvm2sp8,18339
+puda_drivers/machines/first.py,sha256=kpxn8__u2mVt0MROj8Tuqs9-guBAsjW8lDTDVuQL9XE,19683
 puda_drivers/move/__init__.py,sha256=NKIKckcqgyviPM0EGFcmIoaqkJM4qekR4babfdddRzM,96
 puda_drivers/move/deck.py,sha256=yq2B4WMqj0hQvHt8HoJskP10u1DUyKwUnjP2c9gJ174,1397
-puda_drivers/move/gcode.py,sha256=Aw7la4RkPw737hW5sKl6WiPCmmTnsjLvG4mOb-RwVSc,22592
+puda_drivers/move/gcode.py,sha256=NAUBwhCI24NJlcZSQyKO6K7nP6ADcIybb4rrmYusKq0,22586
 puda_drivers/move/grbl/__init__.py,sha256=vBeeti8DVN2dACi1rLmHN_UGIOdo0s-HZX6mIepLV5I,98
 puda_drivers/move/grbl/api.py,sha256=loj8_Vap7S9qaD0ReHhgxr9Vkl6Wp7DGzyLkZyZ6v_k,16995
 puda_drivers/move/grbl/constants.py,sha256=4736CRDzLGWVqGscLajMlrIQMyubsHfthXi4RF1CHNg,9585
-puda_drivers/transfer/liquid/sartorius/__init__.py,sha256=QGpKz5YUwa8xCdSMXeZ0iRU-hRVqAWNPK0mlMTuzv8I,101
+puda_drivers/transfer/liquid/sartorius/__init__.py,sha256=7fljIbu0KkumsI3NI3O64dl6JkMAQDG5-uGqPefDI7M,97
 puda_drivers/transfer/liquid/sartorius/api.py,sha256=jxwIJmY2k1K2ts6NC2ZgFTe4MOiH8TGnJeqYOqNa3rE,28250
 puda_drivers/transfer/liquid/sartorius/constants.py,sha256=mcsjLrVBH-RSodH-pszstwcEL9wwbV0vOgHbGNxZz9w,2770
-puda_drivers/transfer/liquid/sartorius/sartorius.py,sha256=bW838jYOAfLlbUqtsKRipZ-RLjrNTcZ7riYV6I4w8G8,13728
-puda_drivers-0.0.12.dist-info/METADATA,sha256=saXg221vJnpqzC4t6Cn7Kcc1ZX0WPBLQkclr_vFaRgQ,7071
-puda_drivers-0.0.12.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-puda_drivers-0.0.12.dist-info/licenses/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
-puda_drivers-0.0.12.dist-info/RECORD,,
+puda_drivers/transfer/liquid/sartorius/rLine.py,sha256=Lzcxt-oHFHa2a-q1WFFrpHTeQrKQihRJrPcf29J5Rb0,14232
+puda_drivers-0.0.13.dist-info/METADATA,sha256=6shREZadMDvMjcZTBlKd9SDfd0-IZOutmMtg5kOpspY,7102
+puda_drivers-0.0.13.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+puda_drivers-0.0.13.dist-info/licenses/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
+puda_drivers-0.0.13.dist-info/RECORD,,