rpa-suite 1.5.8__py3-none-any.whl → 1.6.0__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.5.9"
 
 # allows importing the rpa_suite module without the package name
 from .suite import rpa

rpa_suite/core/__init__.py

@@ -41,11 +41,8 @@ from .asyncrun import AsyncRunner
 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 .browser import Browser
 
 
-__version__ = '1.5.5'
-
+__version__ = "1.5.5"

rpa_suite/core/asyncrun.py

@@ -1,6 +1,6 @@
 # rpa_suite/core/asyncrun.py
 
-# imports third-party
+# imports standard
 from typing import Any, Callable, Dict, Optional, TypeVar, Generic
 import asyncio
 import time

rpa_suite/core/browser.py

@@ -1,9 +1,11 @@
 # rpa_suite/core/browser.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, alert_print, success_print
+# imports standard
+from time import sleep
+import os
+import requests
 
-# imports external
+# imports third party
 from selenium import webdriver
 from selenium.webdriver.common.by import By
 from selenium.webdriver.chrome.options import Options
@@ -11,9 +13,8 @@ from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.support import expected_conditions as EC
 from webdriver_manager.chrome import ChromeDriverManager
 
-# imports third-party
-from time import sleep
-import os, requests
+# imports internal
+from rpa_suite.functions._printer import error_print, alert_print, success_print
 
 
 class Browser:
@@ -107,9 +108,7 @@ class Browser:
             # Use the absolute path from comment
 
             options = Options()
-            options.add_experimental_option(
-                "debuggerAddress", f"127.0.0.1:{str(self.port)}"
-            )
+            options.add_experimental_option("debuggerAddress", f"127.0.0.1:{str(self.port)}")
 
             # Additional configs
             options.add_argument("--start-maximized")
@@ -117,9 +116,7 @@ class Browser:
 
             # Verifica se o caminho do driver está correto
             if not os.path.exists(self.path_driver):
-                raise FileNotFoundError(
-                    f"O caminho do driver não foi encontrado: {self.path_driver}"
-                )
+                raise FileNotFoundError(f"O caminho do driver não foi encontrado: {self.path_driver}")
 
             # Create driver with options and chromedriver path
             self.driver = webdriver.Chrome(
@@ -129,13 +126,9 @@ class Browser:
             )
 
         except Exception as e:
-            error_print(
-                f"Erro durante a função: {self.configure_browser.__name__}! Error: {str(e)}."
-            )
+            error_print(f"Erro durante a função: {self.configure_browser.__name__}! Error: {str(e)}.")
 
-    def start_browser(
-        self, close_chrome_on_this_port: bool = True, display_message: bool = False
-    ):
+    def start_browser(self, close_chrome_on_this_port: bool = True, display_message: bool = False):
         """
         Starts a Chrome browser instance with remote debugging enabled.
         Args:
@@ -200,17 +193,13 @@ class Browser:
 
         try:
             sleep(0.9)
-            element = WebDriverWait(self.driver, timeout).until(
-                EC.presence_of_element_located((by, value))
-            )
+            element = WebDriverWait(self.driver, timeout).until(EC.presence_of_element_located((by, value)))
             return element
 
         except Exception as e:
 
             if display_message:
-                error_print(
-                    f"Erro durante a função: {self.find_ele.__name__}! Error: {str(e)}."
-                )
+                error_print(f"Erro durante a função: {self.find_ele.__name__}! Error: {str(e)}.")
                 return None
             else:
                 return None
@@ -303,29 +292,25 @@ class Browser:
                     f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1'
                 )
                 if display_message:
-                    alert_print(f"Browser: Fechado via força!")
+                    alert_print("Browser: Fechado via força!")
 
             else:
                 if display_message:
-                    success_print(f"Browser: Fechado com sucesso!")
+                    success_print("Browser: Fechado com sucesso!")
 
         except Exception as e:
 
             try:
                 if display_message:
-                    alert_print(
-                        f"Erro ao fechar navegador: {str(e)}, Tentando meio mais forte!"
-                    )
+                    alert_print(f"Erro ao fechar navegador: {str(e)}, Tentando meio mais forte!")
 
                 # Último recurso - mata todos os processos do Chrome (use com cautela)
                 os.system(
                     f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1'
                 )
                 if display_message:
-                    alert_print(f"Browser: Fechado via força extrema!")
+                    alert_print("Browser: Fechado via força extrema!")
 
             except Exception as error_ultimate:
                 if display_message:
-                    error_print(
-                        f"Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!"
-                    )
+                    error_print(f"Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!")

rpa_suite/core/clock.py

@@ -1,13 +1,13 @@
 # rpa_suite/core/clock.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, success_print
-
-# imports third-party
+# imports standard
 import time
 from typing import Callable, Any
 from datetime import datetime as dt
 
+# imports internal
+from rpa_suite.functions._printer import error_print, success_print
+
 
 class Clock:
     """
