rpa-suite 1.5.1__tar.gz → 1.5.3__tar.gz

{rpa_suite-1.5.1 → rpa_suite-1.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.1
+Version: 1.5.3
 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@vettracode.com
@@ -59,8 +59,17 @@ 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/wiki)**
+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)
@@ -70,7 +79,6 @@ Dynamic: summary
 - [Estrutura do módulo](#estrutura-do-módulo)
 - [Release](#release)
 - [Mais Sobre](#mais-sobre)
-- [Notas da atualização: 1.4.9](#notas-da-atualização-149)
 
 
 ## Destaque
@@ -79,17 +87,24 @@ 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
 
+<br>
+
 ## Instalação
 Para **instalar** o projeto, utilize o comando:
 
@@ -133,6 +148,9 @@ rpa.email.send_mail(...)
 > 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:
@@ -150,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
 
@@ -177,6 +196,8 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 > **⚠️ 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:
@@ -247,15 +268,15 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.2**
+### Versão: **Beta 1.5.3**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** *15/04/2025*
+- **Ú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.2](#notas-da-atualização-152).
+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.2
+### 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).

{rpa_suite-1.5.1 → rpa_suite-1.5.3}/README.md

@@ -19,8 +19,17 @@
 ## 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/wiki)**
+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)
@@ -30,7 +39,6 @@
 - [Estrutura do módulo](#estrutura-do-módulo)
 - [Release](#release)
 - [Mais Sobre](#mais-sobre)
-- [Notas da atualização: 1.4.9](#notas-da-atualização-149)
 
 
 ## Destaque
@@ -39,17 +47,24 @@
 
 **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
 
+<br>
+
 ## Instalação
 Para **instalar** o projeto, utilize o comando:
 
@@ -93,6 +108,9 @@ rpa.email.send_mail(...)
 > 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:
@@ -110,6 +128,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
 
@@ -137,6 +156,8 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 > **⚠️ 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:
@@ -207,15 +228,15 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.2**
+### Versão: **Beta 1.5.3**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** *15/04/2025*
+- **Ú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.2](#notas-da-atualização-152).
+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.2
+### 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).

{rpa_suite-1.5.1 → rpa_suite-1.5.3}/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.1 → rpa_suite-1.5.3}/rpa_suite/core/dir.py

@@ -58,7 +58,8 @@ class Directory():
 
     def create_temp_dir(self,
                         path_to_create: str = 'default',
-                        name_temp_dir: str='temp') -> dict[str, Union[bool, str, None]]:
+                        name_temp_dir: str='temp',
+                        display_message: bool = False) -> dict[str, Union[bool, str, None]]:
 
         """
         Function responsible for creating a temporary directory to work with files and etc. \n
@@ -69,6 +70,8 @@ class Directory():
 
         ``name_temp_dir: str`` - should be a string representing the name of the temporary directory to be created. If it is empty, the ``temp`` value will be used as the default directory name.
 
+        ``display_message: bool`` - should be a bool to display messages on terminal, by default False.
+
         Return:
         ----------
         >>> type:dict
@@ -85,6 +88,8 @@ class Directory():
 
         ``name_temp_dir: str`` - deve ser uma string representando o nome do diretório temporário a ser criado. Se estiver vazio, o valor ``temp`` será usado como o nome padrão do diretório.
 
+        ``display_message: bool`` - deve ser um bool para exibir mensagens no terminal, por padrão False.
+
         Retorno:
         ----------
         >>> type:dict
@@ -115,17 +120,17 @@ class Directory():
                 result['success'] = True
                 result['path_created'] = fr'{full_path}'
 
-                success_print(f"Diretório:'{full_path}' foi criado com sucesso.")
+                if display_message: success_print(f"Directory:'{full_path}' successfully created.")
 
             except FileExistsError:
                 result['success'] = False
                 result['path_created'] = None
-                alert_print(f"Diretório:'{full_path}' já existe.")
+                if display_message: alert_print(f"Directory:'{full_path}' already exists.")
 
             except PermissionError:
                 result['success'] = False
                 result['path_created'] = None
-                alert_print(f"Permissão negada: não é possível criar o diretório '{full_path}'.")
+                alert_print(f"Permission denied: Not possible to create Directory '{full_path}'.")
 
         except Exception as e:
             result['success'] = False
@@ -139,7 +144,8 @@ class Directory():
     def delete_temp_dir(self,
                         path_to_delete: str = 'default',
                         name_temp_dir: str='temp',
-                        delete_files: bool = False) -> dict[str, Union[bool, str, None]]:
+                        delete_files: bool = False,
+                        display_message: bool = False) -> dict[str, Union[bool, str, None]]:
 
         """
         Function responsible for deleting a temporary directory. \n
@@ -209,16 +215,16 @@ class Directory():
                     result['success'] = True
                     result['path_deleted'] = fr'{full_path}'
 
-                    success_print(f"Diretório:'{full_path}' foi deletado com sucesso.")
+                    if display_message: success_print(f"Directory:'{full_path}' successfully delete.")
                 else:
                     result['success'] = False
                     result['path_deleted'] = None
-                    alert_print(f"Diretório:'{full_path}' não existe.")
+                    if display_message: alert_print(f"Directory:'{full_path}' don't exists.")
 
             except PermissionError:
                 result['success'] = False
                 result['path_deleted'] = None
-                alert_print(f"Permissão negada: não é possível deletar o diretório '{full_path}'.")
+                alert_print(f"Permission denied: Not possible to delete Directory '{full_path}'.")
 
         except Exception as e:
             result['success'] = False

{rpa_suite-1.5.1 → rpa_suite-1.5.3}/rpa_suite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.5.1
+Version: 1.5.3
 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@vettracode.com
@@ -59,8 +59,17 @@ 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/wiki)**
+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)
@@ -70,7 +79,6 @@ Dynamic: summary
 - [Estrutura do módulo](#estrutura-do-módulo)
 - [Release](#release)
 - [Mais Sobre](#mais-sobre)
-- [Notas da atualização: 1.4.9](#notas-da-atualização-149)
 
 
 ## Destaque
@@ -79,17 +87,24 @@ 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
 
+<br>
+
 ## Instalação
 Para **instalar** o projeto, utilize o comando:
 
@@ -133,6 +148,9 @@ rpa.email.send_mail(...)
 > 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:
@@ -150,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
 
@@ -177,6 +196,8 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 > **⚠️ 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:
@@ -247,15 +268,15 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release Notes
 
-### Versão: **Beta 1.5.2**
+### Versão: **Beta 1.5.3**
 
 - **Data de Lançamento:** *20/02/2024*
-- **Última Atualização:** *15/04/2025*
+- **Ú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.2](#notas-da-atualização-152).
+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.2
+### 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).

{rpa_suite-1.5.1 → rpa_suite-1.5.3}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='1.5.1',
+    version='1.5.3',
     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',