ul-data-logger-api-sdk 2.0.6__tar.gz → 3.1.1__tar.gz

ul_data_logger_api_sdk-3.1.1/.gitignore

@@ -0,0 +1,299 @@
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+/srv/ci-build/requirements.txt
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+staticfiles/
+
+# PyBuilder
+target/
+
+# celery beat schedule file
+celerybeat-schedule
+
+# Environments
+.venv
+venv/
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+### Node template
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+
+### Linux template
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+
+### VisualStudioCode template
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+
+
+
+
+### Windows template
+# Windows thumbnail cache files
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+
+### macOS template
+# General
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+
+### SublimeText template
+# Cache files for Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# Workspace files are user-specific
+*.sublime-workspace
+
+# Project files should be checked into the repository, unless a significant
+# proportion of contributors will probably not be using Sublime Text
+# *.sublime-project
+
+# SFTP configuration file
+sftp-config.json
+
+# Package control specific files
+Package Control.last-run
+Package Control.ca-list
+Package Control.ca-bundle
+Package Control.system-ca-bundle
+Package Control.cache/
+Package Control.ca-certs/
+Package Control.merged-ca-bundle
+Package Control.user-ca-bundle
+oscrypto-ca-bundle.crt
+bh_unicode_properties.cache
+
+# Sublime-github package stores a github token in this file
+# https://packagecontrol.io/packages/sublime-github
+GitHub.sublime-settings
+
+
+### Vim template
+# Swap
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-v][a-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+
+# Temporary
+.netrwhist
+
+# Auto-generated tag files
+tags
+
+
+### Project template
+
+.pytest_cache/
+
+
+.ipython/
+.envs/*
+!.envs/.local/
+!srv/merge_dotenvs.py
+*.env
+
+
+.ipynb_checkpoints/
+.idea/
+__pycache__
+venv
+.*.ipynb
+_*.ipynb
+.ipynb_checkpoints
+.history/
+.var/
+.tmp/
+*.orig
+*.zip
+*.bz2
+*.gz
+*.xz
+
+/srv/*.retry
+
+# Локальный overlay для demo-стенда (пароли, адреса Patroni)
+srv/docker_compose/docker-compose.demo.yml
+
+# Swagger spec
+/src/conf/*docs.yml

ul_data_logger_api_sdk-3.1.1/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.5
+Name: ul-data-logger-api-sdk
+Version: 3.1.1
+Summary: Data logger API sdk
+Author: Unic-lab
+License-Expression: MIT
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Requires-Dist: ul-unipipeline>=2.0.0

ul_data_logger_api_sdk-3.1.1/data_logger_api_sdk.py

@@ -0,0 +1,316 @@
+import json
+import time
+from datetime import date, datetime
+from functools import lru_cache
+from typing import Any, Dict, List, Type
+from uuid import UUID
+
+from ul_api_utils.internal_api.internal_api import InternalApi
+from ul_api_utils.internal_api.internal_api_response import TPyloadType
+from ul_api_utils.utils.api_method import ApiMethod
+
+from data_logger_api_sdk.data_logger_sdk_config import DataLoggerApiSdkConfig
+from data_logger_api_sdk.types.api_base_stations import (
+    ApiBaseStationDetailResponse,
+    ApiBaseStationDeviceLogsResponse,
+    ApiBaseStationDevicesResponse,
+    ApiBaseStationLogsStatForIntervalsResponse,
+    ApiBaseStationLogsStatResponse,
+    ApiBaseStationLogResponse,
+    ApiBaseStationLogsListResult,
+    ApiBaseStationsListResult,
+    ApiBaseStationResponse,
+    ApiBaseStationSystemLogResponse,
+    ApiBaseStationSystemLogsListResult,
+)
+from data_logger_api_sdk.types.api_bs_traffic_stats import ApiBsTrafficStatsResponse, ApiDeviceTrafficStatsQuery
+from data_logger_api_sdk.types.api_device_data_history import ApiDeviceDataHistoryBody, ApiDeviceDataHistoryResponse
+from data_logger_api_sdk.types.api_last_bs_data_by_device_macs import ApiDeviceLastBsDataResponse, ApiDeviceMacsListBodyModel
+from data_logger_api_sdk.types.api_packet_types import ApiPacketTypesListResponse
+from data_logger_api_sdk.types.api_protocol_types import ApiProtocolTypesListResponse
+
+
+class DataLoggerApiSdk:
+
+    def __init__(self, config: DataLoggerApiSdkConfig) -> None:
+        self._config = config
+        self._api = InternalApi(entry_point=self._config.api_url, default_auth_token=self._config.api_token)
+
+    @lru_cache(maxsize=None)  # there should not be leaks memory leaks. flake8 just scared inmemory cache ;)
+    def request_payload(
+        self,
+        _: int,
+        method: ApiMethod,
+        endpoint: str,
+        typed_as: Type[TPyloadType],
+        body: str | None,
+        query: str | None = None,
+    ) -> TPyloadType:
+        return (
+            self._api.request(
+                method=method,
+                path=endpoint,
+                json=json.loads(body) if body is not None else None,
+                q=json.loads(query) if query is not None else None,
+            )
+            .typed(typed_as)
+            .check()
+            .payload
+        )
+
+    def _get_cache_post_payload(
+        self,
+        method: ApiMethod,
+        path: str,
+        typed: Type[TPyloadType],
+        body: str | None = None,
+        query: str | None = None,
+    ) -> TPyloadType:
+        ttl_status = round(time.time() / self._config.cache_ttl_s)
+        return self.request_payload(ttl_status, method, path, typed, body, query)  # type: ignore  # Type[TPyloadType] is hashable
+
+    def _request_payload_once(
+        self,
+        method: ApiMethod,
+        path: str,
+        typed: Type[TPyloadType],
+        query: Dict[str, Any] | None = None,
+    ) -> TPyloadType:
+        response = self._api.request(
+            method=method,
+            path=path,
+            json=None,
+            q=query,
+        ).typed(typed).check()
+        return response.payload
+
+    def _request_list_payload_once(
+        self,
+        method: ApiMethod,
+        path: str,
+        typed: Type[TPyloadType],
+        query: Dict[str, Any] | None = None,
+    ) -> tuple[TPyloadType, int]:
+        response = self._api.request(
+            method=method,
+            path=path,
+            json=None,
+            q=query,
+        ).typed(typed).check()
+        total_count = response.total_count
+        assert total_count is not None, "total_count must be present for array payloads"
+        return response.payload, total_count
+
+    def get_protocol_types_list(self, mac: int) -> List[str]:
+        return self._get_cache_post_payload(
+            ApiMethod.GET,
+            f"/devices/mac/{mac}/logs/protocol-types",
+            ApiProtocolTypesListResponse,
+        ).protocol_types
+
+    def get_packet_types_list(self, mac: int) -> List[str]:
+        return self._get_cache_post_payload(
+            ApiMethod.GET,
+            f"/devices/mac/{mac}/logs/packet-types",
+            ApiPacketTypesListResponse,
+        ).packet_types
+
+    def get_device_data_history(
+        self,
+        period_from: datetime,
+        period_to: datetime,
+        mac: int,
+        protocol_type: str | None = None,
+        packet_type: str | None = None,
+    ) -> List[ApiDeviceDataHistoryResponse]:
+        api_device_history_body = ApiDeviceDataHistoryBody(
+            period_from=period_from,
+            period_to=period_to,
+            mac=mac,
+            protocol_type=protocol_type,
+            packet_type=packet_type,
+        ).model_dump_json()
+        return self._get_cache_post_payload(
+            ApiMethod.POST,
+            "/device-data-history",
+            List[ApiDeviceDataHistoryResponse],  # type: ignore
+            api_device_history_body,
+        )
+
+    def get_last_bs_data_by_device_macs(
+        self,
+        macs: set[int],
+    ) -> List[ApiDeviceLastBsDataResponse]:
+        return self._get_cache_post_payload(
+            ApiMethod.POST,
+            "/devices/last-bs-data",
+            List[ApiDeviceLastBsDataResponse],  # type: ignore
+            ApiDeviceMacsListBodyModel(macs=macs).model_dump_json(),
+        )
+
+    def get_bs_traffic_stats(
+        self,
+        base_station_id: UUID,
+        start_at: datetime,
+        end_at: datetime,
+    ) -> List[ApiBsTrafficStatsResponse]:
+        api_bs_traffic_stats_query = ApiDeviceTrafficStatsQuery(
+            start_at=start_at,
+            end_at=end_at,
+        )
+        return self._get_cache_post_payload(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/traffic-stats",
+            List[ApiBsTrafficStatsResponse],  # type: ignore
+            None,
+            api_bs_traffic_stats_query.model_dump_json(),
+        )
+
+    def get_base_stations(
+        self,
+        limit: int,
+        offset: int = 0,
+        serial_number: int | None = None,
+        log_stat_days: int = 0,
+    ) -> ApiBaseStationsListResult:
+        """GET /base-stations — список базовых станций Data Logger."""
+        query: Dict[str, Any] = {
+            "limit": limit,
+            "offset": offset,
+            "log_stat_days": log_stat_days,
+        }
+        if serial_number is not None:
+            query["serial_number"] = serial_number
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            "/base-stations",
+            List[ApiBaseStationResponse],  # type: ignore
+            query,
+        )
+        return ApiBaseStationsListResult(items=items, total_count=total_count)
+
+    def get_base_station(
+        self,
+        base_station_id: UUID,
+        log_stat_days: int = 0,
+    ) -> ApiBaseStationDetailResponse:
+        """GET /base-stations/<uuid> — карточка базовой станции Data Logger."""
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}",
+            ApiBaseStationDetailResponse,
+            {"log_stat_days": log_stat_days},
+        )
+
+    def get_base_station_logs(
+        self,
+        base_station_id: UUID,
+        start_at: datetime | None = None,
+        end_at: datetime | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> ApiBaseStationLogsListResult:
+        """GET /base-stations/<uuid>/logs — журнал логов базовой станции."""
+        query: Dict[str, Any] = {"limit": limit, "offset": offset}
+        if start_at is not None:
+            query["start_at"] = start_at.isoformat()
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/logs",
+            List[ApiBaseStationLogResponse],  # type: ignore
+            query,
+        )
+        return ApiBaseStationLogsListResult(items=items, total_count=total_count)
+
+    def get_base_station_system_logs(
+        self,
+        base_station_id: UUID,
+        start_at: datetime | None = None,
+        end_at: datetime | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> ApiBaseStationSystemLogsListResult:
+        """GET /base-stations/<uuid>/system-logs — журнал системных логов базовой станции."""
+        query: Dict[str, Any] = {"limit": limit, "offset": offset}
+        if start_at is not None:
+            query["start_at"] = start_at.isoformat()
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/system-logs",
+            List[ApiBaseStationSystemLogResponse],  # type: ignore
+            query,
+        )
+        return ApiBaseStationSystemLogsListResult(items=items, total_count=total_count)
+
+    def get_base_station_logs_stat(
+        self,
+        base_station_id: UUID,
+        day: date,
+    ) -> ApiBaseStationLogsStatResponse:
+        """GET /base-stations/<uuid>/logs-stat — статистика логов базовой станции за сутки."""
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/logs-stat",
+            ApiBaseStationLogsStatResponse,
+            {"day": day.isoformat()},
+        )
+
+    def get_base_station_logs_stat_for_intervals(
+        self,
+        base_station_id: UUID,
+        start_at: datetime,
+        end_at: datetime | None = None,
+    ) -> ApiBaseStationLogsStatForIntervalsResponse:
+        """GET /base-stations/<uuid>/logs-stat-for-intervals — метки времени логов за интервал."""
+        query: Dict[str, Any] = {"start_at": start_at.isoformat()}
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/logs-stat-for-intervals",
+            ApiBaseStationLogsStatForIntervalsResponse,
+            query,
+        )
+
+    def get_base_station_devices(
+        self,
+        base_station_id: UUID,
+        start_at: datetime,
+        end_at: datetime | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> ApiBaseStationDevicesResponse:
+        """GET /base-stations/<uuid>/devices — устройства, работающие через базовую станцию."""
+        query: Dict[str, Any] = {"start_at": start_at.isoformat(), "limit": limit, "offset": offset}
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/devices",
+            ApiBaseStationDevicesResponse,
+            query,
+        )
+
+    def get_base_station_device_logs(
+        self,
+        base_station_id: UUID,
+        start_at: datetime,
+        end_at: datetime | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> ApiBaseStationDeviceLogsResponse:
+        """GET /base-stations/<uuid>/device-logs — логи устройств базовой станции."""
+        query: Dict[str, Any] = {"start_at": start_at.isoformat(), "limit": limit, "offset": offset}
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        return self._request_payload_once(
+            ApiMethod.GET,
+            f"/base-stations/{base_station_id}/device-logs",
+            ApiBaseStationDeviceLogsResponse,
+            query,
+        )
+

ul_data_logger_api_sdk-3.1.1/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ul-data-logger-api-sdk"
+version = "3.1.1"
+description = "Data logger API sdk"
+license = "MIT"
+requires-python = ">=3.14"
+authors = [{ name = "Unic-lab" }]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "ul-unipipeline>=2.0.0",
+]
+
+[tool.hatch.build]
+include = ["**/*.py", "**/*.yml", "**/py.typed"]
+exclude = ["dist/**", "*.egg-info/**", ".gitignore", "PKG-INFO", "pyproject.toml"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+
+[tool.hatch.build.targets.wheel.sources]
+"." = "data_logger_api_sdk"
+
+[[tool.uv.index]]
+url = "https://pip-cache.dev-unic-lab.by/repository/pip-cache/simple"
+default = true

ul_data_logger_api_sdk-3.1.1/types/api_base_stations.py

@@ -0,0 +1,184 @@
+from datetime import datetime
+from typing import Any, Dict, List, NamedTuple, Tuple
+
+from pydantic.types import UUID4
+from ul_api_utils.api_resource.api_response import JsonApiResponsePayload
+
+BS__LOG_TYPE__DEVICE_DATA = "device_data"
+BS__LOG_TYPE__HEARTBIT = "heartbit"
+
+
+class ApiBaseStationsListResult(NamedTuple):
+    """Результат спискового вызова BS-endpoint Data Logger: страница элементов и total_count."""
+
+    items: List["ApiBaseStationResponse"]
+    total_count: int
+
+
+class ApiBaseStationLogsListResult(NamedTuple):
+    """Результат вызова GET /base-stations/<uuid>/logs."""
+
+    items: List["ApiBaseStationLogResponse"]
+    total_count: int
+
+
+class ApiBaseStationSystemLogsListResult(NamedTuple):
+    """Результат вызова GET /base-stations/<uuid>/system-logs."""
+
+    items: List["ApiBaseStationSystemLogResponse"]
+    total_count: int
+
+
+class ApiBaseStationResponse(JsonApiResponsePayload):
+    """Элемент ответа GET /base-stations (BsListShortResponse на стороне Data Logger)."""
+
+    id: UUID4
+    date_created: datetime
+    date_modified: datetime
+    is_alive: bool
+
+    api_user_modified_id: UUID4 | None = None
+    note: str = ""
+    permission_id: int
+
+    type: str
+    serial_number: int
+
+    latest_log_datetime: datetime | None = None
+    latest_geo_latitude: float | None = None
+    latest_geo_longitude: float | None = None
+    latest_soft_version: str | None = None
+    latest_geo_is_actual: bool | None = None
+    latest_sdr_config_id: UUID4 | None = None
+
+    logs_stat: List[Tuple[datetime, int]] | None = None
+
+
+class ApiBaseStationDetailResponse(ApiBaseStationResponse):
+    """Ответ GET /base-stations/<uuid> (BsResponse на стороне Data Logger)."""
+
+    latest_sdr_config: Dict[str, Any] | None = None
+    device_counts: List[Tuple[datetime, int]] | None = None
+    system_logs_stat: List[Tuple[datetime, int]] | None = None
+    environment_spectrums_stat: List[Tuple[datetime, int]] | None = None
+    sdr_config_data_list: List[Dict[str, Any] | None] | None = None
+
+
+class ApiBaseStationLogResponse(JsonApiResponsePayload):
+    """Элемент ответа GET /base-stations/<uuid>/logs (ApiBsLogsResponse на стороне Data Logger)."""
+
+    id: UUID4
+    date_created: datetime
+
+    bs_id: UUID4 | None = None
+    protocol: str | None = None
+    log_type: str
+
+    date_sending: datetime
+
+    latitude: float | None = None
+    longitude: float | None = None
+    soft_version: str | None = None
+    uptime_s: int | None = None
+
+    external_document_id: UUID4 | None = None
+
+
+class ApiBaseStationSystemLogResponse(JsonApiResponsePayload):
+    """Элемент ответа GET /base-stations/<uuid>/system-logs (ApiBsSystemLogsResponse)."""
+
+    id: UUID4
+    date_created: datetime
+
+    bs_id: UUID4 | None = None
+    bs_log_id: UUID4 | None = None
+    date: datetime
+    type: str
+    mdl: str | None = None
+    text: str | None = None
+
+
+class ApiBaseStationLogsStatResponse(JsonApiResponsePayload):
+    """Ответ GET /base-stations/<uuid>/logs-stat (ApiBsLogsStatResponse)."""
+
+    stats: List[Tuple[datetime, int]]
+
+
+class ApiBaseStationLogsStatForIntervalsResponse(JsonApiResponsePayload):
+    """Ответ GET /base-stations/<uuid>/logs-stat-for-intervals (ApiBsLogsStatForIntervalsGraphResponse)."""
+
+    stats: List[datetime]
+
+
+class ApiBaseStationDeviceResponse(JsonApiResponsePayload):
+    """Элемент devices ответа GET /base-stations/<uuid>/devices (ApiDeviceResponse без вложенной БС)."""
+
+    id: UUID4
+    date_created: datetime
+    date_modified: datetime
+    is_alive: bool
+
+    api_user_modified_id: UUID4
+    note: str
+
+    device_id: UUID4
+    device_network_id: UUID4
+    device_network_mac: int
+
+    latest_device_gateway_id: UUID4 | None = None
+    latest_device_protocol_id: UUID4
+    latest_device_protocol_type: str | None = None
+    latest_device_network_sys_type: str | None = None
+    latest_log_datetime: datetime
+    latest_bs_id: UUID4 | None = None
+    latest_signal_rssi: int | None = None
+    latest_signal_snr: int | None = None
+
+    logs_stat: List[Tuple[datetime, int]] | None = None
+
+
+class ApiBaseStationDevicesResponse(JsonApiResponsePayload):
+    """Ответ GET /base-stations/<uuid>/devices (ApiBsDevicesResponse)."""
+
+    devices: List[ApiBaseStationDeviceResponse]
+    device_count: int
+
+
+class ApiBaseStationDeviceLogResponse(JsonApiResponsePayload):
+    """Элемент device_logs ответа GET /base-stations/<uuid>/device-logs (ApiDeviceLogsResponse)."""
+
+    id: UUID4
+    date_created: datetime
+
+    bs_id: UUID4 | None = None
+    device_id: UUID4
+
+    device_gateway_id: UUID4 | None = None
+    device_protocol_id: UUID4
+
+    signal_rssi: int | None = None
+    signal_snr: int | None = None
+
+    date_sending: datetime
+
+    is_verified: bool | None = None
+    protocol_type: str | None = None
+    packet_type_name: str | None = None
+    network_id: UUID4 | None = None
+    network_sys_type: str | None = None
+    decrypted_payload: str | None = None
+    raw_payload: str | None = None
+
+    error_message: str | None = None
+    error_type: str | None = None
+
+    device: Dict[str, Any] | None = None
+    external_document_id: UUID4 | None = None
+
+
+class ApiBaseStationDeviceLogsResponse(JsonApiResponsePayload):
+    """Ответ GET /base-stations/<uuid>/device-logs (ApiBsDeviceLogsResponse)."""
+
+    device_logs: List[ApiBaseStationDeviceLogResponse]
+    device_logs_count: int
+    device_count: int

ul-data-logger-api-sdk-2.0.6/PKG-INFO

@@ -1,30 +0,0 @@
-Metadata-Version: 2.1
-Name: ul-data-logger-api-sdk
-Version: 2.0.6
-Summary: Data logger API sdk
-Author: Unic-lab
-License: MIT
-Platform: any
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Operating System :: OS Independent
-Description-Content-Type: text/markdown
-
-# ul_iot_account_data_logger
-
-## Restoring the db dump
-
-1) add your dump to ./tmp
-2) run bash in manager
-    ```bash
-   docker-compose run --rm manager__data_logger__db bash
-   ```
-3) run inside of manager
-    ```bash
-    pg_restore -U admin -h data_logger__db -d data_logger_db -p 5432 -1 --data-only -t device_log /temporary/dump.sql
-    ```

