rpa-suite 1.4.2__tar.gz → 1.4.5__tar.gz

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.2
+Version: 1.4.5
 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@triasoftware.com.br
@@ -145,6 +145,14 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+- pillow
+- pyautogui
+- typing
+
+  opcionalmente para automação de navegador:
+
+  - selenium
+  - webdriver_manager
 
 [!IMPORTANT]
 No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow' e 'pyscreeze' instalados, geralmente a instalação de pyautogui já instala as demais dependências deste caso.
@@ -153,6 +161,8 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
 
+! Divisao e nomes de funções precisam ser atualizadas nesta sessão de Estrutura do módulo !
+
 - **rpa_suite**
   - **clock**
     - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
@@ -178,26 +188,26 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release
 
-Versão: **Beta 1.3.4**
+Versão: **Beta 1.4.5**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/11/2024*
+Última atualização: *10/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.2
-
-- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
-- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
-- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
-- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
-- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
-- Funções de regex e busca em textos por strings e palavras atualizadas
-- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
-- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
-- ajuste de cores no svg da logo rpa-suite
+### Notas da atualização: 1.4.5
+
+- Mudança dos submodulos para Objetos, agora Rpa_suite é um Objeto de Suite que compoe diversos sub-objetos separados pelas mesmas categorias anteriormente ja definidas
+- Reformulada a arquitetura do projeto para melhor coeção e menos subpastas e arquivos, agora a estrutura é mais simples e de melhor manutenção contendo apenas uma pasta core para o nucleo de nossos modulos, e uma pasta utils com ferramentas utilitarias que vamos adicionar varias novidades
+- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
+- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
+- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
+- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
+- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
+- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
+- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
+- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
 
 ## Mais Sobre
 

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/README.md

@@ -107,6 +107,14 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+- pillow
+- pyautogui
+- typing
+
+  opcionalmente para automação de navegador:
+
+  - selenium
+  - webdriver_manager
 
 [!IMPORTANT]
 No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow' e 'pyscreeze' instalados, geralmente a instalação de pyautogui já instala as demais dependências deste caso.
@@ -115,6 +123,8 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
 
+! Divisao e nomes de funções precisam ser atualizadas nesta sessão de Estrutura do módulo !
+
 - **rpa_suite**
   - **clock**
     - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
@@ -140,26 +150,26 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release
 
-Versão: **Beta 1.3.4**
+Versão: **Beta 1.4.5**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/11/2024*
+Última atualização: *10/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.2
-
-- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
-- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
-- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
-- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
-- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
-- Funções de regex e busca em textos por strings e palavras atualizadas
-- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
-- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
-- ajuste de cores no svg da logo rpa-suite
+### Notas da atualização: 1.4.5
+
+- Mudança dos submodulos para Objetos, agora Rpa_suite é um Objeto de Suite que compoe diversos sub-objetos separados pelas mesmas categorias anteriormente ja definidas
+- Reformulada a arquitetura do projeto para melhor coeção e menos subpastas e arquivos, agora a estrutura é mais simples e de melhor manutenção contendo apenas uma pasta core para o nucleo de nossos modulos, e uma pasta utils com ferramentas utilitarias que vamos adicionar varias novidades
+- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
+- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
+- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
+- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
+- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
+- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
+- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
+- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
 
 ## Mais Sobre
 

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite/__init__.py

@@ -26,6 +26,7 @@
         ``printer``: Functions for formatted output
         ``regex``: Operations with regular expressions
         ``validate``: Data validation functions
+        ``Browser``: Object Browser automation functions
 
     pt-br
     -----
@@ -55,6 +56,8 @@
         ``printer``: Funções para output formatado
         ``regex``: Operações com expressões regulares
         ``validate``: Funções de validação de dados
