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.
@@ -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