ul-data-logger-api-sdk-2.0.6/README.md

@@ -1,13 +0,0 @@
-# ul_iot_account_data_logger
-
-## Restoring the db dump
-
-1) add your dump to ./tmp
-2) run bash in manager
-    ```bash
-   docker-compose run --rm manager__data_logger__db bash
-   ```
-3) run inside of manager
-    ```bash
-    pg_restore -U admin -h data_logger__db -d data_logger_db -p 5432 -1 --data-only -t device_log /temporary/dump.sql
-    ```

ul-data-logger-api-sdk-2.0.6/data_logger_api_sdk/data_logger_api_sdk.py

@@ -1,123 +0,0 @@
-import json
-import time
-from datetime import datetime
-from functools import lru_cache
-from typing import List, Type
-from uuid import UUID
-
-from ul_api_utils.internal_api.internal_api import InternalApi
-from ul_api_utils.internal_api.internal_api_response import TPyloadType
-from ul_api_utils.utils.api_method import ApiMethod
-
-from data_logger_api_sdk.data_logger_sdk_config import DataLoggerApiSdkConfig
-from data_logger_api_sdk.types.api_bs_traffic_stats import ApiBsTrafficStatsResponse, ApiDeviceTrafficStatsQuery
-from data_logger_api_sdk.types.api_device_data_history import ApiDeviceDataHistoryBody, ApiDeviceDataHistoryResponse
-from data_logger_api_sdk.types.api_last_bs_data_by_device_macs import ApiDeviceLastBsDataResponse, ApiDeviceMacsListBodyModel
-from data_logger_api_sdk.types.api_packet_types import ApiPacketTypesListResponse
-from data_logger_api_sdk.types.api_protocol_types import ApiProtocolTypesListResponse
-
-
-class DataLoggerApiSdk:
-
-    def __init__(self, config: DataLoggerApiSdkConfig) -> None:
-        self._config = config
-        self._api = InternalApi(entry_point=self._config.api_url, default_auth_token=self._config.api_token)
-
-    @lru_cache(maxsize=None)  # there should not be leaks memory leaks. flake8 just scared inmemory cache ;)
-    def request_payload(
-        self,
-        _: int,
-        method: ApiMethod,
-        endpoint: str,
-        typed_as: Type[TPyloadType],
-        body: str | None,
-        query: str | None = None,
-    ) -> TPyloadType:
-        return (
-            self._api.request(
-                method=method,
-                path=endpoint,
-                json=json.loads(body) if body is not None else None,
-                q=json.loads(query) if query is not None else None,
-            )
-            .typed(typed_as)
-            .check()
-            .payload
-        )
-
-    def _get_cache_post_payload(
-        self,
-        method: ApiMethod,
-        path: str,
-        typed: Type[TPyloadType],
-        body: str | None = None,
-        query: str | None = None,
-    ) -> TPyloadType:
-        ttl_status = round(time.time() / self._config.cache_ttl_s)
-        return self.request_payload(ttl_status, method, path, typed, body, query)  # type: ignore  # Type[TPyloadType] is hashable
-
-    def get_protocol_types_list(self, mac: int) -> List[str]:
-        return self._get_cache_post_payload(
-            ApiMethod.GET,
-            f"/devices/mac/{mac}/logs/protocol-types",
-            ApiProtocolTypesListResponse,
-        ).protocol_types
-
-    def get_packet_types_list(self, mac: int) -> List[str]:
-        return self._get_cache_post_payload(
-            ApiMethod.GET,
-            f"/devices/mac/{mac}/logs/packet-types",
-            ApiPacketTypesListResponse,
-        ).packet_types
-
-    def get_device_data_history(
-        self,
-        period_from: datetime,
-        period_to: datetime,
-        mac: int,
-        protocol_type: str | None = None,
-        packet_type: str | None = None,
-    ) -> List[ApiDeviceDataHistoryResponse]:
-        api_device_history_body = ApiDeviceDataHistoryBody(
-            period_from=period_from,
-            period_to=period_to,
-            mac=mac,
-            protocol_type=protocol_type,
-            packet_type=packet_type,
-        ).model_dump_json()
-        return self._get_cache_post_payload(
-            ApiMethod.POST,
-            "/device-data-history",
-            List[ApiDeviceDataHistoryResponse],  # type: ignore
-            api_device_history_body,
-        )
-
-    def get_last_bs_data_by_device_macs(
-        self,
-        macs: set[int],
-    ) -> List[ApiDeviceLastBsDataResponse]:
-        return self._get_cache_post_payload(
-            ApiMethod.POST,
-            "/devices/last-bs-data",
-            List[ApiDeviceLastBsDataResponse],  # type: ignore
-            ApiDeviceMacsListBodyModel(macs=macs).model_dump_json(),
-        )
-
-    def get_bs_traffic_stats(
-        self,
-        base_station_id: UUID,
-        start_at: datetime,
-        end_at: datetime,
-    ) -> List[ApiBsTrafficStatsResponse]:
-        api_bs_traffic_stats_query = ApiDeviceTrafficStatsQuery(
-            start_at=start_at,
-            end_at=end_at,
-        )
-        return self._get_cache_post_payload(
-            ApiMethod.GET,
-            f"/base-stations/{base_station_id}/traffic-stats",
-            List[ApiBsTrafficStatsResponse],  # type: ignore
-            None,
-            api_bs_traffic_stats_query.model_dump_json(),
-        )
-