+        ``Browser``: Objeto de Automação de Navegadores
 """
 
-from .suite import Suite as rpa
+from .suite import rpa
+rpa

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite/core/__init__.py

@@ -25,3 +25,4 @@ from .log import Log
 from .print import Print
 from .regex import Regex
 from .validate import Validate
+from .browser import Browser

rpa_suite-1.4.5/rpa_suite/core/browser.py

@@ -0,0 +1,166 @@
+# default import
+import os, requests
+
+# imports
+from rpa_suite.functions._printer import error_print, alert_print, success_print
+
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from webdriver_manager.chrome import ChromeDriverManager
+from time import sleep
+
+class Browser():
+
+    """
+    WIP ...
+    """
+
+    driver: None
+    port: int = None
+    path_driver = None
+    
+    def __init__(self, port: int = 9393, close_all_chrome_on_this_port: bool = True):
+        self.port = port
+        self.path_driver = ChromeDriverManager().install()
+
+        if close_all_chrome_on_this_port: self._close_all_chrome()
+        ...
+
+    def configure_browser(self) -> None:
+        
+        try:
+            # Use the absolute path from comment
+            
+            options = Options()
+            options.add_experimental_option("debuggerAddress",
+                                         f"127.0.0.1:{str(self.port)}")
+            
+            # Additional configs  
+            options.add_argument("--start-maximized")
+            options.add_argument("--disable-notifications")
+            
+            # 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}')
+            
+            # Create driver with options and chromedriver path
+            self.driver = webdriver.Chrome(
+                #service=self.path_driver,
+                options=options,
+                keep_alive=True
+            )
+
+        except Exception as 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):
+        
+        try:
+            if close_chrome_on_this_port: self.close_browser()
+
+            # Inicia o Chrome com debugging port
+            os.system(f'start chrome.exe --remote-debugging-port={str(self.port)} --user-data-dir="C:/temp/chrome_profile"')
+
+            # Aguardar até que o Chrome esteja realmente aberto
+            while True:
+                try:
+                    # Tenta conectar ao Chrome na porta de depuração
+                    response = requests.get(f'http://127.0.0.1:{self.port}/json')
+                    if response.status_code == 200:
+                        break  # O Chrome está aberto
+                except requests.ConnectionError:
+                    sleep(1)  # Espera um segundo antes de tentar novamente
+            
+            # Inicializa o Chrome com as opções
+            self.configure_browser()
+            
+            if display_message: success_print(f'Browser: Iniciado com sucesso!')
+            
+        except Exception as e:
+            error_print(f'Erro ao iniciar navegador: {str(e)}.')
+
+
+    def find_ele(self, value, by=By.XPATH, timeout=12, display_message=True):
+        
+        try:
+            sleep(2)
+            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)}.')
+                return None
+            else: return None
+
+    # find elements (needs implementation)
+    ...
+    
+    # navigate
+    def get(self, url: str, display_message: bool = False):
+        
+        try:
+            self.driver.get(url)
+            if display_message: success_print(f'Browser: Navegando para: {url}')
+            
+        except Exception as e:
+            error_print(f'Erro ao navegar para a URL: {url}. Error: {str(e)}.')
+
+
+    def _close_all_chrome(self):
+
+        try:
+            os.system('taskkill /F /IM chrome.exe >nul 2>&1')
+        except:
+            pass
+
+
+    def close_browser(self, display_message: bool = False):
+        
+        try:
+            # Primeiro tenta fechar todas as janelas via Selenium
+            try:
+                self.driver.close()
+            except:
+                pass
+                
+            # Depois tenta encerrar a sessão
+            try:
+                self.driver.quit()
+            except:
+                pass
+            
+            # Aguarda um momento para o processo ser liberado
+            sleep(1)
+            
+            # Força o fechamento do processo específico do Chrome
+            os.system(f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" >nul 2>&1')
+            
+            # Verifica se o processo foi realmente terminado
+            check = os.system(f'tasklist /fi "imagename eq chrome.exe" /fi "commandline like *--remote-debugging-port={str(self.port)}*" >nul 2>&1')
+            
+            if check == 0:
+                # Processo ainda existe, tenta método mais agressivo
+                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!')
+                
+            else:
+                if display_message: success_print(f'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!')
+
+                # Ú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!')
+                
+            except Exception as error_ultimate:
+                if display_message: error_print(f'Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!')

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite/core/clock.py

@@ -42,7 +42,7 @@ class Clock():
 
     def __init__(self):
         ...
-
+        
     def exec_at_hour(self,
                 hour_to_exec: str | None,
                 fn_to_exec: Callable[..., Any],

rpa_suite-1.4.5/rpa_suite/core/log.py

@@ -0,0 +1,139 @@
+from typing import Optional as Op
+from rpa_suite.functions._printer import error_print, alert_print, success_print
+from loguru import logger
+import sys, os, inspect
+
+
+class Filters:
+    word_filter: Op[list[str]]
+
+    def __call__(self, record):
+        if self.word_filter and len(self.word_filter) > 0:
+            for words in self.word_filter:
+                string_words: list[str] = [str(word) for word in words]
+                for word in string_words:
+                    if word in record["message"]:
+                        record["message"] = 'Log Alterado devido a palavra Filtrada!'
+                        return True
+        return True
+
+
+class CustomHandler:
+    def __init__(self, formatter):
+        self.formatter = formatter
+
+    def write(self, message):
+        frame = inspect.currentframe().f_back.f_back
+        log_msg = self.formatter.format(message, frame)
+        sys.stderr.write(log_msg)
+
+
+class CustomFormatter:
+    def format(self, record):
+        frame = inspect.currentframe().f_back
+        full_path_filename = frame.f_code.co_filename
+        filename = os.path.basename(full_path_filename)
+        foldername = os.path.basename(os.path.dirname(full_path_filename))
+        filename = os.path.join(foldername, filename)
+        lineno = frame.f_lineno
+        format_string = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <level>{message}</level>\n"
+        log_msg = format_string.format(
+            time=record["time"],
+            level=record["level"].name,
+            filename=filename,
+            lineno=lineno,
+            message=record["message"]
+        )
+        return log_msg
+
+
+class Log:
+    filters: Filters
+    custom_handler: CustomHandler
+    custom_formatter: CustomFormatter
+    path_dir: str | None = None
+    name_file_log: str | None = None
+    full_path: str | None = None
+    file_handler = None
+
+    def __init__(self):
+        self.logger = logger
+
+    def config_logger(self, path_dir: str = 'default', name_log_dir: str = 'Logs', name_file_log: str = 'log', filter_words: list[str] = None):
+        try:
+            self.path_dir = path_dir
+            self.name_file_log = name_file_log
+
+            if self.path_dir == 'default':
+                self.path_dir = os.getcwd()
+
+            full_path = os.path.join(self.path_dir, name_log_dir)
+            self.full_path = full_path
+
+            try:
+                os.makedirs(self.full_path, exist_ok=True)
+                success_print(f"Diretório:'{self.full_path}' foi criado com sucesso.")
+            except FileExistsError:
+                alert_print(f"Diretório:'{self.full_path}' já existe.")
+            except PermissionError:
+                alert_print(f"Permissão negada: não é possível criar o diretório '{self.full_path}'.")
+
+            new_filter = None
+            if filter_words is not None:
+                new_filter = Filters()
+                new_filter.word_filter = [filter_words]
+
+            file_handler = os.path.join(self.full_path, f"{self.name_file_log}.log")
+            self.logger.remove()
+
+            log_format = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{extra[filename]}</green>:{extra[lineno]: <4} <level>{message}</level>"
+
+            formatter = CustomFormatter()
+
+            if new_filter:
+                self.logger.add(file_handler, filter=new_filter, level="DEBUG", format=log_format)
+            else:
+                self.logger.add(file_handler, level="DEBUG", format=log_format)
+
+            self.logger.add(sys.stderr, level="DEBUG", format=formatter.format)
+            self.file_handler = file_handler
+            return file_handler
+
+        except Exception as e:
+            error_print(f'Houve um erro durante a execução da função: {self.config_logger.__name__}! Error: {str(e)}.')
+            return None
+
+    def _log(self, level: str, msg: str):
+        try:
+            frame = inspect.currentframe().f_back
+            full_path_filename = frame.f_code.co_filename
+            filename = os.path.basename(full_path_filename)
+            foldername = os.path.basename(os.path.dirname(full_path_filename))
+            filename = os.path.join(foldername, filename)
+            lineno = frame.f_lineno
+            self.logger.bind(filename=filename, lineno=lineno).log(level, msg)
+        except Exception as e:
+            error_print(f'Erro durante a função de log! Error: {str(e)}')
+
+    def log_start_run_debug(self, msg_start_loggin: str) -> None:
+        try:
+            with open(self.file_handler, "a") as log_file:
+                log_file.write("\n")  # Add a blank line before logging the start message
+            self._log("DEBUG", msg_start_loggin)
+        except Exception as e:
+            error_print(f'Erro fn: {self.log_start_run_debug.__name__} ao tentar acessar o arquivo de log Confira se foi criado a configuração de log correta com a função config_logger e se a pasta e arquivo estão nos diretório desejado! Error: {str(e)}.')
+
+    def log_debug(self, msg: str) -> None:
+        self._log("DEBUG", msg)
+
+    def log_info(self, msg: str) -> None:
+        self._log("INFO", msg)
+
+    def log_warning(self, msg: str) -> None:
+        self._log("WARNING", msg)
+
+    def log_error(self, msg: str) -> None:
+        self._log("ERROR", msg)
+
+    def log_critical(self, msg: str) -> None:
+        self._log("CRITICAL", msg)

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite/suite.py

@@ -1,3 +1,5 @@
+# rpa_suite/suite.py
+
 from .core.clock import Clock
 from .core.date import Date
 from .core.email import Email
@@ -7,8 +9,12 @@ from .core.log import Log
 from .core.print import Print
 from .core.regex import Regex
 from .core.validate import Validate
+
 from colorama import Fore
 
+import subprocess
+import sys
+import hashlib
 
 # Windows bash colors
 class Colors():
@@ -122,6 +128,7 @@ class Suite():
         ``validate``: Funções de validação de dados
     """
     
