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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clarity-api-sdk-python
-Version: 0.3.28
+Version: 0.3.30
 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
@@ -114,10 +114,10 @@ if __name__ == "__main__":
     asyncio.run(main())
 
 # In other modules
-from cti.api.session import async_client
+from cti.api.session import get_async_client
 
 async def fetch_data():
-    if async_client:
-        response = await async_client.get(...)
-        return response.json()
+    client = get_async_client()
+    response = await client.get(...)
+    return response.json()
 ```

{clarity_api_sdk_python-0.3.28 → clarity_api_sdk_python-0.3.30}/README.md

@@ -80,10 +80,10 @@ if __name__ == "__main__":
     asyncio.run(main())
 
 # In other modules
-from cti.api.session import async_client
+from cti.api.session import get_async_client
 
 async def fetch_data():
-    if async_client:
-        response = await async_client.get(...)
-        return response.json()
+    client = get_async_client()
+    response = await client.get(...)
+    return response.json()
 ```

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

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

{clarity_api_sdk_python-0.3.28 → clarity_api_sdk_python-0.3.30}/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.28
+Version: 0.3.30
 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
@@ -114,10 +114,10 @@ if __name__ == "__main__":
     asyncio.run(main())
 
 # In other modules
-from cti.api.session import async_client
+from cti.api.session import get_async_client
 
 async def fetch_data():
