saviialib 1.3.0__tar.gz → 1.5.0__tar.gz

saviialib-1.5.0/PKG-INFO

@@ -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.5.0/README.md

@@ -0,0 +1,98 @@
+# 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.3.0 → saviialib-1.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "saviialib"
-version = "1.3.0"
+version = "1.5.0"
 description = "A client library for IoT projects in the RCER initiative"
 authors = ["pedropablozavalat"]
 license = "MIT"
@@ -12,11 +12,13 @@ aioftp = "*"
 aiohttp = "*"
 aiofiles = "*"
 dotenv = "^0.9.9"
-pytest-cov="^6.1.1"
 build="*"
 numpy = ">=2.2.0,<2.4.0"
 pandas = ">=2.2.3,<2.3.1"
 bitarray="*"
+certifi="*"
+ffmpeg-asyncio="0.1.3"
+asyncssh="2.21.1"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "8.3.5"

saviialib-1.5.0/src/saviialib/__init__.py

@@ -0,0 +1,79 @@
+# read version from installed package
+from importlib.metadata import version
+
+__version__ = version("saviialib")
+
+from .general_types.api.saviia_api_types import SaviiaAPIConfig
+
+from typing import Dict, Type, Any, overload, Literal, List
+
+from saviialib.services.backup.api import SaviiaBackupAPI
+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] = {
+        "thies": SaviiaThiesAPI,
+        "backup": SaviiaBackupAPI,
+    }
+
+    @overload
+    def get(self, name: Literal["thies"]) -> SaviiaThiesAPI: ...
+    @overload
+    def get(self, name: Literal["backup"]) -> SaviiaBackupAPI: ...
+
+    def __init__(self, config: SaviiaAPIConfig):
+        """
+        Receive a dictionary of configurations, with the same key
+        as those registered in API_REGISTRY.
+
+        :params configs: Dictionary of configurations for each API.
+
+        Example:
+            configs = {
+                "thies": SaviiaThiesConfig(...),
+                "backup": SaviiaBackupConfig(...)
+            }
+        """
+        self._instances: Dict[str, Any] = {}
+
+        for name, api_class in SaviiaAPI.API_REGISTRY.items():
+            if name == "thies":
+                service_config = SaviiaThiesConfig(
+                    ftp_host=config.ftp_host,
+                    ftp_port=config.ftp_port,
+                    ftp_user=config.ftp_user,
+                    ftp_password=config.ftp_password,
+                    sharepoint_client_id=config.sharepoint_client_id,
+                    sharepoint_client_secret=config.sharepoint_client_secret,
+                    sharepoint_tenant_id=config.sharepoint_tenant_id,
+                    sharepoint_tenant_name=config.sharepoint_tenant_name,
+                    sharepoint_site_name=config.sharepoint_site_name,
+                    logger=config.logger,
+                )
+            elif name == "backup":
+                service_config = SaviiaBackupConfig(
+                    sharepoint_client_id=config.sharepoint_client_id,
+                    sharepoint_client_secret=config.sharepoint_client_secret,
+                    sharepoint_tenant_id=config.sharepoint_tenant_id,
+                    sharepoint_tenant_name=config.sharepoint_tenant_name,
+                    sharepoint_site_name=config.sharepoint_site_name,
+                    logger=config.logger,
+                )
+
+            self._instances[name] = api_class(service_config)
+
+    def get(self, name: Literal["thies", "backup"]) -> Any:
+        """Returns the API instance associated with the given name."""
+        try:
+            return self._instances[name]
+        except KeyError:
+            raise ValueError(f"API '{name}' is not registered or not configured.")
+
+    def list_available(self) -> List[str]:
+        """List of available registered APIs."""
+        return list(self._instances.keys())

saviialib-1.3.0/src/saviialib/general_types/api/epii_api_types.py → saviialib-1.5.0/src/saviialib/general_types/api/saviia_api_types.py

@@ -3,9 +3,9 @@ from logging import Logger
 
 
 @dataclass
