rpa-suite 1.5.8__py3-none-any.whl → 1.5.9__py3-none-any.whl

rpa_suite/__init__.py

@@ -60,7 +60,7 @@ Módulos disponíveis:
     ``Browser``: Objeto de Automação de Navegadores (necessario Selenium e Webdriver_Manager)
 """
 
-__version__ = '1.5.5'
+__version__ = "1.5.5"
 
 # allows importing the rpa_suite module without the package name
 from .suite import rpa

rpa_suite/core/__init__.py

@@ -41,11 +41,8 @@ from .asyncrun import AsyncRunner
 import importlib.util
 
 # from .browser import Browser
-if importlib.util.find_spec("selenium") and importlib.util.find_spec(
-    "webdriver_manager"
-):
+if importlib.util.find_spec("selenium") and importlib.util.find_spec("webdriver_manager"):
     from .browser import Browser
 
 
-__version__ = '1.5.5'
-
+__version__ = "1.5.5"

rpa_suite/core/asyncrun.py

@@ -1,6 +1,6 @@
 # rpa_suite/core/asyncrun.py
 
-# imports third-party
+# imports standard
 from typing import Any, Callable, Dict, Optional, TypeVar, Generic
 import asyncio
 import time

rpa_suite/core/browser.py

@@ -1,9 +1,11 @@
 # rpa_suite/core/browser.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, alert_print, success_print
+# imports standard
+from time import sleep
+import os
+import requests
 
-# imports external
+# imports third party
 from selenium import webdriver
 from selenium.webdriver.common.by import By
 from selenium.webdriver.chrome.options import Options
@@ -11,9 +13,8 @@ from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.support import expected_conditions as EC
 from webdriver_manager.chrome import ChromeDriverManager
 
-# imports third-party
-from time import sleep
-import os, requests
+# imports internal
+from rpa_suite.functions._printer import error_print, alert_print, success_print
 
 
 class Browser:
@@ -107,9 +108,7 @@ class Browser:
             # Use the absolute path from comment
 
             options = Options()
-            options.add_experimental_option(
-                "debuggerAddress", f"127.0.0.1:{str(self.port)}"
-            )
+            options.add_experimental_option("debuggerAddress", f"127.0.0.1:{str(self.port)}")
 
             # Additional configs
             options.add_argument("--start-maximized")
@@ -117,9 +116,7 @@ class Browser:
 
             # Verifica se o caminho do driver está correto
             if not os.path.exists(self.path_driver):
-                raise FileNotFoundError(
-                    f"O caminho do driver não foi encontrado: {self.path_driver}"
-                )
+                raise FileNotFoundError(f"O caminho do driver não foi encontrado: {self.path_driver}")
 
             # Create driver with options and chromedriver path
             self.driver = webdriver.Chrome(
@@ -129,13 +126,9 @@ class Browser:
             )
 
         except Exception as e:
-            error_print(
-                f"Erro durante a função: {self.configure_browser.__name__}! Error: {str(e)}."
-            )
+            error_print(f"Erro durante a função: {self.configure_browser.__name__}! Error: {str(e)}.")
 
-    def start_browser(
-        self, close_chrome_on_this_port: bool = True, display_message: bool = False
-    ):
+    def start_browser(self, close_chrome_on_this_port: bool = True, display_message: bool = False):
         """
         Starts a Chrome browser instance with remote debugging enabled.
         Args:
@@ -200,17 +193,13 @@ class Browser:
 
         try:
             sleep(0.9)
-            element = WebDriverWait(self.driver, timeout).until(
-                EC.presence_of_element_located((by, value))
-            )
+            element = WebDriverWait(self.driver, timeout).until(EC.presence_of_element_located((by, value)))
             return element
 
         except Exception as e:
 
             if display_message:
-                error_print(
-                    f"Erro durante a função: {self.find_ele.__name__}! Error: {str(e)}."
-                )
+                error_print(f"Erro durante a função: {self.find_ele.__name__}! Error: {str(e)}.")
                 return None
             else:
                 return None
@@ -303,29 +292,25 @@ class Browser:
                     f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1'
                 )
                 if display_message:
-                    alert_print(f"Browser: Fechado via força!")
+                    alert_print("Browser: Fechado via força!")
 
             else:
                 if display_message:
-                    success_print(f"Browser: Fechado com sucesso!")
+                    success_print("Browser: Fechado com sucesso!")
 
         except Exception as e:
 
             try:
                 if display_message:
-                    alert_print(
-                        f"Erro ao fechar navegador: {str(e)}, Tentando meio mais forte!"
-                    )
+                    alert_print(f"Erro ao fechar navegador: {str(e)}, Tentando meio mais forte!")
 
                 # Último recurso - mata todos os processos do Chrome (use com cautela)
                 os.system(
                     f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1'
                 )
                 if display_message:
-                    alert_print(f"Browser: Fechado via força extrema!")
+                    alert_print("Browser: Fechado via força extrema!")
 
             except Exception as error_ultimate:
                 if display_message:
