clarity-api-sdk-python 0.3.26__tar.gz → 0.3.28__tar.gz

{clarity_api_sdk_python-0.3.26 → clarity_api_sdk_python-0.3.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clarity-api-sdk-python
-Version: 0.3.26
+Version: 0.3.28
 Summary: A Python SDK to connect to the CTI Clarity API server.
 Author-email: "Chesapeake Technology Inc." <support@chesapeaketech.com>
 Project-URL: Homepage, https://github.com/chesapeake-tech/clarity-api-sdk-python

{clarity_api_sdk_python-0.3.26 → clarity_api_sdk_python-0.3.28}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clarity-api-sdk-python"
-version = "0.3.26"
+version = "0.3.28"
 authors = [
   { name="Chesapeake Technology Inc.", email="support@chesapeaketech.com" },
 ]

{clarity_api_sdk_python-0.3.26 → clarity_api_sdk_python-0.3.28}/src/clarity_api_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clarity-api-sdk-python
-Version: 0.3.26
+Version: 0.3.28
 Summary: A Python SDK to connect to the CTI Clarity API server.
 Author-email: "Chesapeake Technology Inc." <support@chesapeaketech.com>
 Project-URL: Homepage, https://github.com/chesapeake-tech/clarity-api-sdk-python

{clarity_api_sdk_python-0.3.26 → clarity_api_sdk_python-0.3.28}/src/cti/api/sonar_wiz_api.py

@@ -941,6 +941,66 @@ class SonarWizApi:
         )
         return sources
 