ul-data-logger-api-sdk-2.0.6/pyproject.toml

@@ -1,133 +0,0 @@
-[tool.pytest.ini_options]
-addopts = """
-    --cov src \
-    --no-cov-on-fail \
-    --cov-report term-missing \
-    --cov-report html:./.tmp/coverage \
-    --maxfail=1 \
-    --tb=short \
-    -vvv \
-    -ra \
-    -q \
-    --showlocals \
-    -p pytest_cov"""
-log_cli = true
-cache_dir = "./.tmp/pytest-cache"
-testpaths = [
-    "__tests__",
-]
-norecursedirs = [
-    ".*",
-    ".git",
-    ".tmp",
-    "srv",
-    "node_modules",
-]
-
-[tool.mypy]
-plugins = [
-    "sqlmypy",
-    "sqlalchemy.ext.mypy.plugin",
-    "pydantic.mypy"
-]
-#packages = [
-#    "src",
-#    "__tests__",
-#]
-exclude = ["migrations"]
-cache_dir = "./.tmp/mypy-cache"
-python_version = "3.10"
-warn_return_any = false
-warn_unused_configs = true
-ignore_missing_imports = false
-follow_imports = "normal"
-namespace_packages = true
-explicit_package_bases = true
-follow_imports_for_stubs = true
-implicit_reexport = true
-allow_untyped_globals = false
-disallow_any_generics = true
-disallow_untyped_defs = true
-disallow_incomplete_defs = true
-check_untyped_defs = true
-disallow_untyped_decorators = false
-no_implicit_optional = true
-strict_optional = true
-warn_unused_ignores = true
-warn_no_return = true
-show_none_errors = true
-ignore_errors = false
-allow_redefinition = false
-strict_equality = true
-show_error_context = false
-show_column_numbers = false
-warn_redundant_casts = true
-warn_unreachable = true
-
-[tool.pydantic-mypy]
-init_forbid_extra = true
-init_typed = true
-warn_required_dynamic_aliases = true
-warn_untyped_fields = true
-
-[[tool.mypy.overrides]]
-module = [
-    "sqlalchemy_serializer",
-    "api_utils"
-]
-ignore_missing_imports = true
-
-[tool.ruff]
-exclude = ["migrations"]
-line-length = 150
-target-version = "py310"
-cache-dir = "./.tmp/ruff-cache"
-
-
-[tool.ruff.lint]
-select = ["ALL"]
-ignore = ["D", "RUF001", "PGH003"]
-extend-ignore = [
-    "S311",     # Generated data isn't always used for cryptographic purposes
-    "N805",     # First argument of a method should be named `self` - but pydantic docs use cls
-    "TRY003",   # Avoid specifying long messages outside the exception class - but pydantic allow to use simple raise error
-    "EM101",    # Exception must not use a string literal, assign to variable first - duplicate msg? ok
-    "S101",     # Use of `assert` detected - only way to deal with paranoic mypy
-    "PLR0913",  # Too many arguments in function definition (6 > 5) - maybe good. wiil be refactored later
-    "RUF012",   # Mutable class attributes should be annotated with `typing.ClassVar` - sqlalchemy allow to mutations
-    "G004",     # Logging statement uses f-string - it's OK
-    "UP035",    # `typing.List` is deprecated, use `list` instead - yes, but `list` broke api-utils @rest_api
-    "UP006",    # Use `list` instead of `List` for type annotation - yes, but `list` broke api-utils @rest_api
-    "ANN401",   # Checks that function arguments are annotated with a more specific type than Any
-    "ANN101",   # This rule is commonly disabled because type checkers can infer this type without annotation. It will be removed in a future release
-    "C901",     # Checks for functions with a high McCabe complexity
-    "ERA001",   # Checks for commented-out Python code
-    "ANN102",   # Checks that class method cls arguments have type annotations
-    "PGH004",   # Check for noqa annotations that suppress all diagnostics, as opposed to targeting specific diagnostics
-    "A002",     # Checks for any function arguments that use the same name as a builtin
-    "A001",     # Checks for variable (and function) assignments that use the same name as a builtin
-    "B019",     # Checks for uses of the functools.lru_cache and functools.cache decorators on methods
-    "PLW0603",  # Checks for the use of global statements to update identifiers
-    "UP033",    # Checks for uses of functools.lru_cache that set maxsize=None
-    "FIX002",   # Checks for "TODO" comments
-    "TD002",    # Checks that a TODO comment includes an author
-    "TD003",    # Checks that a TODO comment is associated with a link to a relevant issue or ticket
-    "FBT001",   # Checks for the use of boolean positional arguments in function definitions, as determined by the presence of a bool type hint
-    "PERF203",  # Checks for uses of except handling via try-except within for and while loops
-    "A005",     # Checks if module shadows a Python standard-library module
-    "C420",     # Unnecessary dict comprehension for iterable; use dict.fromkeys instead
-    "LOG015",   # {}() call on root logger
-    "TC006",    # Add quotes to type expression in typing.cast()
-]
-
-[tool.ruff.lint.mccabe]
-max-complexity = 4
-
-[tool.black]
-target-version = ["py310"]
-exclude = "migrations"
-#include = [
-#    "^/src",
-#    "^/notification_sdk",
-#]
-check = false

