rcer-iot-client-pkg 0.3.1__py3-none-any.whl → 0.4.0__py3-none-any.whl

rcer_iot_client_pkg/general_types/error_types/api/update_thies_data_error_types.py

@@ -1,19 +1,30 @@
-class ThiesUploadEmptyError(Exception):
-    """Raised when no files are found to upload to the server."""
+class ThiesConnectionError(Exception):
+    """Raised when unable to connect to the THIES FTP Server"""
+
+    def __init__(self, *args, reason):
+        super().__init__(*args, reason)
+        self.reason = reason
 
     def __str__(self):
-        return "No files were found to upload."
+        return "Unable to connect to THIES FTP Server. " + self.reason.__str__()
 
 
-class FetchCloudFileNamesError(Exception):
-    """Raised when there is an error fetching file names from the RCER cloud."""
+class ThiesFetchingError(Exception):
+    """Raised when no files are found to upload to the server."""
+
+    def __init__(self, *args, reason):
+        super().__init__(*args, reason)
+        self.reason = reason
 
     def __str__(self):
-        return "An error occurred while retrieving file names from the RCER cloud"
+        return (
+            "An error ocurred while retrieving files from THIES FTP Server. "
+            + self.reason.__str__()
+        )
 
 
-class FetchThiesFileContentError(Exception):
-    """Raised when there is an error fetching the content of a Thies file."""
+class SharePointFetchingError(Exception):
+    """Raised when there is an error fetching file names from the RCER cloud."""
 
     def __str__(self):
-        return "An error occurred while retrieving the content of a Thies file"
+        return "An error occurred while retrieving file names from the RCER cloud"

rcer_iot_client_pkg/general_types/error_types/common/__init__.py

@@ -1,7 +1,7 @@
 from .common_types import (
     EmptyDataError,
     FtpClientError,
-    HttpClientError,
+    SharepointClientError,
 )
 
-__all__ = ["EmptyDataError", "HttpClientError", "FtpClientError"]
+__all__ = ["EmptyDataError", "SharepointClientError", "FtpClientError"]

rcer_iot_client_pkg/general_types/error_types/common/common_types.py

@@ -1,11 +1,15 @@
 class EmptyDataError(Exception):
+    def __init__(self, *args, reason):
+        super().__init__(*args, reason)
+        self.reason = reason
+
     def __str__(self):
-        return "The data provided is empty."
+        return "The data provided is empty. " + self.reason.__str__()
 
 
-class HttpClientError(Exception):
+class SharepointClientError(Exception):
     def __str__(self):
-        return "Http Client initialization fails."
+        return "SharePoint API REST Client initialization fails."
 
 
 class FtpClientError(Exception):

rcer_iot_client_pkg/libs/ftp_client/__init__.py

@@ -1,4 +1,4 @@
 from .ftp_client import FTPClient
-from .types import FtpClientInitArgs, ListFilesArgs, ReadFileArgs
+from .types import FtpClientInitArgs, FtpListFilesArgs, FtpReadFileArgs
 
-__all__ = ["FTPClient", "FtpClientInitArgs", "ListFilesArgs", "ReadFileArgs"]
+__all__ = ["FTPClient", "FtpClientInitArgs", "FtpListFilesArgs", "FtpReadFileArgs"]

rcer_iot_client_pkg/libs/ftp_client/clients/aioftp_client.py

@@ -1,12 +1,12 @@
 from aioftp import Client
-
+from aioftp.errors import StatusCodeError
 from rcer_iot_client_pkg.libs.ftp_client.ftp_client_contract import (
     FTPClientContract,
 )
 from rcer_iot_client_pkg.libs.ftp_client.types.ftp_client_types import (
     FtpClientInitArgs,
-    ListFilesArgs,
-    ReadFileArgs,
+    FtpListFilesArgs,
+    FtpReadFileArgs,
 )
 
 
@@ -19,19 +19,27 @@ class AioFTPClient(FTPClientContract):
         self.client = Client()
 
     async def _async_start(self) -> None:
-        try: 
+        try:
             await self.client.connect(host=self.host, port=self.port)
+        except OSError:
+            raise ConnectionRefusedError(
+                f"{self.host}:{self.port} isn't active. "
+                "Please ensure the server is running and accessible."
+            )
+        try:
             await self.client.login(user=self.user, password=self.password)
-        except Exception:
-            raise RuntimeError("Unexpected error occurred while trying to connect to the FTP server")
+        except StatusCodeError:
+            raise ConnectionAbortedError(
+                "Authentication failed. Please verify your credentials and try again."
+            )
 
-    async def list_files(self, args: ListFilesArgs) -> list[str]:
+    async def list_files(self, args: FtpListFilesArgs) -> list[str]:
         await self._async_start()
         return [
             path.name async for path, _ in self.client.list(args.path, recursive=False)
         ]
 
-    async def read_file(self, args: ReadFileArgs) -> bytes:
+    async def read_file(self, args: FtpReadFileArgs) -> bytes:
         await self._async_start()
         async with self.client.download_stream(args.file_path) as stream:
             return await stream.read()

rcer_iot_client_pkg/libs/ftp_client/ftp_client.py

@@ -1,6 +1,6 @@
 from .clients.aioftp_client import AioFTPClient
 from .ftp_client_contract import FTPClientContract
