utils-global 1.10.0

Biblioteca de funções úteis para automações com Selenium. Fornece utilitários para manipulação de arquivos, downloads e interações com Selenium.

utils-global

Repositório com funções globais utilizadas em projetos com Python, focado em automações com Selenium.

Sobre o Projeto

Esta biblioteca contém funções utilitárias para automações usando Selenium, com foco em:

• Gerenciamento de downloads de arquivos
• Verificação de arquivos em uso
• Renomeação segura de arquivos
• Tratamento de erros estruturado
• Interação com iframes em páginas complexas
• Envio de notificações para o Microsoft Teams

Módulos Principais

• download_utils: Gerenciamento de downloads e tratamento de erros
• selenium_utils: Utilitários para interação com iframes no Selenium
• notificacao_utils: Envio de notificações para o Microsoft Teams
• mover_arquivo_utils: Movimentação de arquivos entre diretórios com opções avançadas

Para mais detalhes sobre cada módulo, clique nos links acima para acessar a documentação específica.

Instalação

pip install utils-global
uv add utils-global

Atualização:

pip install --upgrade utils-global
uv add utils-global

Em modo de desenvolvimento (edição local):

# Clone o repositório
git clone https://github.com/gabrielpelizzari/utils-global.git
cd utils-global

# Instale em modo editável
pip install -e .
uv add -e .

Dependências

• seleniumbase: Para automação web
• watchdog: Para monitoramento de arquivos
• psutil: Para gerenciamento de processos
• requests: Para verificação de versões

Contribuição

Para contribuir com este projeto:

1. Faça um fork do repositório
2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
3. Faça commit das mudanças (git commit -m 'Adiciona nova funcionalidade')
4. Faça push para a branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

Autores

• Gabriel Pelizzari
• Gedean Zitkoski

Histórico de Versões

Novidades na versão 1.10.0

• Atualizado o envio de mensagens do Microsoft Teams para o formato aceito por webhooks do Teams Workflows/Power Automate.
• A função enviar_msg_teams agora trata qualquer resposta HTTP 2xx como sucesso, incluindo 202 Accepted.
• Adicionado timeout e retorno booleano para facilitar diagnósticos em automações consumidoras.
• Declarada a dependência direta de requests.

Novidades na versão 1.8.2 - 1.8.8

• Publicado no PyPi
• Agora o projeto pode ser instalado usando o comando: pip install utils-global ou poetry add utils-global
• Ajustado a documentação para refletir as mudanças

Novidades na Versão 1.8.1

• Ajustado para que a função processar_download o parâmetro de renomear: 'nome_arquivo' seja opcional
• Pequenos ajustes na função garantir_iframe para melhorar a robustez

Novidades na Versão 1.8

• Adicionado parâmetro btn_download_js para permitir o uso de JavaScript para clicar no botão de download

Novidades na Versão 1.7

• Adicionado suporte para renomear arquivos com extensão e tratamento de erros ao renomear arquivos com pontos antes da extensão

Novidades na Versão 1.6

• Adicionado módulo mover_arquivo_utils para movimentação de arquivos entre diretórios com opções avançadas
• Documentação detalhada do novo módulo com exemplos de uso

Novidades na Versão 1.5

• Adicionado módulo selenium_utils com função garantir_iframe para facilitar a interação com iframes
• Adicionado módulo notificacao_utils para envio de mensagens ao Microsoft Teams
• Aprimorado o gerenciamento de versão no pacote
• Melhorias na documentação com arquivos específicos para cada módulo

Novidades na Versão 1.4

• Adicionado sistema automático de verificação de novas versões
• A biblioteca agora notifica o usuário quando há uma nova versão disponível
• Incluída função manual para verificar atualizações
• Adicionados tratamentos try/except em mais pontos para melhorar a robustez

Novidades na Versão 1.3

• Melhorado tratamento de erros com suporte para múltiplos seletores
• Adicionado atributo elemento_visivel na classe DownloadErroException para identificar qual seletor específico foi encontrado
• Simplificada a API para permitir uso de string única ou lista de seletores
• Adicionados tratamentos try/except para captura do texto de elementos de erro
• Atualizada a documentação e exemplos de uso