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