-from .types.ftp_client_types import FtpClientInitArgs, ListFilesArgs, ReadFileArgs
+from .types.ftp_client_types import FtpClientInitArgs, FtpListFilesArgs, FtpReadFileArgs
 
 
 class FTPClient(FTPClientContract):
@@ -15,8 +15,8 @@ class FTPClient(FTPClientContract):
             self.client_obj = AioFTPClient(args)
         self.client_name = args.client_name
 
-    def list_files(self, args: ListFilesArgs) -> list[str]:
+    def list_files(self, args: FtpListFilesArgs) -> list[str]:
         return self.client_obj.list_files(args)
 
-    def read_file(self, args: ReadFileArgs) -> bytes:
+    def read_file(self, args: FtpReadFileArgs) -> bytes:
         return self.client_obj.read_file(args)

rcer_iot_client_pkg/libs/ftp_client/ftp_client_contract.py

@@ -1,13 +1,13 @@
 from abc import ABC, abstractmethod
 
-from .types.ftp_client_types import ListFilesArgs, ReadFileArgs
+from .types.ftp_client_types import FtpListFilesArgs, FtpReadFileArgs
 
 
 class FTPClientContract(ABC):
     @abstractmethod
-    def list_files(self, args: ListFilesArgs) -> list[str]:
+    def list_files(self, args: FtpListFilesArgs) -> list[str]:
         pass
 
     @abstractmethod
-    def read_file(self, args: ReadFileArgs) -> bytes:
+    def read_file(self, args: FtpReadFileArgs) -> bytes:
         pass

rcer_iot_client_pkg/libs/ftp_client/types/__init__.py

@@ -1,3 +1,3 @@
-from .ftp_client_types import FtpClientInitArgs, ListFilesArgs, ReadFileArgs
+from .ftp_client_types import FtpClientInitArgs, FtpListFilesArgs, FtpReadFileArgs
 
-__all__ = ["FtpClientInitArgs", "ListFilesArgs", "ReadFileArgs"]
+__all__ = ["FtpClientInitArgs", "FtpListFilesArgs", "FtpReadFileArgs"]

rcer_iot_client_pkg/libs/ftp_client/types/ftp_client_types.py

@@ -11,10 +11,10 @@ class FtpClientInitArgs:
 
 
 @dataclass
-class ListFilesArgs:
+class FtpListFilesArgs:
     path: str
 
 
 @dataclass
-class ReadFileArgs:
+class FtpReadFileArgs:
     file_path: str

rcer_iot_client_pkg/libs/sharepoint_client/__init__.py

@@ -0,0 +1,15 @@
+from .sharepoint_client import SharepointClient
+from .types.sharepoint_client_types import (
+    SharepointClientInitArgs,
+    SpListFilesArgs,
+    SpListFoldersArgs,
+    SpUploadFileArgs,
+)
+
+__all__ = [
+    "SharepointClientInitArgs",
+    "SharepointClient",
+    "SpListFilesArgs",
+    "SpListFoldersArgs",
+    "SpUploadFileArgs",
+]

rcer_iot_client_pkg/libs/sharepoint_client/clients/sharepoint_rest_api.py

