rpa-suite 1.5.5__py3-none-any.whl → 1.5.7__py3-none-any.whl

rpa_suite/core/browser.py

@@ -42,7 +42,7 @@ class Browser:
             Finds a single element on the page using the specified locator strategy.
         get(url: str, display_message: bool = False):
             Navigates the browser to the specified URL.
-        _close_all_chrome():
+        _close_all_browsers():
             Closes all Chrome processes forcefully.
         close_browser(display_message: bool = False):
             Closes the browser instance and terminates the associated Chrome processes.
@@ -74,7 +74,7 @@ class Browser:
             Localiza um único elemento na página usando a estratégia de localização especificada.
         get(url: str, display_message: bool = False):
             Navega o navegador para a URL especificada.
-        _close_all_chrome():
+        _close_all_browsers():
             Fecha todos os processos do Chrome de forma forçada.
         close_browser(display_message: bool = False):
             Fecha a instância do navegador e termina os processos associados do Chrome.
@@ -84,12 +84,12 @@ class Browser:
     port: int = None
     path_driver = None
 
-    def __init__(self, port: int = 9393, close_all_chrome_on_this_port: bool = False):
+    def __init__(self, port: int = 9393, close_browser_on_this_port: bool = False):
         self.port = port
         self.path_driver = ChromeDriverManager().install()
 
-        if close_all_chrome_on_this_port:
-            self._close_all_chrome()
+        if close_browser_on_this_port:
+            self._close_all_browsers()
         ...
 
     def configure_browser(self) -> None:
@@ -168,7 +168,7 @@ class Browser:
                     if response.status_code == 200:
                         break  # O Chrome está aberto
                 except requests.ConnectionError:
-                    sleep(1)  # Espera um segundo antes de tentar novamente
+                    sleep(0.3)  # Espera um segundo antes de tentar novamente
 
             # Inicializa o Chrome com as opções
             self.configure_browser()
@@ -199,7 +199,7 @@ class Browser:
         """
 
         try:
-            sleep(2)
+            sleep(0.9)
             element = WebDriverWait(self.driver, timeout).until(
                 EC.presence_of_element_located((by, value))
             )
@@ -285,7 +285,7 @@ class Browser:
                 pass
 
             # Aguarda um momento para o processo ser liberado
-            sleep(1)
+            sleep(0.6)
 
             # Força o fechamento do processo específico do Chrome
             os.system(

rpa_suite/core/log.py

@@ -37,13 +37,10 @@ class CustomHandler:
 
 class CustomFormatter:
     def format(self, record):
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-        format_string = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <level>{message}</level>\n"
+        # Use the info from record["extra"] which is set in Log._log to the caller's file and line
+        filename = record["extra"].get("filename", "")
+        lineno = record["extra"].get("lineno", "")
+        format_string = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{filename}</green>:<cyan>{lineno: <4}</cyan> <level>{message}</level>\n"
         log_msg = format_string.format(
             time=record["time"],
             level=record["level"].name,
@@ -101,7 +98,7 @@ class Log:
             file_handler = os.path.join(self.full_path, f"{self.name_file_log}.log")
             self.logger.remove()
 
-            log_format = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{extra[filename]}</green>:{extra[lineno]: <4} <level>{message}</level>"
+            log_format = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{extra[filename]}</green>:<cyan>{extra[lineno]: <4}</cyan> <level>{message}</level>"
 
             formatter = CustomFormatter()
 
@@ -123,14 +120,36 @@ class Log:
             return None
 
     def _log(self, level: str, msg: str):
+        """
+        docstring
+        """
         try:
-            frame = inspect.currentframe().f_back
+            # 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
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-            filename = os.path.join(foldername, filename)
+
+            # Normalize path to use os.sep
+            full_path_filename = os.path.normpath(full_path_filename)
+
+            # Get the last two components: parent folder and filename
+            parent_folder = os.path.basename(os.path.dirname(full_path_filename))
+            file_name = os.path.basename(full_path_filename)
+            display_filename = f"{parent_folder}/{file_name}"
+
             lineno = frame.f_lineno
-            self.logger.bind(filename=filename, lineno=lineno).log(level, msg)
+
+            self.logger.bind(filename=display_filename, lineno=lineno).log(level, msg)
         except Exception as e:
             error_print(f"Erro durante a função de log! Error: {str(e)}")
 

rpa_suite/suite.py

@@ -16,7 +16,7 @@ from .core.asyncrun import AsyncRunner
 
 # imports external
 from colorama import Fore
-import pkg_resources
+from importlib.metadata import version
 
 # imports third-party
 import subprocess
@@ -162,7 +162,10 @@ class Suite:
 
     # VARIABLES INTERNAL
     try:
-        __version__ = pkg_resources.get_distribution("rpa_suite").version
+        # old: __version__ = pkg_resources.get_distribution("rpa_suite").version
+        
+        __version__ = version("package_name")
+        
     except Exception:
         __version__ = "unknown"
 

rpa_suite/utils/__init__.py

@@ -9,5 +9,7 @@ pt-br
 O módulo de utilitários da rpa-suite fornece uma coleção de funções e classes utilitárias que facilitam diversas tarefas na automação de processos. Inclui métodos auxiliares para registro de log, manipulação de arquivos e outras operações comuns que aprimoram a funcionalidade e a usabilidade da RPA Suite.
 
 """
