rpa-suite 1.5.3__tar.gz → 1.5.4__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.4}/PKG-INFO +75 -58
  2. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/README.md +69 -57
  3. rpa_suite-1.5.4/rpa_suite/__init__.py +66 -0
  4. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/__init__.py +3 -2
  5. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/asyncrun.py +31 -33
  6. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/browser.py +110 -81
  7. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/clock.py +115 -118
  8. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/date.py +36 -40
  9. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/dir.py +66 -56
  10. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/email.py +55 -53
  11. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/file.py +88 -76
  12. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/log.py +26 -10
  13. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/parallel.py +106 -96
  14. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/print.py +42 -70
  15. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/regex.py +29 -22
  16. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/core/validate.py +89 -86
  17. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/functions/__create_ss_dir.py +24 -20
  18. rpa_suite-1.5.4/rpa_suite/functions/__init__.py +1 -0
  19. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/functions/_printer.py +20 -20
  20. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/suite.py +71 -101
  21. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/utils/system.py +7 -5
  22. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite.egg-info/PKG-INFO +75 -58
  23. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/setup.py +7 -1
  24. rpa_suite-1.5.3/rpa_suite/__init__.py +0 -65
  25. rpa_suite-1.5.3/rpa_suite/functions/__init__.py +0 -1
  26. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/LICENSE +0 -0
  27. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite/utils/__init__.py +0 -0
  28. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite.egg-info/SOURCES.txt +0 -0
  29. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite.egg-info/dependency_links.txt +0 -0
  30. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite.egg-info/requires.txt +0 -0
  31. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/rpa_suite.egg-info/top_level.txt +0 -0
  32. {rpa_suite-1.5.3 → rpa_suite-1.5.4}/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.4
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
 
