rpa-suite 1.5.0__py3-none-any.whl → 1.5.2__py3-none-any.whl

rpa_suite/core/clock.py

@@ -7,7 +7,6 @@ from rpa_suite.functions._printer import error_print, success_print
 import time
 from typing import Callable, Any
 from datetime import datetime as dt
-from typing import Callable, Any
 
 
 class Clock():

{rpa_suite-1.5.0.dist-info → rpa_suite-1.5.2.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.0
+Version: 1.5.2
 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
+Author-email: camilo.carvalho@vettracode.com
 License: MIT
 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,automation-tools,workflow-automation,rpa-framework,python-bots,automation-library,rpa-development,python-automation-tools
 Classifier: Development Status :: 3 - Alpha
@@ -45,7 +45,6 @@ Dynamic: summary
 </h1>
 <br>
 
-![PyPI Latest Release](https://img.shields.io/pypi/v/rpa-suite.svg)
 [![PyPI Downloads](https://static.pepy.tech/badge/rpa-suite/month)](https://pepy.tech/projects/rpa_suite)
 ![PyPI Downloads](https://img.shields.io/pypi/dm/rpa-suite.svg?label=PyPI%20downloads)
 [![PyPI version](https://img.shields.io/pypi/v/rpa-suite)](https://pypi.org/project/rpa-suite/)
@@ -58,12 +57,19 @@ Dynamic: summary
 
 
 ## O que é?
-
 **RPA Suite:** um conjunto abrangente de ferramentas projetadas para simplificar e otimizar o desenvolvimento de projetos de automação RPA com Python. Embora nossa suíte seja um conjunto de Ferramentas de RPA especializado, sua versatilidade a torna igualmente útil para uma ampla gama de projetos de desenvolvimento. Esta desenvolvendo com Selenium, Botcity ou Playwright? Experimente a RPA Suite e descubra como podemos facilitar seu projeto, ou qualquer projeto de Robôs de Software.
 
-## Sumário do conteudo
+<br>
+
+## Documentação
+- **[Documentação no GitHub](https://github.com/CamiloCCarvalho/rpasuite/blob/master/docs/GUIDE.md)**
+Conta com guia de uso , instação e todas funcionalidades. 
+
+<br>
 
+## Sumário
 - [O que é?](#o-que-é)
+- [Documentação](#documentação)
 - [Sumário do conteudo](#sumário-do-conteudo)
 - [Destaque](#destaque)
 - [Objetivo](#objetivo)
@@ -74,8 +80,6 @@ Dynamic: summary
 - [Release](#release)
 - [Mais Sobre](#mais-sobre)
 
-- [Notas da atualização: 1.4.9](#notas-da-atualização-149)
-
 
 ## Destaque
 
@@ -83,19 +87,25 @@ Dynamic: summary
 
 **Simples**: Construímos as ferramentas de maneira mais direta e assertiva possível, utilizando apenas bibliotecas conhecidas no mercado para garantir o melhor desempenho possível.
 
+<br>
+
 ## Objetivo
 
 Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o desenvolvimento de RPAs mais produtivo, oferecendo uma gama de funções para tal:
 
-- Envio de emails (já configurado e personalizavel)
-- Validação de emails (limpeza e tratamento)
-- Busca por palavras, strings ou substrings (patterns) em textos.
-- Criação e deleção de pasta/arquivo temporário com um comando
+- Envio e validação de Emails com apenas uma linha
+- Criação e Manipulação de registros de Logs
+- Busca por palavras, strings e padrões em textos
+- Criar e Deletar Pastas e arquivos temporarios
 - Console com mensagens de melhor visualização com cores definidas para alerta, erro, informativo e sucesso.
+- Módulo dedicado para execução com Paralelismo
+- Funções que facilitam execuções Assincronas
+- Registro de Screenshot com apenas um comando
 - E muito mais
 
-## Instalação
+<br>
 
+## Instalação
 Para **instalar** o projeto, utilize o comando:
 
 ```python
@@ -121,8 +131,8 @@ Feito isso já estará pronto para o uso:
 rpa.email.send_mail(...)
 ```
 
-> [!NOTE]
->
+
+> **⚠️ IMPORTANTE:**
 > Para **desinstalar** o projeto, utilize o comando abaixo:
 >
 > ```python
@@ -131,13 +141,16 @@ rpa.email.send_mail(...)
 >
 > **Observação:** Caso necessário, desinstale também as bibliotecas utilizadas no projeto, como `loguru`, `mail_validator`, `colorama`, `pillow`, e `pyautogui`.
 
-> **⚠️ IMPORTANTE:**  
-> Opcionalmente, você pode querer desinstalar as bibliotecas que foram incluídas no projeto. Para isso, utilize o seguinte comando:  
+> **⚠️ IMPORTANTE:**
+> Opcionalmente, você pode querer desinstalar as bibliotecas que foram incluídas no projeto. Para isso, utilize o seguinte comando:
 >
 > ```python
 > python -m pip uninstall loguru mail_validator colorama pillow pyautogui
 > ```
 
+<br>
+
+
 ## 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:
@@ -155,6 +168,7 @@ 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(...)
 ```
+<br>
 
 ## Dependências
 
@@ -174,42 +188,45 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
   - selenium
   - webdriver_manager
 
+
 <br>
 <hr>
 <br>
 
-> **⚠️ IMPORTANTE:**  
+> **⚠️ IMPORTANTE:**
 > No caso da função de screenshot, é necessário ter as bibliotecas `pyautogui`, `pillow` e `pyscreeze` instaladas. Geralmente, a instalação de `pyautogui` já inclui as demais dependências necessárias.
 
+<br>
+
 ## 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**
+
+  **clock**
     - **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**
     - **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**
+  **email**
     - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
-
-  - **file**
+  
+  **file**
     - **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**
+  
+  **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**
+  
+  **log**
     - **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.
@@ -218,31 +235,32 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
     - **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**
+  **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**
+  
+  **regex**
     - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
   
-  - **validate**
+  **validate**
     - **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**
+  **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**
+  
+  **Parallel (ParallelRunner)**
     - **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".
-
-  - **async**
+  
+  **Asyn (AsyncRunner)**
     - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
     - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
     - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
@@ -250,20 +268,20 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.0**
+### Versão: **Beta 1.5.2**
 
-- **Data de Lançamento:** *20/02/2024*  
-- **Última Atualização:** *15/04/2025*  
-- **Status:** Em desenvolvimento  
+- **Data de Lançamento:** *20/02/2024*
+- **Última Atualização:** *17/04/2025*
+- **Status:** Em desenvolvimento
 
-Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo melhorias significativas na arquitetura, novas funcionalidades e maior simplicidade no uso. Confira as principais mudanças na seção [Notas da atualização: 1.5.0](#notas-da-atualização-150).
+Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo melhorias significativas na arquitetura, novas funcionalidades e maior simplicidade no uso. Confira as principais mudanças abaixo.
 
-### Notas da atualização: 1.5.0
+### Notas da atualização:
 
 - Submódulos agora são objetos internos do objeto principal `Suite`, acessíveis via `rpa.modulo.function()` ou diretamente pelo submódulo.
 - Estrutura reformulada para maior simplicidade, com pastas `core` (núcleo) e `utils` (ferramentas utilitárias).
-- Novo submódulo `Parallel` para execução de processos em paralelo com suporte a timeout e recuperação de resultados.
-- Novo submódulo `AsyncRunner` para facilitar o uso de funções assíncronas com menos código.
+- Novo submódulo `ParallelRunner` (`Parallel`) para execução de processos em paralelo com suporte a timeout e recuperação de resultados.
+- Novo submódulo `AsyncRunner` (`Asyn`) para facilitar o uso de funções assíncronas com menos código.
 - Adicionado suporte à automação de navegadores (inicialmente apenas Chrome).
 - Função `get_dma` renomeada para `get_dmy` para padronização em inglês.
 - Função `send_email` simplificada para maior compatibilidade.
@@ -272,16 +290,11 @@ Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo m
 - Regex e busca em textos simplificados, com novas funcionalidades planejadas.
 - Melhorias gerais na arquitetura e correções de bugs.
 
-
 ## Mais Sobre
 
 Para mais informações, visite os links abaixo:
 
-- **[Repositório no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)**  
-  Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
-
-- **[Página no PyPI](https://pypi.org/project/rpa-suite/)**  
+- **[Repositório no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)**
+Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
+- **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
   Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
-
----
-

{rpa_suite-1.5.0.dist-info → rpa_suite-1.5.2.dist-info}/RECORD

@@ -3,7 +3,7 @@ rpa_suite/suite.py,sha256=1lsdFLz44gh7y3leOR5BCsx1dEKam5cm1g7l5RCFsYc,11187
 rpa_suite/core/__init__.py,sha256=oGQiEtmgR9fBHgcAKYsl5eZsS2_SbRZnlhzOgRqXrAM,1713
 rpa_suite/core/asyncrun.py,sha256=S5b-ueG4oJmupBZLsfYqcyTA5k5SaAi8j3KU8NnTOMg,4378
 rpa_suite/core/browser.py,sha256=h1sMERkEw8y8zfQs2hdv2VbBNt3pQlVkMlkQOTKpaKQ,14755
-rpa_suite/core/clock.py,sha256=-ZEEaTYzwoYk9Bw1K6K1RN4s7O21uEhTg2hgBmdYLtQ,13880
+rpa_suite/core/clock.py,sha256=zEPYkHdzsxvLen1x7GImdEMhNnGgYZ-0sy5XBlVdDPc,13846
 rpa_suite/core/date.py,sha256=0dqkP7zVjWeMmZA5xDZuvin97yYPMl1p0bCfLmtXdlM,6635
 rpa_suite/core/dir.py,sha256=sc_mJGrjo520cmNyC_HZo3YKEbORkBDfD3bCLaQ7U2o,9855
 rpa_suite/core/email.py,sha256=CUqhW8-BF0XS7vFeZieQ13VywEg1TQZVoicEexSQCPE,8671
@@ -18,8 +18,8 @@ rpa_suite/functions/__init__.py,sha256=aa0jejVvnghufR50owKcKpmYit7XVAliyN9gn9Jkd
 rpa_suite/functions/_printer.py,sha256=51Xbqr0Ck7HHOrhJCxhMxdCKrF_kQ5AsKZN5SZQPwpk,3991
 rpa_suite/utils/__init__.py,sha256=RQ-m9QNbaByek25moxx9ajpuxjPAEdjoMu69ReLBCWY,675
 rpa_suite/utils/system.py,sha256=fQ9BAWxVETrFUeZJlfhN3cLzToU3XDQYqvDS9W0hWgY,1157
-rpa_suite-1.5.0.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.5.0.dist-info/METADATA,sha256=jbmz5bzFrjkmQfoB1LnP8Tzr1eFVjj9So0p62iK8gLg,13693
-rpa_suite-1.5.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-rpa_suite-1.5.0.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.5.0.dist-info/RECORD,,
+rpa_suite-1.5.2.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.5.2.dist-info/METADATA,sha256=-xlPDj6qv234kcMJdexKIzu1Oua38Ockaf9DpT-lx1I,13894
+rpa_suite-1.5.2.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+rpa_suite-1.5.2.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.5.2.dist-info/RECORD,,