Coleção de scripts Python para automação e otimização de sistemas de desenvolvimento
Funcionalidades • Instalação • Documentação • Roadmap • Contribuindo
Utils Python Scripts é uma coleção crescente de ferramentas Python desenvolvidas para automatizar tarefas comuns de gerenciamento de sistema e desenvolvimento. O projeto iniciou com a versão 1.0 com dois scripts essenciais (Backup e Cleaning), e agora inclui a Parte 1/3 do Personal Utils Bundle com mais dois utilitários multiplataforma (Gerador de Senhas e Gerador de Username).
Cada script é cuidadosamente desenvolvido com foco em:
- ✨ Simplicidade de uso - Interfaces intuitivas e documentadas
- 🔒 Segurança - Modos preview e confirmações antes de operações destrutivas
- 📚 Documentação completa - Cada script possui documentação técnica detalhada
- 🚀 Performance - Otimizado para lidar com grandes volumes de dados
- 🔧 Extensibilidade - Código modular e bem estruturado para futuras expansões
Script de backup com suporte a múltiplos formatos e gerenciamento inteligente de versões.
Características principais:
- 🗜️ Compressão em múltiplos formatos (tar.gz, zip)
- 🎯 Exclusão inteligente de arquivos (node_modules, caches, builds)
- 📊 Estatísticas detalhadas e progresso em tempo real
- 🔐 Verificação de integridade com hash MD5
- 📑 Índice JSON para rastreamento de todos os backups
- 🧹 Limpeza automática de backups antigos
- 🔄 Sistema de restauração interativo
- 🎨 Detecção automática de tipo de projeto
# Exemplo de uso
python3 backup/script.py -d /projeto --formato tar
python3 backup/script.py --listar-backups
python3 backup/script.py --limpar-antigosFerramenta de limpeza inteligente para liberar espaço em disco removendo arquivos desnecessários.
Características principais:
- 📦 Remoção de node_modules antigos (>30 dias)
- 🗂️ Limpeza de arquivos temporários (*.tmp, *.bak, etc.)
- 💾 Remoção de caches de build (.next, dist, pycache)
- 📋 Limpeza de logs antigos (>7 dias)
- 👁️ Modo preview seguro (mostra antes de remover)
- 📊 Relatórios detalhados com estimativa de espaço
- ⚡ Performance otimizada para grandes diretórios
- 🎯 Limpeza seletiva ou completa
# Exemplo de uso
python3 cleaning/script.py # Modo preview
python3 cleaning/script.py --ex # Executa limpeza
python3 cleaning/script.py --a-n # Apenas node_modules
python3 cleaning/script.py --ex --c # Limpeza completaPacote de utilitários pessoais para uso diário - Primeira parte de três.
🌍 Multiplataforma: Estes utilitários são 100% multiplataforma (Linux, macOS, Windows), usando apenas Python puro!
Ferramenta para criar senhas seguras e personalizáveis através de linha de comando.
Características principais:
- 🔒 Geração de senhas alfanuméricas seguras
- 🎨 Opção de incluir símbolos especiais (!@#$%&*)
- 📏 Tamanho personalizável (padrão: 12 caracteres)
- 🔢 Gerar múltiplas senhas de uma vez
- ⚡ Interface simples de linha de comando
- 🎯 Zero dependências externas
# Exemplos de uso
python3 Personal-utils-bundle/gerarSenha/script.py
python3 Personal-utils-bundle/gerarSenha/script.py -t 16 -q 5
python3 Personal-utils-bundle/gerarSenha/script.py --tamanho 20 --sem-simbolosCrie usernames criativos e estilosos utilizando a API do Google Gemini.
Características principais:
- 🤖 Geração inteligente com IA (Google Gemini)
- 🎨 Usernames únicos com símbolos especiais
- 🎲 Modo aleatório ou baseado em nome
- 💡 Variedade criativa sem código complexo
- 🌐 Interface interativa de linha de comando
- 🔑 Configuração simples via variável de ambiente
# Exemplos de uso
python3 Personal-utils-bundle/gerarUsername/script.py
# O script apresentará um menu interativoRequisito: API Key do Google Gemini (gratuita)
📖 Documentação Completa
- Python 3.6 ou superior
- Sistema operacional: Linux (testado em Arch-based)
📝 Nota: Os scripts atuais foram desenvolvidos para Linux. Alguns paths (como
~/Área de trabalho) podem precisar ser ajustados conforme sua configuração específica.
git clone https://github.com/montezuma-p/utils-python-scripts.git
cd utils-python-scriptsNão há dependências externas! Todos os scripts utilizam apenas bibliotecas padrão do Python.
# Backup
python3 backup/script.py --help
# Limpeza
python3 cleaning/script.py --helpPara executar os scripts de qualquer lugar:
# Linux/macOS
echo 'export PATH="$PATH:$HOME/utils-python-scripts/backup"' >> ~/.bashrc
echo 'export PATH="$PATH:$HOME/utils-python-scripts/cleaning"' >> ~/.bashrc
source ~/.bashrc
# Agora pode executar:
script.py --helpCada script possui documentação técnica completa e detalhada:
| Script | Documentação |
|---|---|
| Backup | DOCUMENTACAO_TECNICA.md |
| Cleaning | DOCUMENTACAO_TECNICA.md |
| Gerador de Senhas | DOCUMENTACAO_TECNICA.md |
| Gerador de Username | DOCUMENTACAO_TECNICA.md |
A documentação técnica cobre:
- 🏗️ Arquitetura e design do código
- 🔧 Explicação detalhada de cada componente
- 💡 Casos de uso práticos
- 🛠️ Sugestões de modificação e extensão
⚠️ Limitações conhecidas- 📖 Boas práticas de uso
Continuação do pacote de utilitários pessoais.
✅ Parte 1/3 Lançada: Gerador de Senhas e Gerador de Username já disponíveis!
🚧 Em Breve: Mais utilitários multiplataforma serão adicionados nas partes 2 e 3.
Uma coleção de ferramentas individuais para tarefas cotidianas. Cada utilitário é independente e pode ser usado separadamente ou em conjunto.
Script de monitoramento de sistema com outputs simplificados e legíveis.
Transformará comandos complexos de monitoramento em visualizações bonitas e fáceis de interpretar.
| Componente | Requisito Mínimo | Recomendado |
|---|---|---|
| Python | 3.6+ | 3.9+ |
| RAM | 512 MB | 2 GB |
| Espaço em Disco | 100 MB | 1 GB |
| OS | Linux | Arch-based Linux |
⚠️ Nota sobre Compatibilidade:
Os scripts atuais (Backup e Cleaning) foram desenvolvidos e testados em Linux (Arch-based).
Devem funcionar em outras distribuições Linux, mas alguns paths podem precisar de ajustes conforme a configuração do usuário (ex:~/Área de trabalhovs~/Desktop).
Suporte para Windows e macOS não foi testado na v1.0.
Contribuições são muito bem-vindas! Este projeto está em constante evolução.
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/NovaFuncionalidade) - Commit suas mudanças (
git commit -m 'Adiciona nova funcionalidade') - Push para a branch (
git push origin feature/NovaFuncionalidade) - Abra um Pull Request
- ✅ Mantenha o código limpo e documentado
- ✅ Adicione testes quando apropriado
- ✅ Atualize a documentação técnica
- ✅ Siga o estilo de código existente
- ✅ Use apenas bibliotecas padrão do Python (quando possível)
Encontrou um bug? Abra uma issue com:
- Descrição clara do problema
- Passos para reproduzir
- Comportamento esperado vs obtido
- Versão do Python e sistema operacional
- Logs de erro (se aplicável)
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.
Pedro Montezuma Loureiro
- GitHub: @montezuma-p
- Email: pedromontezumaloureiro@gmail.com
- Comunidade Python pela excelente linguagem e ecossistema
- Todos os contribuidores que ajudam a melhorar este projeto
- Você, por usar e apoiar este projeto! ⭐
⭐ Se este projeto foi útil para você, considere dar uma estrela! ⭐
Desenvolvido com ❤️ para a comunidade de desenvolvedores