+    def get_position_source_raw_positions(
+        self, position_source_id: UUID | str
+    ) -> list[RawPosition]:
+        """Get all raw positions associated with a position source.
+
+        Args:
+            position_source_id: Position source UUID.
+
+        Returns:
+            List of raw position instances.
+        """
+        logger.info(
+            "fetching_position_source_raw_positions",
+            extra={"position_source_id": str(position_source_id)},
+        )
+        response = self._client.get(
+            f"/api/v1/position-sources/{position_source_id}/raw-positions"
+        )
+        response.raise_for_status()
+        raw_positions = [RawPosition.model_validate(item) for item in response.json()]
+        logger.info(
+            "position_source_raw_positions_fetched",
+            extra={
+                "position_source_id": str(position_source_id),
+                "count": len(raw_positions),
+            },
+        )
+        return raw_positions
+
+    def get_sidescan_ping_source_raw_sidescan_pings(
+        self, sidescan_ping_source_id: UUID | str
+    ) -> list[RawSidescanPing]:
+        """Get all raw sidescan pings associated with a sidescan ping source.
+
+        Args:
+            sidescan_ping_source_id: Sidescan ping source UUID.
+
+        Returns:
+            List of raw sidescan ping instances.
+        """
+        logger.info(
+            "fetching_sidescan_ping_source_raw_sidescan_pings",
+            extra={"sidescan_ping_source_id": str(sidescan_ping_source_id)},
+        )
+        response = self._client.get(
+            f"/api/v1/sidescan-ping-sources/{sidescan_ping_source_id}/raw-sidescan-pings"
+        )
+        response.raise_for_status()
+        raw_sidescan_pings = [
+            RawSidescanPing.model_validate(item) for item in response.json()
+        ]
+        logger.info(
+            "sidescan_ping_source_raw_sidescan_pings_fetched",
+            extra={
+                "sidescan_ping_source_id": str(sidescan_ping_source_id),
+                "count": len(raw_sidescan_pings),
+            },
+        )
+        return raw_sidescan_pings
+
     def create_source(self, source: SourceCreate) -> Source:
         """Create a new source.
 
@@ -1277,21 +1337,20 @@ class SonarWizApi:
         response.raise_for_status()
         return RawDepth.model_validate(response.json())
 
-    def create_raw_sidescan_ping(self, ping: RawSidescanPingCreate) -> None:
-        """Create a raw sidescan ping record.
+    def create_raw_sidescan_pings(self, pings: list[RawSidescanPingCreate]) -> None:
+        """Create raw sidescan ping records.
 
         Args:
-            ping: Raw sidescan ping creation data.
+            pings: Raw sidescan ping creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-sidescan-pings", json=[ping.model_dump(mode="json")]
+            "/api/v1/raw-sidescan-pings", json=[ping.model_dump(mode="json") for ping in pings]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_sidescan_ping_created",
+            "raw_sidescan_pings_created",
             extra={
-                "sidescan_ping_source_id": str(ping.sidescan_ping_source_id),
-                "ping_number_id": str(ping.ping_number_id),
+                "count": len(pings),
             },
         )
 

{clarity_api_sdk_python-0.3.26 → clarity_api_sdk_python-0.3.28}/src/cti/api/sonar_wiz_async_api.py

@@ -951,6 +951,66 @@ class SonarWizAsyncApi:
         )
         return sources
 
+    async def get_position_source_raw_positions(
+        self, position_source_id: UUID | str
+    ) -> list[RawPosition]:
+        """Get all raw positions associated with a position source.
+
+        Args:
+            position_source_id: Position source UUID.
+
+        Returns:
+            List of raw position instances.
+        """
+        logger.info(
+            "fetching_position_source_raw_positions",
+            extra={"position_source_id": str(position_source_id)},
+        )
+        response = await self._client.get(
+            f"/api/v1/position-sources/{position_source_id}/raw-positions"
+        )
+        response.raise_for_status()
+        raw_positions = [RawPosition.model_validate(item) for item in response.json()]
+        logger.info(
+            "position_source_raw_positions_fetched",
+            extra={
+                "position_source_id": str(position_source_id),
+                "count": len(raw_positions),
+            },
+        )
+        return raw_positions
+
+    async def get_sidescan_ping_source_raw_sidescan_pings(
+        self, sidescan_ping_source_id: UUID | str
+    ) -> list[RawSidescanPing]:
+        """Get all raw sidescan pings associated with a sidescan ping source.
+
+        Args:
+            sidescan_ping_source_id: Sidescan ping source UUID.
+
+        Returns:
+            List of raw sidescan ping instances.
+        """
+        logger.info(
+            "fetching_sidescan_ping_source_raw_sidescan_pings",
+            extra={"sidescan_ping_source_id": str(sidescan_ping_source_id)},
+        )
+        response = await self._client.get(
+            f"/api/v1/sidescan-ping-sources/{sidescan_ping_source_id}/raw-sidescan-pings"
+        )
+        response.raise_for_status()
+        raw_sidescan_pings = [
+            RawSidescanPing.model_validate(item) for item in response.json()
+        ]
+        logger.info(
+            "sidescan_ping_source_raw_sidescan_pings_fetched",
+            extra={
+                "sidescan_ping_source_id": str(sidescan_ping_source_id),
+                "count": len(raw_sidescan_pings),
+            },
+        )
+        return raw_sidescan_pings
+
     async def create_source(self, source: SourceCreate) -> Source:
         """Create a new source.
 
@@ -1287,21 +1347,20 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return RawDepth.model_validate(response.json())
 
-    async def create_raw_sidescan_ping(self, ping: RawSidescanPingCreate) -> None:
-        """Create a raw sidescan ping record.
+    async def create_raw_sidescan_pings(self, pings: list[RawSidescanPingCreate]) -> None:
+        """Create raw sidescan ping records.
 
         Args:
-            ping: Raw sidescan ping creation data.
+            pings: Raw sidescan ping creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-sidescan-pings", json=[ping.model_dump(mode="json")]
+            "/api/v1/raw-sidescan-pings", json=[ping.model_dump(mode="json") for ping in pings]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_sidescan_ping_created",
+            "raw_sidescan_pings_created",
             extra={
-                "sidescan_ping_source_id": str(ping.sidescan_ping_source_id),
-                "ping_number_id": str(ping.ping_number_id),
+                "count": len(pings),
             },
         )