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

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.
Files changed (32) hide show
  1. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/PKG-INFO +76 -60
  2. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/README.md +70 -59
  3. rpa_suite-1.5.5/rpa_suite/__init__.py +68 -0
  4. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/__init__.py +7 -2
  5. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/asyncrun.py +31 -33
  6. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/browser.py +110 -81
  7. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/clock.py +115 -118
  8. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/date.py +36 -40
  9. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/dir.py +66 -56
  10. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/email.py +55 -53
  11. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/file.py +88 -76
  12. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/log.py +26 -10
  13. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/parallel.py +106 -96
  14. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/print.py +42 -70
  15. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/regex.py +29 -22
  16. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/core/validate.py +89 -86
  17. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/functions/__create_ss_dir.py +24 -20
  18. rpa_suite-1.5.5/rpa_suite/functions/__init__.py +3 -0
  19. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/functions/_printer.py +20 -20
  20. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/suite.py +71 -101
  21. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/utils/__init__.py +2 -0
  22. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite/utils/system.py +7 -5
  23. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite.egg-info/PKG-INFO +76 -60
  24. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/setup.py +7 -1
  25. rpa_suite-1.5.3/rpa_suite/__init__.py +0 -65
  26. rpa_suite-1.5.3/rpa_suite/functions/__init__.py +0 -1
  27. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/LICENSE +0 -0
  28. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite.egg-info/SOURCES.txt +0 -0
  29. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite.egg-info/dependency_links.txt +0 -0
  30. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite.egg-info/requires.txt +0 -0
  31. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/rpa_suite.egg-info/top_level.txt +0 -0
  32. {rpa_suite-1.5.3 → rpa_suite-1.5.5}/setup.cfg +0 -0
@@ -1,14 +1,18 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: rpa_suite
3
- Version: 1.5.3
3
+ Version: 1.5.5
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@vettracode.com
7
7
  License: MIT
8
+ Project-URL: Código Fonte, https://github.com/CamiloCCarvalho/rpasuite
9
+ Project-URL: Documentação, https://github.com/CamiloCCarvalho/rpasuite/wiki
10
+ Project-URL: LinkedIn, https://www.linkedin.com/in/camilocostac/
8
11
  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
12
  Classifier: Development Status :: 3 - Alpha
10
13
  Classifier: Programming Language :: Python :: 3.11
11
14
  Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: 3.13
12
16
  Classifier: License :: OSI Approved :: MIT License
13
17
  Classifier: Intended Audience :: Developers
14
18
  Classifier: Intended Audience :: Education
@@ -35,6 +39,7 @@ Dynamic: description-content-type
35
39
  Dynamic: keywords
36
40
  Dynamic: license
37
41
  Dynamic: license-file
42
+ Dynamic: project-url
38
43
  Dynamic: requires-dist
39
44
  Dynamic: summary
40
45
 
