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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.5
+Version: 1.4.6
 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
@@ -25,6 +25,7 @@ Requires-Dist: loguru
 Requires-Dist: typing
 Requires-Dist: pillow
 Requires-Dist: pyautogui
+Requires-Dist: requests
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -54,13 +55,16 @@ Dynamic: summary
 
 ## Sumário do conteudo
 
+- [O que é?](#o-que-é)
+- [Sumário do conteudo](#sumário-do-conteudo)
 - [Destaque](#destaque)
 - [Objetivo](#objetivo)
 - [Instalação](#instalação)
 - [Exemplo](#exemplo)
 - [Dependências](#dependências)
 - [Estrutura do módulo](#estrutura-do-módulo)
-- [Versão do projeto](#versão-do-projeto)
+- [Release](#release)
+  - [Notas da atualização: 1.4.6](#notas-da-atualização-146)
 - [Mais Sobre](#mais-sobre)
 
 ## Destaque
@@ -94,17 +98,17 @@ ou no conda:
 conda install -c conda-forge rpa-suite
 ```
 
-Após instalação basta fazer a importação do modulo e instanciar o Objeto ``suite``:
+Após instalação basta fazer a importação do modulo rpa que ja tera um objeto instanciado de ``suite``:
 
 ```python
-from rpa_suite import suite as rpa
+from rpa_suite import rpa
 ```
 
 Feito isso já estará pronto para o uso:
 
 ```python
 # function send mail by SMTP 
-rpa.send_mail(...)
+rpa.email.send_mail(...)
 ```
 
 > [!NOTE]
@@ -121,21 +125,24 @@ rpa.send_mail(...)
 > Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
 
 ```python
->>> python -m pip uninstall loguru mail_validator colorama
+>>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
 ```
 
 ## Exemplo
 
 Do módulo principal, importe a suite. Ela retorna uma instância do Objeto de classe Rpa_suite, onde possui variáveis apontando para todas funções dos submódulos:
 
-    from rpa_suite import suite as rpa
+    from rpa_suite import rpa
 
-    # Usando a função de envio de email por SMTP default
-    rpa.send_email(my_email, my_pass, mail_to, subject, message_body)
+    # Exemplo com função de execução em horario especifico
+    rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
 
-    # Usando submódulo clock para aguardar 30 (seg) e então executar uma função
+    # Usando submódulo clock para aguardar 30(seg) para executar minha função
     time = 30
-    rpa.wait_for_exec(time, my_function, param1, param2)
+    rpa.clock.wait_for_exec(time, my_function, param1, param2)
+
+    # Usando submódulo email para envio de email por smtp comum
+    rpa.email.send_smtp(...)
 
 ## Dependências
 
@@ -159,44 +166,61 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 ## Estrutura do módulo
 
-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 !
+O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a categoria:
 
 - **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
-    - **exec_at** - Função capaz de executar a função do argumento no horario especificado "xx:yy" parecido com scheduler, porem com a vantagem de ter o horario como variavel dentro do escopo de código podendo gerar variações pela propria natureza da aplicação
+    - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
+    - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
+    - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
   - **date**
-    - **date** - Funções capazes de extrair dia/mes/ano e hora/min/seg, facilitando a necessidade de formatar o resultado de datetime, a função ja devolve os valores em trio formatados em string
+    - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
+    - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
   - **email**
-    - **sender_smtp** - Funções para envio de email SMPT com configuração simples já default porem personalizavel
+    - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
   - **file**
-    - **counter** - Funções para contagem de arquivos
-    - **temp_dir** - Funções para diretórios temporários
-    - **screen_shot** -  Função para criar diretório e arquivo de print com nome do diretório, arquivo e delay personalizáveis
-    - **file_flag** -  Funções para criar e deletar arquivo utilizado como flag de execução, tendo path e nome do arquivo já automatico porem personalizavel para se adequar ao seu projeto
+    - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
+    - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
+    - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
+    - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
+  - **directory**
+    - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
+    - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
   - **log**
-    - **logger_uru** - Instanciador de stream e handlefile que cria na pasta raiz do arquivo chamador pasta de log e seta o stream para as funções de log
-    - **functions_logger_uru** - Funções de log parecida com os prints personalizados, setadas e personalizadas para todos log levels usado pelo ´logger_uru´, já escreve no arquivo setado além de gerar o print no terminal
-    - **printer** - Funções de print personalizados (alerta, erro, sucesso, informativo)
+    - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
+    - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
+    - **log_debug** - Função para registrar logs em nível de depuração.
+    - **log_info** - Função para registrar logs em nível informativo.
+    - **log_warning** - Função para registrar logs em nível de aviso.
+    - **log_error** - Função para registrar logs em nível de erro.
+    - **log_critical** - Função para registrar logs em nível crítico.
+  - **printer**
+    - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
+    - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
+    - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
+    - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
   - **regex**
-    - **pattern_in_text** - Função para otimizar o uso mais comum de regex buscando padrões em um texto
+    - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
   - **validate**
-    - **mail_validator** - Função para validar lista de emails, devolvendo a lista com emails validos a partir da lista original
-    - **string_validator** - Função que valida presença de letras, palavras, e textos e possibilita contar as ocorrencias em uma string
+    - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
+    - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
+  - **browser**
+    - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
+    - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
+    - **get** - Função para navegar para URLs específicas.
+    - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
 
 ## Release
 
-Versão: **Beta 1.4.5**
+Versão: **Beta 1.4.6**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/04/2025*
+Última atualização: *12/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.5
+### Notas da atualização: 1.4.6
 
 - 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
@@ -212,13 +236,9 @@ Status: Em desenvolvimento.
 ## Mais Sobre
 
 Para mais informações, visite nosso projeto no Github ou PyPi:
-`<br>`
-`<a href='https://github.com/CamiloCCarvalho/rpa_suite' target='_blank'>`
-    Ver no GitHub.
-`</a>`
-`<br>`
-`<a href='https://pypi.org/project/rpa-suite/' target='_blank'>`
-    Ver projeto publicado no PyPI.
-`</a>`
+
+[Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
+
+[Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
 
 <hr>

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

@@ -16,13 +16,16 @@
 
 ## Sumário do conteudo
 
+- [O que é?](#o-que-é)
+- [Sumário do conteudo](#sumário-do-conteudo)
 - [Destaque](#destaque)
 - [Objetivo](#objetivo)
 - [Instalação](#instalação)
 - [Exemplo](#exemplo)
 - [Dependências](#dependências)
 - [Estrutura do módulo](#estrutura-do-módulo)
-- [Versão do projeto](#versão-do-projeto)
+- [Release](#release)
+  - [Notas da atualização: 1.4.6](#notas-da-atualização-146)
 - [Mais Sobre](#mais-sobre)
 
 ## Destaque
@@ -56,17 +59,17 @@ ou no conda:
 conda install -c conda-forge rpa-suite
 ```
 
-Após instalação basta fazer a importação do modulo e instanciar o Objeto ``suite``:
+Após instalação basta fazer a importação do modulo rpa que ja tera um objeto instanciado de ``suite``:
 
 ```python
-from rpa_suite import suite as rpa
+from rpa_suite import rpa
 ```
 
 Feito isso já estará pronto para o uso:
 
 ```python
 # function send mail by SMTP 
-rpa.send_mail(...)
+rpa.email.send_mail(...)
 ```
 
 > [!NOTE]
@@ -83,21 +86,24 @@ rpa.send_mail(...)
 > Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
 
 ```python
->>> python -m pip uninstall loguru mail_validator colorama
+>>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
 ```
 
 ## Exemplo
 
 Do módulo principal, importe a suite. Ela retorna uma instância do Objeto de classe Rpa_suite, onde possui variáveis apontando para todas funções dos submódulos:
 
-    from rpa_suite import suite as rpa
+    from rpa_suite import rpa
 
-    # Usando a função de envio de email por SMTP default
-    rpa.send_email(my_email, my_pass, mail_to, subject, message_body)
+    # Exemplo com função de execução em horario especifico
+    rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
 
-    # Usando submódulo clock para aguardar 30 (seg) e então executar uma função
+    # Usando submódulo clock para aguardar 30(seg) para executar minha função
     time = 30
-    rpa.wait_for_exec(time, my_function, param1, param2)
+    rpa.clock.wait_for_exec(time, my_function, param1, param2)
+
+    # Usando submódulo email para envio de email por smtp comum
+    rpa.email.send_smtp(...)
 
 ## Dependências
 
@@ -121,44 +127,61 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 ## Estrutura do módulo
 
-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 !
+O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a categoria:
 
 - **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
-    - **exec_at** - Função capaz de executar a função do argumento no horario especificado "xx:yy" parecido com scheduler, porem com a vantagem de ter o horario como variavel dentro do escopo de código podendo gerar variações pela propria natureza da aplicação
+    - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
+    - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
+    - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
   - **date**
-    - **date** - Funções capazes de extrair dia/mes/ano e hora/min/seg, facilitando a necessidade de formatar o resultado de datetime, a função ja devolve os valores em trio formatados em string
+    - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
+    - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
   - **email**
-    - **sender_smtp** - Funções para envio de email SMPT com configuração simples já default porem personalizavel
+    - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
   - **file**
-    - **counter** - Funções para contagem de arquivos
-    - **temp_dir** - Funções para diretórios temporários
-    - **screen_shot** -  Função para criar diretório e arquivo de print com nome do diretório, arquivo e delay personalizáveis
-    - **file_flag** -  Funções para criar e deletar arquivo utilizado como flag de execução, tendo path e nome do arquivo já automatico porem personalizavel para se adequar ao seu projeto
+    - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
+    - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
+    - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
+    - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
+  - **directory**
+    - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
+    - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
   - **log**
-    - **logger_uru** - Instanciador de stream e handlefile que cria na pasta raiz do arquivo chamador pasta de log e seta o stream para as funções de log
-    - **functions_logger_uru** - Funções de log parecida com os prints personalizados, setadas e personalizadas para todos log levels usado pelo ´logger_uru´, já escreve no arquivo setado além de gerar o print no terminal
-    - **printer** - Funções de print personalizados (alerta, erro, sucesso, informativo)
+    - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
+    - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
+    - **log_debug** - Função para registrar logs em nível de depuração.
+    - **log_info** - Função para registrar logs em nível informativo.
+    - **log_warning** - Função para registrar logs em nível de aviso.
+    - **log_error** - Função para registrar logs em nível de erro.
+    - **log_critical** - Função para registrar logs em nível crítico.
+  - **printer**
+    - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
+    - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
+    - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
+    - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
   - **regex**
-    - **pattern_in_text** - Função para otimizar o uso mais comum de regex buscando padrões em um texto
+    - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
   - **validate**
-    - **mail_validator** - Função para validar lista de emails, devolvendo a lista com emails validos a partir da lista original
-    - **string_validator** - Função que valida presença de letras, palavras, e textos e possibilita contar as ocorrencias em uma string
+    - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
+    - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
+  - **browser**
+    - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
+    - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
+    - **get** - Função para navegar para URLs específicas.
+    - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
 
 ## Release
 
-Versão: **Beta 1.4.5**
+Versão: **Beta 1.4.6**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/04/2025*
+Última atualização: *12/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.5
+### Notas da atualização: 1.4.6
 
 - 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
@@ -174,13 +197,9 @@ Status: Em desenvolvimento.
 ## Mais Sobre
 
 Para mais informações, visite nosso projeto no Github ou PyPi:
-`<br>`
-`<a href='https://github.com/CamiloCCarvalho/rpa_suite' target='_blank'>`
-    Ver no GitHub.
-`</a>`
-`<br>`
-`<a href='https://pypi.org/project/rpa-suite/' target='_blank'>`
-    Ver projeto publicado no PyPI.
-`</a>`
+
+[Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
+
+[Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
 
 <hr>

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

@@ -26,7 +26,7 @@
         ``printer``: Functions for formatted output
         ``regex``: Operations with regular expressions
         ``validate``: Data validation functions
-        ``Browser``: Object Browser automation functions
+        ``Browser``: Object Browser automation functions (neeeds Selenium and Webdriver_Manager)
 
     pt-br
     -----
@@ -56,7 +56,7 @@
         ``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
+        ``Browser``: Objeto de Automação de Navegadores (necessario Selenium e Webdriver_Manager)
 """
 
 from .suite import rpa

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

@@ -3,9 +3,12 @@
 """
 The Core module is where we can import all Sub-Objects used by the rpa_suite module separately, categorized by their respective classes based on functionality. However, we can also use them through the main rpa object using the following syntax:
 >>> from rpa_suite import rpa
->>> rpa.clock.wait_for_exec()
+>>> rpa.clock.wait_for_exec(foo)
 >>> rpa.file.screen_shot() ...
-among others.
+or
+>>> from rpa_suite.core.clock import Clock
+>>> clock = Clock()
+>>> clock.wait_for_exec()
 
 pt-br
 ----------
@@ -13,9 +16,13 @@ O módulo Core é de onde podemos importar todos os Sub-Objetos usados pelo mód
 >>> from rpa_suite import rpa
 >>> rpa.clock.wait_for_exec()
 >>> rpa.file.screen_shot() ...
-entre outros.
+ou
+>>> from rpa_suite.core.clock import Clock
+>>> clock = Clock()
+>>> clock.wait_for_exec(foo)
 
 """
+
 from .clock import Clock
 from .date import Date
 from .dir import Directory
@@ -25,4 +32,13 @@ from .log import Log
 from .print import Print
 from .regex import Regex
 from .validate import Validate
-from .browser import Browser
+
+
+
+# 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.
+import importlib.util
+
+# from .browser import Browser
+if importlib.util.find_spec("selenium") and importlib.util.find_spec("webdriver_manager"):
+    from .browser import Browser

rpa_suite-1.4.6/rpa_suite/core/browser.py

@@ -0,0 +1,299 @@
+# 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():
+    
+    """
+    Browser Object for Automation (Work in Progress)
+    This class provides an interface for automating browser interactions using 
+    Google Chrome with a debugging port. It includes methods for starting, 
+    configuring, navigating, and interacting with the browser. The implementation 
+    is still under development and may require further enhancements.
+    
+    Attributes:
+        driver: The WebDriver instance used to control the browser.
+        port (int): The debugging port used to connect to the browser. Default is 9393.
+        path_driver (str): The path to the ChromeDriver executable.
+        
+    Methods:
+        __init__(port: int = 9393, close_all_chrome_on_this_port: bool = False):
+            Initializes the Browser object with the specified debugging port and 
+            optionally closes all Chrome instances running on the same port.
+        configure_browser() -> None:
+            Configures the browser with debugging options and initializes the WebDriver.
+        start_browser(close_chrome_on_this_port: bool = True, display_message: bool = False):
+            Starts the Chrome browser with the specified debugging port and initializes 
+            the WebDriver.
+        find_ele(value, by=By.XPATH, timeout=12, display_message=True):
+            Finds a single element on the page using the specified locator strategy.
+        get(url: str, display_message: bool = False):
+            Navigates the browser to the specified URL.
+        _close_all_chrome():
+            Closes all Chrome processes forcefully.
+        close_browser(display_message: bool = False):
+            Closes the browser instance and terminates the associated Chrome processes.
+    
+    pt-br
+    ----------
+    Objeto Browser para Automação (Em Desenvolvimento)
+    Esta classe fornece uma interface para automação de interações com o navegador 
+    Google Chrome utilizando uma porta de depuração. Inclui métodos para iniciar, 
+    configurar, navegar e interagir com o navegador. A implementação ainda está em 
+    desenvolvimento e pode requerer melhorias adicionais.
+    
+    Atributos:
+        driver: A instância do WebDriver usada para controlar o navegador.
+        port (int): A porta de depuração usada para conectar ao navegador. O padrão é 9393.
+        path_driver (str): O caminho para o executável do ChromeDriver.
+        
+    Métodos:
+        __init__(port: int = 9393, close_all_chrome_on_this_port: bool = False):
+            Inicializa o objeto Browser com a porta de depuração especificada e, 
+            opcionalmente, fecha todas as instâncias do Chrome que estão sendo executadas 
+            na mesma porta.
+        configure_browser() -> None:
+            Configura o navegador com opções de depuração e inicializa o WebDriver.
+        start_browser(close_chrome_on_this_port: bool = True, display_message: bool = False):
+            Inicia o navegador Chrome com a porta de depuração especificada e inicializa 
+            o WebDriver.
+        find_ele(value, by=By.XPATH, timeout=12, display_message=True):
+            Localiza um único elemento na página usando a estratégia de localização especificada.
+        get(url: str, display_message: bool = False):
+            Navega o navegador para a URL especificada.
+        _close_all_chrome():
+            Fecha todos os processos do Chrome de forma forçada.
+        close_browser(display_message: bool = False):
+            Fecha a instância do navegador e termina os processos associados do Chrome.
+    """
+
+    driver: None
+    port: int = None
+    path_driver = None
+    
+    def __init__(self, port: int = 9393, close_all_chrome_on_this_port: bool = False):
+        self.port = port
+        self.path_driver = ChromeDriverManager().install()
+
+        if close_all_chrome_on_this_port: self._close_all_chrome()
+        ...
+
+    def configure_browser(self) -> None:
+        """
+        Configures the browser instance with specified options and initializes the WebDriver.
+        This method sets up the browser with debugging options, maximized window, and disables notifications.
+        It also verifies the existence of the ChromeDriver executable at the specified path before creating
+        the WebDriver instance.
+        Raises:
+            FileNotFoundError: If the specified path to the ChromeDriver executable does not exist.
+            Exception: For any other errors encountered during the browser configuration process.
+        """
+        
+        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):
+        """
+        Starts a Chrome browser instance with remote debugging enabled.
+        Args:
+            close_chrome_on_this_port (bool): If True, closes any existing Chrome instance using the specified debugging port before starting a new one. Defaults to True.
+            display_message (bool): If True, displays a success message upon successfully starting the browser. Defaults to False.
+        Raises:
+            Exception: If an error occurs while starting the browser or connecting to the debugging port.
+        Behavior:
+            - Closes any existing Chrome instance on the specified debugging port if `close_chrome_on_this_port` is True.
+            - Launches Chrome with the specified debugging port and user data directory.
+            - Waits until Chrome is fully initialized and accessible via the debugging port.
+            - Configures the browser instance using the `configure_browser` method.
+            - Optionally displays a success message if `display_message` is True.
+        """
+        
+        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):
+        """
+        Locate and return a web element on the page using the specified locator strategy.
+        Args:
+            value (str): The locator value to identify the web element.
+            by (selenium.webdriver.common.by.By, optional): The locator strategy to use. 
+                Defaults to By.XPATH.
+            timeout (int, optional): The maximum time to wait for the element to appear, in seconds. 
+                Defaults to 12.
+            display_message (bool, optional): Whether to display an error message if the element 
+                is not found. Defaults to True.
+        Returns:
+            selenium.webdriver.remote.webelement.WebElement: The located web element if found.
+            None: If the element is not found or an exception occurs.
+        Raises:
+            Exception: Propagates any exception encountered during the element search if 
+                `display_message` is set to False.
+        """
+        
+        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):
+        """
+        Navigates the browser to the specified URL.
+        Args:
+            url (str): The URL to navigate to.
+            display_message (bool, optional): If True, displays a success message upon navigation. Defaults to False.
+        Raises:
+            Exception: If an error occurs while navigating to the URL, it logs the error message.
+        """
+        
+        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_browsers(self):
+        """
+        Forcefully closes all instances of Google Chrome running on the system.
+        This method uses the `taskkill` command to terminate all processes with the name
+        "chrome.exe". Any errors during the execution of the command are silently ignored.
+        Note:
+            This method is specific to Windows operating systems and will not work on other platforms.
+        """
+
+        try:
+            os.system('taskkill /F /IM chrome.exe >nul 2>&1')
+        except:
+            pass
+
+
+    def close_browser(self, display_message: bool = False):
+        """
+        Fecha o navegador controlado pelo Selenium e encerra os processos relacionados ao Chrome.
+        Este método tenta fechar o navegador de forma ordenada utilizando os métodos `close` e `quit` do Selenium.
+        Caso esses métodos falhem, ele força o encerramento do processo do Chrome associado à porta de depuração remota.
+        Em último caso, pode encerrar todos os processos do Chrome relacionados à porta especificada.
+        Args:
+            display_message (bool): Indica se mensagens de status devem ser exibidas durante o processo de fechamento.
+        Comportamento:
+            - Tenta fechar o navegador utilizando `self.driver.close()` e `self.driver.quit()`.
+            - Aguarda um momento para liberar o processo.
+            - Força o encerramento do processo do Chrome associado à porta de depuração remota.
+            - Verifica se o processo foi encerrado e tenta métodos mais agressivos, se necessário.
+            - Em caso de falha crítica, tenta encerrar todos os processos do Chrome relacionados à porta especificada.
+        Exceções:
+            - Captura e exibe mensagens de erro caso ocorra falha ao fechar o navegador.
+        Observação:
+            Use com cautela, especialmente o encerramento extremo, pois pode afetar outros processos do Chrome em execução.
+        """
+        
+        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.5 → rpa_suite-1.4.6}/rpa_suite/core/file.py

@@ -170,7 +170,7 @@ class File():
                 full_path_with_name = fr'{path_to_create}/{name_file}'
                 
             with open(full_path_with_name, 'w', encoding='utf-8') as file:
-                file.write('[T-BOT Crédit Simulation] running in realtime, waiting finish to new execution')
+                file.write('[RPA Suite] - Running Flag File')
             if display_message: success_print("Flag file created.")
 
         except Exception as e:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.5
+Version: 1.4.6
 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
@@ -25,6 +25,7 @@ Requires-Dist: loguru
 Requires-Dist: typing
 Requires-Dist: pillow
 Requires-Dist: pyautogui
+Requires-Dist: requests
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -54,13 +55,16 @@ Dynamic: summary
 
 ## Sumário do conteudo
 
+- [O que é?](#o-que-é)
+- [Sumário do conteudo](#sumário-do-conteudo)
 - [Destaque](#destaque)
 - [Objetivo](#objetivo)
 - [Instalação](#instalação)
 - [Exemplo](#exemplo)
 - [Dependências](#dependências)
 - [Estrutura do módulo](#estrutura-do-módulo)
-- [Versão do projeto](#versão-do-projeto)
+- [Release](#release)
+  - [Notas da atualização: 1.4.6](#notas-da-atualização-146)
 - [Mais Sobre](#mais-sobre)
 
 ## Destaque
@@ -94,17 +98,17 @@ ou no conda:
 conda install -c conda-forge rpa-suite
 ```
 
-Após instalação basta fazer a importação do modulo e instanciar o Objeto ``suite``:
+Após instalação basta fazer a importação do modulo rpa que ja tera um objeto instanciado de ``suite``:
 
 ```python
-from rpa_suite import suite as rpa
+from rpa_suite import rpa
 ```
 
 Feito isso já estará pronto para o uso:
 
 ```python
 # function send mail by SMTP 
-rpa.send_mail(...)
+rpa.email.send_mail(...)
 ```
 
 > [!NOTE]
@@ -121,21 +125,24 @@ rpa.send_mail(...)
 > Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
 
 ```python
->>> python -m pip uninstall loguru mail_validator colorama
+>>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
 ```
 
 ## Exemplo
 
 Do módulo principal, importe a suite. Ela retorna uma instância do Objeto de classe Rpa_suite, onde possui variáveis apontando para todas funções dos submódulos:
 
-    from rpa_suite import suite as rpa
+    from rpa_suite import rpa
 
-    # Usando a função de envio de email por SMTP default
-    rpa.send_email(my_email, my_pass, mail_to, subject, message_body)
+    # Exemplo com função de execução em horario especifico
+    rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
 
-    # Usando submódulo clock para aguardar 30 (seg) e então executar uma função
+    # Usando submódulo clock para aguardar 30(seg) para executar minha função
     time = 30
-    rpa.wait_for_exec(time, my_function, param1, param2)
+    rpa.clock.wait_for_exec(time, my_function, param1, param2)
+
+    # Usando submódulo email para envio de email por smtp comum
+    rpa.email.send_smtp(...)
 
 ## Dependências
 
@@ -159,44 +166,61 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 ## Estrutura do módulo
 
-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 !
+O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a categoria:
 
 - **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
-    - **exec_at** - Função capaz de executar a função do argumento no horario especificado "xx:yy" parecido com scheduler, porem com a vantagem de ter o horario como variavel dentro do escopo de código podendo gerar variações pela propria natureza da aplicação
+    - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
+    - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
+    - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
   - **date**
-    - **date** - Funções capazes de extrair dia/mes/ano e hora/min/seg, facilitando a necessidade de formatar o resultado de datetime, a função ja devolve os valores em trio formatados em string
+    - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
+    - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
   - **email**
-    - **sender_smtp** - Funções para envio de email SMPT com configuração simples já default porem personalizavel
+    - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
   - **file**
-    - **counter** - Funções para contagem de arquivos
-    - **temp_dir** - Funções para diretórios temporários
-    - **screen_shot** -  Função para criar diretório e arquivo de print com nome do diretório, arquivo e delay personalizáveis
-    - **file_flag** -  Funções para criar e deletar arquivo utilizado como flag de execução, tendo path e nome do arquivo já automatico porem personalizavel para se adequar ao seu projeto
+    - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
+    - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
+    - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
+    - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
+  - **directory**
+    - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
+    - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
   - **log**
-    - **logger_uru** - Instanciador de stream e handlefile que cria na pasta raiz do arquivo chamador pasta de log e seta o stream para as funções de log
-    - **functions_logger_uru** - Funções de log parecida com os prints personalizados, setadas e personalizadas para todos log levels usado pelo ´logger_uru´, já escreve no arquivo setado além de gerar o print no terminal
-    - **printer** - Funções de print personalizados (alerta, erro, sucesso, informativo)
+    - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
+    - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
+    - **log_debug** - Função para registrar logs em nível de depuração.
+    - **log_info** - Função para registrar logs em nível informativo.
+    - **log_warning** - Função para registrar logs em nível de aviso.
+    - **log_error** - Função para registrar logs em nível de erro.
+    - **log_critical** - Função para registrar logs em nível crítico.
+  - **printer**
+    - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
+    - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
+    - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
+    - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
   - **regex**
-    - **pattern_in_text** - Função para otimizar o uso mais comum de regex buscando padrões em um texto
+    - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
   - **validate**
-    - **mail_validator** - Função para validar lista de emails, devolvendo a lista com emails validos a partir da lista original
-    - **string_validator** - Função que valida presença de letras, palavras, e textos e possibilita contar as ocorrencias em uma string
+    - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
+    - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
+  - **browser**
+    - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
+    - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
+    - **get** - Função para navegar para URLs específicas.
+    - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
 
 ## Release
 
-Versão: **Beta 1.4.5**
+Versão: **Beta 1.4.6**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/04/2025*
+Última atualização: *12/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.5
+### Notas da atualização: 1.4.6
 
 - 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
@@ -212,13 +236,9 @@ Status: Em desenvolvimento.
 ## Mais Sobre
 
 Para mais informações, visite nosso projeto no Github ou PyPi:
-`<br>`
-`<a href='https://github.com/CamiloCCarvalho/rpa_suite' target='_blank'>`
-    Ver no GitHub.
-`</a>`
-`<br>`
-`<a href='https://pypi.org/project/rpa-suite/' target='_blank'>`
-    Ver projeto publicado no PyPI.
-`</a>`
+
+[Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
+
+[Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
 
 <hr>

{rpa_suite-1.4.5 → rpa_suite-1.4.6}/rpa_suite.egg-info/requires.txt

@@ -5,3 +5,4 @@ loguru
 typing
 pillow
 pyautogui
+requests

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

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='1.4.5',
+    version='1.4.6',
     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',
@@ -23,5 +23,5 @@ setup(
         'Topic :: Software Development :: Libraries :: Python Modules'
     ],
     keywords='basic-tools, email-tools, email-validation, file-tools, simple-functions, rpa-tools, rpa-functions, Tools, Rpa, Automation, RPA, Automação, Python, Ferramentas de RPA, Automação de Processos, Biblioteca Python para RPA, Bot, Robô, Ferramentas de automação',
-    install_requires=['colorama', 'colorlog', 'email_validator', 'loguru', 'typing', 'pillow', 'pyautogui'],
+    install_requires=['colorama', 'colorlog', 'email_validator', 'loguru', 'typing', 'pillow', 'pyautogui', 'requests'],
 )

rpa_suite-1.4.5/rpa_suite/core/browser.py

@@ -1,166 +0,0 @@
-# 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)}!')