rpa-suite 1.4.9__py3-none-any.whl → 1.5.1__py3-none-any.whl

{rpa_suite-1.4.9.dist-info → rpa_suite-1.5.1.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.9
+Version: 1.5.1
 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
+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
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -45,17 +45,21 @@ 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/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/rpa-suite)](https://pypi.org/project/rpa-suite/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Imports: pyautogui](https://img.shields.io/badge/%20imports-pyautogui-%231674b1?style=flat&labelColor=ef8336)](https://github.com/asweigart/pyautogui)
+[![Imports: loguru](https://img.shields.io/badge/%20imports-loguru-%231674b1?style=flat&labelColor=ef8336)](https://github.com/Delgan/loguru)
+[![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
+[![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
 
----
 
 ## 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
-
 - [O que é?](#o-que-é)
 - [Sumário do conteudo](#sumário-do-conteudo)
 - [Destaque](#destaque)
@@ -65,8 +69,9 @@ Dynamic: summary
 - [Dependências](#dependências)
 - [Estrutura do módulo](#estrutura-do-módulo)
 - [Release](#release)
-  - [Notas da atualização: 1.4.9](#notas-da-atualização-149)
 - [Mais Sobre](#mais-sobre)
+- [Notas da atualização: 1.4.9](#notas-da-atualização-149)
+
 
 ## Destaque
 
@@ -86,7 +91,6 @@ Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o
 - E muito mais
 
 ## Instalação
-
 Para **instalar** o projeto, utilize o comando:
 
 ```python
@@ -112,38 +116,40 @@ Feito isso já estará pronto para o uso:
 rpa.email.send_mail(...)
 ```
 
-> [!NOTE]
->
-> Para **desinstalar** o projeto, utilize o comando abaixo.
-> **Obs.:** como usamos algumas libs no projeto, lembre-se de desinstar elas caso necessário.
-
-```python
->>> python -m pip uninstall rpa-suite
-```
 
-> [!IMPORTANT]
+> **⚠️ IMPORTANTE:**
+> Para **desinstalar** o projeto, utilize o comando abaixo:
 >
-> Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
+> ```python
+> python -m pip uninstall rpa-suite
+> ```
+>
+> **Observação:** Caso necessário, desinstale também as bibliotecas utilizadas no projeto, como `loguru`, `mail_validator`, `colorama`, `pillow`, e `pyautogui`.
 
-```python
->>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
-```
+> **⚠️ 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
+> ```
 
 ## 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 rpa
+```python
+from rpa_suite import rpa
 
-    # Exemplo com função de execução em horario especifico
-    rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
+# Exemplo com função de execução em horário específico
+rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
 
-    # Usando submódulo clock para aguardar 30(seg) para executar minha função
-    time = 30
-    rpa.clock.wait_for_exec(time, my_function, param1, param2)
+# Usando submódulo clock para aguardar 30(seg) para executar minha função
+time = 30
+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(...)
+# Usando submódulo email para envio de email por SMTP comum
+rpa.email.send_smtp(...)
+```
 
 ## Dependências
 
@@ -163,38 +169,43 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
   - selenium
   - webdriver_manager
 
-[!IMPORTANT]
-No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow' e 'pyscreeze' instalados, geralmente a instalação de pyautogui já instala as demais dependências deste caso.
+
+<br>
+<hr>
+<br>
+
+> **⚠️ 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.
 
 ## 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.
@@ -203,67 +214,66 @@ 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.
     - **cancel** - Função para cancelar a tarefa assíncrona em execução.
 
-## Release
+## Release Notes
 
-Versão: **Beta 1.4.9**
+### Versão: **Beta 1.5.2**
 
-Lançamento: *20/02/2024*
+- **Data de Lançamento:** *20/02/2024*
+- **Última Atualização:** *15/04/2025*
+- **Status:** Em desenvolvimento
 
-Última atualização: *12/04/2025*
+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.2](#notas-da-atualização-152).
 
-Status: Em desenvolvimento.
+### Notas da atualização: 1.5.2
 
-### Notas da atualização: 1.4.9
-
-- 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 SubModulo AsyncRunnner com função dedicada a facilitar uso de funções assincronas podendo recuperar seus resultados usando menos código, é um modulo simples porem poupa-nos tempo. 
-- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
-- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
-- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
-- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
-- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
-- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
-- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
+- 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 `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.
+- Melhorias nas descrições e adição de docstrings em todas as funções e objetos.
+- Submódulo de logs unificado com Loguru, agora com suporte a configuração de diretórios, nomes de arquivos e streams para console e arquivo.
+- 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 nosso projeto no Github ou PyPi:
-
-[Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
+Para mais informações, visite os links abaixo:
 
-[Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
-
-<hr>
+- **[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.4.9.dist-info → rpa_suite-1.5.1.dist-info}/RECORD

@@ -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.4.9.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.4.9.dist-info/METADATA,sha256=_Sb_Dl_nnF0kJYHsP0HGAQITOOWFvlndupMsQq9M47Y,13447
-rpa_suite-1.4.9.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-rpa_suite-1.4.9.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.4.9.dist-info/RECORD,,
+rpa_suite-1.5.1.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.5.1.dist-info/METADATA,sha256=tbk3HDcN1mfz8oG7hFM884-OUyaPIzuTsA1l9I3JvZU,13642
+rpa_suite-1.5.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+rpa_suite-1.5.1.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.5.1.dist-info/RECORD,,