📧 Cʟᴇᴀʀ Eᴍᴀɪʟ

Um aplicativo Python para limpeza automática de e-mails via IMAP com interface interativa.

🌟 Funcionalidades

• ✅ Exclusão por data específica - Remove e-mails de uma data determinada (ex: 25/12/2023)
• ✅ Exclusão por período - Remove e-mails entre duas datas específicas
• ✅ Exclusão por antiguidade - Remove e-mails anteriores a uma data específica
• ✅ Exclusão por novidade - Remove e-mails posteriores a uma data específica
• ✅ Exclusão por mês/ano - Remove e-mails de um mês específico em um ano
• ✅ Exclusão por ano específico - Remove e-mails de um ano determinado
• ✅ Exclusão completa - Remove todos os e-mails da caixa de entrada
• ✅ Interface de usuário - Menu amigável com opções
• ✅ Suporte a múltiplos provedores - Gmail, Outlook, Yahoo e outros
• ✅ Progresso em tempo real - Acompanhe o processo de exclusão
• ✅ Confirmação de segurança - Evita exclusões acidentais
• ✅ Estrutura modular - Código modular e organizado

🚀 Instalação

1. Clone o repositório

git clone https://github.com/lucasrodriguescunha/clear-email.git
cd clear-email

2. Instale as dependências

pip install -r requirements.txt

3. Configure as variáveis de ambiente

Crie um arquivo .env na raiz do projeto:

EMAIL=[email protected]
PASSWORD=sua-senha-de-app

🔧 Configuração

Gmail

1. Habilite a verificação em duas etapas
2. Gere uma senha de app específica
3. Use a senha de app no arquivo .env

Outros provedores de email

Provedor	Servidor IMAP
Gmail	imap.gmail.com
Outlook/Hotmail	outlook.office365.com
Yahoo	imap.mail.yahoo.com
AOL	imap.aol.com

📖 Como usar

Execução básica

python main.py

Menu interativo

O que você deseja fazer?
[1] - Apagar e-mails de uma data específica
[2] - Apagar e-mails entre duas datas
[3] - Apagar e-mails anteriores a uma data
[4] - Apagar e-mails posteriores a uma data
[5] - Apagar e-mails de um mês/ano específico
[6] - Apagar e-mails de um ano específico
[7] - Apagar todos os e-mails
[0] - Sair

Exemplo de uso

1. Execute o programa
2. Escolha a opção desejada
3. Para opção 1: Digite a data no formato DD/MM/AAAA (ex: 25/12/2023)
4. Para opção 2: Digite a data inicial e final no formato DD/MM/AAAA
5. Para opção 3: Digite a data limite no formato DD/MM/AAAA (serão excluídos e-mails anteriores)
6. Para opção 4: Digite a data limite no formato DD/MM/AAAA (serão excluídos e-mails posteriores)
7. Para opção 5: Digite o mês (1-12) e o ano
8. Para opção 6: Digite o ano (ex: 2020)
9. Para opção 7: Digite "SIM" para confirmar
10. Acompanhe o progresso da exclusão

🏗️ Estrutura do Projeto

clear-email/
├── main.py                 # Arquivo principal com estrutura modular
├── requirements.txt        # Dependências
├── .env                   # Variáveis de ambiente (não versionado)
├── README.md              # Este arquivo
├── LICENSE                # Licença MIT
└── src/
    ├── config.py          # Configurações e variáveis de ambiente
    ├── imap_connection.py # Conexões IMAP
    ├── email_operations.py # Operações com e-mails
    └── user_interface.py  # Interface do usuário

🔧 Módulos

main.py

Arquivo principal com estrutura modular:

• initialize_connection() - Gerencia a conexão IMAP
• handle_single_date_operation() - Processa operações com uma única data
• handle_date_range_operation() - Processa operações com intervalo de datas
• handle_month_year_operation() - Processa operações com mês/ano
• handle_all_emails_operation() - Gerencia exclusão total
• process_user_choice() - Gerencia as escolhas do usuário
• Tratamento de erros e exceções
• Sistema de logout seguro

config.py

Gerencia configurações e variáveis de ambiente:

• Validação de credenciais
• Configuração padrão do servidor IMAP
• Classe Config para organizar settings

imap_connection.py

Funções para conexão IMAP:

• connect_imap() - Conecta ao servidor
• login_imap() - Autentica usuário
• logout_imap() - Desconecta do servidor

email_operations.py

Funções para manipulação de e-mails:

• fetch_emails_by_criteria() - Sistema unificado de busca por critérios
• convert_date() - Conversão padronizada de datas
• fetch_and_process_emails() - Processamento unificado de e-mails
• Funções específicas para cada tipo de operação
• Sistema robusto de tratamento de erros
• Constantes para mensagens e formatos

user_interface.py

Interface do usuário:

• get_user_choice() - Menu de opções
• get_year_from_user() - Solicita ano
• Funções de exibição de mensagens

⚠️ Avisos Importantes

• Backup seus e-mails antes de usar o programa
• Exclusões são permanentes - não podem ser desfeitas
• Use senhas de app específicas, não sua senha principal
• Teste primeiro com uma conta secundária

🔒 Segurança

• Nunca compartilhe seu arquivo .env
• Use senhas de app específicas
• Mantenha suas credenciais seguras
• O arquivo .env está no .gitignore

🎯 Melhorias Recentes

• ✨ Estrutura mais modular e organizada
• 🛡️ Tratamento robusto de erros
• 🔄 Sistema unificado de processamento
• 📅 Manipulação padronizada de datas
• 🎮 Interface de usuário mais intuitiva
• 🚀 Código mais eficiente e manutenível
• 🔍 Melhor rastreamento de operações
• 🛑 Sistema seguro de logout

🐛 Solução de Problemas

Erro de autenticação

• Verifique se a verificação em duas etapas está habilitada
• Confirme se está usando a senha de app correta
• Teste as credenciais em um cliente de email

Erro de conexão

• Verifique sua conexão com a internet
• Confirme o servidor IMAP correto
• Teste com diferentes provedores

E-mails não encontrados

• Verifique se o ano está correto
• Confirme se há e-mails na caixa de entrada
• Teste com diferentes filtros

📝 Exemplo de Saída

Conectando ao servidor IMAP: imap.gmail.com
Login realizado com sucesso!

O que você deseja fazer?
[1] - Apagar e-mails de uma data específica
[2] - Apagar e-mails entre duas datas
[3] - Apagar e-mails anteriores a uma data
[4] - Apagar e-mails posteriores a uma data
[5] - Apagar e-mails de um mês/ano específico
[6] - Apagar e-mails de um ano específico
[7] - Apagar todos os e-mails
[0] - Sair
Digite sua escolha (0, 1, 2, 3 ou 4): 1

Digite a data no formato DD/MM/AAAA (ex: 25/12/2023): 25/12/2023
100 de 1250 e-mails marcados para exclusão...
200 de 1250 e-mails marcados para exclusão...
...
1250 de 1250 e-mails marcados para exclusão...
Todos os e-mails foram apagados com sucesso!
Logout realizado com sucesso.

🤝 Contribuindo

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
3. Commit suas mudanças (git commit -am 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🆘 Suporte

Se você encontrar problemas ou tiver dúvidas:

1. Abra uma issue
2. Descreva detalhadamente o problema encontrado

---

⚡ Desenvolvido com Python | 📧 Para limpeza eficiente de e-mails | 🔒 Seguro e confiável