-    if async_client:
-        response = await async_client.get(...)
-        return response.json()
+    client = get_async_client()
+    response = await client.get(...)
+    return response.json()
 ```

{clarity_api_sdk_python-0.3.28 → clarity_api_sdk_python-0.3.30}/src/cti/api/__init__.py

@@ -2,6 +2,6 @@
 
 from .async_client import ClarityApiAsyncClient
 from .client import ClarityApiClient
-from .session import async_client, initialize_async_client, close_async_client
+from .session import get_async_client, initialize_async_client, close_async_client
 from .sonar_wiz_api import SonarWizApi
 from .sonar_wiz_async_api import SonarWizAsyncApi

clarity_api_sdk_python-0.3.30/src/cti/api/session.py

@@ -0,0 +1,122 @@
+"""Provides event loop-scoped async client instances.
+
+This module uses contextvars to ensure each event loop gets its own
+ClarityApiAsyncClient instance, preventing issues when event loops are
+created/destroyed (common in Dask workers).
+
+Example:
+    # Each asyncio.run() gets its own isolated client
+    async def task():
+        await initialize_async_client()
+        client = get_async_client()
+        response = await client.get(...)
+        await close_async_client()  # Optional, cleans up resources
+
+    # Task 1 - creates client in loop 1
+    asyncio.run(task())
+
+    # Task 2 - creates new client in loop 2
+    asyncio.run(task())
+"""
+
+# pylint: disable=unnecessary-dunder-call
+
+import asyncio
+from contextvars import ContextVar
+from typing import Optional
+
+from cti.api.async_client import ClarityApiAsyncClient
+
+# Context-local storage (isolated per event loop)
+# Stores tuple of (client, loop) to track which loop the client was created in
+_async_client_var: ContextVar[
+    Optional[tuple[ClarityApiAsyncClient, asyncio.AbstractEventLoop]]
+] = ContextVar("clarity_async_client", default=None)
+
+
+def _is_client_valid(
+    client_tuple: Optional[tuple[ClarityApiAsyncClient, asyncio.AbstractEventLoop]],
+    current_loop: asyncio.AbstractEventLoop,
+) -> bool:
+    """Check if client is still valid for the current event loop.
+
+    Args:
+        client_tuple: Tuple of (client, loop) from context storage.
+        current_loop: The current event loop to check against.
+
+    Returns:
+        True if client is valid for the current loop, False otherwise.
+    """
+    if client_tuple is None:
+        return False
+
+    _, stored_loop = client_tuple
+
+    try:
+        # Check if stored loop is the same as current loop and not closed
+        return stored_loop is current_loop and not current_loop.is_closed()
+    except Exception:
+        pass
+    return False
+
+
+async def initialize_async_client() -> None:
+    """Initialize async client for the current event loop context.
+
+    Creates a new client instance if:
+    - No client exists in current context, OR
+    - Existing client is bound to a different (closed) event loop
+
+    This function is idempotent within a single event loop.
+    """
+    current_client_tuple = _async_client_var.get()
+    current_loop = asyncio.get_running_loop()
+
+    # Check if we need a new client
+    needs_new_client = not _is_client_valid(current_client_tuple, current_loop)
+
+    if needs_new_client:
+        # Close old client if it exists
+        if current_client_tuple is not None:
+            old_client, _ = current_client_tuple
+            try:
+                await old_client.__aexit__(None, None, None)
+            except Exception:
+                pass  # Best effort cleanup
+
+        # Create new client for this event loop
+        new_client = ClarityApiAsyncClient()
+        await new_client.__aenter__()
+        _async_client_var.set((new_client, current_loop))
+
+
+def get_async_client() -> ClarityApiAsyncClient:
+    """Get the async client for the current context.
+
+    Returns:
+        ClarityApiAsyncClient instance for this event loop.
+
+    Raises:
+        ValueError: If initialize_async_client() hasn't been called in this context.
+    """
+    client_tuple = _async_client_var.get()
+    if client_tuple is None:
+        raise ValueError(
+            "initialize_async_client() must be called first to initialize client."
+        )
+    client, _ = client_tuple
+    return client
+
+
+async def close_async_client() -> None:
+    """Close the async client for the current context.
+
+    This function should be awaited to ensure the underlying connection
+    pool is closed gracefully. Resources are cleaned up for the current
+    event loop context only.
+    """
+    client_tuple = _async_client_var.get()
+    if client_tuple:
+        client, _ = client_tuple
+        await client.__aexit__(None, None, None)
+        _async_client_var.set(None)

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

@@ -1164,21 +1164,20 @@ class SonarWizApi:
         response.raise_for_status()
         return [SidescanPingSource.model_validate(item) for item in response.json()]
 
-    def create_raw_position(self, position: RawPositionCreate) -> None:
-        """Create a raw position record.
+    def create_raw_positions(self, positions: list[RawPositionCreate]) -> None:
+        """Create raw position records.
 
         Args:
-            position: Raw position creation data.
+            positions: Raw position creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-positions", json=position.model_dump(mode="json")
+            "/api/v1/raw-positions", json=[position.model_dump(mode="json") for position in positions]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_position_created",
+            "raw_positions_created",
             extra={
-                "position_source_id": str(position.position_source_id),
-                "time": str(position.time),
+                "count": len(positions),
             },
         )
 
@@ -1224,21 +1223,20 @@ class SonarWizApi:
         response.raise_for_status()
         return RawPosition.model_validate(response.json())
 
-    def create_raw_attitude(self, attitude: RawAttitudeCreate) -> None:
-        """Create a raw attitude record.
+    def create_raw_attitudes(self, attitudes: list[RawAttitudeCreate]) -> None:
+        """Create raw attitude records.
 
         Args:
-            attitude: Raw attitude creation data.
+            attitudes: Raw attitude creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-attitudes", json=attitude.model_dump(mode="json")
+            "/api/v1/raw-attitudes", json=[attitude.model_dump(mode="json") for attitude in attitudes]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_attitude_created",
+            "raw_attitudes_created",
             extra={
-                "attitude_source_id": str(attitude.attitude_source_id),
-                "time": str(attitude.time),
+                "count": len(attitudes),
             },
         )
 
@@ -1284,16 +1282,22 @@ class SonarWizApi:
         response.raise_for_status()
         return RawAttitude.model_validate(response.json())
 
-    def create_raw_depth(self, depth: RawDepthCreate) -> None:
-        """Create a raw depth record.
+    def create_raw_depths(self, depths: list[RawDepthCreate]) -> None:
+        """Create raw depth records.
 
         Args:
-            depth: Raw depth creation data.
+            depths: Raw depth creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-depths", json=depth.model_dump(mode="json")
+            "/api/v1/raw-depths", json=[depth.model_dump(mode="json") for depth in depths]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_depths_created",
+            extra={
+                "count": len(depths),
+            },
+        )
 
     def get_raw_depth(self, depth_id: UUID | str) -> RawDepth:
         """Get raw depth by ID.
@@ -1694,16 +1698,22 @@ class SonarWizApi:
         response.raise_for_status()
         return [AltitudeSource.model_validate(item) for item in response.json()]
 
-    def create_raw_altitude(self, altitude: RawAltitudeCreate) -> None:
-        """Create a raw altitude record.
+    def create_raw_altitudes(self, altitudes: list[RawAltitudeCreate]) -> None:
+        """Create raw altitude records.
 
         Args:
-            altitude: Raw altitude creation data.
+            altitudes: Raw altitude creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-altitudes", json=altitude.model_dump(mode="json")
+            "/api/v1/raw-altitudes", json=[altitude.model_dump(mode="json") for altitude in altitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_altitudes_created",
+            extra={
+                "count": len(altitudes),
+            },
+        )
 
     def get_raw_altitude(self, altitude_id: UUID | str) -> RawAltitude:
         """Get raw altitude by ID.
@@ -1811,16 +1821,22 @@ class SonarWizApi:
         response.raise_for_status()
         return [LaybackSource.model_validate(item) for item in response.json()]
 
-    def create_raw_layback(self, layback: RawLaybackCreate) -> None:
-        """Create a raw layback record.
+    def create_raw_laybacks(self, laybacks: list[RawLaybackCreate]) -> None:
+        """Create raw layback records.
 
         Args:
-            layback: Raw layback creation data.
+            laybacks: Raw layback creation data.
         """
         response = self._client.post(
-            "/api/v1/raw-laybacks", json=layback.model_dump(mode="json")
+            "/api/v1/raw-laybacks", json=[layback.model_dump(mode="json") for layback in laybacks]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_laybacks_created",
+            extra={
+                "count": len(laybacks),
+            },
+        )
 
     def get_raw_layback(self, layback_id: UUID | str) -> RawLayback:
         """Get raw layback by ID.
@@ -2468,18 +2484,24 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessingLog.model_validate(response.json())
 
-    def create_processed_altitude(
-        self, altitude: ProcessedAltitudeCreate
+    def create_processed_altitudes(
+        self, altitudes: list[ProcessedAltitudeCreate]
     ) -> None:
-        """Create a processed altitude record.
+        """Create processed altitude records.
 
         Args:
-            altitude: Processed altitude creation data.
+            altitudes: Processed altitude creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-altitudes", json=altitude.model_dump(mode="json")
+            "/api/v1/processed-altitudes", json=[altitude.model_dump(mode="json") for altitude in altitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_altitudes_created",
+            extra={
+                "count": len(altitudes),
+            },
+        )
 
     def get_processed_altitude(
         self, altitude_id: UUID | str
@@ -2525,18 +2547,24 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessedAltitude.model_validate(response.json())
 
-    def create_processed_attitude(
-        self, attitude: ProcessedAttitudeCreate
+    def create_processed_attitudes(
+        self, attitudes: list[ProcessedAttitudeCreate]
     ) -> None:
-        """Create a processed attitude record.
+        """Create processed attitude records.
 
         Args:
-            attitude: Processed attitude creation data.
+            attitudes: Processed attitude creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-attitudes", json=attitude.model_dump(mode="json")
+            "/api/v1/processed-attitudes", json=[attitude.model_dump(mode="json") for attitude in attitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_attitudes_created",
+            extra={
+                "count": len(attitudes),
+            },
+        )
 
     def get_processed_attitude(
         self, attitude_id: UUID | str
@@ -2582,16 +2610,22 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessedAttitude.model_validate(response.json())
 
-    def create_processed_depth(self, depth: ProcessedDepthCreate) -> None:
-        """Create a processed depth record.
+    def create_processed_depths(self, depths: list[ProcessedDepthCreate]) -> None:
+        """Create processed depth records.
 
         Args:
-            depth: Processed depth creation data.
+            depths: Processed depth creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-depths", json=depth.model_dump(mode="json")
+            "/api/v1/processed-depths", json=[depth.model_dump(mode="json") for depth in depths]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_depths_created",
+            extra={
+                "count": len(depths),
+            },
+        )
 
     def get_processed_depth(self, depth_id: UUID | str) -> ProcessedDepth:
         """Get processed depth by ID.
@@ -2635,16 +2669,22 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessedDepth.model_validate(response.json())
 
-    def create_processed_layback(self, layback: ProcessedLaybackCreate) -> None:
-        """Create a processed layback record.
+    def create_processed_laybacks(self, laybacks: list[ProcessedLaybackCreate]) -> None:
+        """Create processed layback records.
 
         Args:
-            layback: Processed layback creation data.
+            laybacks: Processed layback creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-laybacks", json=layback.model_dump(mode="json")
+            "/api/v1/processed-laybacks", json=[layback.model_dump(mode="json") for layback in laybacks]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_laybacks_created",
+            extra={
+                "count": len(laybacks),
+            },
+        )
 
     def get_processed_layback(self, layback_id: UUID | str) -> ProcessedLayback:
         """Get processed layback by ID.
@@ -2688,18 +2728,24 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessedLayback.model_validate(response.json())
 
-    def create_processed_position(
-        self, position: ProcessedPositionCreate
+    def create_processed_positions(
+        self, positions: list[ProcessedPositionCreate]
     ) -> None:
-        """Create a processed position record.
+        """Create processed position records.
 
         Args:
-            position: Processed position creation data.
+            positions: Processed position creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-positions", json=position.model_dump(mode="json")
+            "/api/v1/processed-positions", json=[position.model_dump(mode="json") for position in positions]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_positions_created",
+            extra={
+                "count": len(positions),
+            },
+        )
 
     def get_processed_position(
         self, position_id: UUID | str
@@ -2745,18 +2791,24 @@ class SonarWizApi:
         response.raise_for_status()
         return ProcessedPosition.model_validate(response.json())
 
-    def create_processed_sidescan_ping(
-        self, ping: ProcessedSidescanPingCreate
+    def create_processed_sidescan_pings(
+        self, pings: list[ProcessedSidescanPingCreate]
     ) -> None:
-        """Create a processed sidescan ping record.
+        """Create processed sidescan ping records.
 
         Args:
-            ping: Processed sidescan ping creation data.
+            pings: Processed sidescan ping creation data.
         """
         response = self._client.post(
-            "/api/v1/processed-sidescan-pings", json=ping.model_dump(mode="json")
+            "/api/v1/processed-sidescan-pings", json=[ping.model_dump(mode="json") for ping in pings]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_sidescan_pings_created",
+            extra={
+                "count": len(pings),
+            },
+        )
 
     def get_processed_sidescan_ping(
         self, ping_id: UUID | str

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

@@ -1174,21 +1174,20 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return [SidescanPingSource.model_validate(item) for item in response.json()]
 
-    async def create_raw_position(self, position: RawPositionCreate) -> None:
-        """Create a raw position record.
+    async def create_raw_positions(self, positions: list[RawPositionCreate]) -> None:
+        """Create raw position records.
 
         Args:
-            position: Raw position creation data.
+            positions: Raw position creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-positions", json=position.model_dump(mode="json")
+            "/api/v1/raw-positions", json=[position.model_dump(mode="json") for position in positions]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_position_created",
+            "raw_positions_created",
             extra={
-                "position_source_id": str(position.position_source_id),
-                "time": str(position.time),
+                "count": len(positions),
             },
         )
 
@@ -1234,21 +1233,20 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return RawPosition.model_validate(response.json())
 
-    async def create_raw_attitude(self, attitude: RawAttitudeCreate) -> None:
-        """Create a raw attitude record.
+    async def create_raw_attitudes(self, attitudes: list[RawAttitudeCreate]) -> None:
+        """Create raw attitude records.
 
         Args:
-            attitude: Raw attitude creation data.
+            attitudes: Raw attitude creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-attitudes", json=attitude.model_dump(mode="json")
+            "/api/v1/raw-attitudes", json=[attitude.model_dump(mode="json") for attitude in attitudes]
         )
         response.raise_for_status()
         logger.debug(
-            "raw_attitude_created",
+            "raw_attitudes_created",
             extra={
-                "attitude_source_id": str(attitude.attitude_source_id),
-                "time": str(attitude.time),
+                "count": len(attitudes),
             },
         )
 
@@ -1294,16 +1292,22 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return RawAttitude.model_validate(response.json())
 
-    async def create_raw_depth(self, depth: RawDepthCreate) -> None:
-        """Create a raw depth record.
+    async def create_raw_depths(self, depths: list[RawDepthCreate]) -> None:
+        """Create raw depth records.
 
         Args:
-            depth: Raw depth creation data.
+            depths: Raw depth creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-depths", json=depth.model_dump(mode="json")
+            "/api/v1/raw-depths", json=[depth.model_dump(mode="json") for depth in depths]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_depths_created",
+            extra={
+                "count": len(depths),
+            },
+        )
 
     async def get_raw_depth(self, depth_id: UUID | str) -> RawDepth:
         """Get raw depth by ID.
@@ -1704,16 +1708,22 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return [AltitudeSource.model_validate(item) for item in response.json()]
 
-    async def create_raw_altitude(self, altitude: RawAltitudeCreate) -> None:
-        """Create a raw altitude record.
+    async def create_raw_altitudes(self, altitudes: list[RawAltitudeCreate]) -> None:
+        """Create raw altitude records.
 
         Args:
-            altitude: Raw altitude creation data.
+            altitudes: Raw altitude creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-altitudes", json=altitude.model_dump(mode="json")
+            "/api/v1/raw-altitudes", json=[altitude.model_dump(mode="json") for altitude in altitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_altitudes_created",
+            extra={
+                "count": len(altitudes),
+            },
+        )
 
     async def get_raw_altitude(self, altitude_id: UUID | str) -> RawAltitude:
         """Get raw altitude by ID.
@@ -1821,16 +1831,22 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return [LaybackSource.model_validate(item) for item in response.json()]
 
-    async def create_raw_layback(self, layback: RawLaybackCreate) -> None:
-        """Create a raw layback record.
+    async def create_raw_laybacks(self, laybacks: list[RawLaybackCreate]) -> None:
+        """Create raw layback records.
 
         Args:
-            layback: Raw layback creation data.
+            laybacks: Raw layback creation data.
         """
         response = await self._client.post(
-            "/api/v1/raw-laybacks", json=layback.model_dump(mode="json")
+            "/api/v1/raw-laybacks", json=[layback.model_dump(mode="json") for layback in laybacks]
         )
         response.raise_for_status()
+        logger.debug(
+            "raw_laybacks_created",
+            extra={
+                "count": len(laybacks),
+            },
+        )
 
     async def get_raw_layback(self, layback_id: UUID | str) -> RawLayback:
         """Get raw layback by ID.
@@ -2478,18 +2494,24 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessingLog.model_validate(response.json())
 
-    async def create_processed_altitude(
-        self, altitude: ProcessedAltitudeCreate
+    async def create_processed_altitudes(
+        self, altitudes: list[ProcessedAltitudeCreate]
     ) -> None:
-        """Create a processed altitude record.
+        """Create processed altitude records.
 
         Args:
-            altitude: Processed altitude creation data.
+            altitudes: Processed altitude creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-altitudes", json=altitude.model_dump(mode="json")
+            "/api/v1/processed-altitudes", json=[altitude.model_dump(mode="json") for altitude in altitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_altitudes_created",
+            extra={
+                "count": len(altitudes),
+            },
+        )
 
     async def get_processed_altitude(
         self, altitude_id: UUID | str
@@ -2535,18 +2557,24 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessedAltitude.model_validate(response.json())
 
-    async def create_processed_attitude(
-        self, attitude: ProcessedAttitudeCreate
+    async def create_processed_attitudes(
+        self, attitudes: list[ProcessedAttitudeCreate]
     ) -> None:
-        """Create a processed attitude record.
+        """Create processed attitude records.
 
         Args:
-            attitude: Processed attitude creation data.
+            attitudes: Processed attitude creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-attitudes", json=attitude.model_dump(mode="json")
+            "/api/v1/processed-attitudes", json=[attitude.model_dump(mode="json") for attitude in attitudes]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_attitudes_created",
+            extra={
+                "count": len(attitudes),
+            },
+        )
 
     async def get_processed_attitude(
         self, attitude_id: UUID | str
@@ -2592,16 +2620,22 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessedAttitude.model_validate(response.json())
 
-    async def create_processed_depth(self, depth: ProcessedDepthCreate) -> None:
-        """Create a processed depth record.
+    async def create_processed_depths(self, depths: list[ProcessedDepthCreate]) -> None:
+        """Create processed depth records.
 
         Args:
-            depth: Processed depth creation data.
+            depths: Processed depth creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-depths", json=depth.model_dump(mode="json")
+            "/api/v1/processed-depths", json=[depth.model_dump(mode="json") for depth in depths]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_depths_created",
+            extra={
+                "count": len(depths),
+            },
+        )
 
     async def get_processed_depth(self, depth_id: UUID | str) -> ProcessedDepth:
         """Get processed depth by ID.
@@ -2645,16 +2679,22 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessedDepth.model_validate(response.json())
 
-    async def create_processed_layback(self, layback: ProcessedLaybackCreate) -> None:
-        """Create a processed layback record.
+    async def create_processed_laybacks(self, laybacks: list[ProcessedLaybackCreate]) -> None:
+        """Create processed layback records.
 
         Args:
-            layback: Processed layback creation data.
+            laybacks: Processed layback creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-laybacks", json=layback.model_dump(mode="json")
+            "/api/v1/processed-laybacks", json=[layback.model_dump(mode="json") for layback in laybacks]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_laybacks_created",
+            extra={
+                "count": len(laybacks),
+            },
+        )
 
     async def get_processed_layback(self, layback_id: UUID | str) -> ProcessedLayback:
         """Get processed layback by ID.
@@ -2698,18 +2738,24 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessedLayback.model_validate(response.json())
 
-    async def create_processed_position(
-        self, position: ProcessedPositionCreate
+    async def create_processed_positions(
+        self, positions: list[ProcessedPositionCreate]
     ) -> None:
-        """Create a processed position record.
+        """Create processed position records.
 
         Args:
-            position: Processed position creation data.
+            positions: Processed position creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-positions", json=position.model_dump(mode="json")
+            "/api/v1/processed-positions", json=[position.model_dump(mode="json") for position in positions]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_positions_created",
+            extra={
+                "count": len(positions),
+            },
+        )
 
     async def get_processed_position(
         self, position_id: UUID | str
@@ -2755,18 +2801,24 @@ class SonarWizAsyncApi:
         response.raise_for_status()
         return ProcessedPosition.model_validate(response.json())
 
-    async def create_processed_sidescan_ping(
-        self, ping: ProcessedSidescanPingCreate
+    async def create_processed_sidescan_pings(
+        self, pings: list[ProcessedSidescanPingCreate]
     ) -> None:
-        """Create a processed sidescan ping record.
+        """Create processed sidescan ping records.
 
         Args:
-            ping: Processed sidescan ping creation data.
+            pings: Processed sidescan ping creation data.
         """
         response = await self._client.post(
-            "/api/v1/processed-sidescan-pings", json=ping.model_dump(mode="json")
+            "/api/v1/processed-sidescan-pings", json=[ping.model_dump(mode="json") for ping in pings]
         )
         response.raise_for_status()
+        logger.debug(
+            "processed_sidescan_pings_created",
+            extra={
+                "count": len(pings),
+            },
+        )
 
     async def get_processed_sidescan_ping(
         self, ping_id: UUID | str

clarity_api_sdk_python-0.3.28/src/cti/api/session.py

@@ -1,76 +0,0 @@
-"""Provides a shared, singleton instance of the ClarityApiAsyncClient.
-
-This module allows for a single, reusable async client to be initialized
-and accessed throughout the application, promoting connection reuse and
-efficiency. The client should be initialized at application startup
-and closed gracefully on shutdown.
-
-Example:
-    # In your main application entry point
-    import asyncio
-    from cti.api.session import initialize_async_client, close_async_client
-
-    async def main():
-        await initialize_async_client()
-        # ... your application logic ...
-        await close_async_client()
-
-    if __name__ == "__main__":
-        asyncio.run(main())
-
-    # In other modules
-    from cti.api.session import get_async_client
-
-    async def fetch_data():
-        response = await get_async_client().get(...)
-        return response.json()
-"""
-
-# pylint: disable=global-statement, unnecessary-dunder-call
-
-from cti.api.async_client import ClarityApiAsyncClient
-
-# The singleton instance, initially None.
-async_client: ClarityApiAsyncClient | None = None
-
-
-async def initialize_async_client() -> None:
-    """Initializes the shared ClarityApiAsyncClient instance.
-
-    If the client is already initialized, this function does nothing.
-    This function should be awaited at application startup.
-    """
-    global async_client
-    if async_client is None:
-        async_client = ClarityApiAsyncClient()
-        await async_client.__aenter__()
-
-
-def get_async_client() -> ClarityApiAsyncClient:
-    """Returns the shared ClarityApiAsyncClient instance.
-
-    If the client is not initialized, this function initializes it first.
-
-    Returns:
-        ClarityApiAsyncClient: The shared ClarityApiAsyncClient instance.
-
-    Raises:
-        ValueError: If initialize_async_client() has not been called first.
-    """
-    if async_client is None:
-        raise ValueError(
-            "initialize_async_client() must be called first to initialize client."
-        )
-    return async_client
-
-
-async def close_async_client() -> None:
-    """Closes the shared ClarityApiAsyncClient instance.
-
-    This function should be awaited at application shutdown to ensure
-    the underlying connection pool is closed gracefully.
-    """
-    global async_client
-    if async_client:
-        await async_client.__aexit__(None, None, None)
-        async_client = None