utils-global 1.8.1__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.
- utils_global-1.8.1/PKG-INFO +196 -0
- utils_global-1.8.1/README.md +175 -0
- utils_global-1.8.1/automacao_utils/README.md +29 -0
- utils_global-1.8.1/automacao_utils/__init__.py +31 -0
- utils_global-1.8.1/automacao_utils/download_utils.md +197 -0
- utils_global-1.8.1/automacao_utils/download_utils.py +562 -0
- utils_global-1.8.1/automacao_utils/mover_arquivo_utils.md +70 -0
- utils_global-1.8.1/automacao_utils/mover_arquivo_utils.py +129 -0
- utils_global-1.8.1/automacao_utils/notificacao_utils.md +52 -0
- utils_global-1.8.1/automacao_utils/notificacao_utils.py +64 -0
- utils_global-1.8.1/automacao_utils/selenium_utils.md +40 -0
- utils_global-1.8.1/automacao_utils/selenium_utils.py +17 -0
- utils_global-1.8.1/pyproject.toml +28 -0
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: utils-global
|
|
3
|
+
Version: 1.8.1
|
|
4
|
+
Summary: Repositório com funções globais utilizadas em projetos com Python, focado em automações com Selenium.
|
|
5
|
+
Home-page: https://github.com/gabrielpelizzari/utils_global
|
|
6
|
+
License: MIT
|
|
7
|
+
Keywords: utils,globals
|
|
8
|
+
Author: Gabriel Pelizzari
|
|
9
|
+
Author-email: gpelizzari08@gmail.com
|
|
10
|
+
Requires-Python: >=3.12,<4.0
|
|
11
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
14
|
+
Requires-Dist: psutil (>=7.0.0,<8.0.0)
|
|
15
|
+
Requires-Dist: requests (>=2.32.3,<3.0.0)
|
|
16
|
+
Requires-Dist: seleniumbase (>=4.37.10,<5.0.0)
|
|
17
|
+
Requires-Dist: watchdog (>=6.0.0,<7.0.0)
|
|
18
|
+
Project-URL: Repository, https://github.com/gabrielpelizzari/utils_global
|
|
19
|
+
Description-Content-Type: text/markdown
|
|
20
|
+
|
|
21
|
+
# utils-global
|
|
22
|
+
|
|
23
|
+
Repositório com funções globais utilizadas em projetos com Python, focado em automações com Selenium.
|
|
24
|
+
|
|
25
|
+
## Sobre o Projeto
|
|
26
|
+
|
|
27
|
+
Esta biblioteca contém funções utilitárias para automações usando Selenium, com foco em:
|
|
28
|
+
- Gerenciamento de downloads de arquivos
|
|
29
|
+
- Verificação de arquivos em uso
|
|
30
|
+
- Renomeação segura de arquivos
|
|
31
|
+
- Tratamento de erros estruturado
|
|
32
|
+
- Interação com iframes em páginas complexas
|
|
33
|
+
- Envio de notificações para o Microsoft Teams
|
|
34
|
+
|
|
35
|
+
## Módulos Principais
|
|
36
|
+
|
|
37
|
+
- [download_utils](./automacao_utils/download_utils.md): Gerenciamento de downloads e tratamento de erros
|
|
38
|
+
- [selenium_utils](./automacao_utils/selenium_utils.md): Utilitários para interação com iframes no Selenium
|
|
39
|
+
- [notificacao_utils](./automacao_utils/notificacao_utils.md): Envio de notificações para o Microsoft Teams
|
|
40
|
+
- [mover_arquivo_utils](./automacao_utils/mover_arquivo_utils.md): Movimentação de arquivos entre diretórios com opções avançadas
|
|
41
|
+
|
|
42
|
+
Para mais detalhes sobre cada módulo, clique nos links acima para acessar a documentação específica.
|
|
43
|
+
|
|
44
|
+
## Instalação
|
|
45
|
+
|
|
46
|
+
### A partir do GitHub:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### Para uma versão específica:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
# Usando uma tag específica
|
|
56
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@v0.1.6
|
|
57
|
+
|
|
58
|
+
# Usando um commit específico
|
|
59
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@commit_hash
|
|
60
|
+
|
|
61
|
+
# Usando uma branch específica
|
|
62
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@develop
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Atualização:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
pip install --upgrade git+https://github.com/gabrielpelizzari/utils-global.git
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Em modo de desenvolvimento (edição local):
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
# Clone o repositório
|
|
75
|
+
git clone https://github.com/gabrielpelizzari/utils-global.git
|
|
76
|
+
cd utils-global
|
|
77
|
+
|
|
78
|
+
# Instale em modo editável
|
|
79
|
+
pip install -e .
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Exemplos Rápidos
|
|
83
|
+
|
|
84
|
+
### Processamento de Downloads
|
|
85
|
+
|
|
86
|
+
```python
|
|
87
|
+
from automacao_utils import processar_download
|
|
88
|
+
|
|
89
|
+
# Download de um arquivo
|
|
90
|
+
caminho_arquivo = processar_download(
|
|
91
|
+
sb=sb, # instância do SeleniumBase
|
|
92
|
+
dir_download="C:/Downloads",
|
|
93
|
+
btn_download="#botao_download",
|
|
94
|
+
nome_arquivo="relatorio_mensal"
|
|
95
|
+
)
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Verificação de Arquivos em Uso
|
|
99
|
+
|
|
100
|
+
```python
|
|
101
|
+
from automacao_utils import is_file_in_use, wait_for_file_access
|
|
102
|
+
|
|
103
|
+
# Verificar se arquivo está em uso
|
|
104
|
+
if is_file_in_use("C:/Downloads/arquivo.pdf"):
|
|
105
|
+
print("O arquivo está sendo usado por outro processo")
|
|
106
|
+
|
|
107
|
+
# Aguardar liberação do arquivo
|
|
108
|
+
wait_for_file_access("C:/Downloads/arquivo.pdf", max_retries=30)
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Movimentação de Arquivos
|
|
112
|
+
|
|
113
|
+
```python
|
|
114
|
+
from automacao_utils import mover_arquivo
|
|
115
|
+
|
|
116
|
+
# Mover um arquivo para outro diretório
|
|
117
|
+
arquivos_movidos = mover_arquivo(
|
|
118
|
+
diretorio_origem="C:/Downloads/documento.pdf",
|
|
119
|
+
diretorio_destino="C:/Documentos/Importantes"
|
|
120
|
+
)
|
|
121
|
+
|
|
122
|
+
# Mover todos os arquivos de um diretório (com renomeação automática se já existirem)
|
|
123
|
+
arquivos_movidos = mover_arquivo(
|
|
124
|
+
diretorio_origem="C:/Downloads/Relatórios",
|
|
125
|
+
diretorio_destino="C:/Trabalho/Relatórios",
|
|
126
|
+
substituir=False
|
|
127
|
+
)
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## Dependências
|
|
131
|
+
|
|
132
|
+
- seleniumbase: Para automação web
|
|
133
|
+
- watchdog: Para monitoramento de arquivos
|
|
134
|
+
- psutil: Para gerenciamento de processos
|
|
135
|
+
- requests: Para verificação de versões
|
|
136
|
+
|
|
137
|
+
## Contribuição
|
|
138
|
+
|
|
139
|
+
Para contribuir com este projeto:
|
|
140
|
+
1. Faça um fork do repositório
|
|
141
|
+
2. Crie uma branch para sua feature (`git checkout -b feature/nova-funcionalidade`)
|
|
142
|
+
3. Faça commit das mudanças (`git commit -m 'Adiciona nova funcionalidade'`)
|
|
143
|
+
4. Faça push para a branch (`git push origin feature/nova-funcionalidade`)
|
|
144
|
+
5. Abra um Pull Request
|
|
145
|
+
|
|
146
|
+
## Autores
|
|
147
|
+
|
|
148
|
+
- Gabriel Pelizzari
|
|
149
|
+
- Gedean Zitkoski
|
|
150
|
+
|
|
151
|
+
## Versão
|
|
152
|
+
|
|
153
|
+
Versão atual: 1.8.1
|
|
154
|
+
|
|
155
|
+
## Histórico de Versões
|
|
156
|
+
|
|
157
|
+
### Novidades na Versão 1.8.1
|
|
158
|
+
|
|
159
|
+
- Ajustado para que a função processar_download o parâmetro de renomear: 'nome_arquivo' seja opcional
|
|
160
|
+
- Pequenos ajustes na função garantir_iframe para melhorar a robustez
|
|
161
|
+
|
|
162
|
+
### Novidades na Versão 1.8
|
|
163
|
+
|
|
164
|
+
- Adicionado parâmetro `btn_download_js` para permitir o uso de JavaScript para clicar no botão de download
|
|
165
|
+
|
|
166
|
+
### Novidades na Versão 1.7
|
|
167
|
+
|
|
168
|
+
- Adicionado suporte para renomear arquivos com extensão e tratamento de erros ao renomear arquivos com pontos antes da extensão
|
|
169
|
+
|
|
170
|
+
### Novidades na Versão 1.6
|
|
171
|
+
|
|
172
|
+
- Adicionado módulo `mover_arquivo_utils` para movimentação de arquivos entre diretórios com opções avançadas
|
|
173
|
+
- Documentação detalhada do novo módulo com exemplos de uso
|
|
174
|
+
|
|
175
|
+
### Novidades na Versão 1.5
|
|
176
|
+
|
|
177
|
+
- Adicionado módulo `selenium_utils` com função `garantir_iframe` para facilitar a interação com iframes
|
|
178
|
+
- Adicionado módulo `notificacao_utils` para envio de mensagens ao Microsoft Teams
|
|
179
|
+
- Aprimorado o gerenciamento de versão no pacote
|
|
180
|
+
- Melhorias na documentação com arquivos específicos para cada módulo
|
|
181
|
+
|
|
182
|
+
### Novidades na Versão 1.4
|
|
183
|
+
|
|
184
|
+
- Adicionado sistema automático de verificação de novas versões
|
|
185
|
+
- A biblioteca agora notifica o usuário quando há uma nova versão disponível
|
|
186
|
+
- Incluída função manual para verificar atualizações
|
|
187
|
+
- Adicionados tratamentos try/except em mais pontos para melhorar a robustez
|
|
188
|
+
|
|
189
|
+
### Novidades na Versão 1.3
|
|
190
|
+
|
|
191
|
+
- Melhorado tratamento de erros com suporte para múltiplos seletores
|
|
192
|
+
- Adicionado atributo `elemento_visivel` na classe `DownloadErroException` para identificar qual seletor específico foi encontrado
|
|
193
|
+
- Simplificada a API para permitir uso de string única ou lista de seletores
|
|
194
|
+
- Adicionados tratamentos try/except para captura do texto de elementos de erro
|
|
195
|
+
- Atualizada a documentação e exemplos de uso
|
|
196
|
+
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
# utils-global
|
|
2
|
+
|
|
3
|
+
Repositório com funções globais utilizadas em projetos com Python, focado em automações com Selenium.
|
|
4
|
+
|
|
5
|
+
## Sobre o Projeto
|
|
6
|
+
|
|
7
|
+
Esta biblioteca contém funções utilitárias para automações usando Selenium, com foco em:
|
|
8
|
+
- Gerenciamento de downloads de arquivos
|
|
9
|
+
- Verificação de arquivos em uso
|
|
10
|
+
- Renomeação segura de arquivos
|
|
11
|
+
- Tratamento de erros estruturado
|
|
12
|
+
- Interação com iframes em páginas complexas
|
|
13
|
+
- Envio de notificações para o Microsoft Teams
|
|
14
|
+
|
|
15
|
+
## Módulos Principais
|
|
16
|
+
|
|
17
|
+
- [download_utils](./automacao_utils/download_utils.md): Gerenciamento de downloads e tratamento de erros
|
|
18
|
+
- [selenium_utils](./automacao_utils/selenium_utils.md): Utilitários para interação com iframes no Selenium
|
|
19
|
+
- [notificacao_utils](./automacao_utils/notificacao_utils.md): Envio de notificações para o Microsoft Teams
|
|
20
|
+
- [mover_arquivo_utils](./automacao_utils/mover_arquivo_utils.md): Movimentação de arquivos entre diretórios com opções avançadas
|
|
21
|
+
|
|
22
|
+
Para mais detalhes sobre cada módulo, clique nos links acima para acessar a documentação específica.
|
|
23
|
+
|
|
24
|
+
## Instalação
|
|
25
|
+
|
|
26
|
+
### A partir do GitHub:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Para uma versão específica:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# Usando uma tag específica
|
|
36
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@v0.1.6
|
|
37
|
+
|
|
38
|
+
# Usando um commit específico
|
|
39
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@commit_hash
|
|
40
|
+
|
|
41
|
+
# Usando uma branch específica
|
|
42
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@develop
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Atualização:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
pip install --upgrade git+https://github.com/gabrielpelizzari/utils-global.git
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Em modo de desenvolvimento (edição local):
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
# Clone o repositório
|
|
55
|
+
git clone https://github.com/gabrielpelizzari/utils-global.git
|
|
56
|
+
cd utils-global
|
|
57
|
+
|
|
58
|
+
# Instale em modo editável
|
|
59
|
+
pip install -e .
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Exemplos Rápidos
|
|
63
|
+
|
|
64
|
+
### Processamento de Downloads
|
|
65
|
+
|
|
66
|
+
```python
|
|
67
|
+
from automacao_utils import processar_download
|
|
68
|
+
|
|
69
|
+
# Download de um arquivo
|
|
70
|
+
caminho_arquivo = processar_download(
|
|
71
|
+
sb=sb, # instância do SeleniumBase
|
|
72
|
+
dir_download="C:/Downloads",
|
|
73
|
+
btn_download="#botao_download",
|
|
74
|
+
nome_arquivo="relatorio_mensal"
|
|
75
|
+
)
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Verificação de Arquivos em Uso
|
|
79
|
+
|
|
80
|
+
```python
|
|
81
|
+
from automacao_utils import is_file_in_use, wait_for_file_access
|
|
82
|
+
|
|
83
|
+
# Verificar se arquivo está em uso
|
|
84
|
+
if is_file_in_use("C:/Downloads/arquivo.pdf"):
|
|
85
|
+
print("O arquivo está sendo usado por outro processo")
|
|
86
|
+
|
|
87
|
+
# Aguardar liberação do arquivo
|
|
88
|
+
wait_for_file_access("C:/Downloads/arquivo.pdf", max_retries=30)
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### Movimentação de Arquivos
|
|
92
|
+
|
|
93
|
+
```python
|
|
94
|
+
from automacao_utils import mover_arquivo
|
|
95
|
+
|
|
96
|
+
# Mover um arquivo para outro diretório
|
|
97
|
+
arquivos_movidos = mover_arquivo(
|
|
98
|
+
diretorio_origem="C:/Downloads/documento.pdf",
|
|
99
|
+
diretorio_destino="C:/Documentos/Importantes"
|
|
100
|
+
)
|
|
101
|
+
|
|
102
|
+
# Mover todos os arquivos de um diretório (com renomeação automática se já existirem)
|
|
103
|
+
arquivos_movidos = mover_arquivo(
|
|
104
|
+
diretorio_origem="C:/Downloads/Relatórios",
|
|
105
|
+
diretorio_destino="C:/Trabalho/Relatórios",
|
|
106
|
+
substituir=False
|
|
107
|
+
)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## Dependências
|
|
111
|
+
|
|
112
|
+
- seleniumbase: Para automação web
|
|
113
|
+
- watchdog: Para monitoramento de arquivos
|
|
114
|
+
- psutil: Para gerenciamento de processos
|
|
115
|
+
- requests: Para verificação de versões
|
|
116
|
+
|
|
117
|
+
## Contribuição
|
|
118
|
+
|
|
119
|
+
Para contribuir com este projeto:
|
|
120
|
+
1. Faça um fork do repositório
|
|
121
|
+
2. Crie uma branch para sua feature (`git checkout -b feature/nova-funcionalidade`)
|
|
122
|
+
3. Faça commit das mudanças (`git commit -m 'Adiciona nova funcionalidade'`)
|
|
123
|
+
4. Faça push para a branch (`git push origin feature/nova-funcionalidade`)
|
|
124
|
+
5. Abra um Pull Request
|
|
125
|
+
|
|
126
|
+
## Autores
|
|
127
|
+
|
|
128
|
+
- Gabriel Pelizzari
|
|
129
|
+
- Gedean Zitkoski
|
|
130
|
+
|
|
131
|
+
## Versão
|
|
132
|
+
|
|
133
|
+
Versão atual: 1.8.1
|
|
134
|
+
|
|
135
|
+
## Histórico de Versões
|
|
136
|
+
|
|
137
|
+
### Novidades na Versão 1.8.1
|
|
138
|
+
|
|
139
|
+
- Ajustado para que a função processar_download o parâmetro de renomear: 'nome_arquivo' seja opcional
|
|
140
|
+
- Pequenos ajustes na função garantir_iframe para melhorar a robustez
|
|
141
|
+
|
|
142
|
+
### Novidades na Versão 1.8
|
|
143
|
+
|
|
144
|
+
- Adicionado parâmetro `btn_download_js` para permitir o uso de JavaScript para clicar no botão de download
|
|
145
|
+
|
|
146
|
+
### Novidades na Versão 1.7
|
|
147
|
+
|
|
148
|
+
- Adicionado suporte para renomear arquivos com extensão e tratamento de erros ao renomear arquivos com pontos antes da extensão
|
|
149
|
+
|
|
150
|
+
### Novidades na Versão 1.6
|
|
151
|
+
|
|
152
|
+
- Adicionado módulo `mover_arquivo_utils` para movimentação de arquivos entre diretórios com opções avançadas
|
|
153
|
+
- Documentação detalhada do novo módulo com exemplos de uso
|
|
154
|
+
|
|
155
|
+
### Novidades na Versão 1.5
|
|
156
|
+
|
|
157
|
+
- Adicionado módulo `selenium_utils` com função `garantir_iframe` para facilitar a interação com iframes
|
|
158
|
+
- Adicionado módulo `notificacao_utils` para envio de mensagens ao Microsoft Teams
|
|
159
|
+
- Aprimorado o gerenciamento de versão no pacote
|
|
160
|
+
- Melhorias na documentação com arquivos específicos para cada módulo
|
|
161
|
+
|
|
162
|
+
### Novidades na Versão 1.4
|
|
163
|
+
|
|
164
|
+
- Adicionado sistema automático de verificação de novas versões
|
|
165
|
+
- A biblioteca agora notifica o usuário quando há uma nova versão disponível
|
|
166
|
+
- Incluída função manual para verificar atualizações
|
|
167
|
+
- Adicionados tratamentos try/except em mais pontos para melhorar a robustez
|
|
168
|
+
|
|
169
|
+
### Novidades na Versão 1.3
|
|
170
|
+
|
|
171
|
+
- Melhorado tratamento de erros com suporte para múltiplos seletores
|
|
172
|
+
- Adicionado atributo `elemento_visivel` na classe `DownloadErroException` para identificar qual seletor específico foi encontrado
|
|
173
|
+
- Simplificada a API para permitir uso de string única ou lista de seletores
|
|
174
|
+
- Adicionados tratamentos try/except para captura do texto de elementos de erro
|
|
175
|
+
- Atualizada a documentação e exemplos de uso
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Pacote automacao_utils
|
|
2
|
+
|
|
3
|
+
Este pacote contém módulos utilitários para automações baseadas em Selenium, facilitando operações comuns como downloads de arquivos, verificação de arquivos em uso, e detecção de erros.
|
|
4
|
+
|
|
5
|
+
## Módulos Disponíveis
|
|
6
|
+
|
|
7
|
+
- [download_utils](./download_utils.md): Funções para gerenciamento de downloads e tratamento de erros
|
|
8
|
+
- [version_check](./version_check.md): Sistema de verificação de versões da biblioteca
|
|
9
|
+
- [selenium_utils](./selenium_utils.md): Utilitários para interação com iframes no Selenium
|
|
10
|
+
- [notificacao_utils](./notificacao_utils.md): Envio de notificações para o Microsoft Teams
|
|
11
|
+
|
|
12
|
+
## Importação
|
|
13
|
+
|
|
14
|
+
```python
|
|
15
|
+
# Importação básica
|
|
16
|
+
from automacao_utils import processar_download, DownloadErroException
|
|
17
|
+
|
|
18
|
+
# Importação específica
|
|
19
|
+
from automacao_utils.download_utils import renomear_arquivo, limpar_nome_arquivo
|
|
20
|
+
from automacao_utils.version_check import mostrar_ultima_versao
|
|
21
|
+
from automacao_utils.selenium_utils import garantir_iframe
|
|
22
|
+
from automacao_utils.notificacao_utils import enviar_msg_teams
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Versão Atual
|
|
26
|
+
|
|
27
|
+
A versão atual do pacote é `1.8.1`.
|
|
28
|
+
|
|
29
|
+
Para mais detalhes sobre cada módulo, consulte a documentação específica nos links acima.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Biblioteca de funções úteis para automações com Selenium.
|
|
3
|
+
Fornece utilitários para manipulação de arquivos, downloads e interações com Selenium.
|
|
4
|
+
"""
|
|
5
|
+
|
|
6
|
+
# Versão do pacote
|
|
7
|
+
__version__ = "1.8.1"
|
|
8
|
+
|
|
9
|
+
# Funções de Download
|
|
10
|
+
from automacao_utils.download_utils import (
|
|
11
|
+
processar_download,
|
|
12
|
+
iniciar_monitoramento,
|
|
13
|
+
aguardar_download,
|
|
14
|
+
aguardar_carregamento,
|
|
15
|
+
renomear_arquivo,
|
|
16
|
+
is_file_in_use,
|
|
17
|
+
wait_for_file_access,
|
|
18
|
+
is_temp_file_growing,
|
|
19
|
+
limpar_nome_arquivo,
|
|
20
|
+
DownloadErroException
|
|
21
|
+
)
|
|
22
|
+
|
|
23
|
+
# Funções de Selenium
|
|
24
|
+
from automacao_utils.selenium_utils import garantir_iframe
|
|
25
|
+
|
|
26
|
+
# Funções de Notificações
|
|
27
|
+
from automacao_utils.notificacao_utils import enviar_msg_teams
|
|
28
|
+
|
|
29
|
+
# Funções de Movimentação de Arquivos
|
|
30
|
+
from automacao_utils.mover_arquivo_utils import mover_arquivo
|
|
31
|
+
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
# Módulo download_utils
|
|
2
|
+
|
|
3
|
+
Este módulo contém funções para gerenciamento de downloads e tratamento de erros em automações Selenium.
|
|
4
|
+
|
|
5
|
+
## Classes
|
|
6
|
+
|
|
7
|
+
### DownloadErroException
|
|
8
|
+
|
|
9
|
+
Exceção personalizada para erros durante o processo de download.
|
|
10
|
+
|
|
11
|
+
```python
|
|
12
|
+
class DownloadErroException(Exception):
|
|
13
|
+
def __init__(self, mensagem, seletor_erro=None, codigo_erro="DESCONHECIDO", elemento_visivel=None):
|
|
14
|
+
super().__init__(mensagem)
|
|
15
|
+
self.mensagem = mensagem
|
|
16
|
+
self.seletor_erro = seletor_erro
|
|
17
|
+
self.codigo_erro = codigo_erro
|
|
18
|
+
self.elemento_visivel = elemento_visivel
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**Atributos:**
|
|
22
|
+
- `mensagem`: Mensagem detalhada do erro
|
|
23
|
+
- `seletor_erro`: Seletor(es) que foram passados como parâmetro na função (pode ser uma lista)
|
|
24
|
+
- `codigo_erro`: Código do erro (ex: "ELEMENTO", "TIMEOUT")
|
|
25
|
+
- `elemento_visivel`: Seletor específico que estava visível (quando há múltiplos seletores)
|
|
26
|
+
|
|
27
|
+
## Funções Principais
|
|
28
|
+
|
|
29
|
+
### processar_download
|
|
30
|
+
|
|
31
|
+
```python
|
|
32
|
+
def processar_download(sb, dir_download, btn_download, nome_arquivo, seletor_carregamento=None,
|
|
33
|
+
seletores_erro=None):
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Processa o download de um arquivo, incluindo clique no botão, aguardo do download e tratamento de erros.
|
|
37
|
+
|
|
38
|
+
**Parâmetros:**
|
|
39
|
+
- `sb`: Instância do SeleniumBase
|
|
40
|
+
- `dir_download`: Diretório onde o arquivo será baixado
|
|
41
|
+
- `btn_download`: Seletor CSS do botão de download
|
|
42
|
+
- `nome_arquivo`: Nome a ser dado ao arquivo
|
|
43
|
+
- `seletor_carregamento`: Seletor CSS para indicador de carregamento (opcional)
|
|
44
|
+
- `seletores_erro`: Seletor(es) CSS para mensagens de erro (string ou lista)
|
|
45
|
+
|
|
46
|
+
**Retorno:**
|
|
47
|
+
- Caminho completo para o arquivo baixado
|
|
48
|
+
|
|
49
|
+
### aguardar_download
|
|
50
|
+
|
|
51
|
+
```python
|
|
52
|
+
def aguardar_download(sb, dir_download, handler, observer, seletores_erro=None, tempo_max_espera=180, intervalo=1):
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Aguarda o download de um arquivo ser concluído e retorna o caminho do arquivo.
|
|
56
|
+
|
|
57
|
+
**Parâmetros:**
|
|
58
|
+
- `sb`: Instância do SeleniumBase
|
|
59
|
+
- `dir_download`: Diretório onde o arquivo será baixado
|
|
60
|
+
- `handler`: Instância do manipulador de eventos de arquivo
|
|
61
|
+
- `observer`: Instância do observador de diretório
|
|
62
|
+
- `seletores_erro`: Seletor(es) CSS para mensagens de erro (string ou lista)
|
|
63
|
+
- `tempo_max_espera`: Tempo máximo de espera em segundos
|
|
64
|
+
- `intervalo`: Intervalo entre verificações em segundos
|
|
65
|
+
|
|
66
|
+
**Retorno:**
|
|
67
|
+
- Caminho completo para o arquivo baixado
|
|
68
|
+
|
|
69
|
+
**Exceções:**
|
|
70
|
+
- `DownloadErroException`: Quando ocorre um erro durante o download
|
|
71
|
+
- Exceções genéricas
|
|
72
|
+
|
|
73
|
+
### aguardar_carregamento
|
|
74
|
+
|
|
75
|
+
```python
|
|
76
|
+
def aguardar_carregamento(sb, seletor):
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Aguarda até que um elemento de carregamento desapareça ou apareça.
|
|
80
|
+
|
|
81
|
+
**Parâmetros:**
|
|
82
|
+
- `sb`: Instância do SeleniumBase
|
|
83
|
+
- `seletor`: Seletor CSS do elemento de carregamento
|
|
84
|
+
|
|
85
|
+
### renomear_arquivo
|
|
86
|
+
|
|
87
|
+
```python
|
|
88
|
+
def renomear_arquivo(caminho_arquivo, novo_nome):
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
Renomeia um arquivo de forma segura, aguardando caso o arquivo esteja em uso.
|
|
92
|
+
|
|
93
|
+
**Parâmetros:**
|
|
94
|
+
- `caminho_arquivo`: Caminho do arquivo a ser renomeado
|
|
95
|
+
- `novo_nome`: Novo nome para o arquivo (sem extensão)
|
|
96
|
+
|
|
97
|
+
**Retorno:**
|
|
98
|
+
- Caminho do arquivo renomeado
|
|
99
|
+
|
|
100
|
+
## Funções Auxiliares
|
|
101
|
+
|
|
102
|
+
### is_file_in_use
|
|
103
|
+
|
|
104
|
+
```python
|
|
105
|
+
def is_file_in_use(filepath):
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Verifica se um arquivo está em uso por outro processo.
|
|
109
|
+
|
|
110
|
+
**Parâmetros:**
|
|
111
|
+
- `filepath`: Caminho do arquivo a verificar
|
|
112
|
+
|
|
113
|
+
**Retorno:**
|
|
114
|
+
- `True` se o arquivo estiver em uso, `False` caso contrário
|
|
115
|
+
|
|
116
|
+
### wait_for_file_access
|
|
117
|
+
|
|
118
|
+
```python
|
|
119
|
+
def wait_for_file_access(filepath, max_retries=30, retry_interval=1):
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Aguarda até que um arquivo esteja disponível para acesso.
|
|
123
|
+
|
|
124
|
+
**Parâmetros:**
|
|
125
|
+
- `filepath`: Caminho do arquivo a verificar
|
|
126
|
+
- `max_retries`: Número máximo de tentativas
|
|
127
|
+
- `retry_interval`: Intervalo entre tentativas em segundos
|
|
128
|
+
|
|
129
|
+
**Retorno:**
|
|
130
|
+
- `True` se o arquivo estiver disponível, `False` se o timeout for atingido
|
|
131
|
+
|
|
132
|
+
### limpar_nome_arquivo
|
|
133
|
+
|
|
134
|
+
```python
|
|
135
|
+
def limpar_nome_arquivo(nome):
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Remove caracteres inválidos para nomes de arquivos.
|
|
139
|
+
|
|
140
|
+
**Parâmetros:**
|
|
141
|
+
- `nome`: Nome a ser limpo
|
|
142
|
+
|
|
143
|
+
**Retorno:**
|
|
144
|
+
- Nome limpo, sem caracteres inválidos
|
|
145
|
+
|
|
146
|
+
## Exemplos de Uso
|
|
147
|
+
|
|
148
|
+
### Exemplo Básico
|
|
149
|
+
|
|
150
|
+
```python
|
|
151
|
+
from automacao_utils import processar_download
|
|
152
|
+
|
|
153
|
+
def baixar_relatorio(sb):
|
|
154
|
+
caminho_arquivo = processar_download(
|
|
155
|
+
sb=sb,
|
|
156
|
+
dir_download="C:/Downloads",
|
|
157
|
+
btn_download="#botao_download",
|
|
158
|
+
nome_arquivo="relatorio_mensal"
|
|
159
|
+
)
|
|
160
|
+
|
|
161
|
+
print(f"Arquivo baixado: {caminho_arquivo}")
|
|
162
|
+
return caminho_arquivo
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### Exemplo com Tratamento de Erros
|
|
166
|
+
|
|
167
|
+
```python
|
|
168
|
+
from automacao_utils import processar_download, DownloadErroException
|
|
169
|
+
|
|
170
|
+
def baixar_relatorio(sb):
|
|
171
|
+
try:
|
|
172
|
+
caminho_arquivo = processar_download(
|
|
173
|
+
sb=sb,
|
|
174
|
+
dir_download="C:/Downloads",
|
|
175
|
+
btn_download="#botao_download",
|
|
176
|
+
nome_arquivo="relatorio_mensal",
|
|
177
|
+
seletor_carregamento="#loader",
|
|
178
|
+
seletores_erro=["#mensagem_erro", "#outro_erro"]
|
|
179
|
+
)
|
|
180
|
+
|
|
181
|
+
print(f"Download concluído com sucesso: {caminho_arquivo}")
|
|
182
|
+
return caminho_arquivo
|
|
183
|
+
|
|
184
|
+
except DownloadErroException as e:
|
|
185
|
+
if e.codigo_erro == "ELEMENTO":
|
|
186
|
+
print(f"Erro: Elemento de erro detectado: {e.mensagem}")
|
|
187
|
+
|
|
188
|
+
# Identifica qual elemento específico foi encontrado
|
|
189
|
+
if e.elemento_visivel == "#mensagem_erro":
|
|
190
|
+
print("Erro de validação detectado")
|
|
191
|
+
elif e.elemento_visivel == "#outro_erro":
|
|
192
|
+
print("Outro tipo de erro encontrado")
|
|
193
|
+
else:
|
|
194
|
+
print(f"Erro desconhecido: {e.mensagem}")
|
|
195
|
+
|
|
196
|
+
return None
|
|
197
|
+
```
|