rpa-suite 1.5.4__py3-none-any.whl → 1.5.6__py3-none-any.whl

rpa_suite/__init__.py

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

rpa_suite/core/__init__.py

@@ -45,3 +45,7 @@ if importlib.util.find_spec("selenium") and importlib.util.find_spec(
     "webdriver_manager"
 ):
     from .browser import Browser
+
+
+__version__ = '1.5.5'
+

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/functions/__init__.py

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

rpa_suite/utils/__init__.py

@@ -9,3 +9,5 @@ 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.
 
 """
+
+__version__ = '1.5.5'

rpa_suite/utils/system.py

@@ -4,41 +4,147 @@
 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.
 
-    Returns:
-    ----------
+        Parâmetros:
+        ----------
+        display_message : bool, opcional
+            Se True, exibe uma mensagem de sucesso após definir o diretório. 
+            Por padrão é False.
+
+        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.
+        """
+
+        try:
+            sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+            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)}"
+            )
+
 
-    Parâmetros:
-    ----------
-        display_message: bool - Se True, exibe uma mensagem de sucesso após definir o diretório.
+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.
 
-    Retornos:
-    ----------
-        Nenhum
+    Exemplo de Uso:
+    --------------
+    with KeepSessionActive():
+        # Código que requer que o sistema permaneça ativo
+        realizar_tarefa_longa()
     """
 
-    try:
-        sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+    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.
 
-        if display_message:
-            success_print(f"Successfully set the directory for importation!")
+        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.
 
-    except Exception as e:
-        error_print(
-            f"An error occurred while executing the function: {set_importable_dir.__name__}! Error: {str(e)}."
-        )
+        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)}")

{rpa_suite-1.5.4.dist-info → rpa_suite-1.5.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.4
+Version: 1.5.6
 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
@@ -58,11 +58,10 @@ Dynamic: summary
 [![Imports: pyautogui](https://img.shields.io/badge/%20imports-pyautogui-%231674b1?style=flat&labelColor=ef8336)](https://github.com/asweigart/pyautogui)
 [![Imports: loguru](https://img.shields.io/badge/%20imports-loguru-%231674b1?style=flat&labelColor=ef8336)](https://github.com/Delgan/loguru)
 [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
-[![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
 
 ## O que é?
 
-**RPA Suite:** um conjunto abrangente de ferramentas projetadas para simplificar e otimizar o desenvolvimento de projetos de automação RPA com Python. Embora nossa suíte seja um conjunto de Ferramentas de RPA especializado, sua versatilidade a torna igualmente útil para uma ampla gama de projetos de desenvolvimento. Esta desenvolvendo com Selenium, Botcity ou Playwright? Experimente a RPA Suite e descubra como podemos facilitar seu projeto, ou qualquer projeto de Robôs de Software.
+**RPA Suite:** um conjunto abrangente de ferramentas projetadas para simplificar e otimizar o desenvolvimento de projetos de automação RPA com Python. Embora nossa suíte seja um conjunto de Ferramentas de RPA especializado, sua versatilidade a torna igualmente útil para uma ampla gama de projetos de desenvolvimento. Esta desenvolvendo com Selenium ou Botcity? Experimente a RPA Suite e descubra como podemos facilitar seu projeto e qualquer projeto de Robôs de Software.
 
 <br>
 
@@ -285,10 +284,10 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.4**
+### Versão: **Beta 1.5.6**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 21/04/2025
+- **Última Atualização:** 27/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.4.dist-info → rpa_suite-1.5.6.dist-info}/RECORD

@@ -1,8 +1,8 @@
-rpa_suite/__init__.py,sha256=cxAPfpuoh5bNtv6t1vdV4SD80OXufwqwYi0g7FIpG_o,2340
+rpa_suite/__init__.py,sha256=PGlr0Y0NLLH1sarD1VTv-Tvm_uZPmo1Ar4LLncvUVFU,2365
 rpa_suite/suite.py,sha256=DGP3zOW705qnv8EfFcXg75JIWQwibeIJID5kcmbFSQg,10556
-rpa_suite/core/__init__.py,sha256=v_7bcPP-1QZuDQKgEVAQRXwHkqKmyYMRIEOdlO_Qj70,1719
+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
@@ -14,12 +14,12 @@ 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=JvDgAW0Msy8hf3jdVL0o2D4mkNQGUlUBl88zh1JX8pc,34
+rpa_suite/functions/__init__.py,sha256=nXet0AfuyaazPrJUzfCgE382hONS3QqxDLydo75J6NU,57
 rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
-rpa_suite/utils/__init__.py,sha256=RQ-m9QNbaByek25moxx9ajpuxjPAEdjoMu69ReLBCWY,675
-rpa_suite/utils/system.py,sha256=Fum2VVXgBqWpS-f3Qj3u-sbWtW2dfCpKPRuipAY3x6c,1176
-rpa_suite-1.5.4.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.5.4.dist-info/METADATA,sha256=8YwCc_2PsxIz3IvPP35T82Af4zERwk3nDJb1xVOYLNA,14094
-rpa_suite-1.5.4.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-rpa_suite-1.5.4.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.5.4.dist-info/RECORD,,
+rpa_suite/utils/__init__.py,sha256=Paz45Tn6mSyU0YcQLqvtBx4pOH1yoJVC1nlz4svtHTk,700
+rpa_suite/utils/system.py,sha256=fAIFSiMpb2-Hk6tExSdAWdyecqhVbAprZcyG1y794DU,4936
+rpa_suite-1.5.6.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.5.6.dist-info/METADATA,sha256=QOJHrCs1cfFZ_6M_1gdyFhUHyBFQc3g6qWTbSOW74OA,13938
+rpa_suite-1.5.6.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+rpa_suite-1.5.6.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.5.6.dist-info/RECORD,,