@@ -111,7 +111,7 @@ class Clock:
             minutes = str(now.minute) if now.minute >= 10 else f"0{now.minute}"
             moment_now = f"{hours}:{minutes}"
 
-            if hour_to_exec == None:
+            if hour_to_exec is None:
 
                 # Process
                 while run:
@@ -140,9 +140,7 @@ class Clock:
                             run = False
                             result["tried"] = not run
                             result["success"] = True
-                            success_print(
-                                f"{fn_to_exec.__name__}: Successfully executed!"
-                            )
+                            success_print(f"{fn_to_exec.__name__}: Successfully executed!")
                             break
 
                         except Exception as e:
@@ -157,9 +155,7 @@ class Clock:
                         time.sleep(30)
                         now = dt.now()
                         hours = str(now.hour) if now.hour >= 10 else f"0{now.hour}"
-                        minutes = (
-                            str(now.minute) if now.minute >= 10 else f"0{now.minute}"
-                        )
+                        minutes = str(now.minute) if now.minute >= 10 else f"0{now.minute}"
                         moment_now = f"{hours}:{minutes}"
 
             return result
@@ -167,14 +163,10 @@ class Clock:
         except Exception as e:
 
             result["success"] = False
-            error_print(
-                f"An error occurred on function from executing: {self.exec_at_hour.__name__}. Error: {str(e)}"
-            )
+            error_print(f"An error occurred on function from executing: {self.exec_at_hour.__name__}. Error: {str(e)}")
             return result
 
-    def wait_for_exec(
-        self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs
-    ) -> dict[str, bool]:
+    def wait_for_exec(self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs) -> dict[str, bool]:
         """
         Timer function, wait for a value in ``seconds`` to execute the function of the argument.
 
@@ -226,9 +218,7 @@ class Clock:
             time.sleep(wait_time)
             fn_to_exec(*args, **kwargs)
             result["success"] = True
-            success_print(
-                f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}."
-            )
+            success_print(f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}.")
 
         except Exception as e:
             result["success"] = False
@@ -238,9 +228,7 @@ class Clock:
 
         return result
 
-    def exec_and_wait(
-        self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs
-    ) -> dict[str, bool]:
+    def exec_and_wait(self, wait_time: int, fn_to_exec: Callable[..., Any], *args, **kwargs) -> dict[str, bool]:
         """
         Timer function, executes a function and waits for the time in ``seconds``
 
@@ -292,9 +280,7 @@ class Clock:
             fn_to_exec(*args, **kwargs)
             time.sleep(wait_time)
             result["success"] = True
-            success_print(
-                f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}."
-            )
+            success_print(f"Function: {self.wait_for_exec.__name__} executed the function: {fn_to_exec.__name__}.")
 
         except Exception as e:
             result["success"] = False

rpa_suite/core/date.py

@@ -1,13 +1,13 @@
 # rpa_suite/core/date.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print
-
-# imports third-party
+# imports standard
 import datetime as dt
 from typing import Optional as Op
 from typing import Tuple
 
+# imports internal
+from rpa_suite.functions._printer import error_print
+
 
 class Date:
     """

rpa_suite/core/dir.py

@@ -1,12 +1,13 @@
 # rpa_suite/core/dir.py
 
+# imports standard
+import os
+import shutil
+from typing import Union
+
 # imports internal
 from rpa_suite.functions._printer import error_print, alert_print, success_print
 
-# imports third-party
-import os, shutil
-from typing import Union
-
 
 class Directory:
     """
@@ -51,7 +52,12 @@ class Directory:
         name_temp_dir (str): O nome do diretório temporário a ser criado. O padrão é 'temp'.
     """
 
-    def __init__(self): ...
+    def __init__(self): 
+        """
+        Função construtora da Classe que fornece utilitários para gerenciamento de:\n
+        diretórios, incluindo criação, exclusão e manipulação de diretórios.
+        """
+        ...
 
     def create_temp_dir(
         self,
@@ -130,19 +136,14 @@ class Directory:
             except PermissionError:
                 result["success"] = False
                 result["path_created"] = None
-                alert_print(
-                    f"Permission denied: Not possible to create Directory '{full_path}'."
-                )
+                alert_print(f"Permission denied: Not possible to create Directory '{full_path}'.")
 
         except Exception as e:
             result["success"] = False
             result["path_created"] = None
-            error_print(
-                f"Error capturing current path to create temporary directory! Error: {str(e)}"
-            )
+            error_print(f"Error capturing current path to create temporary directory! Error: {str(e)}")
 
-        finally:
-            return result
+        return result
 
     def delete_temp_dir(
         self,
@@ -230,16 +231,11 @@ class Directory:
             except PermissionError:
                 result["success"] = False
                 result["path_deleted"] = None
-                alert_print(
-                    f"Permission denied: Not possible to delete Directory '{full_path}'."
-                )
+                alert_print(f"Permission denied: Not possible to delete Directory '{full_path}'.")
 
         except Exception as e:
             result["success"] = False
             result["path_deleted"] = None
-            error_print(
-                f"Error capturing current path to delete temporary directory! Error: {str(e)}"
-            )
+            error_print(f"Error capturing current path to delete temporary directory! Error: {str(e)}.")
 
-        finally:
-            return result
+        return result

rpa_suite/core/email.py

@@ -1,16 +1,16 @@
 # rpa_suite/core/email.py
 
-# imports internal
-from rpa_suite.functions._printer import alert_print, error_print, success_print
-
-# imports third-party
+# imports standard
+import os
 import smtplib
-from email.mime.image import MIMEImage
 from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
 from email.mime.base import MIMEBase
 from email import encoders
 
+# imports internal
+from rpa_suite.functions._printer import alert_print, error_print, success_print
+
 
 class Email:
     """