+from .system import Tools
+
 
 __version__ = '1.5.5'

rpa_suite/utils/system.py

@@ -4,41 +4,153 @@
 from rpa_suite.functions._printer import error_print, success_print
 
 # imports third-party
-import sys, os
+import sys, os, ctypes, traceback
 
 
-def set_importable_dir(display_message: bool = False):
+class Utils:
     """
-    Sets the directory to be importable by appending it to the system path.
+    Classe utilitária para gerenciamento de configurações de sistema e diretórios.
 
-    Parameters:
-    ----------
-        display_message: bool - If True, displays a success message after setting the directory.
+    Fornece métodos para manipulação de caminhos de importação e configurações do sistema.
+    """
+    
+    def __init__(self): 
+        """
+        Inicializa a classe Utils.
+
+        Não requer parâmetros de inicialização específicos.
+        """
+        try:
+            pass
+        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 
+        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. 
+            Por padrão é False.
 
-    Returns:
-    ----------
+        Retorna:
+        --------
         None
 
-    pt-br
-    ----------
-    Define o diretório para ser importável, adicionando-o ao caminho do sistema.
+        Exceções:
+        ---------
+        Captura e registra quaisquer erros durante o processo de configuração.
+        """
 
-    Parâmetros:
-    ----------
-        display_message: bool - Se True, exibe uma mensagem de sucesso após definir o diretório.
+        try:
+            sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-    Retornos:
-    ----------
-        Nenhum
+            if display_message:
+                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)}"
+            )
+
+
+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 
+    execução de tarefas críticas, impedindo suspensão ou bloqueio de tela.
+
+    Atributos de Classe:
+    -------------------
+    ES_CONTINUOUS : int
+        Flag para manter o estado de execução atual do sistema.
+    ES_SYSTEM_REQUIRED : int
+        Flag para prevenir a suspensão do sistema.
+    ES_DISPLAY_REQUIRED : int
+        Flag para manter o display ativo.
+
+    Exemplo de Uso:
+    --------------
+    with KeepSessionActive():
+        # Código que requer que o sistema permaneça ativo
+        realizar_tarefa_longa()
+    """
+
+    def __init__(self) -> None:
+        """
+        Inicializa as configurações de estado de execução do sistema.
+
+        Configura constantes específicas do Windows para controle de energia 
+        e gerenciamento de estado do sistema operacional.
+        """
+        try:
+            self.ES_CONTINUOUS = 0x80000000
+            self.ES_SYSTEM_REQUIRED = 0x00000001
+            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 
+        durante a execução do bloco de código.
+
+        Retorna:
+        --------
+        KeepSessionActive
+            A própria instância do gerenciador de contexto.
+
+        Exceções:
+        ---------
+        Captura e registra quaisquer erros durante a configuração de estado.
+        """
+        try:
+            ctypes.windll.kernel32.SetThreadExecutionState(
+                self.ES_CONTINUOUS | self.ES_SYSTEM_REQUIRED | self.ES_DISPLAY_REQUIRED
+            )
+            return self
+        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, 
+        revertendo as configurações de estado de execução para o padrão.
+
+        Parâmetros:
+        ----------
+        exc_type : type, opcional
+            Tipo de exceção que pode ter ocorrido.
+        exc_val : Exception, opcional
+            Valor da exceção que pode ter ocorrido.
+        exc_tb : traceback, opcional
+            Traceback da exceção que pode ter ocorrido.
+
+        Exceções:
+        ---------
+        Captura e registra quaisquer erros durante a restauração do estado.
+        """
+        try:
+            ctypes.windll.kernel32.SetThreadExecutionState(self.ES_CONTINUOUS)
+        except Exception as e:
+            error_print(f"Erro ao restaurar estado de execução: {str(e)}")
 