@@ -53,21 +58,22 @@ Dynamic: summary
53
58
  [![Imports: pyautogui](https://img.shields.io/badge/%20imports-pyautogui-%231674b1?style=flat&labelColor=ef8336)](https://github.com/asweigart/pyautogui)
54
59
  [![Imports: loguru](https://img.shields.io/badge/%20imports-loguru-%231674b1?style=flat&labelColor=ef8336)](https://github.com/Delgan/loguru)
55
60
  [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
56
- [![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
57
-
58
61
 
59
62
  ## O que é?
60
- **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.
63
+
64
+ **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 ou Botcity? Experimente a RPA Suite e descubra como podemos facilitar seu projeto e qualquer projeto de Robôs de Software.
61
65
 
62
66
  <br>
63
67
 
64
68
  ## Documentação
69
+
65
70
  - **[Documentação no GitHub](https://github.com/CamiloCCarvalho/rpasuite/wiki)**
66
- Conta com guia de uso , instação e todas funcionalidades.
71
+ Conta com guia de uso , instação e todas funcionalidades.
67
72
 
68
73
  <br>
69
74
 
70
75
  ## Sumário
76
+
71
77
  - [O que é?](#o-que-é)
72
78
  - [Documentação](#documentação)
73
79
  - [Sumário do conteudo](#sumário-do-conteudo)
@@ -80,7 +86,6 @@ Conta com guia de uso , instação e todas funcionalidades.
80
86
  - [Release](#release)
81
87
  - [Mais Sobre](#mais-sobre)
82
88
 
83
-
84
89
  ## Destaque
85
90
 
86
91
  **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*.
@@ -106,6 +111,7 @@ Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o
106
111
  <br>
107
112
 
108
113
  ## Instalação
114
+
109
115
  Para **instalar** o projeto, utilize o comando:
110
116
 
111
117
  ```python
@@ -131,7 +137,6 @@ Feito isso já estará pronto para o uso:
131
137
  rpa.email.send_mail(...)
132
138
  ```
133
139
 
134
-
135
140
  > **⚠️ IMPORTANTE:**
136
141
  > Para **desinstalar** o projeto, utilize o comando abaixo:
137
142
  >
@@ -150,7 +155,6 @@ rpa.email.send_mail(...)
150
155
 
151
156
  <br>
152
157
 
153
-
154
158
  ## Exemplo
155
159
 
156
160
  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:
@@ -168,6 +172,7 @@ rpa.clock.wait_for_exec(time, my_function, param1, param2)
168
172
  # Usando submódulo email para envio de email por SMTP comum
169
173
  rpa.email.send_smtp(...)
170
174
  ```
175
+
171
176
  <br>
172
177
 
173
178
  ## Dependências
@@ -188,7 +193,6 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
188
193
  - selenium
189
194
  - webdriver_manager
190
195
 
191
-
192
196
  <br>
193
197
  <hr>
194
198
  <br>
@@ -205,73 +209,85 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
205
209
  - **rpa_suite**
206
210
 
207
211
  **clock**
208
- - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
209
- - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
210
- - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
211
-
212
+
213
+ - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
214
+ - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
215
+ - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
216
+
212
217
  **date**
213
- - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
214
- - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
215
-
218
+
219
+ - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
220
+ - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
221
+
216
222
  **email**
217
- - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
218
-
223
+
224
+ - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
225
+
219
226
  **file**
220
- - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
221
- - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
222
- - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
223
- - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
224
-
227
+
228
+ - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
229
+ - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
230
+ - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
231
+ - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
232
+
225
233
  **directory**
226
- - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
227
- - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
228
-
234
+
235
+ - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
236
+ - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
237
+
229
238
  **log**
230
- - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
231
- - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
232
- - **log_debug** - Função para registrar logs em nível de depuração.
233
- - **log_info** - Função para registrar logs em nível informativo.
234
- - **log_warning** - Função para registrar logs em nível de aviso.
235
- - **log_error** - Função para registrar logs em nível de erro.
236
- - **log_critical** - Função para registrar logs em nível crítico.
239
+
240
+ - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
241
+ - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
242
+ - **log_debug** - Função para registrar logs em nível de depuração.
243
+ - **log_info** - Função para registrar logs em nível informativo.
244
+ - **log_warning** - Função para registrar logs em nível de aviso.
245
+ - **log_error** - Função para registrar logs em nível de erro.
246
+ - **log_critical** - Função para registrar logs em nível crítico.
237
247
 
238
248
  **printer**
239
- - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
240
- - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
241
- - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
242
- - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
243
-
249
+
250
+ - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
251
+ - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
252
+ - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
253
+ - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
254
+
244
255
  **regex**
245
- - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
246
-
256
+
257
+ - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
258
+
247
259
  **validate**
248
- - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
249
- - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
250
-
260
+
261
+ - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
262
+ - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
263
+
251
264
  **Browser**
252
- - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
253
- - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
254
- - **get** - Função para navegar para URLs específicas.
255
- - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
256
-
265
+
266
+ - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
267
+ - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
268
+ - **get** - Função para navegar para URLs específicas.
269
+ - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
270
+
257
271
  **Parallel (ParallelRunner)**
258
- - **run** - Função para iniciar um processo em paralelo.
259
- - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
260
- - **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.
261
- - **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".
262
-
272
+
273
+ - **run** - Função para iniciar um processo em paralelo.
274
+ - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
275
+ - **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.
276
+ - **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".
277
+
263
278
  **Asyn (AsyncRunner)**
264
- - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
265
- - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
266
- - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
267
- - **cancel** - Função para cancelar a tarefa assíncrona em execução.
279
+
280
+ - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
281
+ - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
282
+ - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
283
+ - **cancel** - Função para cancelar a tarefa assíncrona em execução.
268
284
 
269
285
  ## Release Notes
270
286
 
271
- ### Versão: **Beta 1.5.3**
287
+ ### Versão: **Beta 1.5.5**
272
288
 
273
289
  - **Data de Lançamento:** *20/02/2024*
274
- - **Última Atualização:** *17/04/2025*
290
+ - **Última Atualização:** 02/05/2025
275
291
  - **Status:** Em desenvolvimento
276
292
 
277
293
  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.
@@ -295,6 +311,6 @@ Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo m
295
311
  Para mais informações, visite os links abaixo:
296
312
 
297
313
  - **[Repositório no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)**
298
- Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
314
+ Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
299
315
  - **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
300
316
  Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
@@ -13,21 +13,22 @@
13
13
  [![Imports: pyautogui](https://img.shields.io/badge/%20imports-pyautogui-%231674b1?style=flat&labelColor=ef8336)](https://github.com/asweigart/pyautogui)
14
14
  [![Imports: loguru](https://img.shields.io/badge/%20imports-loguru-%231674b1?style=flat&labelColor=ef8336)](https://github.com/Delgan/loguru)
15
15
  [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
16
- [![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
17
-
18
16
 
19
17
  ## O que é?
20
- **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.
18
+
19
+ **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 ou Botcity? Experimente a RPA Suite e descubra como podemos facilitar seu projeto e qualquer projeto de Robôs de Software.
21
20
 
22
21
  <br>
23
22
 
24
23
  ## Documentação
24
+
25
25
  - **[Documentação no GitHub](https://github.com/CamiloCCarvalho/rpasuite/wiki)**
26
- Conta com guia de uso , instação e todas funcionalidades.
26
+ Conta com guia de uso , instação e todas funcionalidades.
27
27
 
28
28
  <br>
29
29
 
30
30
  ## Sumário
31
+
31
32
  - [O que é?](#o-que-é)
32
33
  - [Documentação](#documentação)
33
34
  - [Sumário do conteudo](#sumário-do-conteudo)
@@ -40,7 +41,6 @@ Conta com guia de uso , instação e todas funcionalidades.
40
41
  - [Release](#release)
41
42
  - [Mais Sobre](#mais-sobre)
42
43
 
43
-
44
44
  ## Destaque
45
45
 
46
46
  **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*.
@@ -66,6 +66,7 @@ Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o
66
66
  <br>
67
67
 
68
68
  ## Instalação
69
+
69
70
  Para **instalar** o projeto, utilize o comando:
70
71
 
71
72
  ```python
@@ -91,7 +92,6 @@ Feito isso já estará pronto para o uso:
91
92
  rpa.email.send_mail(...)
92
93
  ```
93
94
 
94
-
95
95
  > **⚠️ IMPORTANTE:**
96
96
  > Para **desinstalar** o projeto, utilize o comando abaixo:
97
97
  >
@@ -110,7 +110,6 @@ rpa.email.send_mail(...)
110
110
 
111
111
  <br>
112
112
 
113
-
114
113
  ## Exemplo
115
114
 
116
115
  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:
@@ -128,6 +127,7 @@ rpa.clock.wait_for_exec(time, my_function, param1, param2)
128
127
  # Usando submódulo email para envio de email por SMTP comum
129
128
  rpa.email.send_smtp(...)
130
129
  ```
130
+
131
131
  <br>
132
132
 
133
133
  ## Dependências
@@ -148,7 +148,6 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
148
148
  - selenium
149
149
  - webdriver_manager
150
150
 
151
-
152
151
  <br>
153
152
  <hr>
154
153
  <br>
@@ -165,73 +164,85 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
165
164
  - **rpa_suite**
166
165
 
167
166
  **clock**
168
- - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
169
- - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
170
- - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
171
-
167
+
168
+ - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
169
+ - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
170
+ - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
171
+
172
172
  **date**
173
- - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
174
- - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
175
-
173
+
174
+ - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
175
+ - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
176
+
176
177
  **email**
177
- - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
178
-
178
+
179
+ - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
180
+
179
181
  **file**
180
- - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
181
- - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
182
- - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
183
- - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
184
-
182
+
183
+ - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
184
+ - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
185
+ - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
186
+ - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
187
+
185
188
  **directory**
186
- - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
187
- - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
188
-
189
+
190
+ - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
191
+ - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
192
+
189
193
  **log**
190
- - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
191
- - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
192
- - **log_debug** - Função para registrar logs em nível de depuração.
193
- - **log_info** - Função para registrar logs em nível informativo.
194
- - **log_warning** - Função para registrar logs em nível de aviso.
195
- - **log_error** - Função para registrar logs em nível de erro.
196
- - **log_critical** - Função para registrar logs em nível crítico.
194
+
195
+ - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
196
+ - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
197
+ - **log_debug** - Função para registrar logs em nível de depuração.
198
+ - **log_info** - Função para registrar logs em nível informativo.
199
+ - **log_warning** - Função para registrar logs em nível de aviso.
200
+ - **log_error** - Função para registrar logs em nível de erro.
201
+ - **log_critical** - Função para registrar logs em nível crítico.
197
202
 
198
203
  **printer**
199
- - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
200
- - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
201
- - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
202
- - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
203
-
204
+
205
+ - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
206
+ - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
207
+ - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
208
+ - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
209
+
204
210
  **regex**
205
- - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
206
-
211
+
212
+ - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
213
+
207
214
  **validate**
208
- - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
209
- - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
210
-
215
+
216
+ - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
217
+ - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
218
+
211
219
  **Browser**
212
- - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
213
- - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
214
- - **get** - Função para navegar para URLs específicas.
215
- - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
216
-
220
+
221
+ - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
222
+ - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
223
+ - **get** - Função para navegar para URLs específicas.
224
+ - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
225
+
217
226
  **Parallel (ParallelRunner)**
218
- - **run** - Função para iniciar um processo em paralelo.
219
- - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
220
- - **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.
221
- - **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".
222
-
227
+
228
+ - **run** - Função para iniciar um processo em paralelo.
229
+ - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
230
+ - **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.
231
+ - **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".
232
+
223
233
  **Asyn (AsyncRunner)**
224
- - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
225
- - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
226
- - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
227
- - **cancel** - Função para cancelar a tarefa assíncrona em execução.
234
+
235
+ - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
236
+ - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
237
+ - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
238
+ - **cancel** - Função para cancelar a tarefa assíncrona em execução.
228
239
 
229
240
  ## Release Notes
230
241
 
231
- ### Versão: **Beta 1.5.3**
242
+ ### Versão: **Beta 1.5.5**
232
243
 
233
244
  - **Data de Lançamento:** *20/02/2024*
234
- - **Última Atualização:** *17/04/2025*
245
+ - **Última Atualização:** 02/05/2025
235
246
  - **Status:** Em desenvolvimento
236
247
 
237
248
  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.
@@ -255,6 +266,6 @@ Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo m
255
266
  Para mais informações, visite os links abaixo:
256
267
 
257
268
  - **[Repositório no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)**
258
- Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
269
+ Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
259
270
  - **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
260
271
  Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
@@ -0,0 +1,68 @@
1
+ # rpa_suite/__init__.py
2
+
3
+ """
4
+ RPA Suite is a Python module that provides a set of tools for process automation.
5
+
6
+ To use the module, import it as follows:
7
+ >>> from rpa_suite import rpa
8
+
9
+ Example of usage:
10
+ >>> from rpa_suite import rpa
11
+ >>> rpa.email.send_smtp(
12
+ ... email_user="your@email.com",
13
+ ... email_password="your_password",
14
+ ... email_to="destination@email.com",
15
+ ... subject_title="Test",
16
+ ... body_message="<p>Test message</p>"
17
+ ... )
18
+ >>> rpa.alert_print("Hello World")
19
+
20
+ Available modules:
21
+ ``clock``: Utilities for time and stopwatch manipulation
22
+ ``date``: Functions for date manipulation
23
+ ``email``: Functionalities for sending emails via SMTP
24
+ ``directory``: Operations with directories
25
+ ``file``: File manipulation
26
+ ``log``: Logging system
27
+ ``printer``: Functions for formatted output
28
+ ``regex``: Operations with regular expressions
29
+ ``validate``: Data validation functions
30
+ ``Browser``: Object Browser automation functions (neeeds Selenium and Webdriver_Manager)
31
+
32
+ pt-br
33
+ -----
34
+ RPA Suite é um módulo Python que fornece um conjunto de ferramentas para automação de processos.
35
+
36
+ Para utilizar o módulo, importe-o da seguinte forma:
37
+ >>> from rpa_suite import rpa
38
+
39
+ Exemplo de uso:
40
+ >>> from rpa_suite import rpa
41
+ >>> rpa.email.send_smtp(
42
+ ... email_user="seu@email.com",
43
+ ... email_password="sua_senha",
44
+ ... email_to="destino@email.com",
45
+ ... subject_title="Teste",
46
+ ... body_message="<p>Mensagem de teste</p>"
47
+ ... )
48
+ >>> rpa.alert_print("Hello World")
49
+
50
+ Módulos disponíveis:
51
+ ``clock``: Utilitários para manipulação de tempo e cronômetro
52
+ ``date``: Funções para manipulação de datas
53
+ ``email``: Funcionalidades para envio de emails via SMTP
54
+ ``directory``: Operações com diretórios
55
+ ``file``: Manipulação de arquivos
56
+ ``log``: Sistema de logging
57
+ ``printer``: Funções para output formatado
58
+ ``regex``: Operações com expressões regulares
59
+ ``validate``: Funções de validação de dados
60
+ ``Browser``: Objeto de Automação de Navegadores (necessario Selenium e Webdriver_Manager)
61
+ """
62
+
63
+ __version__ = '1.5.5'
64
+
65
+ # allows importing the rpa_suite module without the package name
66
+ from .suite import rpa
67
+
68
+ rpa
@@ -36,11 +36,16 @@ from .parallel import ParallelRunner
36
36
  from .asyncrun import AsyncRunner
37
37
 
38
38
 
39
-
40
39
  # On this case, we are importing the Browser class only if the selenium and webdriver_manager modules are installed.
41
40
  # This is useful to avoid unnecessary imports and dependencies if the user does not need the Browser functionality.
42
41
  import importlib.util
43
42
 
44
43
  # from .browser import Browser
45
- if importlib.util.find_spec("selenium") and importlib.util.find_spec("webdriver_manager"):
44
+ if importlib.util.find_spec("selenium") and importlib.util.find_spec(
45
+ "webdriver_manager"
46
+ ):
46
47
  from .browser import Browser
48
+
49
+
50
+ __version__ = '1.5.5'
51
+