saviialib 1.4.0__py3-none-any.whl → 1.5.0__py3-none-any.whl

saviialib/__init__.py

@@ -12,6 +12,8 @@ from saviialib.services.thies.api import SaviiaThiesAPI
 from saviialib.general_types.api.saviia_thies_api_types import SaviiaThiesConfig
 from saviialib.general_types.api.saviia_backup_api_types import SaviiaBackupConfig
 
+__all__ = ["SaviiaAPI", "SaviiaAPIConfig"]
+
 
 class SaviiaAPI:
     API_REGISTRY: Dict[str, Type] = {

saviialib/general_types/api/saviia_api_types.py

@@ -30,6 +30,7 @@ class SaviiaAPIConfig:
     sharepoint_site_name: str
     logger: Logger
 
+
 @dataclass
 class FtpClientConfig:
     ftp_host: str

saviialib/general_types/api/saviia_netcamera_api_types.py

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from logging import Logger
+
+
+@dataclass
+class SaviiaNetcameraConfig:
+    username: str
+    password: str
+    protocol: str
+    logger: Logger
+    destination_path: str = "/"

saviialib/general_types/api/saviia_shakes_api_types.py

@@ -0,0 +1,21 @@
+from dataclasses import dataclass
+from logging import Logger
+
+
+@dataclass
+class SaviiaShakesConfig:
+    """
+    Configuration for Raspberry shakes activities as Miniseed extraction, photo record and video record.
+
+    Attributes:
+        sftp_user (str): Username for SFTP Client connection
+        sftp_password (str): Password for SFTP Client connection
+        sftp_port (str): SFTP Server Port. Default port is 22.
+        ssh_key_path (str): Path to the SSH Private key for client-side authentication.
+    """
+
+    sftp_user: str
+    sftp_password: str
+    ssh_key_path: str
+    logger: Logger
+    sftp_port: int = 22

saviialib/general_types/error_types/api/saviia_api_error_types.py

@@ -103,3 +103,11 @@ class BackupEmptyError(Exception):
 
     def __str__(self):
         return "The local backup folder is empty. "
+
+
+class ShakesNoContentError(Exception):
+    def __init__(self, *args):
+        super().__init__(*args)
+
+    def __str__(self):
+        return "All the miniSEED files have been downloaded and are in the local directory."

saviialib/general_types/error_types/api/saviia_netcamera_error_types.py

@@ -0,0 +1,7 @@
+class NetcameraConnectionError(Exception):
+    def __init__(self, *args, reason):
+        super().__init__(*args, reason)
+        self.reason = reason
+
+    def __str__(self):
+        return "Netcamera Connection failed. " + self.reason.__str__()

saviialib/general_types/error_types/common/common_types.py

@@ -15,3 +15,12 @@ class SharepointClientError(Exception):
 class FtpClientError(Exception):
     def __str__(self):
         return "Ftp Client initialization fails."
+
+
+class SftpClientError(Exception):
+    def __init__(self, *args, reason):
+        super().__init__(*args, reason)
+        self.reason = reason
+
+    def __str__(self):
+        return "SFTP Client initialization fails." + self.reason.__str__()

saviialib/libs/directory_client/client/os_client.py

@@ -19,7 +19,7 @@ class OsClient(DirectoryClientContract):
         return await asyncio.to_thread(os.listdir, path)
 
     @staticmethod
-    async def isdir(path: str) -> list:
+    async def isdir(path: str) -> bool:
         return await asyncio.to_thread(os.path.isdir, path)
 
     @staticmethod

saviialib/libs/ffmpeg_client/__init__.py

@@ -0,0 +1,8 @@
+from .ffmpeg_client import (
+    FfmpegClient,
+    FfmpegClientInitArgs,
+    RecordPhotoArgs,
+    RecordVideoArgs,
+)
+
+__all__ = ["FfmpegClient", "FfmpegClientInitArgs", "RecordPhotoArgs", "RecordVideoArgs"]

saviialib/libs/ffmpeg_client/clients/ffmpeg_asyncio_client.py

@@ -0,0 +1,101 @@
+from saviialib.libs.ffmpeg_client.types.ffmpeg_client_types import (
+    FfmpegClientInitArgs,
+    RecordPhotoArgs,
+    RecordVideoArgs,
+)
+from saviialib.libs.ffmpeg_client.ffmpeg_client_contract import FfmpegClientContract
+from typing import List
+import asyncio
+import shutil
+
+from saviialib.libs.directory_client import DirectoryClient, DirectoryClientArgs
+from saviialib.libs.zero_dependency.utils.datetime_utils import today, datetime_to_str
+
+
+class FfmpegAsyncioClient(FfmpegClientContract):
+    def __init__(self, args: FfmpegClientInitArgs) -> None:
+        self.dir_client = DirectoryClient(DirectoryClientArgs("os_client"))
+
+    def _setup_io_args(
+        self,
+        rtsp_user: str,
+        rtsp_pwd: str,
+        ip: str,
+        dest_path: str,
+        record_prefix: str,
+        record_type: str,
+    ):
+        input_arg = f"rtsp://{rtsp_user}:{rtsp_pwd}@{ip}/stream1"
+        output_file = (
+            record_prefix
+            + "_"
+            + datetime_to_str(today(), date_format="%m-%d-%Y_%H-%M-%S")
+            + f".{record_type}"
+        )
+        output_arg = self.dir_client.join_paths(dest_path, output_file)
+        return input_arg, output_arg
+
+    async def _ensure_ffmpeg_available(self):
+        if shutil.which("ffmpeg"):
+            return
+        install_cmd = ["apk", "add", "ffmpeg"]  # Only for Home Assistant OS
+        process = await asyncio.create_subprocess_shell(
+            *install_cmd,
+            stdout=asyncio.subprocess.DEVNULL,
+            stdin=asyncio.subprocess.PIPE,
+        )
+        _, stderr = await process.communicate()
+        if process.returncode != 0:
+            raise ConnectionAbortedError("Failed to install ffmpeg: ", stderr.decode())
+
+    async def _setup_command(
+        self, input_arg: str, output_arg: str, extra: dict
+    ) -> List[str]:
+        await self._ensure_ffmpeg_available()  # Validate ffmpeg module is installed.
+        cmd = ["ffmpeg", "-y", "-i", input_arg, output_arg]
+        for k, v in extra.values():
+            cmd.insert(-1, k)
+            cmd.insert(-1, v)
+        return list(map(str, cmd))
+
+    async def record_video(self, args: RecordVideoArgs):
+        input_arg, output_arg = self._setup_io_args(
+            args.rtsp_user,
+            args.rtsp_password,
+            args.ip_address,
+            args.destination_path,
+            "Video",
+            args.extension,
+        )
+        cmd = await self._setup_command(
+            input_arg, output_arg, extra={"-t": args.duration}
+        )
+        process = await asyncio.create_subprocess_exec(
+            *cmd, stderr=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE
+        )
+        _, stderr = await process.communicate()
+        if process.returncode != 0:
+            raise ConnectionError(
+                "Unexpected error while recording the video: ", stderr.decode()
+            )
+
+    async def record_photo(self, args: RecordPhotoArgs):
+        input_arg, output_arg = self._setup_io_args(
+            args.rtsp_user,
+            args.rtsp_password,
+            args.ip_address,
+            args.destination_path,
+            "Photo",
+            args.extension,
+        )
+        cmd = await self._setup_command(
+            input_arg, output_arg, extra={"-frames:v": args.frames}
+        )
+        process = await asyncio.create_subprocess_exec(
+            *cmd, stderr=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE
+        )
+        _, stderr = await process.communicate()
+        if process.returncode != 0:
+            raise ConnectionError(
+                "Unexpected error while recording the photo: ", stderr.decode()
+            )

saviialib/libs/ffmpeg_client/ffmpeg_client.py

@@ -0,0 +1,25 @@
+from .ffmpeg_client_contract import FfmpegClientContract
+from .types.ffmpeg_client_types import (
+    RecordPhotoArgs,
+    RecordVideoArgs,
+    FfmpegClientInitArgs,
+)
+from .clients.ffmpeg_asyncio_client import FfmpegAsyncioClient
+
+
+class FfmpegClient(FfmpegClientContract):
+    CLIENTS = {"ffmpeg_asyncio"}
+
+    def __init__(self, args: FfmpegClientInitArgs) -> None:
+        if args.client_name not in FfmpegClient.CLIENTS:
+            msg = f"Unsupported client {args.client_name}"
+            raise KeyError(msg)
+        if args.client_name == "ffmpeg_asyncio":
+            self.client_obj = FfmpegAsyncioClient(args)
+        self.client_name = args.client_name
+
+    def record_photo(self, args: RecordPhotoArgs):
+        return self.client_obj.record_photo(args)
+
+    def record_video(self, args: RecordVideoArgs):
+        return self.client_obj.record_video(args)

saviialib/libs/ffmpeg_client/ffmpeg_client_contract.py

@@ -0,0 +1,12 @@
+from abc import ABC, abstractmethod
+from .types.ffmpeg_client_types import RecordPhotoArgs, RecordVideoArgs
+
+
+class FfmpegClientContract(ABC):
+    @abstractmethod
+    async def record_photo(self, args: RecordPhotoArgs):
+        pass
+
+    @abstractmethod
+    async def record_video(self, args: RecordVideoArgs):
+        pass

saviialib/libs/ffmpeg_client/types/ffmpeg_client_types.py

@@ -0,0 +1,28 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class FfmpegClientInitArgs:
+    client_name: str
+
+
+@dataclass
+class RecordPhotoArgs:
+    ip_address: str
+    destination_path: str
+    rtsp_user: str
+    rtsp_password: str
+    port: str
+    extension: str
+    frames: int
+
+
+@dataclass
+class RecordVideoArgs:
+    destination_path: str
+    ip_address: str
+    port: str
+    rtsp_user: str
+    rtsp_password: str
+    extension: str
+    duration: int

saviialib/libs/sftp_client/__init__.py

@@ -0,0 +1,8 @@
+from .sftp_client import SFTPClient
+from .types.sftp_client_types import (
+    ListfilesArgs,
+    DownloadfilesArgs,
+    SFTPClientInitArgs,
+)
+
+__all__ = ["SFTPClient", "ListfilesArgs", "DownloadfilesArgs", "SFTPClientInitArgs"]

saviialib/libs/sftp_client/clients/asyncssh_sftp_client.py

@@ -0,0 +1,83 @@
+from saviialib.libs.sftp_client.sftp_client_contract import SFTPClientContract
+from saviialib.libs.sftp_client.types.sftp_client_types import (
+    SFTPClientInitArgs,
+    ListfilesArgs,
+    DownloadfilesArgs,
+)
+from typing import Optional, List, Tuple
+from saviialib.general_types.error_types.common.common_types import EmptyDataError
+import asyncssh  # type: ignore
+from saviialib.libs.directory_client import DirectoryClient, DirectoryClientArgs
+
+
+class AsyncsshSFTPClient(SFTPClientContract):
+    def __init__(self, args: SFTPClientInitArgs) -> None:
+        self.host: str = args.host
+        self.port: int = args.port
+        self.username: str = args.username
+        self.password: Optional[str] = args.password
+        self.ssh_key_path: Optional[str] = args.ssh_key_path
+        self.dir_client = DirectoryClient(DirectoryClientArgs("os_client"))
+        self._validate_credentials()
+
+    def _validate_credentials(self):
+        if not self.password and not self.ssh_key_path:
+            raise EmptyDataError(
+                reason="At least one attribute (ssh key or password) must be provided"
+            )
+
+    async def _start_connection(
+        self,
+    ) -> Tuple[asyncssh.SSHClientConnection, asyncssh.SFTPClient]:
+        try:
+            ssh_connection = await asyncssh.connect(
+                self.host,
+                username=self.username,
+                port=self.port,
+                client_keys=[self.ssh_key_path],
+                password=self.password,
+            )
+            sftp_client = await ssh_connection.start_sftp_client()
+            return ssh_connection, sftp_client
+        except (OSError, asyncssh.Error) as exc:
+            raise ConnectionError("SFTP Operation failed: " + str(exc))
+
+    async def list_files(self, args: ListfilesArgs) -> List[str]:
+        ssh_conn, sftp_client = await self._start_connection()
+        async with ssh_conn:
+            async with sftp_client:
+                files = await sftp_client.listdir(args.path)
+                files = [f for f in files if f not in (".", "..")]
+                return files
+        await self._end_connection(ssh_conn)
+
+    async def download_files(self, args: DownloadfilesArgs) -> None:
+        ssh_conn, sftp_client = await self._start_connection()
+        if not args.destination_path or not args.source_path:
+            conflict_path = (
+                "destination path" if not args.destination_path else "source path"
+            )
+            raise ConnectionError(f"The {conflict_path} must be provided.")
+
+        download_all = len(args.files_to_download) == 0
+        async with ssh_conn:
+            async with sftp_client:
+                if download_all:
+                    await sftp_client.get(
+                        args.source_path,
+                        args.destination_path,
+                        recurse=True,
+                        preserve=True,
+                    )
+                else:
+                    for filename in args.files_to_download:
+                        source_path = self.dir_client.join_paths(
+                            args.source_path, filename
+                        )
+                        dest_path = self.dir_client.join_paths(
+                            args.destination_path, filename
+                        )
+                        await sftp_client.get(source_path, dest_path)
+
+    async def _end_connection(self, connection) -> None:
+        await connection.wait_closed()

saviialib/libs/sftp_client/sftp_client.py

@@ -0,0 +1,26 @@
+from .sftp_client_contract import SFTPClientContract
+from .types.sftp_client_types import (
+    SFTPClientInitArgs,
+    ListfilesArgs,
+    DownloadfilesArgs,
+)
+from .clients.asyncssh_sftp_client import AsyncsshSFTPClient
+from typing import List
+
+
+class SFTPClient(SFTPClientContract):
+    CLIENTS = {"asyncssh_sftp"}
+
+    def __init__(self, args: SFTPClientInitArgs) -> None:
+        if args.client_name not in SFTPClient.CLIENTS:
+            msg = f"Unsupported client {args.client_name}"
+            raise KeyError(msg)
+        if args.client_name == "asyncssh_sftp":
+            self.client_obj = AsyncsshSFTPClient(args)
+        self.client_name = args.client_name
+
+    async def list_files(self, args: ListfilesArgs) -> List[str]:
+        return await self.client_obj.list_files(args)
+
+    async def download_files(self, args: DownloadfilesArgs) -> None:
+        return await self.client_obj.download_files(args)

saviialib/libs/sftp_client/sftp_client_contract.py

@@ -0,0 +1,13 @@
+from .types.sftp_client_types import ListfilesArgs, DownloadfilesArgs
+from abc import ABC, abstractmethod
+from typing import List
+
+
+class SFTPClientContract(ABC):
+    @abstractmethod
+    async def list_files(self, args: ListfilesArgs) -> List[str]:
+        pass
+
+    @abstractmethod
+    async def download_files(self, args: DownloadfilesArgs) -> None:
+        pass

saviialib/libs/sftp_client/types/sftp_client_types.py

@@ -0,0 +1,24 @@
+from dataclasses import dataclass, field
+from typing import Optional, List
+
+
+@dataclass
+class SFTPClientInitArgs:
+    client_name: str
+    password: Optional[str]
+    username: str
+    ssh_key_path: str
+    host: str = "localhost"
+    port: int = 22
+
+
+@dataclass
+class ListfilesArgs:
+    path: str
+
+
+@dataclass
+class DownloadfilesArgs:
+    source_path: str
+    destination_path: str
+    files_to_download: List[str] = field(default_factory=list)

saviialib/libs/sharepoint_client/clients/sharepoint_rest_api.py

@@ -19,6 +19,7 @@ from saviialib.libs.sharepoint_client.types.sharepoint_client_types import (
 load_dotenv()
 ssl_context = ssl.create_default_context(cafile=certifi.where())
 
+
 class SharepointRestAPI(SharepointClientContract):
     def __init__(self, args: SharepointClientInitArgs):
         self.session: ClientSession | None = None

saviialib/libs/zero_dependency/utils/strings_utils.py

@@ -0,0 +1,5 @@
+def are_equal(str1: str, str2: str) -> bool:
+    if str1.lower() == str2.lower():
+        return True
+    else:
+        return False

saviialib/services/backup/api.py

@@ -1,4 +1,4 @@
-from typing import Any, Dict, List
+from typing import Any, Dict
 
 from .controllers.upload_backup_to_sharepoint import (
     UploadBackupToSharepointControllerInput,

saviialib/services/netcamera/api.py

@@ -0,0 +1,30 @@
+from .controllers.get_media_files import (
+    GetMediaFilesController,
+    GetMediaFilesControllerInput,
+)
+from typing import Dict, Tuple, Any
+from saviialib.general_types.api.saviia_netcamera_api_types import SaviiaNetcameraConfig
+
+
+class NetcameraAPI:
+    """This class provides methods for interacting with network cameras and retrieving
+    files using streaming services."""
+
+    def __init__(self, config: SaviiaNetcameraConfig):
+        self.config = config
+
+    async def get_media_files(
+        self, cameras: Dict[str, Tuple[str, int]]
+    ) -> Dict[str, Any]:
+        """Retrieve media files from Network cameras.
+
+        :param cameras: Dictionary where the key is the identifier of the camera, and the
+            value is a tuple wich contains the service IP address and port of connection.
+            Example: {'cam_01': ('192.168.1.10', 8080), ...}
+        :type cameras: dict
+        :return response: A dictionary containg information of the extraction operation.
+        :rtype: dict
+        """
+        controller = GetMediaFilesController(GetMediaFilesControllerInput(cameras))
+        response = await controller.execute()
+        return response.__dict__

saviialib/services/netcamera/controllers/get_media_files.py

@@ -0,0 +1,40 @@
+from .types.get_media_files_types import (
+    GetMediaFilesControllerInput,
+    GetMediaFilesControllerOutput,
+)
+from saviialib.services.netcamera.use_cases.get_media_files import (
+    GetMediaFilesUseCase,
+    GetMediaFilesUseCaseInput,
+)
+from http import HTTPStatus
+from saviialib.general_types.error_types.api.saviia_netcamera_error_types import (
+    NetcameraConnectionError,
+)
+
+
+class GetMediaFilesController:
+    def __init__(self, input: GetMediaFilesControllerInput) -> None:
+        self.use_case = GetMediaFilesUseCase(
+            GetMediaFilesUseCaseInput(
+                cameras=input.cameras,
+                username=input.config.username,
+                password=input.config.password,
+                protocol=input.config.protocol,
+                logger=input.config.logger,
+                destination_path=input.config.destination_path,
+            )
+        )
+
+    async def execute(self) -> GetMediaFilesControllerOutput:
+        try:
+            _ = await self.use_case.execute()
+            return GetMediaFilesControllerOutput(
+                message="The extraction of media files was successfully!",
+                status=HTTPStatus.OK.value,
+            )
+        except NetcameraConnectionError as error:
+            return GetMediaFilesControllerOutput(
+                message="An unnexpected error ocurred while extractingphotos and videos.",
+                status=HTTPStatus.GATEWAY_TIMEOUT.value,
+                metadata={"error": error.__str__()},
+            )

saviialib/services/netcamera/controllers/types/get_media_files_types.py

@@ -0,0 +1,16 @@
+from dataclasses import dataclass, field
+from typing import Dict, Tuple
+from saviialib.general_types.api.saviia_netcamera_api_types import SaviiaNetcameraConfig
+
+
+@dataclass
+class GetMediaFilesControllerInput:
+    config = SaviiaNetcameraConfig
+    cameras: Dict[str, Tuple[str, int]]
+
+
+@dataclass
+class GetMediaFilesControllerOutput:
+    status: int
+    message: str
+    metadata: Dict = field(default_factory=dict)

saviialib/services/netcamera/use_cases/get_media_files.py

@@ -0,0 +1,76 @@
+from .types.get_media_files_types import (
+    GetMediaFilesUseCaseInput,
+    GetMediaFilesUseCaseOutput,
+)
+from saviialib.libs.ffmpeg_client import (
+    FfmpegClient,
+    FfmpegClientInitArgs,
+    RecordVideoArgs,
+    RecordPhotoArgs,
+)
+from saviialib.libs.zero_dependency.utils.strings_utils import are_equal
+from typing import Tuple, Dict
+from saviialib.libs.directory_client.directory_client import (
+    DirectoryClient,
+    DirectoryClientArgs,
+)
+from saviialib.general_types.error_types.api.saviia_netcamera_error_types import (
+    NetcameraConnectionError,
+)
+
+
+class GetMediaFilesUseCase:
+    def __init__(self, input: GetMediaFilesUseCaseInput) -> None:
+        self.ffmpeg_client = FfmpegClient(
+            FfmpegClientInitArgs(
+                client_name="ffmpeg_asyncio",
+            )
+        )
+        self.dir_client = DirectoryClient(DirectoryClientArgs("os_client"))
+        self.user = input.username
+        self.pwd = input.password
+        self.cameras: Dict[str, Tuple[str, int]] = input.cameras
+        self.protocol = input.protocol
+        self.logger = input.logger
+        self.dest_path = input.destination_path
+
+    async def _retieve_with_rtsp(self):
+        for name, conn in self.cameras.items():
+            ip, port = conn
+            dest_path = self.dir_client.join_paths(self.dest_path, name)
+            try:
+                # Extraction of photo files into dest_path dir.
+                await self.ffmpeg_client.record_photo(
+                    RecordPhotoArgs(
+                        ip_address=ip,
+                        port=str(port),
+                        destination_path=dest_path,
+                        rtsp_user=self.user,
+                        rtsp_password=self.pwd,
+                        extension="jpg",
+                        frames=1,
+                    )
+                )
+                # Extraction of video files into dest_path dir.
+                await self.ffmpeg_client.record_video(
+                    RecordVideoArgs(
+                        destination_path=dest_path,
+                        ip_address=ip,
+                        port=str(port),
+                        rtsp_user=self.user,
+                        rtsp_password=self.pwd,
+                        extension="mp3",
+                        duration=10,
+                    )
+                )
+            except ConnectionError as error:
+                raise NetcameraConnectionError(reason=error)
+
+    async def execute(self) -> GetMediaFilesUseCaseOutput:
+        if are_equal(self.protocol, "rtsp"):
+            await self._retieve_with_rtsp()
+        else:
+            raise NotImplementedError(
+                f"The media files extraction with {self.protocol} is not implemented yet."
+            )
+        return GetMediaFilesUseCaseOutput()

saviialib/services/netcamera/use_cases/types/get_media_files_types.py

@@ -0,0 +1,18 @@
+from dataclasses import dataclass
+from logging import Logger
+from typing import Dict, Tuple
+
+
+@dataclass
+class GetMediaFilesUseCaseInput:
+    cameras: Dict[str, Tuple[str, int]]
+    username: str
+    password: str
+    protocol: str
+    logger: Logger
+    destination_path: str
+
+
+@dataclass
+class GetMediaFilesUseCaseOutput:
+    pass

saviialib/services/shakes/api.py

@@ -0,0 +1,31 @@
+from .controllers.get_miniseed_files import (
+    GetMiniseedFilesController,
+    GetMiniseedFilesControllerInput,
+)
+from saviialib.general_types.api.saviia_shakes_api_types import SaviiaShakesConfig
+
+from typing import Dict
+
+
+class ShakesAPI:
+    """This class provides methods for interacting with Raspberry Shakes"""
+
+    def __init__(self, config: SaviiaShakesConfig) -> None:
+        self.config = config
+
+    async def get_miniseed_files(self, raspberry_shakes: Dict[str, str]):
+        """Download the MiniSEED files from the SFTP Server provided by each Raspberry Shake.
+        Args:
+            raspberry_shakes (dict): Dictionary where the key is the name of the Raspberry Shake,
+                and the value is the IP Address.
+        Returns:
+            response (dict): A dictionary containg the response from the download operation.
+                This response will tipically include the message, the response status, and metadata.
+        """
+        controller = GetMiniseedFilesController(
+            GetMiniseedFilesControllerInput(
+                config=self.config, raspberry_shakes=raspberry_shakes
+            )
+        )
+        response = await controller.execute()
+        return response.__dict__

saviialib/services/shakes/controllers/get_miniseed_files.py

@@ -0,0 +1,48 @@
+from .types.get_miniseed_files_types import (
+    GetMiniseedFilesControllerInput,
+    GetMiniseedFilesControllerOutput,
+)
+from saviialib.services.shakes.use_cases.get_miniseed_files import (
+    GetMiniseedFilesUseCase,
+    GetMiniseedFilesUseCaseInput,
+)
+from http import HTTPStatus
+from saviialib.general_types.error_types.api.saviia_api_error_types import (
+    ShakesNoContentError,
+)
+from saviialib.general_types.error_types.common.common_types import SftpClientError
+
+
+class GetMiniseedFilesController:
+    def __init__(self, input: GetMiniseedFilesControllerInput) -> None:
+        self.use_case = GetMiniseedFilesUseCase(
+            GetMiniseedFilesUseCaseInput(
+                raspberry_shakes=input.raspberry_shakes,
+                username=input.config.sftp_user,
+                password=input.config.sftp_password,
+                ssh_key_path=input.config.ssh_key_path,
+                port=input.config.sftp_port,
+                logger=input.config.logger,
+            )
+        )
+
+    async def execute(self) -> GetMiniseedFilesControllerOutput:
+        try:
+            res = await self.use_case.execute()
+            return GetMiniseedFilesControllerOutput(
+                message="The MiniSEED files have been downloaded succesfully!",
+                status=HTTPStatus.OK.value,
+                metadata=res.download_status,
+            )
+        except ShakesNoContentError as error:
+            return GetMiniseedFilesControllerOutput(
+                message="No files to upload.",
+                status=HTTPStatus.NO_CONTENT.value,
+                metadata={"error": error.__str__()},
+            )
+        except SftpClientError as error:
+            return GetMiniseedFilesControllerOutput(
+                message="An unexpected error ocurred during SFTP Client connection.",
+                status=HTTPStatus.REQUEST_TIMEOUT.value,
+                metadata={"error": error.__str__()},
+            )

saviialib/services/shakes/controllers/types/get_miniseed_files_types.py

@@ -0,0 +1,16 @@
+from dataclasses import dataclass
+from typing import Dict
+from saviialib.general_types.api.saviia_shakes_api_types import SaviiaShakesConfig
+
+
+@dataclass
+class GetMiniseedFilesControllerInput:
+    raspberry_shakes: Dict[str, str]
+    config: SaviiaShakesConfig
+
+
+@dataclass
+class GetMiniseedFilesControllerOutput:
+    status: int
+    metadata: Dict
+    message: str

saviialib/services/shakes/use_cases/get_miniseed_files.py

@@ -0,0 +1,79 @@
+import asyncio
+from .types.get_miniseed_files_types import (
+    GetMiniseedFilesUseCaseInput,
+    GetMiniseedFilesUseCaseOutput,
+)
+from typing import Dict, Any
+from saviialib.libs.sftp_client import (
+    SFTPClient,
+    SFTPClientInitArgs,
+    ListfilesArgs,
+    DownloadfilesArgs,
+)
+from saviialib.libs.directory_client import DirectoryClient, DirectoryClientArgs
+from saviialib.general_types.error_types.api.saviia_api_error_types import (
+    ShakesNoContentError,
+)
+from saviialib.general_types.error_types.common.common_types import SftpClientError
+from .utils.get_miniseed_files_utils import parse_downloaded_metadata
+
+
+class GetMiniseedFilesUseCase:
+    def __init__(self, input: GetMiniseedFilesUseCaseInput) -> None:
+        self.password = input.password
+        self.username = input.username
+        self.ssh_key_path = input.ssh_key_path
+        self.port = input.port
+        self.raspberry_shakes: Dict[str, str] = input.raspberry_shakes
+        self.dir_client = DirectoryClient(DirectoryClientArgs("os_client"))
+
+    def _initialize_sftp_client(self, ip_address: str):
+        return SFTPClient(
+            SFTPClientInitArgs(
+                "asyncssh_sftp",
+                password=self.password,
+                username=self.username,
+                ssh_key_path=self.ssh_key_path,
+                host=ip_address,
+                port=self.port,
+            )
+        )
+
+    async def _download_mseed_file(self, rs_name: str, rs_ip: str) -> Dict[str, Any]:
+        DEST_BASE_DIR = "./rshakes-mseed-files"
+        SOURCE_PATH = self.dir_client.join_paths("opt", "data", "archive")
+        local_path = self.dir_client.join_paths(DEST_BASE_DIR, rs_name)
+        if not await self.dir_client.isdir(local_path):
+            await self.dir_client.makedirs(local_path)
+        sftp_client = self._initialize_sftp_client(rs_ip)
+
+        local_files = await self.dir_client.listdir(local_path)
+        try:
+            sftp_files = await sftp_client.list_files(ListfilesArgs(path=SOURCE_PATH))
+            pending_files = set(sftp_files) - set(local_files)
+            if not pending_files:
+                raise ShakesNoContentError
+
+            await sftp_client.download_files(
+                DownloadfilesArgs(
+                    source_path=SOURCE_PATH,
+                    destination_path=local_path,
+                    files_to_download=list(pending_files),
+                )
+            )
+        except ConnectionError as error:
+            raise SftpClientError(reason=error)
+        return {
+            "rs_name": rs_name,
+            "destination_path": local_path,
+            "total_files": len(pending_files),
+        }
+
+    async def execute(self):
+        requests = []
+        for rs_name, rs_ip in self.raspberry_shakes:
+            requests.append(self._download_mseed_file(rs_name, rs_ip))
+        responses = await asyncio.gather(*requests, return_exceptions=True)
+        return GetMiniseedFilesUseCaseOutput(
+            download_status=parse_downloaded_metadata(responses),
+        )

saviialib/services/shakes/use_cases/types/get_miniseed_files_types.py

@@ -0,0 +1,18 @@
+from dataclasses import dataclass, field
+from typing import Dict
+from logging import Logger
+
+
+@dataclass
+class GetMiniseedFilesUseCaseInput:
+    raspberry_shakes: Dict[str, str]
+    username: str
+    password: str
+    ssh_key_path: str
+    port: int
+    logger: Logger
+
+
+@dataclass
+class GetMiniseedFilesUseCaseOutput:
+    download_status: Dict[str, str] = field(default_factory=dict)

saviialib/services/shakes/use_cases/utils/get_miniseed_files_utils.py

@@ -0,0 +1,11 @@
+from typing import Dict, List, Any
+
+
+def parse_downloaded_metadata(responses: List[Any]) -> Dict[str, Any]:
+    return {
+        x["rs_name"]: {
+            "destination_path": x["destination_path"],
+            "total_files": x["total_files"],
+        }
+        for x in responses
+    }

saviialib/services/thies/use_cases/components/create_thies_statistics_file.py

@@ -1,5 +1,4 @@
 from .thies_bp import THIESDayData
-from typing import List
 from logging import Logger
 from asyncio import to_thread
 from saviialib.libs.directory_client import DirectoryClient
@@ -134,7 +133,8 @@ async def create_thies_daily_statistics_file(
                 )
                 mean = (min_val + max_val) / 2
                 logger.warning(
-                    f"[thies_synchronization_lib] Mean value corrected to {mean}.")
+                    f"[thies_synchronization_lib] Mean value corrected to {mean}."
+                )
 
             if col in ["WD"]:  # Avoid error
                 rows.append(

saviialib/services/thies/use_cases/types/update_thies_data_types.py

@@ -1,6 +1,9 @@
 from dataclasses import dataclass, field
 from typing import Dict, List
-from saviialib.general_types.api.saviia_api_types import FtpClientConfig, SharepointConfig
+from saviialib.general_types.api.saviia_api_types import (
+    FtpClientConfig,
+    SharepointConfig,
+)
 from logging import Logger
 
 

saviialib/services/thies/use_cases/update_thies_data.py

@@ -67,7 +67,7 @@ class UpdateThiesDataUseCase:
     def _initialize_thies_ftp_client(self, config: FtpClientConfig) -> FTPClient:
         """Initialize the FTP client."""
         try:
-            return FTPClient(FtpClientInitArgs(config, client_name="aioftp_client"))
+            return FTPClient(FtpClientInitArgs(config, client_name="ftplib_client"))
         except RuntimeError as error:
             raise FtpClientError(error)
 
@@ -270,10 +270,10 @@ class UpdateThiesDataUseCase:
                     FtpReadFileArgs(file_path)
                 )
             except FileNotFoundError as error:
-                reason = str(error) + ". The file might not be available yet for statistics."
-                self.logger.warning(
-                    "[thies_synchronization_lib] Warning: %s", reason
+                reason = (
+                    str(error) + ". The file might not be available yet for statistics."
                 )
+                self.logger.warning("[thies_synchronization_lib] Warning: %s", reason)
                 self.logger.warning(
                     "[thies_synchronization_lib] Skipping the creation of daily statistics %s",
                     filename,

saviialib-1.5.0.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: saviialib
+Version: 1.5.0
+Summary: A client library for IoT projects in the RCER initiative
+License: MIT
+License-File: LICENSE
+Author: pedropablozavalat
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: aiofiles
+Requires-Dist: aioftp
+Requires-Dist: aiohttp
+Requires-Dist: asyncssh (==2.21.1)
+Requires-Dist: bitarray
+Requires-Dist: build
+Requires-Dist: certifi
+Requires-Dist: dotenv (>=0.9.9,<0.10.0)
+Requires-Dist: ffmpeg-asyncio (==0.1.3)
+Requires-Dist: numpy (>=2.2.0,<2.4.0)
+Requires-Dist: pandas (>=2.2.3,<2.3.1)
+Description-Content-Type: text/markdown
+
+# SAVIIA Library 
+*Sistema de Administración y Visualización de Información para la Investigación y Análisis*
+
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/pedrozavalat/saviia-lib?style=for-the-badge)](https://github.com/pedrozavalat/saviia-lib/releases)
+
+
+## Installation
+This library is designed for use with the SAVIIA Home Assistant Integration. It provides an API to retrieve files from a THIES Data Logger via an FTP server and upload them to a Microsoft SharePoint folder using the SharePoint REST API.
+
+```bash
+pip install saviialib
+```
+
+## Saviia API Client Usage
+
+### Initialize the Saviia API Client
+Import the necessary classes from the library.
+```python
+from saviialib import SaviiaAPI, SaviiaAPIConfig
+```
+
+To start using the library, you need to create an `SaviiaAPI` client instance with its configuration class `SaviiaAPIConfig`. Provide the required parameters such as FTP server details and SharePoint credentials:
+```python
+config = SaviiaAPIConfig(
+    ftp_port=FTP_PORT,
+    ftp_host=FTP_HOST,
+    ftp_user=FTP_USER,
+    ftp_password=FTP_PASSWORD,
+    sharepoint_client_id=SHAREPOINT_CLIENT_ID,
+    sharepoint_client_secret=SHAREPOINT_CLIENT_SECRET,
+    sharepoint_tenant_id=SHAREPOINT_TENANT_ID,
+    sharepoint_tenant_name=SHAREPOINT_TENANT_NAME,
+    sharepoint_site_name=SHAREPOINT_SITE_NAME
+)
+```
+```python
+api_client = SaviiaAPI(config)
+```
+**Notes:** 
+- Store sensitive data like `FTP_PASSWORD`, `FTP_USER`, and SharePoint credentials securely. Use environment variables or a secrets management tool to avoid hardcoding sensitive information in your codebase.
+
+### Access THIES Data Logger Services
+To interact with the THIES Data Logger services, you can access the `thies` attribute of the `SaviiaAPI` instance:
+```python
+thies_client = api_client.get('thies')
+```
+This instance provides methods to interact with the THIES Data Logger. Currently, it includes the main method for extracting files from the FTP server and uploading them to SharePoint.
+
+#### THIES files extraction and synchronization
+The library provides a method to extract and synchronize THIES Data Logger files with the Microsoft SharePoint client. This method downloads files from the FTP server and uploads them to the specified SharePoint folder:
+```python 
+import asyncio
+async def main():
+    # Before calling this method, you must have initialised the THIES service class ...
+    response = await thies_client.update_thies_data()
+    return response
+
+asyncio.run(main())
+```
+
+### Access Backup Services
+To interact with the Backup services, you can access the `backup` attribute of the `SaviiaAPI` instance:
+```python
+backup_client = api_client.get('backup')
+```
+This instance provides methods to interact with the Backup services. Currently, it includes the main method for creating backups of specified directories in a local folder from Home Assistant environment. Then each backup file is uploaded to a Microsoft SharePoint folder.
+
+#### Create Backup
+The library provides a method which creates a backup of a specified directory in a local folder from Home Assistant environment. Then each backup file is uploaded to a Microsoft SharePoint folder: 
+
+```python
+import asyncio
+async def main():
+    # Before calling this method, you must have initialised the Backup service class ...
+    response = await backup_client.upload_backup_to_sharepoint(
+        local_backup_path=LOCAL_BACKUP_PATH,
+        sharepoint_folder_path=SHAREPOINT_FOLDER_PATH
+    )
+    return response
+asyncio.run(main())
+```
+**Notes:**
+- Ensure that the `local_backup_path` exists and contains the files you want to back up. It is a relative path from the Home Assistant configuration directory.
+- The `sharepoint_folder_path` should be the path to the folder in SharePoint where you want to upload the backup files. For example, if your url is `https://yourtenant.sharepoint.com/sites/yoursite/Shared Documents/Backups`, the folder path would be `sites/yoursite/Shared Documents/Backups`.
+
+
+
+
+
+
+
+## Contributing
+If you're interested in contributing to this project, please follow the contributing guidelines. By contributing to this project, you agree to abide by its terms.
+Contributions are welcome and appreciated!
+
+## License
+
+`saviialib` was created by Pedro Pablo Zavala Tejos. It is licensed under the terms of the MIT license.
+

{saviialib-1.4.0.dist-info → saviialib-1.5.0.dist-info}/RECORD

@@ -1,19 +1,27 @@
-saviialib/__init__.py,sha256=jhd-pnya5KnMxjOvpU0_fBo1WajPwt2Miz8wgCpWulo,3030
+saviialib/__init__.py,sha256=pn4KYFwPsVe43mw1e0svWiqA0StzM2B5Cr0iPc481I0,3074
 saviialib/general_types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 saviialib/general_types/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-saviialib/general_types/api/saviia_api_types.py,sha256=3pryGPpvhXDZVwAJUwY-o95rUm7MjhB7QzUWQ5l0faY,1317
+saviialib/general_types/api/saviia_api_types.py,sha256=kX45V3KQb48S1jEstXcAtbiemVUgemJE_XK5qP7BJm0,1318
 saviialib/general_types/api/saviia_backup_api_types.py,sha256=mtXRxFjBOqfUBWWtgLZxNq-vb_mBkCUS9fxoFRJfoYE,791
+saviialib/general_types/api/saviia_netcamera_api_types.py,sha256=WVA3VP_FiTGPhtTl8GCG2RAVo7YDS5TTyl-0I5rUK4Y,208
+saviialib/general_types/api/saviia_shakes_api_types.py,sha256=XlLwfCyFeQXk9kH7H0EcUJHIigj9edFKgn3wKGJ1Z94,623
 saviialib/general_types/api/saviia_thies_api_types.py,sha256=ueqOFjHvRuT-N8H1UZEVXErgK1S1iRw0AXeO8bTdBts,1017
 saviialib/general_types/error_types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 saviialib/general_types/error_types/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-saviialib/general_types/error_types/api/saviia_api_error_types.py,sha256=iprpNvVoNA3vakMm7-dQdjCv7ZrRs6tRiXK1uaV3DNU,3049
+saviialib/general_types/error_types/api/saviia_api_error_types.py,sha256=BcDhteS4KsFNCm3L9ZQJTQKs0bKRXq3LgM4mfxsW-HY,3270
+saviialib/general_types/error_types/api/saviia_netcamera_error_types.py,sha256=ipdY8PDJOFLxjgUIWc09cuaiHzPtBvAb7YKoosTL0wY,246
 saviialib/general_types/error_types/common/__init__.py,sha256=yOBLZbt64Ki9Q0IJ0tMAubgq7PtrQ7XQ3RgtAzyOjiE,170
-saviialib/general_types/error_types/common/common_types.py,sha256=n5yuw-gVtkrtNfmaZ83ZkYxYHGl4jynOLUB9C8Tr32w,474
+saviialib/general_types/error_types/common/common_types.py,sha256=2w790TQNRLc4UskXNHAh8RMZIJLA8FYyQbVxkPp89UA,717
 saviialib/libs/directory_client/__init__.py,sha256=ys07nzp74fHew2mUkbGpntp5w4t_PnhZIS6D4_mJw2A,162
-saviialib/libs/directory_client/client/os_client.py,sha256=TgDnIQvgMP7sIVjn5kAKEJ5BYET7pN-FIQP0lvFMl4Q,763
+saviialib/libs/directory_client/client/os_client.py,sha256=mBIQc8ek8mDY6GMCX-cPNLleM4RbFdqoiuw5Ccoe3YA,763
 saviialib/libs/directory_client/directory_client.py,sha256=5HmB1Pt9M8Tk18WKzfh3Fwr8gKa_RZCdAqvbU0rg7mw,1086
 saviialib/libs/directory_client/directory_client_contract.py,sha256=wtNaUak1a7r6t9OI1L2ou7XMMJFXWpQFb7WyT6X7fCQ,479
 saviialib/libs/directory_client/types/directory_client_types.py,sha256=ncMwVs_o6EYMuypXXmVInsjVDKJsdxVkmwj1M-LEInA,109
+saviialib/libs/ffmpeg_client/__init__.py,sha256=KjOP--Uv0Z-qvoJI9IwwBrU3ZrroaC55zDG7fm9DEts,207
+saviialib/libs/ffmpeg_client/clients/ffmpeg_asyncio_client.py,sha256=eqm7sNm4BY3WaxobXbeoS39DfzfwtICgmQAm9UE7yZw,3639
+saviialib/libs/ffmpeg_client/ffmpeg_client.py,sha256=evqhjQeT9VejtJ8Gb7A3Vjxoj0PT4n7JnbbsuO7-35U,870
+saviialib/libs/ffmpeg_client/ffmpeg_client_contract.py,sha256=mvGrGYkikExz4VyAErcSu6Sd2utYYm9bqxJj1N22z2U,324
+saviialib/libs/ffmpeg_client/types/ffmpeg_client_types.py,sha256=Vo062LHqfTLgRbwLloZMRkC36CO3r9tFqY97nVxr8vE,444
 saviialib/libs/files_client/__init__.py,sha256=sIi9ne7Z3EfxnqGTaSmH-cZ8QsKyu0hoOz61GyA3njs,192
 saviialib/libs/files_client/clients/aiofiles_client.py,sha256=Mu5pSnnEa3dT3GONmt1O-lCQstuQNXHtJHM3D2L6TU8,1107
 saviialib/libs/files_client/clients/csv_client.py,sha256=Rk4QbiKlVKrYxYtxQt-Pmkp9QoB_dNgs5r36JB9hU0o,1478
@@ -28,14 +36,20 @@ saviialib/libs/ftp_client/ftp_client.py,sha256=Naj9p0yYWlXt9um0zKfvuHSoycM8JZg2S
 saviialib/libs/ftp_client/ftp_client_contract.py,sha256=tymkugDzsJ5PzUXIaSkwX1h7T0naR15qAkjrqswqDyM,338
 saviialib/libs/ftp_client/types/__init__.py,sha256=syfwf9feP4QK7fkCTfl4j8l11ic-jHtfi1DE2chaWbs,155
 saviialib/libs/ftp_client/types/ftp_client_types.py,sha256=e4SmYkewldulaD8ms2q75zVgLFXyBxBqoa_L-IQOmso,256
+saviialib/libs/sftp_client/__init__.py,sha256=f51sFOd_XIhhd6x6AZ3ZdbJ86hO1xnqAk9MmEjwRJ-c,229
+saviialib/libs/sftp_client/clients/asyncssh_sftp_client.py,sha256=vqCKHIx3K6QFujQP5DIAB5EYOz1zAdhi825LTRvhG20,3469
+saviialib/libs/sftp_client/sftp_client.py,sha256=_5HRYSBPadxZEdHuHSpQ_VrwerBfu24izNRg-pvLzlU,918
+saviialib/libs/sftp_client/sftp_client_contract.py,sha256=JWWxIfNBXcsBd8z3gQHGpeRASRjtP9WGkznoMfP0IZc,365
+saviialib/libs/sftp_client/types/sftp_client_types.py,sha256=NzUZVq6yeGKkO7KF-v4Cc-rwaWeOgFCUGVPL1YBbYgA,446
 saviialib/libs/sharepoint_client/__init__.py,sha256=6RbEzFtCfMrrY8F0JOCVcK6Gqt1FBJ09m0NuWHMCmCI,384
-saviialib/libs/sharepoint_client/clients/sharepoint_rest_api.py,sha256=LOdaY16yu-aqOJuwvK2i5XbW6JU4cunvf9kgsW-PF5k,6318
+saviialib/libs/sharepoint_client/clients/sharepoint_rest_api.py,sha256=I3OfZ5M4uR86hLIBOlOQzGNyTzQRy1yckrLF1ne7F1g,6319
 saviialib/libs/sharepoint_client/sharepoint_client.py,sha256=gXFisWWCk6pKhoEeaNN8dcHA5ywrGDLqfiKjchrHRy0,1816
 saviialib/libs/sharepoint_client/sharepoint_client_contract.py,sha256=H-WsXR5f50jy5RRYNlgV61y_YGjOUq4U_E1DWUUrDYw,612
 saviialib/libs/sharepoint_client/types/sharepoint_client_types.py,sha256=JruUCn6o16w00t4zxDrxmv_Bxa52UyShGYmwUFfBCCQ,482
 saviialib/libs/zero_dependency/utils/datetime_utils.py,sha256=c2H_JpUKpunCzDw6I4alDWNftEqaciWGtEUklPepm_s,759
+saviialib/libs/zero_dependency/utils/strings_utils.py,sha256=XqEukvCLkQ0PhjjPm9FTjrzbwBYMejs-0uSoLwSxhPo,133
 saviialib/services/backup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-saviialib/services/backup/api.py,sha256=LQAsf3JEY58_b0McgmR0FxX3dZgZ9I729Gu081_OQm4,1414
+saviialib/services/backup/api.py,sha256=S1dMGyyjYzVyo-E8FMttHZMOO2TtQoAMaLp-oquW46g,1408
 saviialib/services/backup/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 saviialib/services/backup/controllers/types/__init__.py,sha256=0zIWXQb6YQVIIbb5b_FeL-D9Zy_d1GqR8kVz3hen4IU,222
 saviialib/services/backup/controllers/types/upload_backup_to_sharepoint_types.py,sha256=AzoHx3AWrVCM8LjmlEovDlRe4kJPJBbRoMToG8QK_Nw,464
@@ -46,16 +60,28 @@ saviialib/services/backup/use_cases/types/upload_backup_to_sharepoint_types.py,s
 saviialib/services/backup/use_cases/upload_backup_to_sharepoint.py,sha256=tBAfztcXdr3pmJqhwdHKc6AbddajZubs_wkL93Wajv4,11890
 saviialib/services/backup/utils/__init__.py,sha256=Khz07TAC17xGBbkSgNcOXSjzeFm6-NiQadNJ3R7tRgg,112
 saviialib/services/backup/utils/upload_backup_to_sharepoint_utils.py,sha256=J2PkLvNFHqka4NLW4lrAdaK5pRgHnU3ZSOflO43uu78,3530
+saviialib/services/netcamera/api.py,sha256=W8ZKfh_iGEvfE36yGXYH9RlveUUtHoxQI_E3__YGfq0,1182
+saviialib/services/netcamera/controllers/get_media_files.py,sha256=CEfZ7YRhXBcuGeK3HWB3Bpp-i-pIvAs70krreCHL_eA,1507
+saviialib/services/netcamera/controllers/types/get_media_files_types.py,sha256=40V0ARqtloRM16KYYxzeq5aQU-mrghEK7FfkeFoSmbk,417
+saviialib/services/netcamera/use_cases/get_media_files.py,sha256=ct_MOOgxzqCURQo2JJx1ioBaO-Qq-Gj-27Y4JAdZbeo,2801
+saviialib/services/netcamera/use_cases/types/get_media_files_types.py,sha256=XCpodI-WdZYbhd3DD1LkKDgLTSRKlXkHClbhwT8zXm8,333
+saviialib/services/shakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+saviialib/services/shakes/api.py,sha256=WvmOJ35lPdJuqSEl9-q9VOGNxqkqvzfBUmkp-G8WKj4,1230
+saviialib/services/shakes/controllers/get_miniseed_files.py,sha256=k55QiIQoNHyMQsgW939IbrPY4tHy8cFMg51LDVQQSgs,1934
+saviialib/services/shakes/controllers/types/get_miniseed_files_types.py,sha256=LZ8LZxpjPYrl-EIuwQixXl8z4Ygl81DgodoHyxzvIxY,366
+saviialib/services/shakes/use_cases/get_miniseed_files.py,sha256=HD6VphToOF8eq-J281qOg9AgeD6hFAsVfScwvP5c9jc,3033
+saviialib/services/shakes/use_cases/types/get_miniseed_files_types.py,sha256=bb5XurP08pHhhNK80dvgoSP_OmHFEdKhT-jzyd8w5kk,385
+saviialib/services/shakes/use_cases/utils/get_miniseed_files_utils.py,sha256=6TEdu9MglnM0_FTuxs9BETneXqQBUGb-Q1rDKhvRLvg,288
 saviialib/services/thies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 saviialib/services/thies/api.py,sha256=ibXBSzs_LJjZbC9LWh1EcHMWUp5qWTz-P_qOIb3rx6Y,1365
 saviialib/services/thies/controllers/types/update_thies_data_types.py,sha256=YSLd0HgkeB7auTXFjZVYz_g9jv2hY2vaK7x6VLZ2BK4,439
 saviialib/services/thies/controllers/update_thies_data.py,sha256=j_orYJfom4lo8xm8Jsru1h8JjDFI4xAfUL2oSM_XpcE,4890
-saviialib/services/thies/use_cases/components/create_thies_statistics_file.py,sha256=yH2rd66qjvYbPwpJem-GX9iXGY02NrkRj1jVSfFs4tI,5582
+saviialib/services/thies/use_cases/components/create_thies_statistics_file.py,sha256=_1wY_yI_Lg2QTOGag4lVZBWM3B1gp2Duz7ore-kOHhQ,5575
 saviialib/services/thies/use_cases/components/thies_bp.py,sha256=1Iq5Wz3kqzJfQNawV_v8ORr_Pl-PoamFp_2Xo8DjvmI,15042
-saviialib/services/thies/use_cases/types/update_thies_data_types.py,sha256=VoK9wIRuBF72beEYU3sLUhBQ8Mi-3mi2jJTZ9mKjqbo,541
-saviialib/services/thies/use_cases/update_thies_data.py,sha256=jiD0CHN7SQM60m6aEtZvyHkuV8PPCiFVd8uweaoshLY,14960
+saviialib/services/thies/use_cases/types/update_thies_data_types.py,sha256=S9_oS4Laygh_XIQoKWzaLd9QrAjVajyHcgJgbzEFPww,554
+saviialib/services/thies/use_cases/update_thies_data.py,sha256=6l3AvFRwDMTCChJfMR_f1Y6ejDNiy9eKlD1mfxqFjPw,14962
 saviialib/services/thies/utils/update_thies_data_utils.py,sha256=EpjYWXqyHxJ-dO3MHhdXp-rGV7WyUckeFko-nnfnNac,555
-saviialib-1.4.0.dist-info/METADATA,sha256=wFykbY3s8rYATm7zmctuKA8ilE8-WJqcYqpvoTItwqM,4166
-saviialib-1.4.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-saviialib-1.4.0.dist-info/licenses/LICENSE,sha256=NWpf6b38xgBWPBo5HZsCbdfp9hZSliEbRqWQgm0fkOo,1076
-saviialib-1.4.0.dist-info/RECORD,,
+saviialib-1.5.0.dist-info/METADATA,sha256=gp3HoVlafLCIXXrjex5UmaJHV-2a8uBYpap7EzpkAEk,5235
+saviialib-1.5.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+saviialib-1.5.0.dist-info/licenses/LICENSE,sha256=NWpf6b38xgBWPBo5HZsCbdfp9hZSliEbRqWQgm0fkOo,1076
+saviialib-1.5.0.dist-info/RECORD,,

saviialib-1.4.0.dist-info/METADATA

@@ -1,124 +0,0 @@
-Metadata-Version: 2.4
-Name: saviialib
-Version: 1.4.0
-Summary: A client library for IoT projects in the RCER initiative
-License: MIT
-License-File: LICENSE
-Author: pedropablozavalat
-Requires-Python: >=3.11,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: aiofiles
-Requires-Dist: aioftp
-Requires-Dist: aiohttp
-Requires-Dist: bitarray
-Requires-Dist: build
-Requires-Dist: certifi
-Requires-Dist: dotenv (>=0.9.9,<0.10.0)
-Requires-Dist: numpy (>=2.2.0,<2.4.0)
-Requires-Dist: pandas (>=2.2.3,<2.3.1)
-Description-Content-Type: text/markdown
-
-# SAVIIA Library 
-*Sistema de Administración y Visualización de Información para la Investigación y Análisis*
-
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/pedrozavalat/saviia-lib?style=for-the-badge)](https://github.com/pedrozavalat/saviia-lib/releases)
-
-
-## Installation
-This library is designed for use with the SAVIIA Home Assistant Integration. It provides an API to retrieve files from a THIES Data Logger via an FTP server and upload them to a Microsoft SharePoint folder using the SharePoint REST API.
-
-```bash
-pip install saviialib
-```
-
-## Usage
-
-### Initialize the EPii API Client
-To start using the library, you need to create an `EpiiAPI` client instance with its configuration class:
-
-```python
-from saviialib import EpiiAPI, EpiiAPIConfig
-config = EpiiAPIConfig(
-        ftp_port=FTP_PORT,
-        ftp_host=FTP_HOST,
-        ftp_user=FTP_USER,
-        ftp_password=FTP_PASSWORD,
-        sharepoint_client_id=SHAREPOINT_CLIENT_ID,
-        sharepoint_client_secret=SHAREPOINT_CLIENT_SECRET,
-        sharepoint_tenant_id=SHAREPOINT_TENANT_ID,
-        sharepoint_tenant_name=SHAREPOINT_TENANT_NAME,
-        sharepoint_site_name=SHAREPOINT_SITE_NAME
-    )
-api_client = EpiiAPI(config)
-```
-**Notes:** 
-- Store sensitive data like `FTP_PASSWORD`, `FTP_USER`, and SharePoint credentials securely. Use environment variables or a secrets management tool to avoid hardcoding sensitive information in your codebase.
-
-### Update THIES Data Logger Files
-The library provides a method to synchronize THIES Data Logger files with the RCER SharePoint client. This method updates the folder containing binary files with meteorological data:
-
-```python
-from saviialib import EpiiUpdateThiesConfig
-import asyncio
-
-async def main():
-    # Before calling this method, you must have initialised the api class ...
-    response = await api_client.update_thies_data()
-    return response
-
-asyncio.run(main())
-```
-
-## Development
-
-This project includes a `Makefile` to simplify common tasks. Below are the available commands:
-
-### Install Basic Dependencies
-To install the basic dependencies required for the project, run the following command:
-
-```bash
-make install-deps
-```
-
-This will ensure that all necessary libraries and tools are installed for the project to function properly.
-
-### Install Development Requirements
-For setting up a development environment with additional tools and libraries, execute:
-
-```bash
-make dev
-```
-
-This command installs all the dependencies needed for development, including testing and linting tools.
-
-### Run Tests
-To verify that the code is functioning as expected, you can run the test suite using:
-
-```bash
-make test
-```
-
-This will execute all the tests in the project and provide a summary of the results.
-
-### Lint the Code
-To ensure that the code adheres to the project's style guidelines and is free of common errors, run:
-
-```bash
-make lint
-```
-
-This command checks the codebase for linting issues and outputs any problems that need to be addressed.
-
-## Contributing
-If you're interested in contributing to this project, please follow the contributing guidelines. By contributing to this project, you agree to abide by its terms.
-Contributions are welcome and appreciated!
-
-## License
-
-`saviialib` was created by Pedro Pablo Zavala Tejos. It is licensed under the terms of the MIT license.
-