@@ -117,7 +117,8 @@ class Email:
                 Default: '<p>test message</p>'.
 
         Returns:
-            None: This function does not explicitly return any value, but prints success or failure messages when sending the email.
+            None: This function does not explicitly return any value,\n
+            but prints success or failure messages when sending the email.
 
         pt-br
         ------
@@ -160,11 +161,7 @@ class Email:
             # Criando a mensagem
             msg = MIMEMultipart()
             msg["From"] = self.email_user
-            msg["To"] = (
-                ", ".join(self.email_to)
-                if isinstance(self.email_to, list)
-                else self.email_to
-            )
+            msg["To"] = ", ".join(self.email_to) if isinstance(self.email_to, list) else self.email_to
             msg["Subject"] = str(self.subject_title)
 
             # Corpo do e-mail
@@ -173,10 +170,6 @@ class Email:
 
             # Anexos (opcional)
             if self.attachments:
-                from email.mime.base import MIMEBase
-                from email import encoders
-                import os
-
                 for attachment_path in self.attachments:
                     try:
                         with open(attachment_path, "rb") as attachment:
@@ -190,9 +183,7 @@ class Email:
                             msg.attach(part)
 
                     except Exception as e:
-                        error_print(
-                            f"Erro ao anexar o arquivo {attachment_path}: {str(e)}"
-                        )
+                        error_print(f"Erro ao anexar o arquivo {attachment_path}: {str(e)}")
 
             try:
                 if self.auth_tls:

rpa_suite/core/file.py

@@ -1,17 +1,17 @@
 # rpa_suite/core/file.py
 
-# imports internal
-from rpa_suite.functions._printer import error_print, success_print, alert_print
-from rpa_suite.functions.__create_ss_dir import __create_ss_dir as create_ss_dir
-
-# imports external
-from colorama import Fore
-
-# imports third-party
+# imports standard
 import os, time
 from datetime import datetime
 from typing import Dict, List, Union
 
+# imports third party
+from colorama import Fore
+
+# imports internal
+from rpa_suite.functions._printer import error_print, success_print, alert_print
+from rpa_suite.functions.__create_ss_dir import __create_ss_dir as create_ss_dir
+
 
 class File:
     """
@@ -138,9 +138,7 @@ class File:
 
             if save_with_date:  # use date on file name
                 image = pyautogui.screenshot()
-                file_name = (
-                    f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
-                )
+                file_name = f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
                 path_file_screenshoted = os.path.join(path_dir, file_name)
 
                 image.save(path_file_screenshoted)
@@ -164,9 +162,7 @@ class File:
 
         except Exception as e:
 
-            error_print(
-                f"Error to execute function:{self.screen_shot.__name__}! Error: {str(e)}"
-            )
+            error_print(f"Error to execute function:{self.screen_shot.__name__}! Error: {str(e)}")
             return None
 
     def flag_create(
@@ -180,7 +176,7 @@ class File:
         """
 
         try:
-            if path_to_create == None:
+            if path_to_create is None:
                 path_origin: str = os.getcwd()
                 full_path_with_name = rf"{path_origin}/{name_file}"
             else:
@@ -206,7 +202,7 @@ class File:
 
         try:
 
-            if path_to_delete == None:
+            if path_to_delete is None:
                 path_origin: str = os.getcwd()
                 full_path_with_name = rf"{path_origin}/{name_file}"
             else:
@@ -264,21 +260,18 @@ class File:
 
         # Process
         try:
-            for dir in dir_to_count:
-                for _, _, files in os.walk(dir):
+            for directory in dir_to_count:
+                for _, _, files in os.walk(directory):
                     for file in files:
                         if type_extension == "*" or file.endswith(f".{type_extension}"):
                             result["qt"] += 1
             result["success"] = True
 
             if display_message:
-                success_print(
-                    f'Function: {self.count_files.__name__} counted {result["qt"]} files.'
-                )
+                success_print(f'Function: {self.count_files.__name__} counted {result["qt"]} files.')
 
         except Exception as e:
             result["success"] = False
             error_print(f"Error when trying to count files! Error: {str(e)}")
 
-        finally:
-            return result
+        return result