rpa-suite 1.4.2__py3-none-any.whl → 1.4.6__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.
- rpa_suite/__init__.py +4 -1
- rpa_suite/core/__init__.py +20 -3
- rpa_suite/core/browser.py +299 -0
- rpa_suite/core/clock.py +1 -1
- rpa_suite/core/file.py +1 -1
- rpa_suite/core/log.py +55 -381
- rpa_suite/suite.py +36 -22
- rpa_suite/utils/__init__.py +10 -0
- rpa_suite/utils/system.py +33 -0
- rpa_suite-1.4.6.dist-info/METADATA +244 -0
- {rpa_suite-1.4.2.dist-info → rpa_suite-1.4.6.dist-info}/RECORD +14 -11
- rpa_suite-1.4.2.dist-info/METADATA +0 -214
- {rpa_suite-1.4.2.dist-info → rpa_suite-1.4.6.dist-info}/WHEEL +0 -0
- {rpa_suite-1.4.2.dist-info → rpa_suite-1.4.6.dist-info}/licenses/LICENSE +0 -0
- {rpa_suite-1.4.2.dist-info → rpa_suite-1.4.6.dist-info}/top_level.txt +0 -0
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: rpa_suite
|
|
3
|
+
Version: 1.4.6
|
|
4
|
+
Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
|
|
5
|
+
Author: Camilo Costa de Carvalho
|
|
6
|
+
Author-email: camilo.carvalho@triasoftware.com.br
|
|
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
|
|
9
|
+
Classifier: Development Status :: 3 - Alpha
|
|
10
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
11
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
12
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Intended Audience :: Education
|
|
15
|
+
Classifier: Intended Audience :: Science/Research
|
|
16
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
17
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
18
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
19
|
+
Description-Content-Type: text/markdown
|
|
20
|
+
License-File: LICENSE
|
|
21
|
+
Requires-Dist: colorama
|
|
22
|
+
Requires-Dist: colorlog
|
|
23
|
+
Requires-Dist: email_validator
|
|
24
|
+
Requires-Dist: loguru
|
|
25
|
+
Requires-Dist: typing
|
|
26
|
+
Requires-Dist: pillow
|
|
27
|
+
Requires-Dist: pyautogui
|
|
28
|
+
Requires-Dist: requests
|
|
29
|
+
Dynamic: author
|
|
30
|
+
Dynamic: author-email
|
|
31
|
+
Dynamic: classifier
|
|
32
|
+
Dynamic: description
|
|
33
|
+
Dynamic: description-content-type
|
|
34
|
+
Dynamic: keywords
|
|
35
|
+
Dynamic: license
|
|
36
|
+
Dynamic: license-file
|
|
37
|
+
Dynamic: requires-dist
|
|
38
|
+
Dynamic: summary
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
<h1 align="left">
|
|
43
|
+
RPA Suite
|
|
44
|
+
</h1>
|
|
45
|
+
<br>
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## O que é?
|
|
53
|
+
|
|
54
|
+
**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.
|
|
55
|
+
|
|
56
|
+
## Sumário do conteudo
|
|
57
|
+
|
|
58
|
+
- [O que é?](#o-que-é)
|
|
59
|
+
- [Sumário do conteudo](#sumário-do-conteudo)
|
|
60
|
+
- [Destaque](#destaque)
|
|
61
|
+
- [Objetivo](#objetivo)
|
|
62
|
+
- [Instalação](#instalação)
|
|
63
|
+
- [Exemplo](#exemplo)
|
|
64
|
+
- [Dependências](#dependências)
|
|
65
|
+
- [Estrutura do módulo](#estrutura-do-módulo)
|
|
66
|
+
- [Release](#release)
|
|
67
|
+
- [Notas da atualização: 1.4.6](#notas-da-atualização-146)
|
|
68
|
+
- [Mais Sobre](#mais-sobre)
|
|
69
|
+
|
|
70
|
+
## Destaque
|
|
71
|
+
|
|
72
|
+
**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*.
|
|
73
|
+
|
|
74
|
+
**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.
|
|
75
|
+
|
|
76
|
+
## Objetivo
|
|
77
|
+
|
|
78
|
+
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:
|
|
79
|
+
|
|
80
|
+
- Envio de emails (já configurado e personalizavel)
|
|
81
|
+
- Validação de emails (limpeza e tratamento)
|
|
82
|
+
- Busca por palavras, strings ou substrings (patterns) em textos.
|
|
83
|
+
- Criação e deleção de pasta/arquivo temporário com um comando
|
|
84
|
+
- Console com mensagens de melhor visualização com cores definidas para alerta, erro, informativo e sucesso.
|
|
85
|
+
- E muito mais
|
|
86
|
+
|
|
87
|
+
## Instalação
|
|
88
|
+
|
|
89
|
+
Para **instalar** o projeto, utilize o comando:
|
|
90
|
+
|
|
91
|
+
```python
|
|
92
|
+
>>> python -m pip install rpa-suite
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
ou no conda:
|
|
96
|
+
|
|
97
|
+
```python
|
|
98
|
+
conda install -c conda-forge rpa-suite
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Após instalação basta fazer a importação do modulo rpa que ja tera um objeto instanciado de ``suite``:
|
|
102
|
+
|
|
103
|
+
```python
|
|
104
|
+
from rpa_suite import rpa
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Feito isso já estará pronto para o uso:
|
|
108
|
+
|
|
109
|
+
```python
|
|
110
|
+
# function send mail by SMTP
|
|
111
|
+
rpa.email.send_mail(...)
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
> [!NOTE]
|
|
115
|
+
>
|
|
116
|
+
> Para **desinstalar** o projeto, utilize o comando abaixo.
|
|
117
|
+
> **Obs.:** como usamos algumas libs no projeto, lembre-se de desinstar elas caso necessário.
|
|
118
|
+
|
|
119
|
+
```python
|
|
120
|
+
>>> python -m pip uninstall rpa-suite
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
> [!IMPORTANT]
|
|
124
|
+
>
|
|
125
|
+
> Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
|
|
126
|
+
|
|
127
|
+
```python
|
|
128
|
+
>>> python -m pip uninstall loguru mail_validator colorama pillow pyautogui
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Exemplo
|
|
132
|
+
|
|
133
|
+
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:
|
|
134
|
+
|
|
135
|
+
from rpa_suite import rpa
|
|
136
|
+
|
|
137
|
+
# Exemplo com função de execução em horario especifico
|
|
138
|
+
rpa.clock.exec_at_hour('13:53', my_function, param_a, param_b)
|
|
139
|
+
|
|
140
|
+
# Usando submódulo clock para aguardar 30(seg) para executar minha função
|
|
141
|
+
time = 30
|
|
142
|
+
rpa.clock.wait_for_exec(time, my_function, param1, param2)
|
|
143
|
+
|
|
144
|
+
# Usando submódulo email para envio de email por smtp comum
|
|
145
|
+
rpa.email.send_smtp(...)
|
|
146
|
+
|
|
147
|
+
## Dependências
|
|
148
|
+
|
|
149
|
+
No setup do nosso projeto já estão inclusas as dependências, só será necessário instalar nossa **Lib**, mas segue a lista das libs usadas:
|
|
150
|
+
|
|
151
|
+
- colorama
|
|
152
|
+
- loguru
|
|
153
|
+
- email-validator
|
|
154
|
+
- colorlog
|
|
155
|
+
- pillow
|
|
156
|
+
- pyautogui
|
|
157
|
+
- typing
|
|
158
|
+
|
|
159
|
+
opcionalmente para automação de navegador:
|
|
160
|
+
|
|
161
|
+
- selenium
|
|
162
|
+
- webdriver_manager
|
|
163
|
+
|
|
164
|
+
[!IMPORTANT]
|
|
165
|
+
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.
|
|
166
|
+
|
|
167
|
+
## Estrutura do módulo
|
|
168
|
+
|
|
169
|
+
O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a categoria:
|
|
170
|
+
|
|
171
|
+
- **rpa_suite**
|
|
172
|
+
- **clock**
|
|
173
|
+
- **exec_at_hour** - Função que executa uma função no horário especificado "xx:yy", permitindo agendamento de tarefas com precisão.
|
|
174
|
+
- **wait_for_exec** - Função que aguarda um tempo em segundos antes de executar a função passada como argumento.
|
|
175
|
+
- **exec_and_wait** - Função que executa uma função e, em seguida, aguarda um tempo em segundos antes de continuar.
|
|
176
|
+
- **date**
|
|
177
|
+
- **get_hms** - Função que retorna hora, minuto e segundo formatados como strings.
|
|
178
|
+
- **get_dmy** - Função que retorna dia, mês e ano formatados como strings.
|
|
179
|
+
- **email**
|
|
180
|
+
- **send_smtp** - Função para envio de emails via SMTP com suporte a anexos e mensagens HTML, configurável e personalizável.
|
|
181
|
+
- **file**
|
|
182
|
+
- **screen_shot** - Função para capturar screenshots, criando diretórios e arquivos com nomes e caminhos personalizáveis.
|
|
183
|
+
- **flag_create** - Função para criar arquivos de flag indicando execução de processos.
|
|
184
|
+
- **flag_delete** - Função para deletar arquivos de flag após a execução de processos.
|
|
185
|
+
- **count_files** - Função para contar arquivos em diretórios, com suporte a extensões específicas.
|
|
186
|
+
- **directory**
|
|
187
|
+
- **create_temp_dir** - Função para criar diretórios temporários com nomes e caminhos personalizáveis.
|
|
188
|
+
- **delete_temp_dir** - Função para deletar diretórios temporários, com opção de remover arquivos contidos.
|
|
189
|
+
- **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.
|
|
197
|
+
- **printer**
|
|
198
|
+
- **success_print** - Função para imprimir mensagens de sucesso com destaque em verde.
|
|
199
|
+
- **alert_print** - Função para imprimir mensagens de alerta com destaque em amarelo.
|
|
200
|
+
- **info_print** - Função para imprimir mensagens informativas com destaque em ciano.
|
|
201
|
+
- **error_print** - Função para imprimir mensagens de erro com destaque em vermelho.
|
|
202
|
+
- **regex**
|
|
203
|
+
- **check_pattern_in_text** - Função para verificar a presença de padrões em textos, com suporte a case-sensitive.
|
|
204
|
+
- **validate**
|
|
205
|
+
- **emails** - Função para validar listas de emails, retornando listas de emails válidos e inválidos.
|
|
206
|
+
- **word** - Função para buscar palavras ou padrões específicos em textos, com suporte a contagem de ocorrências.
|
|
207
|
+
- **browser**
|
|
208
|
+
- **start_browser** - Função para iniciar o navegador Chrome com suporte a depuração remota.
|
|
209
|
+
- **find_ele** - Função para localizar elementos na página utilizando estratégias de localização do Selenium.
|
|
210
|
+
- **get** - Função para navegar para URLs específicas.
|
|
211
|
+
- **close_browser** - Função para fechar o navegador e encerrar processos relacionados.
|
|
212
|
+
|
|
213
|
+
## Release
|
|
214
|
+
|
|
215
|
+
Versão: **Beta 1.4.6**
|
|
216
|
+
|
|
217
|
+
Lançamento: *20/02/2024*
|
|
218
|
+
|
|
219
|
+
Última atualização: *12/04/2025*
|
|
220
|
+
|
|
221
|
+
Status: Em desenvolvimento.
|
|
222
|
+
|
|
223
|
+
### Notas da atualização: 1.4.6
|
|
224
|
+
|
|
225
|
+
- 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
|
|
226
|
+
- 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
|
|
227
|
+
- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
|
|
228
|
+
- 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.*
|
|
229
|
+
- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
|
|
230
|
+
- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
|
|
231
|
+
- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
|
|
232
|
+
- 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()",
|
|
233
|
+
- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
|
|
234
|
+
- 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.
|
|
235
|
+
|
|
236
|
+
## Mais Sobre
|
|
237
|
+
|
|
238
|
+
Para mais informações, visite nosso projeto no Github ou PyPi:
|
|
239
|
+
|
|
240
|
+
[Ver no GitHub](https://github.com/CamiloCCarvalho/rpa_suite)
|
|
241
|
+
|
|
242
|
+
[Ver projeto publicado no PyPI](https://pypi.org/project/rpa-suite/)
|
|
243
|
+
|
|
244
|
+
<hr>
|
|
@@ -1,12 +1,13 @@
|
|
|
1
|
-
rpa_suite/__init__.py,sha256=
|
|
2
|
-
rpa_suite/suite.py,sha256=
|
|
3
|
-
rpa_suite/core/__init__.py,sha256=
|
|
4
|
-
rpa_suite/core/
|
|
1
|
+
rpa_suite/__init__.py,sha256=A6Y1CmdmN9ADAgmvhS8FNXmLNP5fQuyUuZBTm9AKdQo,2494
|
|
2
|
+
rpa_suite/suite.py,sha256=pCbceWTf9WM_xt0GSf_k7Xnk4w_qHKS1hLscYqV5Ga0,10280
|
|
3
|
+
rpa_suite/core/__init__.py,sha256=TJ-WlsgWTVQ-jc-n66K5ZrqJJeHfI27jXytQVcVHN3M,1640
|
|
4
|
+
rpa_suite/core/browser.py,sha256=E-yD2LgwaDVOwUBs09BBXQVx5tLZ7DMFee8LYvgLClY,14682
|
|
5
|
+
rpa_suite/core/clock.py,sha256=1QnlOLs9YCRIq-tMFfk9OgaoicKtCL9sBzJmJmz9m_w,13808
|
|
5
6
|
rpa_suite/core/date.py,sha256=PBU999Acxiwoep029ElqKSzK6T4DrF3eIP-LB_J-BbM,6568
|
|
6
7
|
rpa_suite/core/dir.py,sha256=y6YDyRYQdf9Bj0z3Gs6ugNZ0tKWYgWdDI5R5BjjRIEY,9783
|
|
7
8
|
rpa_suite/core/email.py,sha256=kQJAc6Nb9y7jo-oBAo8X1EZS2y-_gTJRoRc9ylS04CE,8675
|
|
8
|
-
rpa_suite/core/file.py,sha256=
|
|
9
|
-
rpa_suite/core/log.py,sha256=
|
|
9
|
+
rpa_suite/core/file.py,sha256=rgvXqq_uV3D5wsioL4kTy0cbKv0bNO35alSVup6veHk,11524
|
|
10
|
+
rpa_suite/core/log.py,sha256=xCAoXLxnG2bVzXIafULvW45I4-ljo296E4auU1CppYY,5537
|
|
10
11
|
rpa_suite/core/print.py,sha256=tLHIKo6LDTrV91gWKvwlTrxb1idgx3EV_fIRkqtzWBM,6389
|
|
11
12
|
rpa_suite/core/regex.py,sha256=wsTxe8-baKul2Fv1-fycXZ-DVa5krhkc9qMkP04giGs,3303
|
|
12
13
|
rpa_suite/core/validate.py,sha256=0HnCUgT19LPBMhKxIV_hOAoixpqM7TAL9EkC0S56DFc,10976
|
|
@@ -18,8 +19,10 @@ rpa_suite/functions/_logger.py,sha256=gTYO9JlbX5_jDfu_4FTTajJw3_GotE2BHUbDDB1Hf5
|
|
|
18
19
|
rpa_suite/functions/_printer.py,sha256=r72zeobAi2baVbYgbfFH0h5-WMv4tSDGPNlcpZen7O0,3949
|
|
19
20
|
rpa_suite/functions/_variables.py,sha256=vCcktifFUriBQTyUaayZW8BlE8Gr7VP-tFbfomKOS5U,312
|
|
20
21
|
rpa_suite/functions/_variables_uru.py,sha256=xRqYp49l1fFNrHczOmJ6Pqw1PKIWs0f9kxlgvuYGYys,303
|
|
21
|
-
rpa_suite
|
|
22
|
-
rpa_suite
|
|
23
|
-
rpa_suite-1.4.
|
|
24
|
-
rpa_suite-1.4.
|
|
25
|
-
rpa_suite-1.4.
|
|
22
|
+
rpa_suite/utils/__init__.py,sha256=f0qiYRZ7VzBarp1yNj91V0UMZG9QY2mgDXEbWvNZDYs,673
|
|
23
|
+
rpa_suite/utils/system.py,sha256=JIONQutSbNBkQIATcN1wC0NUE4ILlgVZ-TOnuoMPxHI,1055
|
|
24
|
+
rpa_suite-1.4.6.dist-info/licenses/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
|
|
25
|
+
rpa_suite-1.4.6.dist-info/METADATA,sha256=N-wf425WMZNyO6PcTVXcHboPh97H4dZNaAgjfijqplI,11828
|
|
26
|
+
rpa_suite-1.4.6.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
|
|
27
|
+
rpa_suite-1.4.6.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
|
|
28
|
+
rpa_suite-1.4.6.dist-info/RECORD,,
|
|
@@ -1,214 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: rpa_suite
|
|
3
|
-
Version: 1.4.2
|
|
4
|
-
Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
|
|
5
|
-
Author: Camilo Costa de Carvalho
|
|
6
|
-
Author-email: camilo.carvalho@triasoftware.com.br
|
|
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
|
|
9
|
-
Classifier: Development Status :: 3 - Alpha
|
|
10
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
11
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
12
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
13
|
-
Classifier: Intended Audience :: Developers
|
|
14
|
-
Classifier: Intended Audience :: Education
|
|
15
|
-
Classifier: Intended Audience :: Science/Research
|
|
16
|
-
Classifier: Operating System :: Microsoft :: Windows
|
|
17
|
-
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
18
|
-
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
19
|
-
Description-Content-Type: text/markdown
|
|
20
|
-
License-File: LICENSE
|
|
21
|
-
Requires-Dist: colorama
|
|
22
|
-
Requires-Dist: colorlog
|
|
23
|
-
Requires-Dist: email_validator
|
|
24
|
-
Requires-Dist: loguru
|
|
25
|
-
Requires-Dist: typing
|
|
26
|
-
Requires-Dist: pillow
|
|
27
|
-
Requires-Dist: pyautogui
|
|
28
|
-
Dynamic: author
|
|
29
|
-
Dynamic: author-email
|
|
30
|
-
Dynamic: classifier
|
|
31
|
-
Dynamic: description
|
|
32
|
-
Dynamic: description-content-type
|
|
33
|
-
Dynamic: keywords
|
|
34
|
-
Dynamic: license
|
|
35
|
-
Dynamic: license-file
|
|
36
|
-
Dynamic: requires-dist
|
|
37
|
-
Dynamic: summary
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
<h1 align="left">
|
|
42
|
-
RPA Suite
|
|
43
|
-
</h1>
|
|
44
|
-
<br>
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## O que é?
|
|
52
|
-
|
|
53
|
-
**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.
|
|
54
|
-
|
|
55
|
-
## Sumário do conteudo
|
|
56
|
-
|
|
57
|
-
- [Destaque](#destaque)
|
|
58
|
-
- [Objetivo](#objetivo)
|
|
59
|
-
- [Instalação](#instalação)
|
|
60
|
-
- [Exemplo](#exemplo)
|
|
61
|
-
- [Dependências](#dependências)
|
|
62
|
-
- [Estrutura do módulo](#estrutura-do-módulo)
|
|
63
|
-
- [Versão do projeto](#versão-do-projeto)
|
|
64
|
-
- [Mais Sobre](#mais-sobre)
|
|
65
|
-
|
|
66
|
-
## Destaque
|
|
67
|
-
|
|
68
|
-
**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*.
|
|
69
|
-
|
|
70
|
-
**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.
|
|
71
|
-
|
|
72
|
-
## Objetivo
|
|
73
|
-
|
|
74
|
-
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:
|
|
75
|
-
|
|
76
|
-
- Envio de emails (já configurado e personalizavel)
|
|
77
|
-
- Validação de emails (limpeza e tratamento)
|
|
78
|
-
- Busca por palavras, strings ou substrings (patterns) em textos.
|
|
79
|
-
- Criação e deleção de pasta/arquivo temporário com um comando
|
|
80
|
-
- Console com mensagens de melhor visualização com cores definidas para alerta, erro, informativo e sucesso.
|
|
81
|
-
- E muito mais
|
|
82
|
-
|
|
83
|
-
## Instalação
|
|
84
|
-
|
|
85
|
-
Para **instalar** o projeto, utilize o comando:
|
|
86
|
-
|
|
87
|
-
```python
|
|
88
|
-
>>> python -m pip install rpa-suite
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
ou no conda:
|
|
92
|
-
|
|
93
|
-
```python
|
|
94
|
-
conda install -c conda-forge rpa-suite
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
Após instalação basta fazer a importação do modulo e instanciar o Objeto ``suite``:
|
|
98
|
-
|
|
99
|
-
```python
|
|
100
|
-
from rpa_suite import suite as rpa
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
Feito isso já estará pronto para o uso:
|
|
104
|
-
|
|
105
|
-
```python
|
|
106
|
-
# function send mail by SMTP
|
|
107
|
-
rpa.send_mail(...)
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
> [!NOTE]
|
|
111
|
-
>
|
|
112
|
-
> Para **desinstalar** o projeto, utilize o comando abaixo.
|
|
113
|
-
> **Obs.:** como usamos algumas libs no projeto, lembre-se de desinstar elas caso necessário.
|
|
114
|
-
|
|
115
|
-
```python
|
|
116
|
-
>>> python -m pip uninstall rpa-suite
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
> [!IMPORTANT]
|
|
120
|
-
>
|
|
121
|
-
> Opcionalmente você pode querer desinstalar as libs que foram inclusas no projeto, sendo assim:
|
|
122
|
-
|
|
123
|
-
```python
|
|
124
|
-
>>> python -m pip uninstall loguru mail_validator colorama
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
## Exemplo
|
|
128
|
-
|
|
129
|
-
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:
|
|
130
|
-
|
|
131
|
-
from rpa_suite import suite as rpa
|
|
132
|
-
|
|
133
|
-
# Usando a função de envio de email por SMTP default
|
|
134
|
-
rpa.send_email(my_email, my_pass, mail_to, subject, message_body)
|
|
135
|
-
|
|
136
|
-
# Usando submódulo clock para aguardar 30 (seg) e então executar uma função
|
|
137
|
-
time = 30
|
|
138
|
-
rpa.wait_for_exec(time, my_function, param1, param2)
|
|
139
|
-
|
|
140
|
-
## Dependências
|
|
141
|
-
|
|
142
|
-
No setup do nosso projeto já estão inclusas as dependências, só será necessário instalar nossa **Lib**, mas segue a lista das libs usadas:
|
|
143
|
-
|
|
144
|
-
- colorama
|
|
145
|
-
- loguru
|
|
146
|
-
- email-validator
|
|
147
|
-
- colorlog
|
|
148
|
-
|
|
149
|
-
[!IMPORTANT]
|
|
150
|
-
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.
|
|
151
|
-
|
|
152
|
-
## Estrutura do módulo
|
|
153
|
-
|
|
154
|
-
O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
|
|
155
|
-
|
|
156
|
-
- **rpa_suite**
|
|
157
|
-
- **clock**
|
|
158
|
-
- **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
|
|
159
|
-
- **exec_at** - Função capaz de executar a função do argumento no horario especificado "xx:yy" parecido com scheduler, porem com a vantagem de ter o horario como variavel dentro do escopo de código podendo gerar variações pela propria natureza da aplicação
|
|
160
|
-
- **date**
|
|
161
|
-
- **date** - Funções capazes de extrair dia/mes/ano e hora/min/seg, facilitando a necessidade de formatar o resultado de datetime, a função ja devolve os valores em trio formatados em string
|
|
162
|
-
- **email**
|
|
163
|
-
- **sender_smtp** - Funções para envio de email SMPT com configuração simples já default porem personalizavel
|
|
164
|
-
- **file**
|
|
165
|
-
- **counter** - Funções para contagem de arquivos
|
|
166
|
-
- **temp_dir** - Funções para diretórios temporários
|
|
167
|
-
- **screen_shot** - Função para criar diretório e arquivo de print com nome do diretório, arquivo e delay personalizáveis
|
|
168
|
-
- **file_flag** - Funções para criar e deletar arquivo utilizado como flag de execução, tendo path e nome do arquivo já automatico porem personalizavel para se adequar ao seu projeto
|
|
169
|
-
- **log**
|
|
170
|
-
- **logger_uru** - Instanciador de stream e handlefile que cria na pasta raiz do arquivo chamador pasta de log e seta o stream para as funções de log
|
|
171
|
-
- **functions_logger_uru** - Funções de log parecida com os prints personalizados, setadas e personalizadas para todos log levels usado pelo ´logger_uru´, já escreve no arquivo setado além de gerar o print no terminal
|
|
172
|
-
- **printer** - Funções de print personalizados (alerta, erro, sucesso, informativo)
|
|
173
|
-
- **regex**
|
|
174
|
-
- **pattern_in_text** - Função para otimizar o uso mais comum de regex buscando padrões em um texto
|
|
175
|
-
- **validate**
|
|
176
|
-
- **mail_validator** - Função para validar lista de emails, devolvendo a lista com emails validos a partir da lista original
|
|
177
|
-
- **string_validator** - Função que valida presença de letras, palavras, e textos e possibilita contar as ocorrencias em uma string
|
|
178
|
-
|
|
179
|
-
## Release
|
|
180
|
-
|
|
181
|
-
Versão: **Beta 1.3.4**
|
|
182
|
-
|
|
183
|
-
Lançamento: *20/02/2024*
|
|
184
|
-
|
|
185
|
-
Última atualização: *10/11/2024*
|
|
186
|
-
|
|
187
|
-
Status: Em desenvolvimento.
|
|
188
|
-
|
|
189
|
-
### Notas da atualização: 1.4.2
|
|
190
|
-
|
|
191
|
-
- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
|
|
192
|
-
- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
|
|
193
|
-
- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
|
|
194
|
-
- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
|
|
195
|
-
- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
|
|
196
|
-
- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
|
|
197
|
-
- Funções de regex e busca em textos por strings e palavras atualizadas
|
|
198
|
-
- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
|
|
199
|
-
- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
|
|
200
|
-
- ajuste de cores no svg da logo rpa-suite
|
|
201
|
-
|
|
202
|
-
## Mais Sobre
|
|
203
|
-
|
|
204
|
-
Para mais informações, visite nosso projeto no Github ou PyPi:
|
|
205
|
-
`<br>`
|
|
206
|
-
`<a href='https://github.com/CamiloCCarvalho/rpa_suite' target='_blank'>`
|
|
207
|
-
Ver no GitHub.
|
|
208
|
-
`</a>`
|
|
209
|
-
`<br>`
|
|
210
|
-
`<a href='https://pypi.org/project/rpa-suite/' target='_blank'>`
|
|
211
|
-
Ver projeto publicado no PyPI.
|
|
212
|
-
`</a>`
|
|
213
|
-
|
|
214
|
-
<hr>
|
|
File without changes
|
|
File without changes
|
|
File without changes
|