-                    error_print(
-                        f"Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!"
-                    )
+                    error_print(f"Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!")

rpa_suite/core/clock.py

@@ -1,13 +1,13 @@
 # rpa_suite/core/clock.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, success_print
-
-# imports third-party
+# imports standard
 import time
 from typing import Callable, Any
 from datetime import datetime as dt
 
+# imports internal
+from rpa_suite.functions._printer import error_print, success_print
+
 
 class Clock:
     """
@@ -111,7 +111,7 @@ class Clock:
             minutes = str(now.minute) if now.minute >= 10 else f"0{now.minute}"
             moment_now = f"{hours}:{minutes}"
 
-            if hour_to_exec == None:
+            if hour_to_exec is None:
 
                 # Process
                 while run:
@@ -140,9 +140,7 @@ class Clock:
                             run = False
                             result["tried"] = not run
                             result["success"] = True
-                            success_print(
-                                f"{fn_to_exec.__name__}: Successfully executed!"
-                            )
+                            success_print(f"{fn_to_exec.__name__}: Successfully executed!")
                             break
 
                         except Exception as e:
@@ -157,9 +155,7 @@ class Clock:
                         time.sleep(30)
                         now = dt.now()
                         hours = str(now.hour) if now.hour >= 10 else f"0{now.hour}"
-                        minutes = (
-                            str(now.minute) if now.minute >= 10 else f"0{now.minute}"
-                        )
+                        minutes = str(now.minute) if now.minute >= 10 else f"0{now.minute}"
                         moment_now = f"{hours}:{minutes}"
 
             return result
@@ -167,14 +163,10 @@ class Clock:
         except Exception as e:
 
             result["success"] = False
-            error_print(
-                f"An error occurred on function from executing: {self.exec_at_hour.__name__}. Error: {str(e)}"
-            )
+            error_print(f"An error occurred on function from executing: {self.exec_at_hour.__name__}. Error: {str(e)}")
             return result
 
-    def wait_for_exec(
-        self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs
-    ) -> dict[str, bool]:
+    def wait_for_exec(self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs) -> dict[str, bool]:
         """
         Timer function, wait for a value in ``seconds`` to execute the function of the argument.
 
@@ -226,9 +218,7 @@ class Clock:
             time.sleep(wait_time)
             fn_to_exec(*args, **kwargs)
             result["success"] = True
-            success_print(
-                f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}."
-            )
+            success_print(f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}.")
 
         except Exception as e:
             result["success"] = False
@@ -238,9 +228,7 @@ class Clock:
 
         return result
 
-    def exec_and_wait(
-        self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs
-    ) -> dict[str, bool]:
+    def exec_and_wait(self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs) -> dict[str, bool]:
         """
         Timer function, executes a function and waits for the time in ``seconds``
 
@@ -292,9 +280,7 @@ class Clock:
             fn_to_exec(*args, **kwargs)
             time.sleep(wait_time)
             result["success"] = True
-            success_print(
-                f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}."
-            )
+            success_print(f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}.")
 
         except Exception as e:
             result["success"] = False

rpa_suite/core/date.py

@@ -1,13 +1,13 @@
 # rpa_suite/core/date.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print
-
-# imports third-party
+# imports standard
 import datetime as dt
 from typing import Optional as Op
 from typing import Tuple
 
+# imports internal
+from rpa_suite.functions._printer import error_print
+
 
 class Date:
     """

rpa_suite/core/dir.py

@@ -1,12 +1,13 @@
 # rpa_suite/core/dir.py
 
+# imports standard
+import os
+import shutil
+from typing import Union
+
 # imports internal
 from rpa_suite.functions._printer import error_print, alert_print, success_print
 
-# imports third-party
-import os, shutil
-from typing import Union
-
 
 class Directory:
     """
@@ -51,7 +52,12 @@ class Directory:
         name_temp_dir (str): O nome do diretório temporário a ser criado. O padrão é 'temp'.
     """
 
