ul-data-logger-api-sdk 3.2.0__tar.gz → 3.3.1__tar.gz

{ul_data_logger_api_sdk-3.2.0 → ul_data_logger_api_sdk-3.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ul-data-logger-api-sdk
-Version: 3.2.0
+Version: 3.3.1
 Summary: Data logger API sdk
 Author: Unic-lab
 License-Expression: MIT

{ul_data_logger_api_sdk-3.2.0 → ul_data_logger_api_sdk-3.3.1}/data_logger_api_sdk.py

@@ -17,6 +17,7 @@ from data_logger_api_sdk.types.api_base_stations import (
     ApiBaseStationDevicesResponse,
     ApiBaseStationLogsStatForIntervalsResponse,
     ApiBaseStationLogsStatResponse,
+    ApiBaseStationLogDetailResponse,
     ApiBaseStationLogResponse,
     ApiBaseStationLogsListResult,
     ApiBaseStationsListResult,
@@ -194,13 +195,21 @@ class DataLoggerApiSdk:
         self,
         base_station_id: UUID,
         log_stat_days: int = 0,
+        exclude_log_types: List[str] | None = None,
     ) -> ApiBaseStationDetailResponse:
-        """GET /base-stations/<uuid> — карточка базовой станции Data Logger."""
+        """GET /base-stations/<uuid> — карточка базовой станции Data Logger.
+
+        exclude_log_types исключает типы из logs_stat (например, ['heartbit']);
+        без него счётчики включают служебные heartbeat-логи.
+        """
+        query: Dict[str, Any] = {"log_stat_days": log_stat_days}
+        if exclude_log_types:
+            query["exclude_log_types"] = exclude_log_types
         return self._request_payload_once(
             ApiMethod.GET,
             f"/base-stations/{base_station_id}",
             ApiBaseStationDetailResponse,
-            {"log_stat_days": log_stat_days},
+            query,
         )
 
     def get_base_station_logs(
@@ -235,6 +244,18 @@ class DataLoggerApiSdk:
         )
         return ApiBaseStationLogsListResult(items=items, total_count=total_count)
 
+    def get_base_station_log(
+        self,
+        base_station_id: UUID,
+        log_id: UUID,
+    ) -> ApiBaseStationLogDetailResponse:
+        """GET /base-stations/<uuid>/logs/<uuid> — конкретный лог БС с сырым JSON пакета."""
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/logs/{log_id}",
+            ApiBaseStationLogDetailResponse,
+        )
+
     def get_base_station_system_logs(
         self,
         base_station_id: UUID,
@@ -261,13 +282,20 @@ class DataLoggerApiSdk:
         self,
         base_station_id: UUID,
         day: date,
+        exclude_log_types: List[str] | None = None,
     ) -> ApiBaseStationLogsStatResponse:
-        """GET /base-stations/<uuid>/logs-stat — статистика логов базовой станции за сутки."""
+        """GET /base-stations/<uuid>/logs-stat — статистика логов базовой станции за сутки.
+
+        exclude_log_types исключает типы из поминутных счётчиков (['heartbit'] прячет heartbeat).
+        """
+        query: Dict[str, Any] = {"day": day.isoformat()}
+        if exclude_log_types:
+            query["exclude_log_types"] = exclude_log_types
         return self._request_payload_once(
             ApiMethod.GET,
             f"/base-stations/{base_station_id}/logs-stat",
             ApiBaseStationLogsStatResponse,
-            {"day": day.isoformat()},
+            query,
         )
 
     def get_base_station_device_logs_stat(

{ul_data_logger_api_sdk-3.2.0 → ul_data_logger_api_sdk-3.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ul-data-logger-api-sdk"
-version = "3.2.0"
+version = "3.3.1"
 description = "Data logger API sdk"
 license = "MIT"
 requires-python = ">=3.14"

{ul_data_logger_api_sdk-3.2.0 → ul_data_logger_api_sdk-3.3.1}/types/api_base_stations.py

@@ -84,6 +84,12 @@ class ApiBaseStationLogResponse(JsonApiResponsePayload):
     external_document_id: UUID4 | None = None
 
 
+class ApiBaseStationLogDetailResponse(ApiBaseStationLogResponse):
+    """Ответ GET /base-stations/<uuid>/logs/<uuid> — лог с сырым JSON пакета (ApiBsLogDetailResponse в DL)."""
+
+    data: Dict[str, Any] | None = None
+
+
 class ApiBaseStationSystemLogResponse(JsonApiResponsePayload):
     """Элемент ответа GET /base-stations/<uuid>/system-logs (ApiBsSystemLogsResponse)."""