standardbots 2.0.0.dev1763155352__tar.gz → 2.0.0.dev1763765170__tar.gz

{standardbots-2.0.0.dev1763155352 → standardbots-2.0.0.dev1763765170}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: standardbots
-Version: 2.0.0.dev1763155352
+Version: 2.0.0.dev1763765170
 Summary: Standard Bots RO1 Robotics API
 Home-page: 
 Author: Standard Bots Support

{standardbots-2.0.0.dev1763155352 → standardbots-2.0.0.dev1763765170}/setup.py

@@ -13,7 +13,7 @@
 from setuptools import setup, find_packages  # noqa: H301
 
 NAME = "standardbots"
-VERSION = "2.0.0-dev1763155352"
+VERSION = "2.0.0-dev1763765170"
 # To install the library, run the following
 #
 # python setup.py install

{standardbots-2.0.0.dev1763155352 → standardbots-2.0.0.dev1763765170}/standardbots/auto_generated/apis.py

@@ -1914,6 +1914,55 @@ class Camera:
                 )
                 parsed = None
 
+                is_user_error = response.status >= 400 and response.status <= 500
+                is_unavailable = response.status == 503
+                if parsed is None and (is_user_error or is_unavailable):
+                    parsed = models.parse_error_response(json.loads(response.data))
+
+                return Response(
+                    parsed,
+                    response.status,
+                    response
+                )
+            except urllib3.exceptions.MaxRetryError:
+                return Response(
+                    models.ErrorResponse(
+                        error=models.ErrorEnum.InternalServerError,
+                        message="Connection Refused"
+                    ),
+                    503,
+                    None
+                )
+        def get_camera_frame(
+            self,
+            camera_id: str,
+            stream_name: str,
+        ) -> Response[
+            Union[
+                models.CameraFrameResponse,
+                models.ErrorResponse,
+                None
+            ],
+            models.CameraFrameResponse
+        ]:
+            """
+            Retrieve the latest frame from a specific camera by camera ID using the messenger GetFrame method. Returns a JSON object containing the frame as a base64 string in JPEG format, along with frame metadata including timestamp, camera ID, and stream name.
+            """
+            path = "/api/v1/camera/{camera_id}/frame"
+            path = path.replace("{camera_id}", str(camera_id))
+            try:
+                response = self._request_manager.request(
+                    "GET",
+                    path,
+                    headers=self._request_manager.json_headers(),
+                    fields={
+                        "stream_name": models.serialize_str(stream_name),
+                    }
+                )
+                parsed = None
+                if response.status == 200:
+                    parsed = models.parse_camera_frame_response(json.loads(response.data))
+
                 is_user_error = response.status >= 400 and response.status <= 500
                 is_unavailable = response.status == 503
                 if parsed is None and (is_user_error or is_unavailable):

{standardbots-2.0.0.dev1763155352 → standardbots-2.0.0.dev1763765170}/standardbots/auto_generated/models.py

@@ -387,6 +387,81 @@ def serialize_camera_configuration(data: CameraConfiguration) -> object:
     "height": None if data.height is None else serialize_u_32(data.height),
   }
 
+@dataclass
+class CameraFrameResponse:
+  """Response containing a camera frame and associated metadata."""
+  imageData: Union[str, None] = None
+  timestamp: Union[str, None] = None
+  camera_id: Union[str, None] = None
+  stream_name: Union[str, None] = None
+
+  def validate_imageData(self, value: str) -> Tuple[bool, str]:
+    if value is None:
+      return [True, ""]
+
+    if not isinstance(value, str):
+      return [False, "imageData must be of type str for CameraFrameResponse, got " + type(value).__name__]
+
+    return [True, ""]
+
+  def validate_timestamp(self, value: str) -> Tuple[bool, str]:
+    if value is None:
+      return [True, ""]
+
+    if not isinstance(value, str):
+      return [False, "timestamp must be of type str for CameraFrameResponse, got " + type(value).__name__]
+
+    return [True, ""]
+
+  def validate_camera_id(self, value: str) -> Tuple[bool, str]:
+    if value is None:
+      return [True, ""]
+
+    if not isinstance(value, str):
+      return [False, "camera_id must be of type str for CameraFrameResponse, got " + type(value).__name__]
+
+    return [True, ""]
+
+  def validate_stream_name(self, value: str) -> Tuple[bool, str]:
+    if value is None:
+      return [True, ""]
+
+    if not isinstance(value, str):
+      return [False, "stream_name must be of type str for CameraFrameResponse, got " + type(value).__name__]
+
+    return [True, ""]
+
+  def __post_init__(self):
+    # Type check incoming model - raise error if invalid (required or wrong type)
+    is_valid, error_str = self.validate_imageData(self.imageData)
+    if not is_valid:
+      raise TypeError(error_str)
+    is_valid, error_str = self.validate_timestamp(self.timestamp)
+    if not is_valid:
+      raise TypeError(error_str)
+    is_valid, error_str = self.validate_camera_id(self.camera_id)
+    if not is_valid:
+      raise TypeError(error_str)
+    is_valid, error_str = self.validate_stream_name(self.stream_name)
+    if not is_valid:
+      raise TypeError(error_str)
+
+def parse_camera_frame_response(data: object):
+  return CameraFrameResponse(
+    imageData=parse_str(data["imageData"]) if "imageData" in data and data.get("imageData") is not None else None,
+    timestamp=parse_str(data["timestamp"]) if "timestamp" in data and data.get("timestamp") is not None else None,
+    camera_id=parse_str(data["camera_id"]) if "camera_id" in data and data.get("camera_id") is not None else None,
+    stream_name=parse_str(data["stream_name"]) if "stream_name" in data and data.get("stream_name") is not None else None,
+  )
+
+def serialize_camera_frame_response(data: CameraFrameResponse) -> object:
+  return {
+    "imageData": None if data.imageData is None else serialize_str(data.imageData),
+    "timestamp": None if data.timestamp is None else serialize_str(data.timestamp),
+    "camera_id": None if data.camera_id is None else serialize_str(data.camera_id),
+    "stream_name": None if data.stream_name is None else serialize_str(data.stream_name),
+  }
+
 @dataclass
 class CameraIntrinsics:
   """Intrinsic parameters of the camera."""

{standardbots-2.0.0.dev1763155352 → standardbots-2.0.0.dev1763765170}/standardbots.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: standardbots
-Version: 2.0.0.dev1763155352
+Version: 2.0.0.dev1763765170
 Summary: Standard Bots RO1 Robotics API
 Home-page: 
 Author: Standard Bots Support