-    def __init__(self): ...
+    def __init__(self): 
+        """
+        Função construtora da Classe que fornece utilitários para gerenciamento de:\n
+        diretórios, incluindo criação, exclusão e manipulação de diretórios.
+        """
+        ...
 
     def create_temp_dir(
         self,
@@ -130,19 +136,14 @@ class Directory:
             except PermissionError:
                 result["success"] = False
                 result["path_created"] = None
-                alert_print(
-                    f"Permission denied: Not possible to create Directory '{full_path}'."
-                )
+                alert_print(f"Permission denied: Not possible to create Directory '{full_path}'.")
 
         except Exception as e:
             result["success"] = False
             result["path_created"] = None
-            error_print(
-                f"Error capturing current path to create temporary directory! Error: {str(e)}"
-            )
+            error_print(f"Error capturing current path to create temporary directory! Error: {str(e)}")
 
-        finally:
-            return result
+        return result
 
     def delete_temp_dir(
         self,
@@ -230,16 +231,11 @@ class Directory:
             except PermissionError:
                 result["success"] = False
                 result["path_deleted"] = None
-                alert_print(
-                    f"Permission denied: Not possible to delete Directory '{full_path}'."
-                )
+                alert_print(f"Permission denied: Not possible to delete Directory '{full_path}'.")
 
         except Exception as e:
             result["success"] = False
             result["path_deleted"] = None
-            error_print(
-                f"Error capturing current path to delete temporary directory! Error: {str(e)}"
-            )
+            error_print(f"Error capturing current path to delete temporary directory! Error: {str(e)}.")
 
-        finally:
-            return result
+        return result

rpa_suite/core/email.py

@@ -1,16 +1,16 @@
 # rpa_suite/core/email.py
 
-# imports internal
-from rpa_suite.functions._printer import alert_print, error_print, success_print
-
-# imports third-party
+# imports standard
+import os
 import smtplib
-from email.mime.image import MIMEImage
 from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
 from email.mime.base import MIMEBase
 from email import encoders
 
+# imports internal
+from rpa_suite.functions._printer import alert_print, error_print, success_print
+
 
 class Email:
     """
@@ -117,7 +117,8 @@ class Email:
                 Default: '<p>test message</p>'.
 
         Returns:
-            None: This function does not explicitly return any value, but prints success or failure messages when sending the email.
+            None: This function does not explicitly return any value,\n
+            but prints success or failure messages when sending the email.
 
         pt-br
         ------
@@ -160,11 +161,7 @@ class Email:
             # Criando a mensagem
             msg = MIMEMultipart()
             msg["From"] = self.email_user
-            msg["To"] = (
-                ", ".join(self.email_to)
-                if isinstance(self.email_to, list)
-                else self.email_to
-            )
+            msg["To"] = ", ".join(self.email_to) if isinstance(self.email_to, list) else self.email_to
             msg["Subject"] = str(self.subject_title)
 
             # Corpo do e-mail
@@ -173,10 +170,6 @@ class Email:
 
             # Anexos (opcional)
             if self.attachments:
-                from email.mime.base import MIMEBase
-                from email import encoders
-                import os
-
                 for attachment_path in self.attachments:
                     try:
                         with open(attachment_path, "rb") as attachment:
@@ -190,9 +183,7 @@ class Email:
                             msg.attach(part)
 
                     except Exception as e:
-                        error_print(
-                            f"Erro ao anexar o arquivo {attachment_path}: {str(e)}"
-                        )
+                        error_print(f"Erro ao anexar o arquivo {attachment_path}: {str(e)}")
 
             try:
                 if self.auth_tls:

rpa_suite/core/file.py

@@ -1,17 +1,17 @@
 # rpa_suite/core/file.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, success_print, alert_print
-from rpa_suite.functions.__create_ss_dir import __create_ss_dir as create_ss_dir
-
-# imports external
-from colorama import Fore
-
-# imports third-party
+# imports standard
 import os, time
 from datetime import datetime
 from typing import Dict, List, Union
 
+# imports third party
+from colorama import Fore
+
+# imports internal
+from rpa_suite.functions._printer import error_print, success_print, alert_print
+from rpa_suite.functions.__create_ss_dir import __create_ss_dir as create_ss_dir
+
 
 class File:
     """
@@ -138,9 +138,7 @@ class File:
 
             if save_with_date:  # use date on file name
                 image = pyautogui.screenshot()
-                file_name = (
-                    f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
-                )
+                file_name = f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
                 path_file_screenshoted = os.path.join(path_dir, file_name)
 
                 image.save(path_file_screenshoted)
@@ -164,9 +162,7 @@ class File:
 
         except Exception as e:
 
-            error_print(
-                f"Error to execute function:{self.screen_shot.__name__}! Error: {str(e)}"
-            )
+            error_print(f"Error to execute function:{self.screen_shot.__name__}! Error: {str(e)}")
             return None
 
     def flag_create(
@@ -180,7 +176,7 @@ class File:
         """
 
         try:
-            if path_to_create == None:
+            if path_to_create is None:
                 path_origin: str = os.getcwd()
                 full_path_with_name = rf"{path_origin}/{name_file}"
             else:
@@ -206,7 +202,7 @@ class File:
 
         try:
 
-            if path_to_delete == None:
+            if path_to_delete is None:
                 path_origin: str = os.getcwd()
                 full_path_with_name = rf"{path_origin}/{name_file}"
             else:
@@ -264,21 +260,18 @@ class File:
 
         # Process
         try:
-            for dir in dir_to_count:
-                for _, _, files in os.walk(dir):
+            for directory in dir_to_count:
+                for _, _, files in os.walk(directory):
                     for file in files:
                         if type_extension == "*" or file.endswith(f".{type_extension}"):
                             result["qt"] += 1
             result["success"] = True
 
             if display_message:
-                success_print(
-                    f'Function: {self.count_files.__name__} counted {result["qt"]} files.'
-                )
+                success_print(f'Function: {self.count_files.__name__} counted {result["qt"]} files.')
 
         except Exception as e:
             result["success"] = False
             error_print(f"Error when trying to count files! Error: {str(e)}")
 
-        finally:
-            return result
+        return result

rpa_suite/core/log.py

@@ -3,12 +3,14 @@
 # imports internal
 from rpa_suite.functions._printer import error_print, alert_print, success_print
 
-# imports external
+# imports third party
 from loguru import logger
 
-# imports third-party
+# imports standard
 from typing import Optional as Op
-import sys, os, inspect
+import sys
+import os
+import inspect
 
 
 class Filters:
@@ -83,13 +85,13 @@ class Log:
 
             try:
                 os.makedirs(self.full_path, exist_ok=True)
-                if display_message: success_print(f"Diretório:'{self.full_path}' foi criado com sucesso.")
+                if display_message:
+                    success_print(f"Diretório:'{self.full_path}' foi criado com sucesso.")
             except FileExistsError:
-                if display_message: alert_print(f"Diretório:'{self.full_path}' já existe.")
+                if display_message:
+                    alert_print(f"Diretório:'{self.full_path}' já existe.")
             except PermissionError:
-                alert_print(
-                    f"Permissão negada: não é possível criar o diretório '{self.full_path}'."
-                )
+                alert_print(f"Permissão negada: não é possível criar o diretório '{self.full_path}'.")
 
             new_filter = None
             if filter_words is not None:
@@ -104,9 +106,7 @@ class Log:
             formatter = CustomFormatter()
 
             if new_filter:
-                self.logger.add(
-                    file_handler, filter=new_filter, level="DEBUG", format=log_format
-                )
+                self.logger.add(file_handler, filter=new_filter, level="DEBUG", format=log_format)
             else:
                 self.logger.add(file_handler, level="DEBUG", format=log_format)
 
@@ -115,9 +115,7 @@ class Log:
             return file_handler
 
         except Exception as e:
-            error_print(
-                f"Houve um erro durante a execução da função: {self.config_logger.__name__}! Error: {str(e)}."
-            )
+            error_print(f"Houve um erro durante a execução da função: {self.config_logger.__name__}! Error: {str(e)}.")
             return None
 
     def _log(self, level: str, msg: str):
@@ -128,16 +126,16 @@ class Log:
             # Find the first frame that's not from this log.py file
             frame = inspect.currentframe()
             current_file = os.path.normpath(__file__)
-            
+
             while frame:
                 frame = frame.f_back
                 if frame and os.path.normpath(frame.f_code.co_filename) != current_file:
                     break
-            
+
             if not frame:
                 # Fallback if we can't find external caller
                 frame = inspect.currentframe().f_back.f_back
-                
+
             full_path_filename = frame.f_code.co_filename
 
             # Normalize path to use os.sep
@@ -157,9 +155,7 @@ class Log:
     def log_start_run_debug(self, msg_start_loggin: str) -> None:
         try:
             with open(self.file_handler, "a") as log_file:
-                log_file.write(
-                    "\n"
-                )  # Add a blank line before logging the start message
+                log_file.write("\n")  # Add a blank line before logging the start message
             self._log("DEBUG", msg_start_loggin)
         except Exception as e:
             error_print(

rpa_suite/core/parallel.py

@@ -1,6 +1,6 @@
 # rpa_suite/core/parallel.py
 
-# imports third-party
+# imports standard
 from multiprocessing import Process, Manager
 from typing import Any, Callable, Dict, Optional, TypeVar, Generic
 import time
@@ -177,9 +177,7 @@ class ParallelRunner(Generic[T]):
             return False
         return self._process.is_alive()
 
-    def get_result(
-        self, timeout: Optional[float] = 60, terminate_on_timeout: bool = True
-    ) -> Dict[str, Any]:
+    def get_result(self, timeout: Optional[float] = 60, terminate_on_timeout: bool = True) -> Dict[str, Any]:
         """
         Retrieves the result of the parallel execution.
 
@@ -234,27 +232,19 @@ class ParallelRunner(Generic[T]):
 
         # Debug - mostra o dicionário compartilhado
         if self.display_message:
-            print(
-                f"[Processo Principal] Dicionário compartilhado: {dict(self._result_dict)}"
-            )
+            print(f"[Processo Principal] Dicionário compartilhado: {dict(self._result_dict)}")
 
         # Verifica se o processo terminou ou se atingiu o timeout
         if self._process.is_alive():
             if terminate_on_timeout:
                 self._process.terminate()
-                self._process.join(
-                    timeout=1
-                )  # Pequeno timeout para garantir que o processo termine
+                self._process.join(timeout=1)  # Pequeno timeout para garantir que o processo termine
                 result["terminated"] = True
                 result["success"] = False
-                result["error"] = (
-                    f"Operação cancelada por timeout após {execution_time:.2f} segundos"
-                )
+                result["error"] = f"Operação cancelada por timeout após {execution_time:.2f} segundos"
             else:
                 result["success"] = False
-                result["error"] = (
-                    f"Operação ainda em execução após {execution_time:.2f} segundos"
-                )
+                result["error"] = f"Operação ainda em execução após {execution_time:.2f} segundos"
         else:
             # Processo terminou normalmente - verificamos o status
             status = self._result_dict.get("status", "unknown")
@@ -266,9 +256,7 @@ class ParallelRunner(Generic[T]):
                     result["result"] = self._result_dict["result"]
                 else:
                     result["success"] = False
-                    result["error"] = (
-                        "Resultado não encontrado no dicionário compartilhado"
-                    )
+                    result["error"] = "Resultado não encontrado no dicionário compartilhado"
             else:
                 result["success"] = False
                 result["error"] = self._result_dict.get("error", "Erro desconhecido")
@@ -276,9 +264,7 @@ class ParallelRunner(Generic[T]):
                     result["traceback"] = self._result_dict["traceback"]
 
         # Finaliza o Manager se o processo terminou e não estamos mais esperando resultado
-        if not self._process.is_alive() and (
-            result.get("success", False) or result.get("terminated", False)
-        ):
+        if not self._process.is_alive() and (result.get("success", False) or result.get("terminated", False)):
             self._cleanup()
 
         return result

rpa_suite/core/print.py

@@ -1,6 +1,6 @@
 # rpa_suite/core/print.py
 
-# imports external
+# imports third party
 from colorama import Fore
 
 
@@ -126,9 +126,7 @@ class Print:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def magenta_print(
-        self, string_text: str, color=Colors.magenta, ending="\n"
-    ) -> None:
+    def magenta_print(self, string_text: str, color=Colors.magenta, ending="\n") -> None:
         """
         Print customized with the color Magenta \n
 
@@ -162,9 +160,7 @@ class Print:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def print_call_fn(
-        self, string_text: str, color=Colors.call_fn, ending="\n"
-    ) -> None:
+    def print_call_fn(self, string_text: str, color=Colors.call_fn, ending="\n") -> None:
         """
         Print customized for function called (log) \n
         Color: Magenta Light
@@ -182,9 +178,7 @@ class Print:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def print_retur_fn(
-        self, string_text: str, color=Colors.retur_fn, ending="\n"
-    ) -> None:
+    def print_retur_fn(self, string_text: str, color=Colors.retur_fn, ending="\n") -> None:
         """
         Print customized for function return (log) \n
         Color: Yellow Light

rpa_suite/core/regex.py

@@ -1,11 +1,11 @@
 # rpa_suite/core/regex.py
 
+# imports standard
+import re
+
 # imports internal
 from rpa_suite.functions._printer import error_print, success_print
 
-# imports third-party
-import re
-
 
 class Regex:
     """

rpa_suite/core/validate.py

@@ -1,11 +1,11 @@
 # rpa_suite/core/mail_validator.py
 
+# imports third party
+import email_validator
+
 # imports internal
 from rpa_suite.functions._printer import error_print, success_print
 
-# imports external
-import email_validator
-
 
 class Validate:
     """
@@ -200,15 +200,11 @@ class Validate:
                     else:
                         words_lowercase = [word.lower() for word in origin_words]
                         searched_word_lower = searched_word.lower()
-                        result["number_occurrences"] = words_lowercase.count(
-                            searched_word_lower
-                        )
+                        result["number_occurrences"] = words_lowercase.count(searched_word_lower)
                         result["is_found"] = result["number_occurrences"] > 0
 
                 except Exception as e:
-                    return error_print(
-                        f"Unable to complete the search: {searched_word}. Error: {str(e)}"
-                    )
+                    return error_print(f"Unable to complete the search: {searched_word}. Error: {str(e)}")
 
             elif search_by == "string":
                 try:
@@ -218,20 +214,14 @@ class Validate:
                     else:
                         origin_text_lower = origin_text.lower()
                         searched_word_lower = searched_word.lower()
-                        result["number_occurrences"] = origin_text_lower.count(
-                            searched_word_lower
-                        )
+                        result["number_occurrences"] = origin_text_lower.count(searched_word_lower)
                         result["is_found"] = result["number_occurrences"] > 0
 
                 except Exception as e:
-                    return error_print(
-                        f"Unable to complete the search: {searched_word}. Error: {str(e)}"
-                    )
+                    return error_print(f"Unable to complete the search: {searched_word}. Error: {str(e)}")
 
         except Exception as e:
-            return error_print(
-                f"Unable to search for: {searched_word}. Error: {str(e)}"
-            )
+            return error_print(f"Unable to search for: {searched_word}. Error: {str(e)}")
 
         # Postprocessing
         if result["is_found"]:

rpa_suite/functions/__create_ss_dir.py

@@ -76,16 +76,12 @@ def __create_ss_dir(
         except PermissionError:
             result["success"] = False
             result["path_created"] = None
-            alert_print(
-                f"Permissão negada: não é possível criar o diretório '{full_path}'."
-            )
+            alert_print(f"Permissão negada: não é possível criar o diretório '{full_path}'.")
 
     except Exception as e:
         result["success"] = False
         result["path_created"] = None
-        error_print(
-            f"Error capturing current path to create screenshots directory! Error: {str(e)}"
-        )
+        error_print(f"Error capturing current path to create screenshots directory! Error: {str(e)}")
 
     finally:
         return result

rpa_suite/functions/__init__.py

@@ -1,3 +1,3 @@
 # rpa_suite/functions/__init__.py
 
-__version__ = '1.5.5'
+__version__ = "1.5.5"

rpa_suite/suite.py

@@ -153,9 +153,7 @@ class Suite:
     import importlib.util
 
     # from .browser import Browser
-    if importlib.util.find_spec("selenium") and importlib.util.find_spec(
-        "webdriver_manager"
-    ):
+    if importlib.util.find_spec("selenium") and importlib.util.find_spec("webdriver_manager"):
         from .core.browser import Browser
 
         browser: Browser = Browser
@@ -163,9 +161,9 @@ class Suite:
     # VARIABLES INTERNAL
     try:
         # old: __version__ = pkg_resources.get_distribution("rpa_suite").version
-        
+
         __version__ = version("package_name")
-        
+
     except Exception:
         __version__ = "unknown"
 
@@ -242,9 +240,7 @@ class Suite:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def magenta_print(
-        self, string_text: str, color=Colors.magenta, ending="\n"
-    ) -> None:
+    def magenta_print(self, string_text: str, color=Colors.magenta, ending="\n") -> None:
         """
         Print customized with the color Magenta \n
 
@@ -278,9 +274,7 @@ class Suite:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def print_call_fn(
-        self, string_text: str, color=Colors.call_fn, ending="\n"
-    ) -> None:
+    def print_call_fn(self, string_text: str, color=Colors.call_fn, ending="\n") -> None:
         """
         Print customized for function called (log) \n
         Color: Magenta Light
@@ -298,9 +292,7 @@ class Suite:
         """
         print(f"{color}{string_text}{Colors.default}", end=ending)
 
-    def print_retur_fn(
-        self, string_text: str, color=Colors.retur_fn, ending="\n"
-    ) -> None:
+    def print_retur_fn(self, string_text: str, color=Colors.retur_fn, ending="\n") -> None:
         """
         Print customized for function return (log) \n
         Color: Yellow Light

rpa_suite/utils/__init__.py

@@ -12,4 +12,4 @@ O módulo de utilitários da rpa-suite fornece uma coleção de funções e clas
 from .system import Tools
 
 
-__version__ = '1.5.5'
+__version__ = "1.5.5"

rpa_suite/utils/system.py

@@ -1,11 +1,13 @@
 # rpa_suite/utils/system.py
 
+# imports third-party
+import sys
+import os
+import ctypes
+
 # imports internal
 from rpa_suite.functions._printer import error_print, success_print
 
-# imports third-party
-import sys, os, ctypes
-
 
 class Utils:
     """
@@ -13,8 +15,8 @@ class Utils:
 
     Fornece métodos para manipulação de caminhos de importação e configurações do sistema.
     """
-    
-    def __init__(self): 
+
+    def __init__(self):
         """
         Inicializa a classe Utils.
 
@@ -25,18 +27,17 @@ class Utils:
         except Exception as e:
             error_print(f"Erro durante a inicialização da classe Utils: {str(e)}.")
 
-
     def set_importable_dir(self, display_message: bool = False) -> None:
         """
         Configura o diretório atual como importável, adicionando-o ao caminho do sistema.
 
-        Adiciona o diretório pai do módulo atual ao sys.path, permitindo importações 
+        Adiciona o diretório pai do módulo atual ao sys.path, permitindo importações
         dinâmicas de módulos locais.
 
         Parâmetros:
         ----------
         display_message : bool, opcional
-            Se True, exibe uma mensagem de sucesso após definir o diretório. 
+            Se True, exibe uma mensagem de sucesso após definir o diretório.
             Por padrão é False.
 
         Retorna:
@@ -55,16 +56,14 @@ class Utils:
                 success_print("Diretório configurado com sucesso para importação!")
 
         except Exception as e:
-            error_print(
-                f"Erro ao configurar diretório importável: {str(e)}."
-            )
+            error_print(f"Erro ao configurar diretório importável: {str(e)}.")
 
 
 class KeepSessionActive:
     """
     Gerenciador de contexto avançado para prevenir bloqueio de tela no Windows.
 
-    Utiliza chamadas de API do Windows para manter o sistema ativo durante 
+    Utiliza chamadas de API do Windows para manter o sistema ativo durante
     execução de tarefas críticas, impedindo suspensão ou bloqueio de tela.
 
     Atributos de Classe:
@@ -87,7 +86,7 @@ class KeepSessionActive:
         """
         Inicializa as configurações de estado de execução do sistema.
 
-        Configura constantes específicas do Windows para controle de energia 
+        Configura constantes específicas do Windows para controle de energia
         e gerenciamento de estado do sistema operacional.
         """
         try:
@@ -96,13 +95,12 @@ class KeepSessionActive:
             self.ES_DISPLAY_REQUIRED = 0x00000002
         except Exception as e:
             error_print(f"Erro ao inicializar KeepSessionActive: {str(e)}.")
-    
 
     def __enter__(self) -> None:
         """
         Configura o estado de execução para prevenir bloqueio de tela.
 
-        Utiliza chamada de API do Windows para manter sistema e display ativos 
+        Utiliza chamada de API do Windows para manter sistema e display ativos
         durante a execução do bloco de código.
 
         Retorna:
@@ -122,13 +120,12 @@ class KeepSessionActive:
         except Exception as e:
             error_print(f"Erro ao configurar estado de execução: {str(e)}.")
             return self
-    
 
     def __exit__(self, exc_type, exc_val, exc_tb) -> None:
         """
         Restaura as configurações padrão de energia do sistema.
 
-        Método chamado automaticamente ao sair do bloco de contexto, 
+        Método chamado automaticamente ao sair do bloco de contexto,
         revertendo as configurações de estado de execução para o padrão.
 
         Parâmetros:
@@ -149,10 +146,12 @@ class KeepSessionActive:
         except Exception as e:
             error_print(f"Erro ao restaurar estado de execução: {str(e)}.")
 
+
 class Tools(Utils):
     """
     Classe utilitária para gerenciamento de configurações de sistema e diretórios.
 
     Fornece métodos para manipulação de caminhos de importação e configurações do sistema.
     """
+
     keep_session_active: KeepSessionActive = KeepSessionActive

{rpa_suite-1.5.8.dist-info → rpa_suite-1.5.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.8
+Version: 1.5.9
 Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
 Author: Camilo Costa de Carvalho
 Author-email: camilo.carvalho@vettracode.com
@@ -284,23 +284,25 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.8**
+### Versão: **Beta 1.5.9**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 02/06/2025
+- **Última Atualização:** 06/06/2025
 - **Status:** Em desenvolvimento
 
 Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo melhorias significativas na arquitetura, novas funcionalidades e maior simplicidade no uso. Confira as principais mudanças abaixo.
 
 ### Notas da atualização:
 
-- Submódulos agora são objetos internos do objeto principal `Suite`, acessíveis via `rpa.modulo.function()` ou diretamente pelo submódulo.
-- Estrutura reformulada para maior simplicidade, com pastas `core` (núcleo) e `utils` (ferramentas utilitárias).
-- Novo submódulo `ParallelRunner` (`Parallel`) para execução de processos em paralelo com suporte a timeout e recuperação de resultados.
-- Novo submódulo `AsyncRunner` (`Asyn`) para facilitar o uso de funções assíncronas com menos código.
-- Adicionado suporte à automação de navegadores (inicialmente apenas Chrome).
-- Melhorias nas descrições e adição de docstrings em todas as funções e objetos.
-- Submódulo de logs unificado com Loguru, agora com suporte a configuração de diretórios, nomes de arquivos e streams para console e arquivo.
+- Atualização de Linters e Formatters
+  - black
+  - pylint
+  - bandit
+  - flake8
+  - isort
+  - pyupgrade
+  - detect-secrets
+  - autoflake
 
 
 ## Mais Sobre

rpa_suite-1.5.9.dist-info/RECORD

@@ -0,0 +1,25 @@
+rpa_suite/__init__.py,sha256=uk4XRRpZn734AlzjPgvbmW0mO384jmOdYOZ8a0c--Q8,2365
+rpa_suite/suite.py,sha256=E4UDl4SgLSu2c2yI-qmK48NbQH2WwjSfvq3MAjmGnJ4,10568
+rpa_suite/core/__init__.py,sha256=2KWotqRNuCNwVhACACB4zhrXnTWR9H77_6U6j0WTJK0,1738
+rpa_suite/core/asyncrun.py,sha256=gRKsqvT4QAwg906BkLQXHi-oMbjM30D3yRWV1qAqj1Y,4192
+rpa_suite/core/browser.py,sha256=NeJk8lWDKZcGR9ULfWkDZ4WmFujU-DVr5-QH0qUSSgU,14725
+rpa_suite/core/clock.py,sha256=ELhgehLoqrf5bjkDpJ8wkcha9YmsnIfLb0qQW7OKrzw,13161
+rpa_suite/core/date.py,sha256=nnAktYMZNjcN4e6HEiYJgdMLD5VZluaOjfyfSPaz71c,6307
+rpa_suite/core/dir.py,sha256=ZfgFeCkl8iB8Tc5dST35olImpj4PoWThovNYvtpwnu8,10329
+rpa_suite/core/email.py,sha256=D69vPmoBJYwSTgDu5tvXhakvsYprXr0BAFRYeaVicx0,8473
+rpa_suite/core/file.py,sha256=hCXoWiEGtxRfp5Uq33p0f2eDwKUv3dEiUSajOhpNwbc,11317
+rpa_suite/core/log.py,sha256=9dPDnV8e4p9lwZoyd1ICb6CjJiiSXTXVJseQkdtdRuQ,6542
+rpa_suite/core/parallel.py,sha256=a_aEqvoJ9jxsFg1H42wsPT2pCS3WApqbGc2PETgBBEs,11460
+rpa_suite/core/print.py,sha256=i1icdpNreQf2DCO6uLQKuuUD0vsrsOnYSpiQGaGNJi4,5780
+rpa_suite/core/regex.py,sha256=IHQF-xHVacDuloQqcBJdTCjd7oXVqDdbGa50Mb803Bk,3321
+rpa_suite/core/validate.py,sha256=Msk_bL9pBuenuUzFv7Wg9L_z3zXq0lOHsDavkwfaAn0,10620
+rpa_suite/functions/__create_ss_dir.py,sha256=kaRotLlYDCQGKtv9nd8zZUorQmHYGbHmOEWJ1DZBBYc,3426
+rpa_suite/functions/__init__.py,sha256=Y9Kp8tTmyCcQ4sErjb0c2cbDNTAAoTArEF2pYl7mt5s,57
+rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
+rpa_suite/utils/__init__.py,sha256=bqxq5kckulcQzNCn1tHwHj0WMIQBTUYNDzMzBhLtbIY,729
+rpa_suite/utils/system.py,sha256=kkTsjwBQ-8_G_6l-0tuwkpmeI3KVssRZ7QAiYlR3vt0,5185
+rpa_suite-1.5.9.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.5.9.dist-info/METADATA,sha256=Cb7VubI35_hoUBEU8Tkz1RQke7yFpqkAyUUBfo9ydbs,12978
+rpa_suite-1.5.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rpa_suite-1.5.9.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.5.9.dist-info/RECORD,,

rpa_suite-1.5.8.dist-info/RECORD

@@ -1,25 +0,0 @@
-rpa_suite/__init__.py,sha256=PGlr0Y0NLLH1sarD1VTv-Tvm_uZPmo1Ar4LLncvUVFU,2365
-rpa_suite/suite.py,sha256=fIbli4MCBVKXvv5JFmzudcEZATYMFyvx9rIK9CceorI,10648
-rpa_suite/core/__init__.py,sha256=clmYBLmsmFRXGMABUjIkV-dBe_OlviowszdIJEwS-yM,1748
-rpa_suite/core/asyncrun.py,sha256=bE04H36V01LavLRzGMhaUDBrnwhwLLSqpzKRZjsHVnA,4195
-rpa_suite/core/browser.py,sha256=tew_SaTBVsWZHi66O41GOLMrdoR1XvgQmtoBMjGa9iE,15009
-rpa_suite/core/clock.py,sha256=T8ilbWrmGwhRGBAVRCCvICWQ1_uu2VjDTJgNEljPYhY,13414
-rpa_suite/core/date.py,sha256=42Nwvyx-FBBImEyVhBGksmIZ9VSwyFqhQPVeEwSpmtc,6310
-rpa_suite/core/dir.py,sha256=sN9R-XGIrySAyUYIB3XVHzaZR5ZqcX2Ag-pKZ6G3jpY,10301
-rpa_suite/core/email.py,sha256=kH6wFPxekXxhqt4ry_gWOzVeV_YBSIzb_xr5CL9FR_8,8741
-rpa_suite/core/file.py,sha256=plj_sC-j2j2IEQ5NRTssnSNPaPGLBg-RjPwGZPpWsIo,11441
-rpa_suite/core/log.py,sha256=ieaAKO3R4H8YW8jcg9KMRjfKd1iRcjGzh2husVnQjgc,6678
-rpa_suite/core/parallel.py,sha256=nmATr6KimkAplDeh-dGwP6iB9muJ7ygDQ3NoYkEYgIg,11709
-rpa_suite/core/print.py,sha256=T-O4zaYzfPLKn5tEzgNrWOqRV_p4hAzT-c1Y3JDla24,5825
-rpa_suite/core/regex.py,sha256=76NjtLaIFM4LuTWLAOusQoOcP_Rub_G2ol9H6CIkTMg,3324
-rpa_suite/core/validate.py,sha256=gOISOwjCza-18kfpaZnWCrKj4aIk2s7U4mStBDUAC7E,10857
-rpa_suite/functions/__create_ss_dir.py,sha256=oAvZCMRgrBNUpaYGEiNlUFa1XiVYDfOqPb9M8ITxqG8,3482
-rpa_suite/functions/__init__.py,sha256=nXet0AfuyaazPrJUzfCgE382hONS3QqxDLydo75J6NU,57
-rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
-rpa_suite/utils/__init__.py,sha256=FeMyn0dSuj8gMBrvzk-61mkz4F_hPT6l--vDyMWjxYw,729
-rpa_suite/utils/system.py,sha256=5ggEJoIZttoFZ46SKoQJoMp65exsYDQrzeDqzxqtMP0,5224
-rpa_suite-1.5.8.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.5.8.dist-info/METADATA,sha256=losVczz4q2NzB6P_Z6wrNkX9tneK8J4m9FpJaerGpHQ,13657
-rpa_suite-1.5.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rpa_suite-1.5.8.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.5.8.dist-info/RECORD,,