ul-data-logger-api-sdk-2.0.6/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

ul-data-logger-api-sdk-2.0.6/setup.py

@@ -1,84 +0,0 @@
-import sys
-from pathlib import Path
-
-from setuptools import find_packages, setup
-
-HERE = Path(__file__).resolve().parent
-
-with Path.open(Path(HERE) / "README.md", encoding="utf-8") as f:
-    long_description = f.read()
-
-if sys.argv:
-    if "broker_sdk" in set(sys.argv):
-        sys.argv.remove("broker_sdk")
-        setup(
-            name="ul-data-logger-sdk",
-            version="3.0.4",
-            description="Data logger sdk",
-            author="Unic-lab",
-            long_description=long_description,
-            long_description_content_type="text/markdown",
-            packages=find_packages(include=["data_logger_sdk*"]),
-            include_package_data=True,
-            package_data={
-                "": ["*.yml", "py.typed"],
-                "data_logger_sdk": ["py.typed"],
-            },
-            license="MIT",
-            classifiers=[
-                "Intended Audience :: Developers",
-                "License :: OSI Approved :: MIT License",
-                "Programming Language :: Python",
-                "Programming Language :: Python :: 3.6",
-                "Programming Language :: Python :: 3.7",
-                "Programming Language :: Python :: 3.8",
-                "Programming Language :: Python :: 3.9",
-                "Operating System :: OS Independent",
-            ],
-            platforms="any",
-            install_requires=[
-                "ul-unipipeline>=2.0.0",
-                # "ul-data-aggregator-sdk>=8.13.2",
-                # "ul-py-tool==2.1.3,
-                # "ul-api-utils==8.1.9",
-                # "ul-db-utils==4.0.2",
-                # "ul-data-gateway-sdk==1.0.6",
-            ],
-        )
-    elif "api_sdk" in set(sys.argv):
-        sys.argv.remove("api_sdk")
-        setup(
-            name="ul-data-logger-api-sdk",
-            version="2.0.6",
-            description="Data logger API sdk",
-            author="Unic-lab",
-            long_description=long_description,
-            long_description_content_type="text/markdown",
-            packages=find_packages(include=["data_logger_api_sdk*"]),
-            include_package_data=True,
-            package_data={
-                "": ["*.yml", "py.typed"],
-                "data_logger_api_sdk": ["py.typed"],
-            },
-            license="MIT",
-            classifiers=[
-                "Intended Audience :: Developers",
-                "License :: OSI Approved :: MIT License",
-                "Programming Language :: Python",
-                "Programming Language :: Python :: 3.6",
-                "Programming Language :: Python :: 3.7",
-                "Programming Language :: Python :: 3.8",
-                "Programming Language :: Python :: 3.9",
-                "Operating System :: OS Independent",
-            ],
-            platforms="any",
-            install_requires=[
-                "ul-unipipeline>=2.0.0",
-                "tqdm==4.66.1",
-                # "ul-data-aggregator-sdk>=8.13.2",
-                # "ul-py-tool==2.1.4,
-                # "ul-api-utils==9.1.1",
-                # "ul-db-utils==5.1.0",
-                # "ul-data-gateway-sdk==1.0.6",
-            ],
-        )

