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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.5
+Version: 1.4.8
 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,8 @@ Requires-Dist: loguru
 Requires-Dist: typing
 Requires-Dist: pillow
 Requires-Dist: pyautogui
+Requires-Dist: requests
+Requires-Dist: setuptools
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -54,13 +56,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.8](#notas-da-atualização-148)
 - [Mais Sobre](#mais-sobre)
 
 ## Destaque
@@ -94,17 +99,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 +126,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,47 +167,80 @@ 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.
+
+  - **parallel**
+    - **run** - Função para iniciar um processo em paralelo.
+    - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
+    - **get_result** - Função para coletar o retorno da execução em paralelo junto com resultado da função ou funções que foram enviadas a este processo com retorno em forma de dict.
+    - **terminate** - Função para finalizar o processo paralelo mantendo apenas o processo principal do seu código, também é chamada de forma automatica esta função ao final de um procesos paralelo ou no final da função "get_result".
 
 ## Release
 
-Versão: **Beta 1.4.5**
+Versão: **Beta 1.4.8**
 
 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.8
 
 - 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 SubModulo Parallel com função dedicada a rodar um processo em paralelo com seu fluxo principal podendo recuperar o resultado da execução em paralelo a qualquer momento e setando timeout ou deixando o tempo indefinido para aguardar a resposta. 
 - 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
@@ -212,13 +253,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.8}/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.8](#notas-da-atualização-148)
 - [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,47 +127,80 @@ 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.
+
+  - **parallel**
+    - **run** - Função para iniciar um processo em paralelo.
+    - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
+    - **get_result** - Função para coletar o retorno da execução em paralelo junto com resultado da função ou funções que foram enviadas a este processo com retorno em forma de dict.
+    - **terminate** - Função para finalizar o processo paralelo mantendo apenas o processo principal do seu código, também é chamada de forma automatica esta função ao final de um procesos paralelo ou no final da função "get_result".
 
 ## Release
 
-Versão: **Beta 1.4.5**
+Versão: **Beta 1.4.8**
 
 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.8
 
 - 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 SubModulo Parallel com função dedicada a rodar um processo em paralelo com seu fluxo principal podendo recuperar o resultado da execução em paralelo a qualquer momento e setando timeout ou deixando o tempo indefinido para aguardar a resposta. 
 - 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
@@ -174,13 +213,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.8}/rpa_suite/__init__.py

@@ -1,4 +1,5 @@
 # rpa_suite/__init__.py
+
 """
     RPA Suite is a Python module that provides a set of tools for process automation.
     
@@ -26,7 +27,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,8 +57,9 @@
         ``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)
 """
 
+# allows importing the rpa_suite module without the package name
 from .suite import rpa
 rpa

{rpa_suite-1.4.5 → rpa_suite-1.4.8}/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,14 @@ from .log import Log
 from .print import Print
 from .regex import Regex
 from .validate import Validate
-from .browser import Browser
+from .parallel import ParallelRunner
+
+
+
+# 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