-    try:
-        sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-        if display_message:
-            success_print(f"Successfully set the directory for importation!")
 
-    except Exception as e:
-        error_print(
-            f"An error occurred while executing the function: {set_importable_dir.__name__}! Error: {str(e)}."
-        )
+class Tools(Utils):
+    
+    KeepSessionActive = KeepSessionActive

{rpa_suite-1.5.5.dist-info → rpa_suite-1.5.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.5
+Version: 1.5.7
 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,10 +284,10 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.5**
+### Versão: **Beta 1.5.7**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 02/05/2025
+- **Última Atualização:** 28/05/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.

{rpa_suite-1.5.5.dist-info → rpa_suite-1.5.7.dist-info}/RECORD

@@ -1,14 +1,14 @@
 rpa_suite/__init__.py,sha256=PGlr0Y0NLLH1sarD1VTv-Tvm_uZPmo1Ar4LLncvUVFU,2365
-rpa_suite/suite.py,sha256=DGP3zOW705qnv8EfFcXg75JIWQwibeIJID5kcmbFSQg,10556
+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=Hpx4xJkg0KbBRgdYA5umYcOyHVYY-sz9k9ohBrk4uM0,15003
+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=LqH_sJ2ttAuW6qIhVP0x-gdDxBEzC1CoQCo_7VNgHSg,5869
+rpa_suite/core/log.py,sha256=WAMGRwQr-zvl7eWR-JLJHQbq4NF4vN68MCc84QMnBfs,6568
 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
@@ -16,10 +16,10 @@ rpa_suite/core/validate.py,sha256=gOISOwjCza-18kfpaZnWCrKj4aIk2s7U4mStBDUAC7E,10
 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=Paz45Tn6mSyU0YcQLqvtBx4pOH1yoJVC1nlz4svtHTk,700
-rpa_suite/utils/system.py,sha256=Fum2VVXgBqWpS-f3Qj3u-sbWtW2dfCpKPRuipAY3x6c,1176
-rpa_suite-1.5.5.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.5.5.dist-info/METADATA,sha256=6V1UAxuE8DBMLcv7YO5VVzTK4hgv7WuxG-6XgHNE-lo,13938
-rpa_suite-1.5.5.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-rpa_suite-1.5.5.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.5.5.dist-info/RECORD,,
+rpa_suite/utils/__init__.py,sha256=FeMyn0dSuj8gMBrvzk-61mkz4F_hPT6l--vDyMWjxYw,729
+rpa_suite/utils/system.py,sha256=KUx3yisPr-eSnORgcBVcGUypoW-xef2e-l5odLAYrnQ,5012
+rpa_suite-1.5.7.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.5.7.dist-info/METADATA,sha256=EcOxaInP0RQJUwwZwKprf7nSuc2f-61TpMsbxjZG2sU,13938
+rpa_suite-1.5.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rpa_suite-1.5.7.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.5.7.dist-info/RECORD,,

{rpa_suite-1.5.5.dist-info → rpa_suite-1.5.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any