-class EpiiAPIConfig:
+class SaviiaAPIConfig:
     """
-    Configuration for Epii API.
+    Configuration for SAVIIA API.
 
     Attributes:
         ftp_port (int): Port number of the FTP server.
@@ -46,39 +46,3 @@ class SharepointConfig:
     sharepoint_tenant_id: str
     sharepoint_tenant_name: str
     sharepoint_site_name: str
-
-
-@dataclass
-class EpiiUpdateThiesConfig:
-    ftp_port: int
-    ftp_host: str
-    ftp_user: str
-    ftp_password: str
-    sharepoint_client_id: str
-    sharepoint_client_secret: str
-    sharepoint_tenant_id: str
-    sharepoint_tenant_name: str
-    sharepoint_site_name: str
-    logger: Logger
-
-
-@dataclass
-class EpiiSharepointBackupConfig:
-    """
-    Configuration for backing up files to SharePoint.
-
-    Attributes:
-        sharepoint_client_id (str): Client ID for SharePoint authentication.
-        sharepoint_client_secret (str): Client secret for SharePoint authentication.
-        sharepoint_tenant_id (str): Tenant ID for SharePoint authentication.
-        sharepoint_tenant_name (str): Tenant name for SharePoint.
-        sharepoint_site_name (str): Site name in SharePoint.
-        local_backup_source_path (str): Local path to backup.
-    """
-
-    sharepoint_client_id: str
-    sharepoint_client_secret: str
-    sharepoint_tenant_id: str
-    sharepoint_tenant_name: str
-    sharepoint_site_name: str
-    logger: Logger

saviialib-1.5.0/src/saviialib/general_types/api/saviia_backup_api_types.py

@@ -0,0 +1,24 @@
+from dataclasses import dataclass
+from logging import Logger
+
+
+@dataclass
+class SaviiaBackupConfig:
+    """
+    Configuration for backing up files to SharePoint.
+
+    Attributes:
+        sharepoint_client_id (str): Client ID for SharePoint authentication.
+        sharepoint_client_secret (str): Client secret for SharePoint authentication.
+        sharepoint_tenant_id (str): Tenant ID for SharePoint authentication.
+        sharepoint_tenant_name (str): Tenant name for SharePoint.
+        sharepoint_site_name (str): Site name in SharePoint.
+        local_backup_source_path (str): Local path to backup.
+    """
+
+    sharepoint_client_id: str
+    sharepoint_client_secret: str
+    sharepoint_tenant_id: str
+    sharepoint_tenant_name: str
+    sharepoint_site_name: str
+    logger: Logger

saviialib-1.5.0/src/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-1.5.0/src/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-1.5.0/src/saviialib/general_types/api/saviia_thies_api_types.py

@@ -0,0 +1,31 @@
+from dataclasses import dataclass
+from logging import Logger
+
+
+@dataclass
+class SaviiaThiesConfig:
+    """
+    Configuration for Saviia Thies.
+
+    Attributes:
+        ftp_port (int): Port number of the FTP server.
+        ftp_host (str): Hostname or IP address of the FTP server.
+        ftp_user (str): Username for the FTP server.
+        ftp_password (str): Password for the FTP server.
+        sharepoint_client_id (str): Client ID for SharePoint authentication.
+        sharepoint_client_secret (str): Client secret for SharePoint authentication.
+        sharepoint_tenant_id (str): Tenant ID for SharePoint authentication.
+        sharepoint_tenant_name (str): Tenant name for SharePoint.
+        sharepoint_site_name (str): Site name in SharePoint.
+    """
+
+    ftp_host: str
+    ftp_port: int
+    ftp_user: str
+    ftp_password: str
+    sharepoint_client_id: str
+    sharepoint_client_secret: str
+    sharepoint_tenant_id: str
+    sharepoint_tenant_name: str
+    sharepoint_site_name: str
+    logger: Logger

saviialib-1.3.0/src/saviialib/general_types/error_types/api/epii_api_error_types.py → saviialib-1.5.0/src/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-1.5.0/src/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-1.3.0 → saviialib-1.5.0}/src/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-1.3.0 → saviialib-1.5.0}/src/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-1.5.0/src/saviialib/libs/ffmpeg_client/__init__.py

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

saviialib-1.5.0/src/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-1.5.0/src/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-1.5.0/src/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