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

rpa_suite/__init__.py

@@ -27,7 +27,10 @@ Available modules:
     ``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
 -----
@@ -57,10 +60,13 @@ Módulos disponíveis:
     ``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``
 """
 
-__version__ = "1.5.5"
+__version__ = "1.6.1"
 
 # allows importing the rpa_suite module without the package name
 from .suite import rpa

rpa_suite/core/__init__.py

@@ -36,13 +36,16 @@ from .parallel import ParallelRunner
 from .asyncrun import 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| docling) 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"):
     from .browser import Browser
 
+# from .iris import Iris
+if importlib.util.find_spec("docling"):
+    from .iris import Iris
 
-__version__ = "1.5.5"
+__version__ = "1.6.1"

rpa_suite/core/iris.py

@@ -0,0 +1,140 @@
+# rpa_suite/core/iris.py
+
+"""
+Iris (OCR-IA) módulo para conversão de documentos usando DocLing.
+
+Este módulo fornece uma interface simplificada para converter documentos
+em vários formatos, otimizado para uso em automação RPA.
+"""
+
+# imports externos
+try:
+    from docling.document_converter import DocumentConverter
+except ImportError as e:
+    raise ImportError("Iris - Error: Não foi possível importar 'docling.document_converter'. Certifique-se de que a biblioteca 'docling' está instalada.") from e
+
+# imports de terceiros
+from enum import Enum
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Union
+
+# imports internos
+from rpa_suite.functions._printer import alert_print, error_print, success_print
+
+class IrisError(Exception):
+    """Exceção personalizada para erros do Iris."""
+    def __init__(self, message):
+        super().__init__(f'Iris - Error: {message}')
+
+class ExportFormats(Enum):
+    """Formatos de exportação suportados para conversão de documentos."""
+    MARKDOWN = "markdown"
+    DICT = "dict"
+    DOCTAGS = "doctags"
+    HTML = "html"
+    TEXT = "text"
+
+class Iris:
+    """
+    Iris (OCR-IA)
+    Conversor de documentos usando a biblioteca DocLing.
+
+    Esta classe fornece uma interface simplificada para converter documentos
+    em vários formatos (PDF, imagens, texto) para formatos estruturados como
+    Markdown, HTML, texto simples, entre outros.
+
+    Atributos:
+        engine: Instância do DocumentConverter do DocLing.
+        last_result: Último resultado de conversão processado.
+
+    Exemplo:
+        >>> iris = Iris()
+        >>> content = iris.read_document("document.pdf", ExportFormats.MARKDOWN)
+        >>> print(content)
+    """
+
+    engine: Optional[DocumentConverter]
+
+    def __init__(self) -> None:
+        """
+        Inicializa a classe Iris com o conversor de documentos.
+
+        Levanta:
+            IrisError: Se a biblioteca DocLing não estiver instalada.
+        """
+        try:
+            self.iris_converter = DocumentConverter()
+            self.engine = self.iris_converter
+            self.path_file = None
+            self.result_converted = None
+            self.result_formatted = None
+        except Exception as e:
+            error_print("Iris - Error: Falha ao inicializar o DocumentConverter.")
+            raise IrisError(f"Falha ao inicializar o DocumentConverter: {e}")
+
+    def __convert_document(self, path_file: str = None):
+        """
+        Converte o documento informado pelo caminho.
+
+        Levanta:
+            IrisError: Se ocorrer erro na conversão do documento.
+        """
+        try:
+            if not path_file:
+                raise IrisError("Caminho do arquivo não informado para conversão.")
+            self.result_converted = self.iris_converter.convert(path_file)
+        except Exception as e:
+            error_print(f"Iris - Error: Falha ao converter o documento: {e}")
+            raise IrisError(f"Falha ao converter o documento: {e}")
+
+    def read_document(self, file_path: str = None, result_format=ExportFormats.MARKDOWN, verbose: bool = False) -> Optional[Union[str, dict]]:
+        """
+        Lê e converte um documento para o formato especificado.
+
+        Args:
+            file_path: Caminho para o arquivo do documento.
+            result_format: Formato de exportação desejado.
+            verbose: Se True, exibe mensagens de sucesso.
+
+        Retorna:
+            Documento convertido para o formato especificado, ou None se falhar.
+
+        Levanta:
+            IrisError: Se ocorrer erro durante validação, conversão ou exportação.
+
+        Exemplo:
+            >>> iris = Iris()
+            >>> content = iris.read_document("doc.pdf", ExportFormats.TEXT)
+            >>> print(content)
+        """
+        try:
+            self.__convert_document(file_path)
+
+            if not self.result_converted or not hasattr(self.result_converted, 'document'):
+                raise IrisError("Conversão falhou ou objeto retornado inválido.")
+
+            if result_format == ExportFormats.MARKDOWN:
+                self.result_formatted = self.result_converted.document.export_to_markdown()
+            elif result_format == ExportFormats.DICT:
+                self.result_formatted = self.result_converted.document.export_to_dict()
+            elif result_format == ExportFormats.DOCTAGS:
+                self.result_formatted = self.result_converted.document.export_to_doctags()
+            elif result_format == ExportFormats.HTML:
+                self.result_formatted = self.result_converted.document.export_to_html()
+            elif result_format == ExportFormats.TEXT:
+                self.result_formatted = self.result_converted.document.export_to_text()
+            else:
+                alert_print(f'Iris - Error: Formato não suportado: {result_format}.')
+                raise IrisError(f"Formato não suportado: {result_format}.")
+
+            if verbose:
+                success_print('Irir - Convertido com sucesso!')
+
+            return self.result_formatted
+
+        except IrisError as ie:
+            error_print(str(ie))
+            return None
+        except Exception as e:
+            error_print(f"Iris - Error: Erro inesperado ao ler o documento: {e}")
+            raise IrisError(f"Erro inesperado ao ler o documento: {e}")

rpa_suite/functions/__init__.py

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

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,8 +155,9 @@ 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| docling) 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
@@ -158,6 +166,12 @@ class Suite:
 
         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
@@ -312,10 +326,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",
@@ -326,15 +346,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.6.1"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.9
+Version: 1.6.1
 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
@@ -186,12 +186,12 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - pillow
 - pyautogui
 - typing
-- setuptools
 
-  opcionalmente para automação de navegador:
+  opcionalmente para usar todas funcionalidades:
 
   - selenium
   - webdriver_manager
+  - docling
 
 <br>
 <hr>
@@ -282,19 +282,31 @@ 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.
+
+<br>
+
 ## Release Notes
 
-### Versão: **Beta 1.5.9**
+### Versão: **Beta 1.6.1**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** 06/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:
+### 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 de Linters e Formatters
+- atualização 1.5.9 
+  - Atualização de Linters e Formatters
   - black
   - pylint
   - bandit

{rpa_suite-1.5.9.dist-info → rpa_suite-1.6.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
-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/__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
@@ -8,18 +8,19 @@ 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=x-CvbIVtThFpA1AtmVlm-Ps97jcCuk-De-22WF3_qRo,5461
 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/__init__.py,sha256=7u63cRyow2OYQMt6Ph5uYImM_aUeMqdMaOvvO5v698Y,57
 rpa_suite/functions/_printer.py,sha256=gj7dwOt4roSj2iwOGWeGgUD3JVr7h4UESyCg9CmrieA,3946
-rpa_suite/utils/__init__.py,sha256=bqxq5kckulcQzNCn1tHwHj0WMIQBTUYNDzMzBhLtbIY,729
+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.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.6.1.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.6.1.dist-info/METADATA,sha256=wLNug0aSQf_uGvoVplzWELy6a9LL7Vc_BOh98MIwRt0,13324
+rpa_suite-1.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rpa_suite-1.6.1.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.6.1.dist-info/RECORD,,