@@ -0,0 +1,134 @@
+import os
+from typing import Any
+
+from aiohttp import ClientError, ClientSession
+from dotenv import load_dotenv
+
+from rcer_iot_client_pkg.libs.sharepoint_client.sharepoint_client_contract import (
+    SharepointClientContract,
+)
+from rcer_iot_client_pkg.libs.sharepoint_client.types.sharepoint_client_types import (
+    SpListFilesArgs,
+    SpListFoldersArgs,
+    SpUploadFileArgs,
+)
+
+load_dotenv()
+
+
+class SharepointRestAPI(SharepointClientContract):
+    def __init__(self):
+        self.session: ClientSession | None = None
+        self.base_headers = {}
+        self.credentials = {}
+        self.base_url = ""
+
+    async def _load_form_digest_value(self) -> str:
+        try:
+            response = await self.session.post("contextinfo")
+            response_json = await response.json()
+            return response_json["FormDigestValue"]
+        except ClientError as error:
+            raise ConnectionError(error) from error
+
+    async def _load_credentials(self) -> dict:
+        tenant_id = os.getenv("TENANT_ID")
+        client_id = os.getenv("CLIENT_ID")
+        client_secret = os.getenv("CLIENT_SECRET")
+        resource_base = "00000003-0000-0ff1-ce00-000000000000"
+        resource = (
+            f"{resource_base}/{os.getenv('TENANT_NAME')}.sharepoint.com@{tenant_id}"
+        )
+        url = f"https://accounts.accesscontrol.windows.net/{tenant_id}/tokens/OAuth/2"
+        payload = {
+            "grant_type": "client_credentials",
+            "client_id": f"{client_id}@{tenant_id}",
+            "client_secret": client_secret,
+            "resource": resource,
+        }
+        headers = {
+            "Content-Type": "application/x-www-form-urlencoded",
+        }
+
+        async with ClientSession() as session:
+            # Load access token
+            response = await session.post(url, data=payload, headers=headers)
+            if response.status != 200:
+                raise ClientError(
+                    f"Failed to fetch credentials: {response.status}, {await response.text()}"
+                )
+            response_json = await response.json()
+
+            return {
+                "access_token": response_json["access_token"],
+            }
+
+    async def __aenter__(self) -> "SharepointRestAPI":
+        self.credentials = await self._load_credentials()
+        site_url = f"https://{os.getenv('TENANT_NAME')}.sharepoint.com"
+        site_name = os.getenv("SITE_NAME")
+
+        self.base_headers = {
+            "Authorization": f"Bearer {self.credentials['access_token']}",
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        }
+        self.base_url = f"{site_url}/sites/{site_name}/_api/"
+        self.session = ClientSession(headers=self.base_headers, base_url=self.base_url)
+        return self
+
+    async def __aexit__(
+        self, _exc_type: type[BaseException], _exc_val: BaseException, _exc_tb: Any
+    ) -> None:
+        await self.session.close()
+
+    async def list_files(self, args: SpListFilesArgs) -> list:
+        try:
+            folder_relative_url = (
+                f"GetFolderByServerRelativeUrl('{args.folder_relative_url}')"
+            )
+            endpoint = f"web/{folder_relative_url}/Files"
+            response = await self.session.get(endpoint.lstrip("/"))
+            response.raise_for_status()
+            response_json = await response.json()
+            return response_json
+        except ClientError as error:
+            raise ConnectionError(error) from error
+
+    async def list_folders(self, args: SpListFoldersArgs) -> list:
+        try:
+            folder_relative_url = (
+                f"GetFolderByServerRelativeUrl('{args.folder_relative_url}')"
+            )
+            endpoint = f"web/{folder_relative_url}/Folder"
+            response = await self.session.get(endpoint.lstrip("/"))
+            response.raise_for_status()
+            return await response.json()
+        except ClientError as error:
+            raise ConnectionError(error) from error
+
+    async def upload_file(self, args: SpUploadFileArgs) -> dict:
+        try:
+            # Load form digest value
+            form_digest_value = await self._load_form_digest_value()
+            headers = {
+                **self.base_headers,
+                "X-RequestDigest": form_digest_value,
+                "Content-Type": "application/octet-stream",
+            }
+            # Upload the file in the requested folder
+            folder_relative_url = (
+                f"GetFolderByServerRelativeUrl('{args.folder_relative_url}')"
+            )
+            # Read the file
+            source_file_path = os.path.basename(args.file_path)
+            with open(source_file_path, "rb") as file:
+                data = file.read()
+
+            endpoint = f"web/{folder_relative_url}/Files/add(url='{source_file_path}',overwrite=false)"
+            response = await self.session.post(endpoint, data=data, headers=headers)
+
+            response.raise_for_status()
+            return await response.json()
+        except ClientError as error:
+            raise ConnectionError(error) from error

rcer_iot_client_pkg/libs/sharepoint_client/sharepoint_client.py

@@ -0,0 +1,34 @@
+from .clients.sharepoint_rest_api import SharepointRestAPI
+from .sharepoint_client_contract import SharepointClientContract
+from .types.sharepoint_client_types import (
+    SharepointClientInitArgs,
+    SpListFilesArgs,
+    SpListFoldersArgs,
+    SpUploadFileArgs,
+)
+
+
+class SharepointClient(SharepointClientContract):
+    CLIENTS = {"sharepoint_rest_api"}
+
+    def __init__(self, args: SharepointClientInitArgs):
+        if args.client_name not in SharepointClient.CLIENTS:
+            msg = f"Unsupported client {args.client_name}"
+            raise KeyError(msg)
+        elif args.client_name == "sharepoint_rest_api":
+            self.client_obj = SharepointRestAPI()
+
+    async def __aenter__(self):
+        return await self.client_obj.__aenter__()
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.client_obj.__aexit__(exc_type, exc_val, exc_tb)
+
+    async def list_files(self, args: SpListFilesArgs) -> list:
+        return await self.client_obj.list_files(args)
+
+    async def list_folders(self, args: SpListFoldersArgs) -> list:
+        return self.client_obj.list_files(args)
+
+    async def upload_file(self, args: SpUploadFileArgs) -> dict:
+        return self.client_obj.upload_file(args)

rcer_iot_client_pkg/libs/sharepoint_client/sharepoint_client_contract.py

@@ -0,0 +1,21 @@
+from abc import ABC, abstractmethod
+
+from .types.sharepoint_client_types import (
+    SpListFilesArgs,
+    SpListFoldersArgs,
+    SpUploadFileArgs,
+)
+
+
+class SharepointClientContract(ABC):
+    @abstractmethod
+    async def list_files(self, args: SpListFilesArgs) -> list:
+        pass
+
+    @abstractmethod
+    async def list_folders(self, args: SpListFoldersArgs) -> list:
+        pass
+
+    @abstractmethod
+    async def upload_file(self, args: SpUploadFileArgs) -> dict:
+        pass

rcer_iot_client_pkg/libs/sharepoint_client/types/sharepoint_client_types.py

@@ -0,0 +1,23 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class SharepointClientInitArgs:
+    client_name: str = "sharepoint_rest_api"
+
+
+@dataclass
+class SpListFilesArgs:
+    folder_relative_url: str
+
+
+@dataclass
+class SpListFoldersArgs:
+    folder_relative_url: str
+
+
+@dataclass
+class SpUploadFileArgs:
+    file_path: str
+    folder_relative_url: str
+    file_content: bytes = bytes()