+    # SUBMODULES
     clock: Clock = Clock()
     date: Date = Date()
     email: Email = Email()
@@ -131,30 +138,36 @@ class Suite():
     printer: Print = Print()
     regex: Regex = Regex()
     validate: Validate = Validate()
+
+    
+    
+    # VARIABLES INTERNAL
+    __version__ = '1.4.5'
+    __id_hash__ = 'rpa_suite'
+    
     
     def __init__(self):
-        ...
+        self.__id_hash__ = hashlib.sha256(self.__version__.encode()).hexdigest()
     
     def success_print(self,
-                        string_text: str,
-                        color=Colors.green,
-                        ending="\n") -> None:
-            """
-            Print that indicates ``SUCCESS``. Customized with the color Green \n
-
-            Return:
-            ----------
-                >>> type:None
-
-            pt-br
-            ----------
-            Print  que indica ``SUCESSO``. Personalizado com a cor Verde \n
-
-            Retorno:
-            ----------
-                >>> type:None
-            """
-            print(f'{color}{string_text}{Colors.default}', end=ending) 
+            string_text: str,
+            color=Colors.green,
+            ending="\n") -> None:
+        
+        """
+        Print that indicates ``SUCCESS``. Customized with the color Green \n
+        Return:
+        ----------
+            >>> type:None
+        pt-br
+        ----------
+        Print  que indica ``SUCESSO``. Personalizado com a cor Verde \n
+        Retorno:
+        ----------
+            >>> type:None
+        """
+        
+        print(f'{color}{string_text}{Colors.default}', end=ending) 
 
 
     def alert_print(self,
@@ -311,8 +324,7 @@ class Suite():
         Metodo responsavel por instalar todas libs para uso avançado do RPA-Suite com todas funcionalidades incluindo OCR e agente de IA
         """
 
-        import subprocess
-        import sys
+        
 
         libs = [
             'colorama',
@@ -334,3 +346,5 @@ class Suite():
 
             except subprocess.CalledProcessError:
                 self.error_print(f'Erro ao instalar biblioteca {lib}')
+
+rpa = Suite()

rpa_suite-1.4.5/rpa_suite/utils/__init__.py

@@ -0,0 +1,10 @@
+# rpa_suite/utils/__init__.py
+"""
+The utils module of the rpa-suite provides a collection of utility functions and classes that facilitate various tasks in process automation. It includes helper methods for logging, file handling, and other common operations that enhance the functionality and usability of the RPA Suite.
+
+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.
+
+"""

rpa_suite-1.4.5/rpa_suite/utils/system.py

@@ -0,0 +1,33 @@
+from rpa_suite.functions._printer import error_print, success_print
+import sys, os
+
+def set_importable_dir(display_message: bool = False):
+    """
+    Sets the directory to be importable by appending it to the system path.
+
+    Parameters:
+    ----------
+        display_message: bool - If True, displays a success message after setting the directory.
+
+    Returns:
+    ----------
+        None
+
+    pt-br
+    ----------
+    Define o diretório para ser importável, adicionando-o ao caminho do sistema.
+
+    Parâmetros:
+    ----------
+        display_message: bool - Se True, exibe uma mensagem de sucesso após definir o diretório.
+
+    Retornos:
+    ----------
+        Nenhum
+    """
+    try:
+        sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+        if display_message: success_print(f'Successfully set the directory for importation!')
+    except Exception as e:
+        error_print(f'An error occurred while executing the function: {set_importable_dir.__name__}! Error: {str(e)}.')

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.2
+Version: 1.4.5
 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@triasoftware.com.br
@@ -145,6 +145,14 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+- pillow
+- pyautogui
+- typing
+
+  opcionalmente para automação de navegador:
+
+  - selenium
+  - webdriver_manager
 
 [!IMPORTANT]
 No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow' e 'pyscreeze' instalados, geralmente a instalação de pyautogui já instala as demais dependências deste caso.
@@ -153,6 +161,8 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
 
+! Divisao e nomes de funções precisam ser atualizadas nesta sessão de Estrutura do módulo !
+
 - **rpa_suite**
   - **clock**
     - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
@@ -178,26 +188,26 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release
 
-Versão: **Beta 1.3.4**
+Versão: **Beta 1.4.5**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/11/2024*
+Última atualização: *10/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.2
-
-- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
-- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
-- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
-- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
-- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
-- Funções de regex e busca em textos por strings e palavras atualizadas
-- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
-- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
-- ajuste de cores no svg da logo rpa-suite
+### Notas da atualização: 1.4.5
+
+- Mudança dos submodulos para Objetos, agora Rpa_suite é um Objeto de Suite que compoe diversos sub-objetos separados pelas mesmas categorias anteriormente ja definidas
+- Reformulada a arquitetura do projeto para melhor coeção e menos subpastas e arquivos, agora a estrutura é mais simples e de melhor manutenção contendo apenas uma pasta core para o nucleo de nossos modulos, e uma pasta utils com ferramentas utilitarias que vamos adicionar varias novidades
+- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
+- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
+- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
+- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
+- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
+- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
+- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
+- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
 
 ## Mais Sobre
 

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/rpa_suite.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ rpa_suite.egg-info/dependency_links.txt
 rpa_suite.egg-info/requires.txt
 rpa_suite.egg-info/top_level.txt
 rpa_suite/core/__init__.py
+rpa_suite/core/browser.py
 rpa_suite/core/clock.py
 rpa_suite/core/date.py
 rpa_suite/core/dir.py
@@ -25,4 +26,6 @@ rpa_suite/functions/_functions_logger.py
 rpa_suite/functions/_logger.py
 rpa_suite/functions/_printer.py
 rpa_suite/functions/_variables.py
-rpa_suite/functions/_variables_uru.py
+rpa_suite/functions/_variables_uru.py
+rpa_suite/utils/__init__.py
+rpa_suite/utils/system.py

{rpa_suite-1.4.2 → rpa_suite-1.4.5}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='1.4.2',
+    version='1.4.5',
     packages=find_packages(),
     description='Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.',
     long_description_content_type='text/markdown',

rpa_suite-1.4.2/rpa_suite/core/log.py

@@ -1,465 +0,0 @@
-from typing import Optional as Op
-from ..functions.__create_log_dir import _create_log_dir
-from rpa_suite.functions._printer import error_print, alert_print
-from loguru import logger
-import sys, os, inspect
-
-
-class Filters():
-    """
-    Class that provides utilities for filtering log messages based on specific keywords.
-
-    This class allows you to define a list of words that, if found in a log message, will trigger a modification of that message. 
-    The modified message will indicate that it has been altered due to the presence of a filtered word.
-
-    Methods:
-        __call__: Checks if any of the specified words are present in the log message and alters the message if a match is found.
-
-    Example:
-        >>> filter = Filters()
-        >>> filter.word_filter = ['error', 'warning']
-        >>> record = {"message": "This is an error message."}
-        >>> filter(record)  # This will alter the message to 'Log Alterado devido a palavra Filtrada!'
-
-    pt-br
-    ----------
-    Classe que fornece utilitários para filtrar mensagens de log com base em palavras-chave específicas.
-
-    Esta classe permite que você defina uma lista de palavras que, se encontradas em uma mensagem de log, acionarão uma modificação dessa mensagem. 
-    A mensagem modificada indicará que foi alterada devido à presença de uma palavra filtrada.
-
-    Métodos:
-        __call__: Verifica se alguma das palavras especificadas está presente na mensagem de log e altera a mensagem se uma correspondência for encontrada.
-
-    Exemplo:
-        >>> filtro = Filters()
-        >>> filtro.word_filter = ['erro', 'aviso']
-        >>> registro = {"message": "Esta é uma mensagem de erro."}
-        >>> filtro(registro)  # Isso alterará a mensagem para 'Log Alterado devido a palavra Filtrada!'
-    """
-
-    word_filter: Op[list[str]]
-
-    def __call__(self, record):
-
-        if len(self.word_filter) > 0:
-
-            for words in self.word_filter:
-
-                string_words: list[str] = [str(word) for word in words]
-
-                for word in string_words:
-                    if word in record["message"]:
-                        record["message"] = 'Log Alterado devido a palavra Filtrada!'
-                        return True
-
-        return True
-
-
-class CustomHandler():
-    """
-    Class that provides a custom logging handler to manage log messages.
-    
-    This class allows for the formatting and writing of log messages to a specified output. 
-    It utilizes a custom formatter to structure the log messages, including details such as 
-    the time of logging, log level, and the message itself.
-
-    Methods:
-        write: Writes the formatted log message to the output.
-
-    Example:
-        >>> handler = CustomHandler(formatter=CustomFormatter())
-        >>> handler.write({"time": "12:00", "level": "INFO", "message": "This is a log message."})
-
-    pt-br
-    ----------
-    Classe que fornece um manipulador de log personalizado para gerenciar mensagens de log.
-    
-    Esta classe permite a formatação e escrita de mensagens de log em uma saída especificada. 
-    Ela utiliza um formatador personalizado para estruturar as mensagens de log, incluindo detalhes como 
-    o horário do log, nível de log e a própria mensagem.
-
-    Métodos:
-        write: Escreve a mensagem de log formatada na saída.
-
-    Exemplo:
-        >>> manipulador = CustomHandler(formatter=CustomFormatter())
-        >>> manipulador.write({"time": "12:00", "level": "INFO", "message": "Esta é uma mensagem de log."})
-    """
-    def __init__(self, formatter):
-        self.formatter = formatter
-
-    def write(self, message):
-        frame = inspect.currentframe().f_back.f_back
-        log_msg = self.formatter.format(message, frame)
-        sys.stderr.write(log_msg)
-
-
-class CustomFormatter:
-    """
-    Class that provides a custom formatter for log messages.
-    
-    This class is responsible for formatting log messages in a structured way, 
-    allowing for easy readability and understanding of log entries. It formats 
-    the log messages to include details such as the time of logging, log level, 
-    the filename, line number, and the actual log message.
-
-    Methods:
-        format: Formats the log message based on the provided record.
-
-    Example:
-        >>> formatter = CustomFormatter()
-        >>> log_message = formatter.format({
-        ...     "time": "12:00",
-        ...     "level": "INFO",
-        ...     "message": "This is a log message."
-        ... })
-        >>> print(log_message)
-
-    pt-br
-    ----------
-    Classe que fornece um formatador personalizado para mensagens de log.
-    
-    Esta classe é responsável por formatar mensagens de log de maneira estruturada, 
-    permitindo fácil leitura e compreensão das entradas de log. Ela formata 
-    as mensagens de log para incluir detalhes como o horário do log, nível de log, 
-    o nome do arquivo, número da linha e a mensagem de log real.
-
-    Métodos:
-        format: Formata a mensagem de log com base no registro fornecido.
-
-    Exemplo:
-        >>> formatador = CustomFormatter()
-        >>> mensagem_log = formatador.format({
-        ...     "time": "12:00",
-        ...     "level": "INFO",
-        ...     "message": "Esta é uma mensagem de log."
-        ... })
-        >>> print(mensagem_log)
-    """
-    def format(self, record):
-
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Formate a mensagem de log TERMINAL
-        format_string = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <level>{message}</level>\n"
-
-        log_msg = format_string.format(
-            time=record["time"],
-            level=record["level"].name,
-            filename=filename,
-            lineno=lineno,
-            message=record["message"]
-        )
-        return log_msg
-
-
-
-
-class Log():
-
-    """
-    Class that provides utilities for logging messages in a structured manner.
-    
-    This class is responsible for managing log entries, allowing for easy tracking 
-    and debugging of application behavior. It supports various logging levels and 
-    can be configured to log messages to different outputs, such as files or the console.
-
-    Methods:
-        config_logger: Configures the logger with specified parameters.
-        
-    Example:
-        >>> logger = Log()
-        >>> logger.config_logger(path_dir='logs', name_log_dir='my_logs', name_file_log='app_log')
-    
-    pt-br
-    ----------
-    Classe que fornece utilitários para registrar mensagens de forma estruturada.
-    
-    Esta classe é responsável por gerenciar entradas de log, permitindo fácil rastreamento 
-    e depuração do comportamento da aplicação. Suporta vários níveis de log e 
-    pode ser configurada para registrar mensagens em diferentes saídas, como arquivos ou console.
-
-    Métodos:
-        config_logger: Configura o logger com parâmetros especificados.
-        
-    Exemplo:
-        >>> logger = Log()
-        >>> logger.config_logger(path_dir='logs', name_log_dir='meus_logs', name_file_log='log_app')
-    """
-    
-    filters: Filters
-    custom_handler: CustomHandler
-    custom_formatter: CustomFormatter
-    
-    
-    def __init__(self):
-        ...
-    
-    def config_logger(self,
-                        path_dir:str = None, 
-                        name_log_dir:str = None, 
-                        name_file_log: str = 'log', 
-                        use_default_path_and_name: bool = True, 
-                        filter_words: list[str] = None):
-
-        """
-        Função responsável por criar um objeto logger com fileHandler e streamHandler
-        
-        pt-br
-        ----------
-        Function responsible for create a object logger with fileHandler and streamHandler
-        """
-
-        try:
-
-            if not use_default_path_and_name:
-                result_tryed: dict = _create_log_dir(path_dir, name_log_dir)
-                path_dir = result_tryed['path_created']
-            else:
-                if path_dir == None and name_log_dir == None:
-                    result_tryed: dict = _create_log_dir()
-                    path_dir = result_tryed['path_created']
-
-
-            # ATRIBUIÇÕES
-            new_filter: Op[Filters] = None
-            if filter_words is not None:
-                new_filter: Filters = Filters()
-                new_filter.word_filter = [filter_words]
-
-
-            # configuração de objetos logger
-            file_handler = fr'{path_dir}\{name_file_log}.log'
-            logger.remove()
-
-            # Formate a mensagem de log FILE
-            log_format: str = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{extra[filename]}</green>:{extra[lineno]: <4} <level>{message}</level>"
-
-
-            formatter = CustomFormatter()
-            if new_filter is not None:
-                logger.add(file_handler, filter=new_filter, level="DEBUG", format=log_format)
-            else:
-                logger.add(file_handler, level="DEBUG", format=log_format)
-
-            # Adicione sys.stderr como um manipulador
-            logger.add(sys.stderr, level="DEBUG", format=formatter.format)
-
-            return file_handler
-
-        except Exception as e:
-
-            error_print(f'Houve um erro durante a execução da função: {self.config_logger.__name__}! Error: {str(e)}.')
-            return None
-    
-
-
-    def log_start_run_debug(self,
-                            msg_start_loggin: str) -> None: # represent start application
-
-        """
-        Function responsable to generate ``start run log level debug``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        ----------
-        Função responsável por gerar o nível de log ``início execução nível debug``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        file_h: False
-
-        try:
-            file_h = self.config_logger()
-
-        except Exception as e:
-
-            error_print(f'Para usar o log_start_run_debug é necessario instanciar file_handler usando o arquivo "logger_uru" em algum arquivo de configuração do seu projeto primeiramente! Error: {str(e)}')
-
-        try:
-            try:
-                if file_h:
-                    with open(file_h, 'a') as f:
-                        f.write('\n')
-
-            except Exception as e:
-                alert_print(f'Não foi possivel gerar break_row para log inicial!')
-
-            # logger.debug(f'{msg_start_loggin}')
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).debug(f'{msg_start_loggin}')
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_start_run_debug.__name__}! Error: {str(e)}')
-
-
-    def log_debug(
-                self,
-                msg: str) -> None:
-
-        """
-        Function responsable to generate log level ``debug``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        -----
-        Função responsável por gerar o nível de log ``debug``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        try:
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).debug(msg)
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_debug.__name__}! Error: {str(e)}')
-
-    def log_info(
-                self,
-                msg: str) -> None:
-
-        """
-        Function responsable to generate log level ``info``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        -----
-        Função responsável por gerar o nível de log ``info``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        try:
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).info(msg)
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_info.__name__}! Error: {str(e)}')
-
-    def log_warning(self, 
-                    msg: str) -> None:
-
-        """
-        Function responsable to generate log level ``warning``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        -----
-        Função responsável por gerar o nível de log ``aviso``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        try:
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).warning(msg)
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_warning.__name__}! Error: {str(e)}')
-
-
-    def log_error(
-                self, 
-                msg: str) -> None:
-
-        """
-        Function responsable to generate log level ``error``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        -----
-        Função responsável por gerar o nível de log ``erro``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        try:
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).error(msg)
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_error.__name__}! Error: {str(e)}')
-
-
-    def log_critical(self, 
-                    msg: str) -> None:
-
-        """
-        Function responsable to generate log level ``critical``, in file and print on terminal the same log captured on this call.
-        
-        pt-br
-        ----------
-        
-        Função responsável por gerar o nível de log ``crítico``, em arquivo e imprimir no terminal o mesmo log capturado nesta chamada.
-        """
-
-        try:
-            frame = inspect.currentframe().f_back
-            full_path_filename = frame.f_code.co_filename
-
-            # Obtenha o nome do arquivo e o nome da pasta
-            filename = os.path.basename(full_path_filename)
-            foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-            # Combine o nome da pasta e o nome do arquivo
-            filename = os.path.join(foldername, filename)
-            lineno = frame.f_lineno
-
-            # Vincule o nome do arquivo e a linha à mensagem de log
-            logger.bind(filename=filename, lineno=lineno).critical(msg)
-
-        except Exception as e:
-            error_print(f'Erro durante a função: {self.log_critical.__name__}! Error: {str(e)}')
-