@@ -55,19 +60,21 @@ Dynamic: summary
55
60
  [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
56
61
  [![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
57
62
 
58
-
59
63
  ## O que é?
64
+
60
65
  **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.
61
66
 
62
67
  <br>
63
68
 
64
69
  ## Documentação
70
+
65
71
  - **[Documentação no GitHub](https://github.com/CamiloCCarvalho/rpasuite/wiki)**
66
- Conta com guia de uso , instação e todas funcionalidades.
72
+ Conta com guia de uso , instação e todas funcionalidades.
67
73
 
68
74
  <br>
69
75
 
70
76
  ## Sumário
77
+
71
78
  - [O que é?](#o-que-é)
72
79
  - [Documentação](#documentação)
73
80
  - [Sumário do conteudo](#sumário-do-conteudo)
@@ -80,7 +87,6 @@ Conta com guia de uso , instação e todas funcionalidades.
80
87
  - [Release](#release)
81
88
  - [Mais Sobre](#mais-sobre)
82
89
 
83
-
84
90
  ## Destaque
85
91
 
86
92
  **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 +112,7 @@ Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o
106
112
  <br>
107
113
 
108
114
  ## Instalação
115
+
109
116
  Para **instalar** o projeto, utilize o comando:
110
117
 
111
118
  ```python
@@ -131,7 +138,6 @@ Feito isso já estará pronto para o uso:
131
138
  rpa.email.send_mail(...)
132
139
  ```
133
140
 
134
-
135
141
  > **⚠️ IMPORTANTE:**
136
142
  > Para **desinstalar** o projeto, utilize o comando abaixo:
137
143
  >
@@ -150,7 +156,6 @@ rpa.email.send_mail(...)
150
156
 
151
157
  <br>
152
158
 
153
-
154
159
  ## Exemplo
155
160
 
156
161
  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 +173,7 @@ rpa.clock.wait_for_exec(time, my_function, param1, param2)
168
173
  # Usando submódulo email para envio de email por SMTP comum
169
174
  rpa.email.send_smtp(...)
170
175
  ```
176
+
171
177
  <br>
172
178
 
173
179
  ## Dependências
@@ -188,7 +194,6 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
188
194
  - selenium
189
195
  - webdriver_manager
190
196
 
191
-
192
197
  <br>
193
198
  <hr>
194
199
  <br>
@@ -205,73 +210,85 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
205
210
  - **rpa_suite**
206
211
 
207
212
  **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
-
213
+
214
+ - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
215
+ - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
216
+ - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
217
+
212
218
  **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
-
219
+
220
+ - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
221
+ - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
222
+
216
223
  **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
-
224
+
225
+ - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
226
+
219
227
  **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
-
228
+
229
+ - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
230
+ - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
231
+ - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
232
+ - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
233
+
225
234
  **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
-
235
+
236
+ - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
237
+ - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
238
+
229
239
  **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.
240
+
241
+ - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
242
+ - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
243
+ - **log_debug** - Função para registrar logs em nível de depuração.
244
+ - **log_info** - Função para registrar logs em nível informativo.
245
+ - **log_warning** - Função para registrar logs em nível de aviso.
246
+ - **log_error** - Função para registrar logs em nível de erro.
247
+ - **log_critical** - Função para registrar logs em nível crítico.
237
248
 
238
249
  **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
-
250
+
251
+ - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
252
+ - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
253
+ - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
254
+ - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
255
+
244
256
  **regex**
245
- - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
246
-
257
+
258
+ - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
259
+
247
260
  **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
-
261
+
262
+ - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
263
+ - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
264
+
251
265
  **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
-
266
+
267
+ - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
268
+ - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
269
+ - **get** - Função para navegar para URLs específicas.
270
+ - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
271
+
257
272
  **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
-
273
+
274
+ - **run** - Função para iniciar um processo em paralelo.
275
+ - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
276
+ - **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.
277
+ - **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".
278
+
263
279
  **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.
280
+
281
+ - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
282
+ - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
283
+ - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
284
+ - **cancel** - Função para cancelar a tarefa assíncrona em execução.
268
285
 
269
286
  ## Release Notes
270
287
 
271
- ### Versão: **Beta 1.5.3**
288
+ ### Versão: **Beta 1.5.4**
272
289
 
273
290
  - **Data de Lançamento:** *20/02/2024*
274
- - **Última Atualização:** *17/04/2025*
291
+ - **Última Atualização:** 21/04/2025
275
292
  - **Status:** Em desenvolvimento
276
293
 
277
294
  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 +312,6 @@ Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo m
295
312
  Para mais informações, visite os links abaixo:
296
313
 
297
314
  - **[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.
315
+ Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
299
316
  - **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
300
317
  Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
@@ -15,19 +15,21 @@
15
15
  [![License MIT](https://img.shields.io/github/license/docling-project/docling)](https://opensource.org/licenses/MIT)
16
16
  [![rpa-suite Actor](https://apify.com/actor-badge?actor=camiloccarvalho/rpasuite?fpr=rpa-suite)](https://apify.com/camiloccarvalho/rpasuite)
17
17
 
18
-
19
18
  ## O que é?
19
+
20
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.
21
21
 
22
22
  <br>
23
23
 
24
24
  ## Documentação
25
+
25
26
  - **[Documentação no GitHub](https://github.com/CamiloCCarvalho/rpasuite/wiki)**
26
- Conta com guia de uso , instação e todas funcionalidades.
27
+ Conta com guia de uso , instação e todas funcionalidades.
27
28
 
28
29
  <br>
29
30
 
30
31
  ## Sumário
32
+
31
33
  - [O que é?](#o-que-é)
32
34
  - [Documentação](#documentação)
33
35
  - [Sumário do conteudo](#sumário-do-conteudo)
@@ -40,7 +42,6 @@ Conta com guia de uso , instação e todas funcionalidades.
40
42
  - [Release](#release)
41
43
  - [Mais Sobre](#mais-sobre)
42
44
 
43
-
44
45
  ## Destaque
45
46
 
46
47
  **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 +67,7 @@ Nosso objetivo é se tornar a Biblioteca Python para RPA referência. Tornando o
66
67
  <br>
67
68
 
68
69
  ## Instalação
70
+
69
71
  Para **instalar** o projeto, utilize o comando:
70
72
 
71
73
  ```python
@@ -91,7 +93,6 @@ Feito isso já estará pronto para o uso:
91
93
  rpa.email.send_mail(...)
92
94
  ```
93
95
 
94
-
95
96
  > **⚠️ IMPORTANTE:**
96
97
  > Para **desinstalar** o projeto, utilize o comando abaixo:
97
98
  >
@@ -110,7 +111,6 @@ rpa.email.send_mail(...)
110
111
 
111
112
  <br>
112
113
 
113
-
114
114
  ## Exemplo
115
115
 
116
116
  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 +128,7 @@ rpa.clock.wait_for_exec(time, my_function, param1, param2)
128
128
  # Usando submódulo email para envio de email por SMTP comum
129
129
  rpa.email.send_smtp(...)
130
130
  ```
131
+
131
132
  <br>
132
133
 
133
134
  ## Dependências
@@ -148,7 +149,6 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
148
149
  - selenium
149
150
  - webdriver_manager
150
151
 
151
-
152
152
  <br>
153
153
  <hr>
154
154
  <br>
@@ -165,73 +165,85 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
165
165
  - **rpa_suite**
166
166
 
167
167
  **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
-
168
+
169
+ - **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
170
+ - **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
171
+ - **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
172
+
172
173
  **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
-
174
+
175
+ - **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
176
+ - **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
177
+
176
178
  **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
-
179
+
180
+ - **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
181
+
179
182
  **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
-
183
+
184
+ - **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
185
+ - **flag_create** - Função para criar arquivos de flag indicando execução de processos.
186
+ - **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
187
+ - **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
188
+
185
189
  **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
-
190
+
191
+ - **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
192
+ - **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
193
+
189
194
  **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.
195
+
196
+ - **config_logger** - Função para configurar logs com suporte a arquivos e streams, utilizando a biblioteca Loguru.
197
+ - **log_start_run_debug** - Função para registrar logs de início de execução em nível de depuração.
198
+ - **log_debug** - Função para registrar logs em nível de depuração.
199
+ - **log_info** - Função para registrar logs em nível informativo.
200
+ - **log_warning** - Função para registrar logs em nível de aviso.
201
+ - **log_error** - Função para registrar logs em nível de erro.
202
+ - **log_critical** - Função para registrar logs em nível crítico.
197
203
 
198
204
  **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
-
205
+
206
+ - **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
207
+ - **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
208
+ - **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
209
+ - **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
210
+
204
211
  **regex**
205
- - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
206
-
212
+
213
+ - **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
214
+
207
215
  **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
-
216
+
217
+ - **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
218
+ - **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
219
+
211
220
  **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
-
221
+
222
+ - **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
223
+ - **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
224
+ - **get** - Função para navegar para URLs específicas.
225
+ - **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
226
+
217
227
  **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
-
228
+
229
+ - **run** - Função para iniciar um processo em paralelo.
230
+ - **is_running** - Função para capturar o status atual do processo que esta rodando em paralelo.
231
+ - **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.
232
+ - **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".
233
+
223
234
  **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.
235
+
236
+ - **run** - Função para iniciar a execução assíncrona de uma função mantendo o fluxo principal da aplicação.
237
+ - **is_running** - Função para verificar se a tarefa assíncrona ainda está em execução.
238
+ - **get_result** - Função para obter o resultado da execução assíncrona, incluindo tempo de execução e status, com suporte a timeout.
239
+ - **cancel** - Função para cancelar a tarefa assíncrona em execução.
228
240
 
229
241
  ## Release Notes
230
242
 
231
- ### Versão: **Beta 1.5.3**
243
+ ### Versão: **Beta 1.5.4**
232
244
 
233
245
  - **Data de Lançamento:** *20/02/2024*
234
- - **Última Atualização:** *17/04/2025*
246
+ - **Última Atualização:** 21/04/2025
235
247
  - **Status:** Em desenvolvimento
236
248
 
237
249
  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 +267,6 @@ Esta versão marca um grande avanço no desenvolvimento da RPA Suite, trazendo m
255
267
  Para mais informações, visite os links abaixo:
256
268
 
257
269
  - **[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.
270
+ Explore o código-fonte, contribua com melhorias e acompanhe o desenvolvimento do projeto.
259
271
  - **[Página no PyPI](https://pypi.org/project/rpa-suite/)**
260
272
  Confira a documentação oficial, instale a biblioteca e veja as versões disponíveis.
@@ -0,0 +1,66 @@
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
+ # allows importing the rpa_suite module without the package name
64
+ from .suite import rpa
65
+
66
+ rpa
@@ -36,11 +36,12 @@ 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