rpa-suite 1.6.2__py3-none-any.whl → 1.6.3__py3-none-any.whl

rpa_suite/utils/system.py

@@ -8,109 +8,113 @@ import ctypes
 # imports internal
 from rpa_suite.functions._printer import error_print, success_print
 
+class UtilsError(Exception):
+    """Custom exception for Utils errors."""
+    def __init__(self, message):
+        super().__init__(f'UtilsError: {message}')
 
 class Utils:
     """
-    Classe utilitária para gerenciamento de configurações de sistema e diretórios.
+    Utility class for system configuration and directory management.
 
-    Fornece métodos para manipulação de caminhos de importação e configurações do sistema.
+    Provides methods for manipulating import paths and system configurations.
     """
 
     def __init__(self):
         """
-        Inicializa a classe Utils.
+        Initializes the Utils class.
 
-        Não requer parâmetros de inicialização específicos.
+        Does not require specific initialization parameters.
         """
         try:
             pass
         except Exception as e:
-            error_print(f"Erro durante a inicialização da classe Utils: {str(e)}.")
+            UtilsError(f"Error during Utils class initialization: {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.
+        Configures the current directory as importable by adding it to the system path.
 
-        Adiciona o diretório pai do módulo atual ao sys.path, permitindo importações
-        dinâmicas de módulos locais.
+        Adds the parent directory of the current module to sys.path, allowing
+        dynamic imports of local modules.
 
-        Parâmetros:
+        Parameters:
         ----------
-        display_message : bool, opcional
-            Se True, exibe uma mensagem de sucesso após definir o diretório.
-            Por padrão é False.
+        display_message : bool, optional
+            If True, displays a success message after setting the directory.
+            Default is False.
 
-        Retorna:
+        Returns:
         --------
         None
 
-        Exceções:
-        ---------
-        Captura e registra quaisquer erros durante o processo de configuração.
+        Exceptions:
+        -----------
+        Captures and logs any errors during the configuration process.
         """
 
         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!")
+                success_print("Directory successfully configured for import!")
 
         except Exception as e:
-            error_print(f"Erro ao configurar diretório importável: {str(e)}.")
+            UtilsError(f"Error configuring importable directory: {str(e)}.")
 
 
 class KeepSessionActive:
     """
-    Gerenciador de contexto avançado para prevenir bloqueio de tela no Windows.
+    Advanced context manager to prevent screen lock on 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.
+    Uses Windows API calls to keep the system active during
+    critical task execution, preventing suspension or screen lock.
 
-    Atributos de Classe:
-    -------------------
+    Class Attributes:
+    ----------------
     ES_CONTINUOUS : int
-        Flag para manter o estado de execução atual do sistema.
+        Flag to maintain the current system execution state.
     ES_SYSTEM_REQUIRED : int
-        Flag para prevenir a suspensão do sistema.
+        Flag to prevent system suspension.
     ES_DISPLAY_REQUIRED : int
-        Flag para manter o display ativo.
+        Flag to keep the display active.
 
-    Exemplo de Uso:
-    --------------
+    Usage Example:
+    -------------
     with KeepSessionActive():
-        # Código que requer que o sistema permaneça ativo
-        realizar_tarefa_longa()
+        # Code that requires the system to remain active
+        perform_long_task()
     """
 
     def __init__(self) -> None:
         """
-        Inicializa as configurações de estado de execução do sistema.
+        Initializes system execution state settings.
 
-        Configura constantes específicas do Windows para controle de energia
-        e gerenciamento de estado do sistema operacional.
+        Configures Windows-specific constants for power control
+        and operating system state management.
         """
         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)}.")
+            UtilsError(f"Error initializing KeepSessionActive: {str(e)}.")
 
     def __enter__(self) -> None:
         """
-        Configura o estado de execução para prevenir bloqueio de tela.
+        Configures execution state to prevent screen lock.
 
-        Utiliza chamada de API do Windows para manter sistema e display ativos
-        durante a execução do bloco de código.
+        Uses Windows API call to keep system and display active
+        during code block execution.
 
-        Retorna:
+        Returns:
         --------
         KeepSessionActive
-            A própria instância do gerenciador de contexto.
+            The context manager instance itself.
 
-        Exceções:
-        ---------
-        Captura e registra quaisquer erros durante a configuração de estado.
+        Exceptions:
+        -----------
+        Captures and logs any errors during state configuration.
         """
         try:
             ctypes.windll.kernel32.SetThreadExecutionState(
@@ -118,40 +122,39 @@ class KeepSessionActive:
             )
             return self
         except Exception as e:
-            error_print(f"Erro ao configurar estado de execução: {str(e)}.")
-            return self
+            UtilsError(f"Error configuring execution state: {str(e)}.")
 
     def __exit__(self, exc_type, exc_val, exc_tb) -> None:
         """
-        Restaura as configurações padrão de energia do sistema.
+        Restores default system power settings.
 
-        Método chamado automaticamente ao sair do bloco de contexto,
-        revertendo as configurações de estado de execução para o padrão.
+        Method called automatically when exiting the context block,
+        reverting execution state settings to default.
 
-        Parâmetros:
+        Parameters:
         ----------
-        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.
+        exc_type : type, optional
+            Type of exception that may have occurred.
+        exc_val : Exception, optional
+            Value of exception that may have occurred.
+        exc_tb : traceback, optional
+            Traceback of exception that may have occurred.
+
+        Exceptions:
+        -----------
+        Captures and logs any errors during state restoration.
         """
         try:
             ctypes.windll.kernel32.SetThreadExecutionState(self.ES_CONTINUOUS)
         except Exception as e:
-            error_print(f"Erro ao restaurar estado de execução: {str(e)}.")
+            UtilsError(f"Error restoring execution state: {str(e)}.")
 
 
 class Tools(Utils):
     """
-    Classe utilitária para gerenciamento de configurações de sistema e diretórios.
+    Utility class for system configuration and directory management.
 
-    Fornece métodos para manipulação de caminhos de importação e configurações do sistema.
+    Provides methods for manipulating import paths and system configurations.
     """
 
     keep_session_active: KeepSessionActive = KeepSessionActive

{rpa_suite-1.6.2.dist-info → rpa_suite-1.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.6.2
+Version: 1.6.3
 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
@@ -292,33 +292,21 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.6.2**
+### Versão: **Beta 1.6.3**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 08/06/2025
+- **Última Atualização:** 16/09/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:
-- atualização 1.6.0 
+- atualização 1.6.3
   - Adição Módulo: Iris (OCR-IA)
   - Feat.: leitura de documento (aceita multiplos formatos)
   - Feat.: leitura em lote (multiplos docmumentos em uma unica chamada)
   - Melhoria de docstrings
 
-- atualização 1.5.9 
-  - Atualização de Linters e Formatters
-  - black
-  - pylint
-  - bandit
-  - flake8
-  - isort
-  - pyupgrade
-  - detect-secrets
-  - autoflake
-
-
 ## Mais Sobre
 
 Para mais informações, visite os links abaixo:

rpa_suite-1.6.3.dist-info/RECORD

@@ -0,0 +1,27 @@
+rpa_suite/__init__.py,sha256=oFipolNqMhr7shYERyO8R8YUGJzQwepnHDIL2VVX6FU,2915
+rpa_suite/suite.py,sha256=yP-5_YrB_DujKpZXfAcIqgNV5BeTjNbNxB-Jst9UJJo,12361
+rpa_suite/core/__init__.py,sha256=TVOHv0U3sDTtqrvu2jg0_URtEI1Si3EyNW-N7eEnXqo,1966
+rpa_suite/core/artemis.py,sha256=QjyTxXK48kCJpwpGBIfHupGSpmwhCsMDuWwMuxSXPRE,17784
+rpa_suite/core/asyncrun.py,sha256=VP7x5KN_qxXUL0AdA6evklPgHCRRqgyyqhWYuQHFye8,4551
+rpa_suite/core/browser.py,sha256=37desqhn4Vo8dSbz9KSNwLFSmY-WRW7rh0HIqOMjmN4,14566
+rpa_suite/core/clock.py,sha256=czjUN4m1NyPxD9eO59DRfn7IRbycXlrJSFwePBnBbSY,14353
+rpa_suite/core/date.py,sha256=dvtXU43qK8zbcwmpdpSYM3Y7LtQAUR8ByB7uFw7UTHk,7411
+rpa_suite/core/dir.py,sha256=8JQg56W8kho8Kk9D78YCNYQmAirBSudvOjVTpO-dbYw,8032
+rpa_suite/core/email.py,sha256=EaJy8keVfRYNUdcIWz2ri9To-W8iZPqiMleDQt9KE3I,8914
+rpa_suite/core/file.py,sha256=aBsnoHH0QjyNnhW0KDxF7TrLUuI51Rz7R4sfOitZe_g,11398
+rpa_suite/core/iris.py,sha256=qhQqVoJe_PQGvZt0e9_-VXNXVN16_UM0PxF_U8nZuJ0,9007
+rpa_suite/core/log.py,sha256=rsQ-sSi0dahvMBUvRPDE72nR9lBzncRS5mf9eqc8U1E,10474
+rpa_suite/core/parallel.py,sha256=hcycdS8TZU8R3DsFAukBBOc5_IutLDu8PlaH3K1WJbs,12705
+rpa_suite/core/print.py,sha256=-0oUO3sVTft2_dc6E4OkchyZLR2zJPHne4ZOn65rw20,6533
+rpa_suite/core/regex.py,sha256=f5aDw3pZ7xG7qpsTzHIr6nlD93FZTBXMMG--v448oY0,3012
+rpa_suite/core/validate.py,sha256=XL8y80GK4C_kisg6Lzc0zV4XhfBHiICyn78VCnT-aqc,7567
+rpa_suite/functions/__create_ss_dir.py,sha256=kaRotLlYDCQGKtv9nd8zZUorQmHYGbHmOEWJ1DZBBYc,3426
+rpa_suite/functions/__init__.py,sha256=3e7nQAFAG-w5WnbqggSnBnFph3ff4lalvK4Wh5QkrFo,57
+rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
+rpa_suite/utils/__init__.py,sha256=Y0R89MMt7aiKQDn3w463uB_U0C4GcgwTAtU8-jCUI1Q,729
+rpa_suite/utils/system.py,sha256=3g3Pwt-bFUPIY2UQzN7EVSH7OJ_cd35Vs8x3w1I24jk,4938
+rpa_suite-1.6.3.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.6.3.dist-info/METADATA,sha256=CWjnoWK7Fkc0RJhFp_0nNb-1HbP5qkJeObD9qFvGTiQ,13203
+rpa_suite-1.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rpa_suite-1.6.3.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.6.3.dist-info/RECORD,,

rpa_suite-1.6.2.dist-info/RECORD

@@ -1,26 +0,0 @@
-rpa_suite/__init__.py,sha256=olciiOHwT6n0OtAxGp2QH-GTLuS0IvfvnnJOObiKIMo,2915
-rpa_suite/suite.py,sha256=ylGDXRhyIWM3wibmG_R0UbeHKz5-hYUaTT92LvA9IaU,11818
-rpa_suite/core/__init__.py,sha256=dmW1RHmaX17QDJ-7lZgZys6JcY1o0kaoplAWSOnZpXY,1858
-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/iris.py,sha256=0ciu5QTRABmb5DVNmaa0gAU8AjJrTJPGv83kD5NoX1w,8916
-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=7u63cRyow2OYQMt6Ph5uYImM_aUeMqdMaOvvO5v698Y,57
-rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
-rpa_suite/utils/__init__.py,sha256=VAPzxR_aW-8kWsAUYzvrFdkH_aRLXywTUvj_qah9GwM,729
-rpa_suite/utils/system.py,sha256=kkTsjwBQ-8_G_6l-0tuwkpmeI3KVssRZ7QAiYlR3vt0,5185
-rpa_suite-1.6.2.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.6.2.dist-info/METADATA,sha256=P7t3b0YagF5azd8NreHkLKsi4LFktUyFzXMjTP0LzgE,13383
-rpa_suite-1.6.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rpa_suite-1.6.2.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.6.2.dist-info/RECORD,,