Disparador Outlook

EM DESENVOLVIMENTO

Este projeto é uma aplicação Kivy para enviar emails utilizando a API do Microsoft Graph. A aplicação permite selecionar uma planilha Excel contendo os dados dos emails, formatar os corpos dos emails e enviá-los para os destinatários especificados.

Estrutura do Projeto

.env
.gitignore
main.py
README.md
requirements.txt
app/
├── __init__.py
├── auth/
│   ├── __init__.py
│   └── authenticator.py
├── config/
│   ├── __init__.py
│   ├── log_settings.py
│   └── settings.py
├── controller/
│   ├── __init__.py
│   └── home_controller.py
├── enum/
│   ├── __init__.py
│   ├── email_format_type.py
│   ├── email_recipient_type.py
│   └── excel_columns.py
├── exceptions/
│   ├── __init__.py
│   ├── asyncio_exceptions.py
│   ├── authentication_exceptions.py
│   ├── configuration_exceptions.py
│   ├── email_exceptions.py
│   ├── excel_exceptions.py
│   └── main_exceptions.py
├── services/
│   ├── __init__.py
│   ├── email_formatter.py
│   ├── process_excel.py
│   └── send_email.py
└── views/
    ├── __init__.py
    ├── main.kv
    └── main_screen.py

Estrutura da Planilha Excel

A planilha Excel deve seguir o exemplo estrutural abaixo, podendo ter quantos "CORPO E-MAIL" forem necessários:

E-MAIL ASSUNTO	E-MAIL PARA (separar com ;)	E-MAIL CC (separar com ;)	E-MAIL CCO (separar com ;)	CORPO E-MAIL 1	CORPO E-MAIL 2	...
Assunto 1	email1@example.com;email2@example.com	cc1@example.com;cc2@example.com	cco1@example.com;cco2@example.com	Corpo do email parte 1	Corpo do email parte 2	...
Assunto 2	email3@example.com;email4@example.com	cc3@example.com;cc4@example.com	cco3@example.com;cco4@example.com	Corpo do email parte 1	Corpo do email parte 2	...

Instalação

1. Clone o repositório:

   git clone <URL_DO_REPOSITORIO>
   cd msgraph-email-sender

2. Crie um ambiente virtual e ative-o:

   python -m venv venv
   source venv/bin/activate  # No Windows, use `venv\Scripts\activate`

3. Instale as dependências:

   pip install -r requirements.txt

4. Configure as variáveis de ambiente no arquivo .env:

   # Tenant Identification
   TENANT_ID= "your_tenant_id_here"
   
   # Client Credentials
   CLIENT_ID= "your_client_id_here"
   CLIENT_SECRET= "your_client_secret_here"
   
   # User Credentials
   USER_EMAIL= "your_email_here"
   
   # Log Configurations
   LOG_LEVEL="DEBUG"
   LOG_FORMAT="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
   
   # aiohttp Configurations
   AIOHTTP_LIMIT=10
   
   # API Configurations
   API_SCOPE="https://graph.microsoft.com/.default"
   
   # Excel File Path
   EXCEL_FILE_PATH="path_to_your_excel_file_here"
   
   # App Configurations
   APP_TITLE="Disparador Outlook"
   APP_ICON_PATH="path_to_your_app_icon_here"
   
   # Email Formatting Configurations
   DEFAULT_FONT_SIZE=1
   FONT_SIZE_INCREMENT=0.50
   
   # Excel Processing Configurations
   INVALID_VALUES="x,nan,"
   
   # Email Sending Configurations
   GRAPH_API_URL="https://graph.microsoft.com/v1.0"
   SAVE_TO_SENT_ITEMS="true"

Uso

1. Execute a aplicação:

   python main.py

2. Na interface da aplicação, selecione a planilha Excel contendo os dados dos emails.

3. Formate os corpos dos emails conforme necessário.

4. Clique no botão "Enviar" para enviar os emails.

FIXME

• Fazer com que a quebra de linha funcione para corpos de email sem formatação
• Fazer com que o hiperlink funcione corretamente
• Corrigir feedbacks visuais ao selecionar e deselecionar os botões de formatação, spinners e etc

TODOs

• Colocar toda a interface e as mensagens de resposta em português
• Separar as responsabilidades em controller, corrigir nome de métodos, e separar as funções em arquivos diferentes
• Fazer isso com a main screen também, melhorar a organização do código
• Tirar números mágicos, fazer uso de enum
• Corrigir o layout, melhorar a interface
• Adicionar novos tipos de formatação e algo mais personalizado em relação ao tamanho da fonte

Preview