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

rpa_suite/suite.py

@@ -13,7 +13,6 @@ from .core.validate import Validate
 from .core.parallel import ParallelRunner
 from .core.asyncrun import AsyncRunner
 
-
 # imports external
 from colorama import Fore
 from importlib.metadata import version
@@ -104,6 +103,10 @@ class Suite:
         ``printer``: Functions for formatted output
         ``regex``: Operations with regular expressions
         ``validate``: Data validation functions
+        ``ParallelRunner``: Object ParallelRunner functions to run in parallel
+        ``AsyncRunner``: Object AsyncRunner functions to run in Assyncronous
+        ``Browser``: Object Browser automation functions (neeeds Selenium and Webdriver_Manager)
+        ``Iris``: Object Iris automation functions to convert documents with OCR + IA based on ``docling``
 
     pt-br
     -----
@@ -133,6 +136,10 @@ class Suite:
         ``printer``: Funções para output formatado
         ``regex``: Operações com expressões regulares
         ``validate``: Funções de validação de dados
+        ``ParallelRunner``: Objeto ParallelRunner funções para rodar processos em paralelo
+        ``AsyncRunner``: Objeto AsyncRunner funções para rodar processos em assincronicidade
+        ``Browser``: Objeto de Automação de Navegadores (necessario Selenium e Webdriver_Manager)
+        ``Iris``: Objeto Iris Automação de funções para converter documentos com OCR + IA baseado em ``docling``
     """
 
     # SUBMODULES
@@ -148,24 +155,28 @@ class Suite:
     Parallel: ParallelRunner = ParallelRunner
     Asyn: AsyncRunner = AsyncRunner
 
-    # On this case, we are importing the Browser class only if the selenium and webdriver_manager modules are installed.
-    # This is useful to avoid unnecessary imports and dependencies if the user does not need the Browser functionality.
+    # On this case, we are importing the (Browser | Iris) class only if the selenium and webdriver_manager modules are installed.
+    # This is useful to avoid unnecessary imports and dependencies if the user does not need the (Browser | Iris) functionality.
     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
 
+    # from .iris import Iris
+    if importlib.util.find_spec("docling"):
+        from .core.iris import Iris
+
+        iris: Iris = Iris
+        
     # VARIABLES INTERNAL
     try:
         # old: __version__ = pkg_resources.get_distribution("rpa_suite").version
-        
+
         __version__ = version("package_name")
-        
+
     except Exception:
         __version__ = "unknown"
 
@@ -242,9 +253,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 +287,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 +305,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
@@ -320,10 +325,16 @@ class Suite:
 
     def __install_all_libs(self):
         """
+        Method responsible for installing all libraries for advanced use of RPA-Suite, including all features such as OCR and AI agent.
+        ----------
         Metodo responsavel por instalar todas libs para uso avançado do RPA-Suite com todas funcionalidades incluindo OCR e agente de IA
         """
 
         libs = [
+            "setuptools",
+            "wheel",
+            "pyperclip",
+            "pywin32"
             "colorama",
             "colorlog",
             "email_validator",
@@ -334,15 +345,16 @@ class Suite:
             "selenium",
             "typing",
             "webdriver_manager",
+            "docling",
         ]
 
         for lib in libs:
             try:
                 subprocess.check_call([sys.executable, "-m", "pip", "install", lib])
-                self.success_print(f"Biblioteca {lib} instalada com sucesso!")
+                self.success_print(f"Suite RPA: Library {lib} installed successfully!")
 
             except subprocess.CalledProcessError:
-                self.error_print(f"Erro ao instalar biblioteca {lib}")
+                self.error_print(f"Suite RPA: Error installing library {lib}")
 
 
 rpa = Suite()

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.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.8
+Version: 1.6.0
 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
@@ -282,25 +282,41 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
   - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
   - **cancel** - Função para cancelar a tarefa assíncrona em execução.
 
+  **Iris (OCR-IA)**
+
+  - **read_document** - Reads and converts a document to the specified format.
+  - **read_multiple_documents** - Reads and converts multiple documents.
+  - **get_supported_extensions** - Returns the list of supported file extensions
+  - **is_file_supported** - Checks if a file is supported by the class.
+
+
 ## Release Notes
 
-### Versão: **Beta 1.5.8**
+### Versão: **Beta 1.6.0**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 02/06/2025
+- **Última Atualização:** 08/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.
+### Notas:
+- atualização 1.6.0 
+  - 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

rpa_suite-1.6.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+rpa_suite/__init__.py,sha256=WqIndloIi1jP_YsEf0lGNOxgr7Htdgt6XuL5ti5znb8,2915
+rpa_suite/suite.py,sha256=j07ZkaJttJ9WhfIKcc7j6h11ZssRzWdpcvXQDBYZT_s,11804
+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/iris.py,sha256=Z8aP96y78-DnzUxwtxJZiIXXOLXWTCsaWpdMoxROfQY,11467
+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.6.0.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.6.0.dist-info/METADATA,sha256=sIX1G91PeiHFKxPIrckrZFQ32BgGfv5Mf4YwKFsM4sQ,13546
+rpa_suite-1.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rpa_suite-1.6.0.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.6.0.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,,