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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,11 +1,11 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: rpa_suite
3
- Version: 1.4.9
3
+ Version: 1.5.0
4
4
  Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
5
5
  Author: Camilo Costa de Carvalho
6
6
  Author-email: camilo.carvalho@triasoftware.com.br
7
7
  License: MIT
8
- 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
8
+ 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
9
9
  Classifier: Development Status :: 3 - Alpha
10
10
  Classifier: Programming Language :: Python :: 3.11
11
11
  Classifier: Programming Language :: Python :: 3.12
@@ -46,9 +46,16 @@ Dynamic: summary
46
46
  <br>
47
47
 
48
48
  ![PyPI Latest Release](https://img.shields.io/pypi/v/rpa-suite.svg)
49
+ [![PyPI Downloads](https://static.pepy.tech/badge/rpa-suite/month)](https://pepy.tech/projects/rpa_suite)
49
50
  ![PyPI Downloads](https://img.shields.io/pypi/dm/rpa-suite.svg?label=PyPI%20downloads)
51
+ [![PyPI version](https://img.shields.io/pypi/v/rpa-suite)](https://pypi.org/project/rpa-suite/)
52
+ [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/rpa-suite)](https://pypi.org/project/rpa-suite/)
53
+ [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
54
+ [![Imports: pyautogui](https://img.shields.io/badge/%20imports-pyautogui-%231674b1?style=flat&labelColor=ef8336)](https://github.com/asweigart/pyautogui)
55
+ [![Imports: loguru](https://img.shields.io/badge/%20imports-loguru-%231674b1?style=flat&labelColor=ef8336)](https://github.com/Delgan/loguru)
56
+ [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
57
+ [![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
50
58
 
51
- ---
52
59
 
53
60
  ## O que é?
54
61
 
@@ -65,9 +72,11 @@ Dynamic: summary
65
72
  - [Dependências](#dependências)
66
73
  - [Estrutura do módulo](#estrutura-do-módulo)
67
74
  - [Release](#release)
68
- - [Notas da atualização: 1.4.9](#notas-da-atualização-149)
69
75
  - [Mais Sobre](#mais-sobre)
70
76
 
77
+ - [Notas da atualização: 1.4.9](#notas-da-atualização-149)
78
+
79
+
71
80
  ## Destaque
72
81
 
73
82
  **Versátil**: Além da Automação de Processos e criação de BOT em RPA, mas também para uso geral podendo ser aplicadas em outros modelos de projeto, *além do RPA*.
@@ -114,36 +123,38 @@ rpa.email.send_mail(...)
114
123
 
115
124
  > [!NOTE]
116
125
  >
117
- > Para **desinstalar** o projeto, utilize o comando abaixo.
118
- > **Obs.:** como usamos algumas libs no projeto, lembre-se de desinstar elas caso necessário.
119
-
120
- ```python
121
- >>> python -m pip uninstall rpa-suite
122
- ```
123
-
124
- > [!IMPORTANT]
126
+ > Para **desinstalar** o projeto, utilize o comando abaixo:
127
+ >
128
+ > ```python
129
+ > python -m pip uninstall rpa-suite
130
+ > ```
125
131
  >
126
- > Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
132
+ > **Observação:** Caso necessário, desinstale também as bibliotecas utilizadas no projeto, como `loguru`, `mail_validator`, `colorama`, `pillow`, e `pyautogui`.
127
133
 
128
- ```python
129
- >>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
130
- ```
134
+ > **⚠️ IMPORTANTE:**
135
+ > Opcionalmente, você pode querer desinstalar as bibliotecas que foram incluídas no projeto. Para isso, utilize o seguinte comando:
136
+ >
137
+ > ```python
138
+ > python -m pip uninstall loguru mail_validator colorama pillow pyautogui
139
+ > ```
131
140
 
132
141
  ## Exemplo
133
142
 
134
143
  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:
135
144
 
136
- from rpa_suite import rpa
145
+ ```python
146
+ from rpa_suite import rpa
137
147
 
138
- # Exemplo com função de execução em horario especifico
139
- rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
148
+ # Exemplo com função de execução em horário específico
149
+ rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
140
150
 
141
- # Usando submódulo clock para aguardar 30(seg) para executar minha função
142
- time = 30
143
- rpa.clock.wait_for_exec(time, my_function, param1, param2)
151
+ # Usando submódulo clock para aguardar 30(seg) para executar minha função
152
+ time = 30
153
+ rpa.clock.wait_for_exec(time, my_function, param1, param2)
144
154
 
145
- # Usando submódulo email para envio de email por smtp comum
146
- rpa.email.send_smtp(...)
155
+ # Usando submódulo email para envio de email por SMTP comum
156
+ rpa.email.send_smtp(...)
157
+ ```
147
158
 
148
159
  ## Dependências
149
160
 
@@ -163,8 +174,12 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
163
174
  - selenium
164
175
  - webdriver_manager
165
176
 
166
- [!IMPORTANT]
167
- 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.
177
+ <br>
178
+ <hr>
179
+ <br>
180
+
181
+ > **⚠️ IMPORTANTE:**
182
+ > 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.
168
183
 
169
184
  ## Estrutura do módulo
170
185
 
@@ -233,37 +248,40 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
233
248
  - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
234
249
  - **cancel** - Função para cancelar a tarefa assíncrona em execução.
235
250
 
236
- ## Release
251
+ ## Release Notes
237
252
 
238
- Versão: **Beta 1.4.9**
253
+ ### Versão: **Beta 1.5.0**
239
254
 
240
- Lançamento: *20/02/2024*
255
+ - **Data de Lançamento:** *20/02/2024*
256
+ - **Última Atualização:** *15/04/2025*
257
+ - **Status:** Em desenvolvimento
241
258
 
242
- Última atualização: *12/04/2025*
259
+ 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).
243
260
 
244
- Status: Em desenvolvimento.
261
+ ### Notas da atualização: 1.5.0
245
262
 
246
- ### Notas da atualização: 1.4.9
263
+ - Submódulos agora são objetos internos do objeto principal `Suite`, acessíveis via `rpa.modulo.function()` ou diretamente pelo submódulo.
264
+ - Estrutura reformulada para maior simplicidade, com pastas `core` (núcleo) e `utils` (ferramentas utilitárias).
265
+ - Novo submódulo `Parallel` para execução de processos em paralelo com suporte a timeout e recuperação de resultados.
266
+ - Novo submódulo `AsyncRunner` para facilitar o uso de funções assíncronas com menos código.
267
+ - Adicionado suporte à automação de navegadores (inicialmente apenas Chrome).
268
+ - Função `get_dma` renomeada para `get_dmy` para padronização em inglês.
269
+ - Função `send_email` simplificada para maior compatibilidade.
270
+ - Melhorias nas descrições e adição de docstrings em todas as funções e objetos.
271
+ - 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.
272
+ - Regex e busca em textos simplificados, com novas funcionalidades planejadas.
273
+ - Melhorias gerais na arquitetura e correções de bugs.
247
274
 
248
- - 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
249
- - 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
250
- - 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.
251
- - 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.
252
- - Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
253
- - 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.*
254
- - Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
255
- - Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
256
- - Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
257
- - 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()",
258
- - Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
259
- - 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.
260
275
 
261
276
  ## Mais Sobre
262
277
 
263
- Para mais informações, visite nosso projeto no Github ou PyPi:
278
+ Para mais informações, visite os links abaixo:
264
279
 
265
- [Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
280
+ - **[Repositório no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)**
281
+ Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
266
282
 
267
- [Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
283
+ - **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
284
+ Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
285
+
286
+ ---
268
287
 
269
- <hr>
@@ -18,8 +18,8 @@ rpa_suite/functions/__init__.py,sha256=aa0jejVvnghufR50owKcKpmYit7XVAliyN9gn9Jkd
18
18
  rpa_suite/functions/_printer.py,sha256=51Xbqr0Ck7HHOrhJCxhMxdCKrF_kQ5AsKZN5SZQPwpk,3991
19
19
  rpa_suite/utils/__init__.py,sha256=RQ-m9QNbaByek25moxx9ajpuxjPAEdjoMu69ReLBCWY,675
20
20
  rpa_suite/utils/system.py,sha256=fQ9BAWxVETrFUeZJlfhN3cLzToU3XDQYqvDS9W0hWgY,1157
21
- rpa_suite-1.4.9.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
22
- rpa_suite-1.4.9.dist-info/METADATA,sha256=_Sb_Dl_nnF0kJYHsP0HGAQITOOWFvlndupMsQq9M47Y,13447
23
- rpa_suite-1.4.9.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
24
- rpa_suite-1.4.9.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
25
- rpa_suite-1.4.9.dist-info/RECORD,,
21
+ rpa_suite-1.5.0.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
22
+ rpa_suite-1.5.0.dist-info/METADATA,sha256=jbmz5bzFrjkmQfoB1LnP8Tzr1eFVjj9So0p62iK8gLg,13693
23
+ rpa_suite-1.5.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
24
+ rpa_suite-1.5.0.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
25
+ rpa_suite-1.5.0.dist-info/RECORD,,