ul-data-logger-api-sdk-2.0.6/ul_data_logger_api_sdk.egg-info/PKG-INFO

@@ -1,30 +0,0 @@
-Metadata-Version: 2.1
-Name: ul-data-logger-api-sdk
-Version: 2.0.6
-Summary: Data logger API sdk
-Author: Unic-lab
-License: MIT
-Platform: any
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Operating System :: OS Independent
-Description-Content-Type: text/markdown
-
-# ul_iot_account_data_logger
-
-## Restoring the db dump
-
-1) add your dump to ./tmp
-2) run bash in manager
-    ```bash
-   docker-compose run --rm manager__data_logger__db bash
-   ```
-3) run inside of manager
-    ```bash
-    pg_restore -U admin -h data_logger__db -d data_logger_db -p 5432 -1 --data-only -t device_log /temporary/dump.sql
-    ```

ul-data-logger-api-sdk-2.0.6/ul_data_logger_api_sdk.egg-info/SOURCES.txt

@@ -1,18 +0,0 @@
-README.md
-pyproject.toml
-setup.py
-data_logger_api_sdk/__init__.py
-data_logger_api_sdk/data_logger_api_sdk.py
-data_logger_api_sdk/data_logger_sdk_config.py
-data_logger_api_sdk/py.typed
-data_logger_api_sdk/types/__init__.py
-data_logger_api_sdk/types/api_bs_traffic_stats.py
-data_logger_api_sdk/types/api_device_data_history.py
-data_logger_api_sdk/types/api_last_bs_data_by_device_macs.py
-data_logger_api_sdk/types/api_packet_types.py
-data_logger_api_sdk/types/api_protocol_types.py
-ul_data_logger_api_sdk.egg-info/PKG-INFO
-ul_data_logger_api_sdk.egg-info/SOURCES.txt
-ul_data_logger_api_sdk.egg-info/dependency_links.txt
-ul_data_logger_api_sdk.egg-info/requires.txt
-ul_data_logger_api_sdk.egg-info/top_level.txt

ul-data-logger-api-sdk-2.0.6/ul_data_logger_api_sdk.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

ul-data-logger-api-sdk-2.0.6/ul_data_logger_api_sdk.egg-info/requires.txt

@@ -1,2 +0,0 @@
-ul-unipipeline>=2.0.0
-tqdm==4.66.1

ul-data-logger-api-sdk-2.0.6/ul_data_logger_api_sdk.egg-info/top_level.txt

@@ -1 +0,0 @@
-data_logger_api_sdk