rcer_iot_client_pkg/services/epii/api.py

@@ -1,17 +1,32 @@
-from typing import Dict
+from typing import Dict, Any
 
 from .controllers.types.update_thies_data_types import UpdateThiesDataControllerInput
 from .controllers.update_thies_data import UpdateThiesDataController
 
 
 class EpiiAPI:
+    """
+    EpiiAPI is a service class that provides methods to interact with Patagonia Center system.
+    """
+
     async def update_thies_data(
         self,
         ftp_port: int,
         ftp_host: str,
         ftp_password: str,
         ftp_user: str,
-    ) -> Dict[str, any]:
+    ) -> Dict[str, Any]:
+        """
+        This method establishes a connection to an FTP server using the provided
+        credentials and updates data related to THIES Data Logger.
+        Args:
+            ftp_port (int): The port number of the FTP server.
+            ftp_host (str): The hostname or IP address of the FTP server.
+            ftp_password (str): The password for the FTP server.
+            ftp_user (str): The username for the FTP server.
+        Returns:
+            response (dict): A dictionary representation of the API response.
+        """
         controller = UpdateThiesDataController(
             UpdateThiesDataControllerInput(
                 ftp_port=ftp_port,

rcer_iot_client_pkg/services/epii/constants/update_thies_data_constants.py

@@ -0,0 +1,5 @@
+SHAREPOINT_BASE_URL = "/sites/uc365_CentrosyEstacionesRegionalesUC/Shared Documents/General/Test_Raspberry/THIES"
+SHAREPOINT_THIES_FOLDERS = ["AVG", "EXT"]
+
+FTP_SERVER_PATH_AVG_FILES = "ftp/thies/BINFILES/ARCH_AV1"
+FTP_SERVER_PATH_EXT_FILES = "ftp/thies/BINFILES/ARCH_EX1"

rcer_iot_client_pkg/services/epii/controllers/update_thies_data.py

@@ -1,12 +1,14 @@
 from http import HTTPStatus
 
 from rcer_iot_client_pkg.general_types.error_types.api.update_thies_data_error_types import (
-    FetchCloudFileNamesError,
-    ThiesUploadEmptyError,
+    SharePointFetchingError,
+    ThiesConnectionError,
+    ThiesFetchingError,
 )
 from rcer_iot_client_pkg.general_types.error_types.common.common_types import (
+    EmptyDataError,
     FtpClientError,
-    HttpClientError,
+    SharepointClientError,
 )
 from rcer_iot_client_pkg.services.epii.controllers.types.update_thies_data_types import (
     UpdateThiesDataControllerInput,
@@ -34,6 +36,11 @@ class UpdateThiesDataController:
                 status=HTTPStatus.OK.value,
                 metadata={"data": data},
             )
+        except EmptyDataError:
+            return UpdateThiesDataControllerOutput(
+                message="No files to upload", status=HTTPStatus.NO_CONTENT
+            )
+
         except (AttributeError, NameError, ValueError) as error:
             return UpdateThiesDataControllerOutput(
                 message="An unexpected error occurred during use case initialization.",
@@ -47,22 +54,30 @@ class UpdateThiesDataController:
                 metadata={"error": error.__str__()},
             )
 
-        except HttpClientError as error:
+        except SharepointClientError as error:
             return UpdateThiesDataControllerOutput(
-                message="Http Client initialization fails.",
+                message="Sharepoint Client initialization fails.",
                 status=HTTPStatus.BAD_REQUEST.value,
                 metadata={"error": error.__str__()},
             )
 
-        except FetchCloudFileNamesError as error:
+        except SharePointFetchingError as error:
             return UpdateThiesDataControllerOutput(
                 message="An error occurred while retrieving file names from the RCER cloud",
                 status=HTTPStatus.INTERNAL_SERVER_ERROR.value,
                 metadata={"error": error.__str__()},
             )
-        except ThiesUploadEmptyError as error:
+
+        except ThiesFetchingError as error:
             return UpdateThiesDataControllerOutput(
-                message="No files were found to upload.",
+                message="An error ocurred while retrieving file names from THIES FTP Server.",
                 status=HTTPStatus.NO_CONTENT.value,
                 metadata={"error": error.__str__()},
             )
+
+        except ThiesConnectionError as error:
+            return UpdateThiesDataControllerOutput(
+                message="Unable to connect to THIES Data Logger FTP Server.",
+                status=HTTPStatus.INTERNAL_SERVER_ERROR.value,
+                metadata={"error": error.__str__()},
+            )

rcer_iot_client_pkg/services/epii/use_cases/types/update_thies_data_types.py

@@ -5,7 +5,7 @@ from typing import Dict
 @dataclass
 class UpdateThiesDataUseCaseInput:
     ftp_host: str
-    ftp_port: str
+    ftp_port: int
     ftp_user: str
     ftp_password: str
 

rcer_iot_client_pkg/services/epii/use_cases/update_thies_data.py

@@ -1,32 +1,32 @@
 from dotenv import load_dotenv
 
-import rcer_iot_client_pkg.services.epii.use_cases.constants as c
+import rcer_iot_client_pkg.services.epii.constants.update_thies_data_constants as c
 from rcer_iot_client_pkg.general_types.error_types.api.update_thies_data_error_types import (
-    FetchCloudFileNamesError,
-    FetchThiesFileContentError,
-    ThiesUploadEmptyError,
+    SharePointFetchingError,
+    ThiesConnectionError,
+    ThiesFetchingError,
 )
 from rcer_iot_client_pkg.general_types.error_types.common import (
     EmptyDataError,
     FtpClientError,
-    HttpClientError,
-)
-from rcer_iot_client_pkg.libs.async_http_client import (
-    AsyncHTTPClient,
-    AsyncHttpClientInitArgs,
-    GetArgs,
+    SharepointClientError,
 )
 from rcer_iot_client_pkg.libs.ftp_client import (
     FTPClient,
     FtpClientInitArgs,
-    ListFilesArgs,
-    ReadFileArgs,
+    FtpListFilesArgs,
+    FtpReadFileArgs,
+)
+from rcer_iot_client_pkg.libs.sharepoint_client import (
+    SharepointClient,
+    SharepointClientInitArgs,
+    SpListFilesArgs,
 )
 from rcer_iot_client_pkg.services.epii.use_cases.types import (
     UpdateThiesDataUseCaseInput,
 )
 from rcer_iot_client_pkg.services.epii.utils import (
-    generate_file_content,
+    parse_execute_response,
 )
 
 load_dotenv()
@@ -42,18 +42,14 @@ class UpdateThiesDataUseCase:
         self.thies_ftp_client = self._initialize_thies_ftp_client()
         self.uploading = set()
 
-    def _initialize_sharepoint_client(self) -> AsyncHTTPClient:
+    def _initialize_sharepoint_client(self) -> SharepointClient:
         """Initialize the HTTP client."""
         try:
-            return AsyncHTTPClient(
-                AsyncHttpClientInitArgs(
-                    client_name="aiohttp_client",
-                    access_token="temporal-token",
-                    base_url="https://graph.microsoft.com/v1.0/",
-                )
+            return SharepointClient(
+                SharepointClientInitArgs(client_name="sharepoint_rest_api")
             )
         except ConnectionError as error:
-            raise HttpClientError(error)
+            raise SharepointClientError(error)
 
     def _initialize_thies_ftp_client(self) -> FTPClient:
         """Initialize the FTP client."""
@@ -70,55 +66,61 @@ class UpdateThiesDataUseCase:
         except RuntimeError as error:
             raise FtpClientError(error)
 
-    async def fetch_cloud_file_names(self, folder_name: str) -> set[str]:
+    async def fetch_cloud_file_names(self) -> set[str]:
         """Fetch file names from the RCER cloud."""
+
         try:
             cloud_files = set()
             async with self.sharepoint_client:
-                for file_type in c.FILE_TYPES:
-                    destination_path = f"Onedrive_UC/noveno-semestre/IPRE-RCER/{folder_name}/{file_type}"
-                    endpoint = f"drives/{c.DRIVE_ID}/root:/{destination_path}:/children"
-                    response = await self.sharepoint_client.get(
-                        GetArgs(endpoint=endpoint)
+                for folder in c.SHAREPOINT_THIES_FOLDERS:
+                    args = SpListFilesArgs(
+                        folder_relative_url=f"{c.SHAREPOINT_BASE_URL}/{folder}"
                     )
+                    response = await self.sharepoint_client.list_files(args)
                     cloud_files.update(
-                        {f"{file_type}_{item['name']}" for item in response["value"]}
+                        {f"{folder}_{item['Name']}" for item in response["value"]}
                     )
             return cloud_files
         except ConnectionError as error:
-            raise FetchCloudFileNamesError(error)
+            raise SharePointFetchingError(reason=error)
 
     async def fetch_thies_file_names(self) -> set[str]:
         """Fetch file names from the THIES FTP server."""
         try:
             avg_files = await self.thies_ftp_client.list_files(
-                ListFilesArgs(path=c.PATH_AVG_FILES)
+                FtpListFilesArgs(path=c.FTP_SERVER_PATH_AVG_FILES)
             )
             ext_files = await self.thies_ftp_client.list_files(
-                ListFilesArgs(path=c.PATH_EXT_FILES)
+                FtpListFilesArgs(path=c.FTP_SERVER_PATH_EXT_FILES)
             )
             return {f"AVG_{name}" for name in avg_files} | {
                 f"EXT_{name}" for name in ext_files
             }
-        except ConnectionError:
-            raise ThiesUploadEmptyError
+        except ConnectionRefusedError as error:
+            raise ThiesConnectionError(reason=error)
+        except ConnectionAbortedError as error:
+            raise ThiesFetchingError(reason=error)
 
     async def fetch_thies_file_content(self) -> dict[str, bytes]:
         """Fetch the content of files from the THIES FTP server."""
-        content_files = {}
-        for file in self.uploading:
-            try:
+        try:
+            content_files = {}
+            for file in self.uploading:
                 origin, filename = file.split("_", 1)
                 file_path = (
-                    f"{c.PATH_AVG_FILES}/{filename}"
+                    f"{c.FTP_SERVER_PATH_AVG_FILES}/{filename}"
                     if origin == "AVG"
-                    else f"{c.PATH_EXT_FILES}/{filename}"
+                    else f"{c.FTP_SERVER_PATH_EXT_FILES}/{filename}"
+                )
+                content = await self.thies_ftp_client.read_file(
+                    FtpReadFileArgs(file_path)
                 )
-                content = await self.thies_ftp_client.read_file(ReadFileArgs(file_path))
                 content_files[filename] = content
-            except ConnectionError as error:
-                raise FetchThiesFileContentError(error)
-        return content_files
+            return content_files
+        except ConnectionRefusedError as error:
+            raise ThiesConnectionError(reason=error)
+        except ConnectionAbortedError as error:
+            raise ThiesFetchingError(reason=error)
 
     async def execute(self) -> dict:
         """Synchronize data from the THIES Center to the cloud."""
@@ -126,12 +128,14 @@ class UpdateThiesDataUseCase:
             thies_files = await self.fetch_thies_file_names()
         except RuntimeError as error:
             raise FtpClientError(error)
-
-        cloud_files = await self.fetch_cloud_file_names(folder_name="thies")
+        try:
+            cloud_files = await self.fetch_cloud_file_names()
+        except RuntimeError as error:
+            raise SharepointClient(error)
         self.uploading = thies_files - cloud_files
         if not self.uploading:
-            raise EmptyDataError
+            raise EmptyDataError(reason="No files to upload.")
 
         thies_file_contents = await self.fetch_thies_file_content()
-        data = generate_file_content(thies_file_contents)
+        data = parse_execute_response(thies_file_contents)
         return data

rcer_iot_client_pkg/services/epii/utils/__init__.py

@@ -1,3 +1,3 @@
-from .update_thies_data_utils import generate_file_content
+from .update_thies_data_utils import parse_execute_response
 
-__all__ = ["generate_file_content"]
+__all__ = ["parse_execute_response"]

rcer_iot_client_pkg/services/epii/utils/update_thies_data_utils.py

@@ -6,7 +6,7 @@ from rcer_iot_client_pkg.libs.zero_dependency.utils.datetime_utils import (
 )
 
 
-def generate_file_content(
+def parse_execute_response(
     file_contents: dict[str, Any],
 ) -> dict[str, dict[str, int | str]]:
     return {

{rcer_iot_client_pkg-0.3.1.dist-info → rcer_iot_client_pkg-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: rcer_iot_client_pkg
-Version: 0.3.1
+Version: 0.4.0
 Summary: A client library for IoT projects in the RCER initiative
 License: MIT
 Author: pedropablozavalat
@@ -30,6 +30,39 @@ This library provides a robust and efficient client for interacting with IoT dev
 pip install rcer_iot_client_pkg
 ```
 
+## Usage
+
+### Initialize the EPii API Client
+To start using the library, you need to create an `EpiiAPI` client instance:
+
+```python
+from rcer_iot_client_pkg import EpiiAPI
+
+api_client = EpiiAPI()
+```
+
+### 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
+import asyncio
+
+async def update_thies_data():
+    response = await api_client.update_thies_data(
+        ftp_port=PORT,
+        ftp_host=LOCAL_HOST,
+        ftp_password=PASSWORD,
+        ftp_user=USER
+    )
+    return response
+
+asyncio.run(update_thies_data())
+```
+
+**Notes:** 
+- Store sensitive data like `PASSWORD` and `USER` securely, e.g., in environment variables or a secrets file.
+- Ensure `asyncio` is installed to run concurrent code with `EpiiAPI` methods.
+
 ## Development
 
 This project includes a `Makefile` to simplify common tasks. Below are the available commands:

{rcer_iot_client_pkg-0.3.1.dist-info → rcer_iot_client_pkg-0.4.0.dist-info}/RECORD

@@ -4,9 +4,9 @@ rcer_iot_client_pkg/general_types/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCe
 rcer_iot_client_pkg/general_types/api/update_thies_data_types.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rcer_iot_client_pkg/general_types/error_types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rcer_iot_client_pkg/general_types/error_types/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rcer_iot_client_pkg/general_types/error_types/api/update_thies_data_error_types.py,sha256=pbkIZxKTGtTOSVVcOVQ-mINN5mY8JYt5PeFqsyAF-Sg,640
-rcer_iot_client_pkg/general_types/error_types/common/__init__.py,sha256=qb0Z01TjUlOSrC9W40z011XxabrjGQN8UddO8upr8KQ,158
-rcer_iot_client_pkg/general_types/error_types/common/common_types.py,sha256=w25vajcnX24zIezMG3EjG32dDouV51p-iXtNKz8qjD4,319
+rcer_iot_client_pkg/general_types/error_types/api/update_thies_data_error_types.py,sha256=lDVcK7RrqT4s0Bzxa5nEyIsNee93GaIRCyPV9k0s4-o,928
+rcer_iot_client_pkg/general_types/error_types/common/__init__.py,sha256=yOBLZbt64Ki9Q0IJ0tMAubgq7PtrQ7XQ3RgtAzyOjiE,170
+rcer_iot_client_pkg/general_types/error_types/common/common_types.py,sha256=n5yuw-gVtkrtNfmaZ83ZkYxYHGl4jynOLUB9C8Tr32w,474
 rcer_iot_client_pkg/libs/async_http_client/__init__.py,sha256=LF1KEh5Dhu0j9qZhSBGOsD-PWUFKEvS2oE0eUCyNLd0,279
 rcer_iot_client_pkg/libs/async_http_client/async_http_client.py,sha256=wlOvjThS8wnpyqdcY7HbeEx1X3eVNKxJ8DuCJtx0wFk,1135
 rcer_iot_client_pkg/libs/async_http_client/async_http_client_contract.py,sha256=PCoTt4R6vFwjvyOTETQ8jEw1uqzAQC3PYiIlg_d7iRI,816
@@ -14,27 +14,32 @@ rcer_iot_client_pkg/libs/async_http_client/clients/__init__.py,sha256=47DEQpj8HB
 rcer_iot_client_pkg/libs/async_http_client/clients/aiohttp_client.py,sha256=exJ7yq_9ukKoGhdyEwUEe8N5syvEsv2vsQ5eJcQbKSc,1837
 rcer_iot_client_pkg/libs/async_http_client/types/__init__.py,sha256=TnJOBj5R6rVA5XAiId5dpQM6KjMIfi8KJkCCav7n930,154
 rcer_iot_client_pkg/libs/async_http_client/types/async_http_client_types.py,sha256=d-_rHQ21ajTr5AI66fH3-cpJzF8VhSqG0BHbVrlwND8,329
-rcer_iot_client_pkg/libs/ftp_client/__init__.py,sha256=6c6C3_hnZVApYKlRVOlCeEPH8RPnQ22c5Fqqb-hVKp0,179
+rcer_iot_client_pkg/libs/ftp_client/__init__.py,sha256=dW2Yutgc7mJJJzgKLhWKXMgQ6KIWJYfFa1sGpjHH5xU,191
 rcer_iot_client_pkg/libs/ftp_client/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rcer_iot_client_pkg/libs/ftp_client/clients/aioftp_client.py,sha256=cI65J230Ptew3zSsMdWdZ_9EBBDft-k9mlYwcM6410s,1269
-rcer_iot_client_pkg/libs/ftp_client/ftp_client.py,sha256=sYaq_ilO1DlDHHMFz4Gt4t7oTx3hXFHQJx9WCoqG7M4,808
-rcer_iot_client_pkg/libs/ftp_client/ftp_client_contract.py,sha256=sISJSMzkCBTdRZT9xpspzQBvo03d80mC4XdmbEd_EwY,314
-rcer_iot_client_pkg/libs/ftp_client/types/__init__.py,sha256=_HaW5-nKNvxfgf7tiGoAI_bZewzneHE9DY_3niwFRKw,143
-rcer_iot_client_pkg/libs/ftp_client/types/ftp_client_types.py,sha256=uNECnvKpc8z-WFE1C-EaYypDqprGmyG25sKDfTvONT4,276
+rcer_iot_client_pkg/libs/ftp_client/clients/aioftp_client.py,sha256=b0YYNXOTlYqsxwmxrcCqb__xy7CBv6PO5-WiZkOioRk,1589
+rcer_iot_client_pkg/libs/ftp_client/ftp_client.py,sha256=RhWnGwfU8SN0tRqfDc3u6NKDj9qla4cOI2IANyb-S2s,820
+rcer_iot_client_pkg/libs/ftp_client/ftp_client_contract.py,sha256=2x1MPZNFVw3l-sVd65Z6kZYkXlk_8isH_ykzRZB9Cv8,326
+rcer_iot_client_pkg/libs/ftp_client/types/__init__.py,sha256=syfwf9feP4QK7fkCTfl4j8l11ic-jHtfi1DE2chaWbs,155
+rcer_iot_client_pkg/libs/ftp_client/types/ftp_client_types.py,sha256=4ywi5UROTR5TOaApPrm-JyV2PeTvD-cv5K_lL4Fj9AA,282
+rcer_iot_client_pkg/libs/sharepoint_client/__init__.py,sha256=v7h-cNsK-BaPp-hTU3NWRNXYRD9ztU-hsCk0eNRPIKA,334
+rcer_iot_client_pkg/libs/sharepoint_client/clients/sharepoint_rest_api.py,sha256=fjmpP7ityjBRBLpok0GYQMrMNIhrCwVjIvLKbBdsQkk,5095
+rcer_iot_client_pkg/libs/sharepoint_client/sharepoint_client.py,sha256=cTHQan7vMCJ2In3D1s1Nizvnt7K5Y8n87WiYcmVdjhk,1230
+rcer_iot_client_pkg/libs/sharepoint_client/sharepoint_client_contract.py,sha256=xqNHzCjp7GvUGGUox9YTJj2QJgTc5819t2etOk8X26o,485
+rcer_iot_client_pkg/libs/sharepoint_client/types/sharepoint_client_types.py,sha256=NTV5kL1xEOr5tUZOJMkr3gFTwSXRG1V9PkmHtntyQk0,375
 rcer_iot_client_pkg/libs/zero_dependency/utils/datetime_utils.py,sha256=kD38wC087H3jwTIgrntBajE55cR2ioo_ftPUHiyGs_M,751
 rcer_iot_client_pkg/services/epii/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rcer_iot_client_pkg/services/epii/api.py,sha256=7tPzQAMwaN5q3M8Eb7NpyT4LT48nfVrHZSRO2Ji-bsM,708
+rcer_iot_client_pkg/services/epii/api.py,sha256=lqoyBR6ub6BLqwOPR_kvtG8z80KqUNpJD8Yl6VT7z34,1369
+rcer_iot_client_pkg/services/epii/constants/update_thies_data_constants.py,sha256=XeBNsQaTsc0mylQegB4Wf9ECIo0i1Fk-BurWm84WDqE,273
 rcer_iot_client_pkg/services/epii/controllers/__init__.py,sha256=mCdGgKGDgGxCtRoiZN9Rki-fTOyOuJWw9e7festpQYA,98
 rcer_iot_client_pkg/services/epii/controllers/types/__init__.py,sha256=xzky-oTSojLNkWETp_k8a4dcXYvYSQY0VhWo23Yhb8U,195
 rcer_iot_client_pkg/services/epii/controllers/types/update_thies_data_types.py,sha256=0zbNgjln7PXQRjFPAbiNV9n_cXV1H1-XtXMCC_VA4kE,336
-rcer_iot_client_pkg/services/epii/controllers/update_thies_data.py,sha256=_TeHGWoIx-QC3KTfI0_o6rimkx9v_7hOpjSvSGWz4Ls,2698
-rcer_iot_client_pkg/services/epii/use_cases/constants.py,sha256=fslc2XtEBs2bwVL1pfXXeDnJw35YLYz35ApXwatplH8,202
+rcer_iot_client_pkg/services/epii/controllers/update_thies_data.py,sha256=Si-oGHyunp8lgxvjdZjRizAJuf2uoq5b6QD1dRHYVuM,3272
 rcer_iot_client_pkg/services/epii/use_cases/types/__init__.py,sha256=c2RRUbjWq2PIqYW8DcxmYDg0gLZ74kmHh3BkeQCVii0,108
-rcer_iot_client_pkg/services/epii/use_cases/types/update_thies_data_types.py,sha256=Rt76-f3tjJpg5VL8sraxXYVhXG_GHlnDBKotqCFuS8o,334
-rcer_iot_client_pkg/services/epii/use_cases/update_thies_data.py,sha256=UNq-I6WR8MKA6wenWVGi21hTimeholU4xMG8dhI9Am4,5058
-rcer_iot_client_pkg/services/epii/utils/__init__.py,sha256=cAhC0EiJkIF9WxXfst93v1AZ-pyYqbcn4y9_vav8gSg,96
-rcer_iot_client_pkg/services/epii/utils/update_thies_data_utils.py,sha256=husJv2E2FXROBvFU7k9jpYfFBH-tVj4Cma_zfajpjk4,414
-rcer_iot_client_pkg-0.3.1.dist-info/LICENSE,sha256=NWpf6b38xgBWPBo5HZsCbdfp9hZSliEbRqWQgm0fkOo,1076
-rcer_iot_client_pkg-0.3.1.dist-info/METADATA,sha256=85jl4vwLiuv_Nd8H4J5bcylq73IKZ1Uo4BQS8Vcl220,2582
-rcer_iot_client_pkg-0.3.1.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-rcer_iot_client_pkg-0.3.1.dist-info/RECORD,,
+rcer_iot_client_pkg/services/epii/use_cases/types/update_thies_data_types.py,sha256=JGmBwQtQB-nfopNlGwuI8Jf3A2QBFTGtrzjrDZDWMQ0,334
+rcer_iot_client_pkg/services/epii/use_cases/update_thies_data.py,sha256=7H7Y6jDRb8ymsZv8spJ_NUWPBTiGFeD42FH1-eo1FS8,5268
+rcer_iot_client_pkg/services/epii/utils/__init__.py,sha256=cYt2tvq65_OMjFaqb8-CCC7IGCQgFd4ziEUWJV7s1iY,98
+rcer_iot_client_pkg/services/epii/utils/update_thies_data_utils.py,sha256=-q8t-xZmpwFDADGlDu0S7EKvZK7R0GUR6JqOxQShWgE,415
+rcer_iot_client_pkg-0.4.0.dist-info/LICENSE,sha256=NWpf6b38xgBWPBo5HZsCbdfp9hZSliEbRqWQgm0fkOo,1076
+rcer_iot_client_pkg-0.4.0.dist-info/METADATA,sha256=Byx8wk_eQeCPMTS_46IeXPkB6hxSlNW_M3Qhj-8x5Lo,3483
+rcer_iot_client_pkg-0.4.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+rcer_iot_client_pkg-0.4.0.dist-info/RECORD,,

rcer_iot_client_pkg/services/epii/use_cases/constants.py

@@ -1,4 +0,0 @@
-PATH_AVG_FILES = "ftp/thies/BINFILES/ARCH_AV1"
-PATH_EXT_FILES = "ftp/thies/BINFILES/ARCH_EX1"
-DRIVE_ID = "b!Row14jaFrU-1q8qzrvj3OmPPTYWXizFEpJmI-wsfH5pXxA0qQwgQS50m2xvPCZem"
-FILE_TYPES = ["AVG", "EXT"]