utils-global 0.1.0__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-0.1.0/PKG-INFO +195 -0
- utils_global-0.1.0/README.md +179 -0
- utils_global-0.1.0/automacao_utils/__init__.py +40 -0
- utils_global-0.1.0/automacao_utils/download_utils.py +562 -0
- utils_global-0.1.0/automacao_utils/mover_arquivo_utils.py +129 -0
- utils_global-0.1.0/automacao_utils/notificacao_utils.py +64 -0
- utils_global-0.1.0/automacao_utils/selenium_utils.py +17 -0
- utils_global-0.1.0/automacao_utils/version_check.py +141 -0
- utils_global-0.1.0/pyproject.toml +12 -0
- utils_global-0.1.0/setup.cfg +4 -0
- utils_global-0.1.0/setup.py +35 -0
- utils_global-0.1.0/utils_global.egg-info/PKG-INFO +195 -0
- utils_global-0.1.0/utils_global.egg-info/SOURCES.txt +14 -0
- utils_global-0.1.0/utils_global.egg-info/dependency_links.txt +1 -0
- utils_global-0.1.0/utils_global.egg-info/requires.txt +4 -0
- utils_global-0.1.0/utils_global.egg-info/top_level.txt +1 -0
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: utils-global
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Add your description here
|
|
5
|
+
Author: Gedean Zitkoski, Gabriel Pelizzari
|
|
6
|
+
Author-email: gedezitkoski@gmail.com, gpelizzari08@gmail.com
|
|
7
|
+
Requires-Python: >=3.7
|
|
8
|
+
Description-Content-Type: text/markdown
|
|
9
|
+
Requires-Dist: build>=1.2.2.post1
|
|
10
|
+
Requires-Dist: psutil>=7.0.0
|
|
11
|
+
Requires-Dist: seleniumbase>=4.38.2
|
|
12
|
+
Requires-Dist: watchdog>=6.0.0
|
|
13
|
+
Dynamic: author
|
|
14
|
+
Dynamic: author-email
|
|
15
|
+
Dynamic: requires-python
|
|
16
|
+
|
|
17
|
+
# utils-global
|
|
18
|
+
|
|
19
|
+
Repositório com funções globais utilizadas em projetos com Python, focado em automações com Selenium.
|
|
20
|
+
|
|
21
|
+
## Sobre o Projeto
|
|
22
|
+
|
|
23
|
+
Esta biblioteca contém funções utilitárias para automações usando Selenium, com foco em:
|
|
24
|
+
- Gerenciamento de downloads de arquivos
|
|
25
|
+
- Verificação de arquivos em uso
|
|
26
|
+
- Renomeação segura de arquivos
|
|
27
|
+
- Tratamento de erros estruturado
|
|
28
|
+
- Interação com iframes em páginas complexas
|
|
29
|
+
- Envio de notificações para o Microsoft Teams
|
|
30
|
+
|
|
31
|
+
## Módulos Principais
|
|
32
|
+
|
|
33
|
+
- [download_utils](./automacao_utils/download_utils.md): Gerenciamento de downloads e tratamento de erros
|
|
34
|
+
- [selenium_utils](./automacao_utils/selenium_utils.md): Utilitários para interação com iframes no Selenium
|
|
35
|
+
- [notificacao_utils](./automacao_utils/notificacao_utils.md): Envio de notificações para o Microsoft Teams
|
|
36
|
+
- [mover_arquivo_utils](./automacao_utils/mover_arquivo_utils.md): Movimentação de arquivos entre diretórios com opções avançadas
|
|
37
|
+
|
|
38
|
+
Para mais detalhes sobre cada módulo, clique nos links acima para acessar a documentação específica.
|
|
39
|
+
|
|
40
|
+
## Instalação
|
|
41
|
+
|
|
42
|
+
### A partir do GitHub:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Para uma versão específica:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# Usando uma tag específica
|
|
52
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@v0.1.6
|
|
53
|
+
|
|
54
|
+
# Usando um commit específico
|
|
55
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@commit_hash
|
|
56
|
+
|
|
57
|
+
# Usando uma branch específica
|
|
58
|
+
pip install git+https://github.com/gabrielpelizzari/utils-global.git@develop
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Atualização:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
pip install --upgrade git+https://github.com/gabrielpelizzari/utils-global.git
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Em modo de desenvolvimento (edição local):
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Clone o repositório
|
|
71
|
+
git clone https://github.com/gabrielpelizzari/utils-global.git
|
|
72
|
+
cd utils-global
|
|
73
|
+
|
|
74
|
+
# Instale em modo editável
|
|
75
|
+
pip install -e .
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Exemplos Rápidos
|
|
79
|
+
|
|
80
|
+
### Processamento de Downloads
|
|
81
|
+
|
|
82
|
+
```python
|
|
83
|
+
from automacao_utils import processar_download
|
|
84
|
+
|
|
85
|
+
# Download de um arquivo
|
|
86
|
+
caminho_arquivo = processar_download(
|
|
87
|
+
sb=sb, # instância do SeleniumBase
|
|
88
|
+
dir_download="C:/Downloads",
|
|
89
|
+
btn_download="#botao_download",
|
|
90
|
+
nome_arquivo="relatorio_mensal"
|
|
91
|
+
)
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### Verificação de Arquivos em Uso
|
|
95
|
+
|
|
96
|
+
```python
|
|
97
|
+
from automacao_utils import is_file_in_use, wait_for_file_access
|
|
98
|
+
|
|
99
|
+
# Verificar se arquivo está em uso
|
|
100
|
+
if is_file_in_use("C:/Downloads/arquivo.pdf"):
|
|
101
|
+
print("O arquivo está sendo usado por outro processo")
|
|
102
|
+
|
|
103
|
+
# Aguardar liberação do arquivo
|
|
104
|
+
wait_for_file_access("C:/Downloads/arquivo.pdf", max_retries=30)
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### Movimentação de Arquivos
|
|
108
|
+
|
|
109
|
+
```python
|
|
110
|
+
from automacao_utils import mover_arquivo
|
|
111
|
+
|
|
112
|
+
# Mover um arquivo para outro diretório
|
|
113
|
+
arquivos_movidos = mover_arquivo(
|
|
114
|
+
diretorio_origem="C:/Downloads/documento.pdf",
|
|
115
|
+
diretorio_destino="C:/Documentos/Importantes"
|
|
116
|
+
)
|
|
117
|
+
|
|
118
|
+
# Mover todos os arquivos de um diretório (com renomeação automática se já existirem)
|
|
119
|
+
arquivos_movidos = mover_arquivo(
|
|
120
|
+
diretorio_origem="C:/Downloads/Relatórios",
|
|
121
|
+
diretorio_destino="C:/Trabalho/Relatórios",
|
|
122
|
+
substituir=False
|
|
123
|
+
)
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Dependências
|
|
127
|
+
|
|
128
|
+
- seleniumbase: Para automação web
|
|
129
|
+
- watchdog: Para monitoramento de arquivos
|
|
130
|
+
- psutil: Para gerenciamento de processos
|
|
131
|
+
- requests: Para verificação de versões
|
|
132
|
+
|
|
133
|
+
## Contribuição
|
|
134
|
+
|
|
135
|
+
Para contribuir com este projeto:
|
|
136
|
+
1. Faça um fork do repositório
|
|
137
|
+
2. Crie uma branch para sua feature (`git checkout -b feature/nova-funcionalidade`)
|
|
138
|
+
3. Faça commit das mudanças (`git commit -m 'Adiciona nova funcionalidade'`)
|
|
139
|
+
4. Faça push para a branch (`git push origin feature/nova-funcionalidade`)
|
|
140
|
+
5. Abra um Pull Request
|
|
141
|
+
|
|
142
|
+
## Autores
|
|
143
|
+
|
|
144
|
+
- Gabriel Pelizzari
|
|
145
|
+
- Gedean Zitkoski
|
|
146
|
+
|
|
147
|
+
## Versão
|
|
148
|
+
|
|
149
|
+
Versão atual: 1.8.2
|
|
150
|
+
|
|
151
|
+
## Histórico de Versões
|
|
152
|
+
|
|
153
|
+
### Novidades na Versão 1.8.2
|
|
154
|
+
|
|
155
|
+
- Testes validando o pypi
|
|
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
|
|
@@ -0,0 +1,179 @@
|
|
|
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.2
|
|
134
|
+
|
|
135
|
+
## Histórico de Versões
|
|
136
|
+
|
|
137
|
+
### Novidades na Versão 1.8.2
|
|
138
|
+
|
|
139
|
+
- Testes validando o pypi
|
|
140
|
+
|
|
141
|
+
### Novidades na Versão 1.8.1
|
|
142
|
+
|
|
143
|
+
- Ajustado para que a função processar_download o parâmetro de renomear: 'nome_arquivo' seja opcional
|
|
144
|
+
- Pequenos ajustes na função garantir_iframe para melhorar a robustez
|
|
145
|
+
|
|
146
|
+
### Novidades na Versão 1.8
|
|
147
|
+
|
|
148
|
+
- Adicionado parâmetro `btn_download_js` para permitir o uso de JavaScript para clicar no botão de download
|
|
149
|
+
|
|
150
|
+
### Novidades na Versão 1.7
|
|
151
|
+
|
|
152
|
+
- Adicionado suporte para renomear arquivos com extensão e tratamento de erros ao renomear arquivos com pontos antes da extensão
|
|
153
|
+
|
|
154
|
+
### Novidades na Versão 1.6
|
|
155
|
+
|
|
156
|
+
- Adicionado módulo `mover_arquivo_utils` para movimentação de arquivos entre diretórios com opções avançadas
|
|
157
|
+
- Documentação detalhada do novo módulo com exemplos de uso
|
|
158
|
+
|
|
159
|
+
### Novidades na Versão 1.5
|
|
160
|
+
|
|
161
|
+
- Adicionado módulo `selenium_utils` com função `garantir_iframe` para facilitar a interação com iframes
|
|
162
|
+
- Adicionado módulo `notificacao_utils` para envio de mensagens ao Microsoft Teams
|
|
163
|
+
- Aprimorado o gerenciamento de versão no pacote
|
|
164
|
+
- Melhorias na documentação com arquivos específicos para cada módulo
|
|
165
|
+
|
|
166
|
+
### Novidades na Versão 1.4
|
|
167
|
+
|
|
168
|
+
- Adicionado sistema automático de verificação de novas versões
|
|
169
|
+
- A biblioteca agora notifica o usuário quando há uma nova versão disponível
|
|
170
|
+
- Incluída função manual para verificar atualizações
|
|
171
|
+
- Adicionados tratamentos try/except em mais pontos para melhorar a robustez
|
|
172
|
+
|
|
173
|
+
### Novidades na Versão 1.3
|
|
174
|
+
|
|
175
|
+
- Melhorado tratamento de erros com suporte para múltiplos seletores
|
|
176
|
+
- Adicionado atributo `elemento_visivel` na classe `DownloadErroException` para identificar qual seletor específico foi encontrado
|
|
177
|
+
- Simplificada a API para permitir uso de string única ou lista de seletores
|
|
178
|
+
- Adicionados tratamentos try/except para captura do texto de elementos de erro
|
|
179
|
+
- Atualizada a documentação e exemplos de uso
|
|
@@ -0,0 +1,40 @@
|
|
|
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.2"
|
|
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
|
+
|
|
32
|
+
# Verificação de versão ao importar
|
|
33
|
+
try:
|
|
34
|
+
from automacao_utils.version_check import verificar_versao_mais_recente
|
|
35
|
+
verificar_versao_mais_recente(__version__)
|
|
36
|
+
except ImportError:
|
|
37
|
+
pass
|
|
38
|
+
|
|
39
|
+
# Funções públicas de verificação de versão
|
|
40
|
+
from automacao_utils.version_check import mostrar_ultima_versao
|