Felipe Cardoso
c589b565f0
- Introduced `pyproject.toml` to centralize backend tool configurations (e.g., Ruff, mypy, coverage, pytest). - Replaced Black, isort, and Flake8 with Ruff for linting, formatting, and import sorting. - Updated `requirements.txt` to include Ruff and remove replaced tools. - Added `Makefile` to streamline development workflows with commands for linting, formatting, type-checking, testing, and cleanup.
296 lines
9.2 KiB
Python
296 lines
9.2 KiB
Python
# app/services/email_service.py
|
|
"""
|
|
Email service with placeholder implementation.
|
|
|
|
This service provides email sending functionality with a simple console/log-based
|
|
placeholder that can be easily replaced with a real email provider (SendGrid, SES, etc.)
|
|
"""
|
|
|
|
import logging
|
|
from abc import ABC, abstractmethod
|
|
|
|
from app.core.config import settings
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
class EmailBackend(ABC):
|
|
"""Abstract base class for email backends."""
|
|
|
|
@abstractmethod
|
|
async def send_email(
|
|
self,
|
|
to: list[str],
|
|
subject: str,
|
|
html_content: str,
|
|
text_content: str | None = None,
|
|
) -> bool:
|
|
"""Send an email."""
|
|
|
|
|
|
class ConsoleEmailBackend(EmailBackend):
|
|
"""
|
|
Console/log-based email backend for development and testing.
|
|
|
|
This backend logs email content instead of actually sending emails.
|
|
Replace this with a real backend (SMTP, SendGrid, SES) for production.
|
|
"""
|
|
|
|
async def send_email(
|
|
self,
|
|
to: list[str],
|
|
subject: str,
|
|
html_content: str,
|
|
text_content: str | None = None,
|
|
) -> bool:
|
|
"""
|
|
Log email content to console/logs.
|
|
|
|
Args:
|
|
to: List of recipient email addresses
|
|
subject: Email subject
|
|
html_content: HTML version of the email
|
|
text_content: Plain text version of the email
|
|
|
|
Returns:
|
|
True if "sent" successfully
|
|
"""
|
|
logger.info("=" * 80)
|
|
logger.info("EMAIL SENT (Console Backend)")
|
|
logger.info("=" * 80)
|
|
logger.info(f"To: {', '.join(to)}")
|
|
logger.info(f"Subject: {subject}")
|
|
logger.info("-" * 80)
|
|
if text_content:
|
|
logger.info("Plain Text Content:")
|
|
logger.info(text_content)
|
|
logger.info("-" * 80)
|
|
logger.info("HTML Content:")
|
|
logger.info(html_content)
|
|
logger.info("=" * 80)
|
|
return True
|
|
|
|
|
|
class SMTPEmailBackend(EmailBackend):
|
|
"""
|
|
SMTP email backend for production use.
|
|
|
|
TODO: Implement SMTP sending with proper error handling.
|
|
This is a placeholder for future implementation.
|
|
"""
|
|
|
|
def __init__(self, host: str, port: int, username: str, password: str):
|
|
self.host = host
|
|
self.port = port
|
|
self.username = username
|
|
self.password = password
|
|
|
|
async def send_email(
|
|
self,
|
|
to: list[str],
|
|
subject: str,
|
|
html_content: str,
|
|
text_content: str | None = None,
|
|
) -> bool:
|
|
"""Send email via SMTP."""
|
|
# TODO: Implement SMTP sending
|
|
logger.warning("SMTP backend not yet implemented, falling back to console")
|
|
console_backend = ConsoleEmailBackend()
|
|
return await console_backend.send_email(to, subject, html_content, text_content)
|
|
|
|
|
|
class EmailService:
|
|
"""
|
|
High-level email service that uses different backends.
|
|
|
|
This service provides a clean interface for sending various types of emails
|
|
and can be configured to use different backends (console, SMTP, SendGrid, etc.)
|
|
"""
|
|
|
|
def __init__(self, backend: EmailBackend | None = None):
|
|
"""
|
|
Initialize email service with a backend.
|
|
|
|
Args:
|
|
backend: Email backend to use. Defaults to ConsoleEmailBackend.
|
|
"""
|
|
self.backend = backend or ConsoleEmailBackend()
|
|
|
|
async def send_password_reset_email(
|
|
self, to_email: str, reset_token: str, user_name: str | None = None
|
|
) -> bool:
|
|
"""
|
|
Send password reset email.
|
|
|
|
Args:
|
|
to_email: Recipient email address
|
|
reset_token: Password reset token
|
|
user_name: User's name for personalization
|
|
|
|
Returns:
|
|
True if email sent successfully
|
|
"""
|
|
# Generate reset URL
|
|
reset_url = f"{settings.FRONTEND_URL}/reset-password?token={reset_token}"
|
|
|
|
# Prepare email content
|
|
subject = "Password Reset Request"
|
|
|
|
# Plain text version
|
|
text_content = f"""
|
|
Hello{" " + user_name if user_name else ""},
|
|
|
|
You requested a password reset for your account. Click the link below to reset your password:
|
|
|
|
{reset_url}
|
|
|
|
This link will expire in 1 hour.
|
|
|
|
If you didn't request this, please ignore this email.
|
|
|
|
Best regards,
|
|
The {settings.PROJECT_NAME} Team
|
|
"""
|
|
|
|
# HTML version
|
|
html_content = f"""
|
|
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<style>
|
|
body {{ font-family: Arial, sans-serif; line-height: 1.6; color: #333; }}
|
|
.container {{ max-width: 600px; margin: 0 auto; padding: 20px; }}
|
|
.header {{ background-color: #4CAF50; color: white; padding: 20px; text-align: center; }}
|
|
.content {{ padding: 20px; background-color: #f9f9f9; }}
|
|
.button {{ display: inline-block; padding: 12px 24px; background-color: #4CAF50;
|
|
color: white; text-decoration: none; border-radius: 4px; margin: 20px 0; }}
|
|
.footer {{ padding: 20px; text-align: center; color: #777; font-size: 12px; }}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div class="header">
|
|
<h1>Password Reset</h1>
|
|
</div>
|
|
<div class="content">
|
|
<p>Hello{" " + user_name if user_name else ""},</p>
|
|
<p>You requested a password reset for your account. Click the button below to reset your password:</p>
|
|
<p style="text-align: center;">
|
|
<a href="{reset_url}" class="button">Reset Password</a>
|
|
</p>
|
|
<p>Or copy and paste this link into your browser:</p>
|
|
<p style="word-break: break-all; color: #4CAF50;">{reset_url}</p>
|
|
<p><strong>This link will expire in 1 hour.</strong></p>
|
|
<p>If you didn't request this, please ignore this email.</p>
|
|
</div>
|
|
<div class="footer">
|
|
<p>Best regards,<br>The {settings.PROJECT_NAME} Team</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
"""
|
|
|
|
try:
|
|
return await self.backend.send_email(
|
|
to=[to_email],
|
|
subject=subject,
|
|
html_content=html_content,
|
|
text_content=text_content,
|
|
)
|
|
except Exception as e:
|
|
logger.error(f"Failed to send password reset email to {to_email}: {e!s}")
|
|
return False
|
|
|
|
async def send_email_verification(
|
|
self, to_email: str, verification_token: str, user_name: str | None = None
|
|
) -> bool:
|
|
"""
|
|
Send email verification email.
|
|
|
|
Args:
|
|
to_email: Recipient email address
|
|
verification_token: Email verification token
|
|
user_name: User's name for personalization
|
|
|
|
Returns:
|
|
True if email sent successfully
|
|
"""
|
|
# Generate verification URL
|
|
verification_url = (
|
|
f"{settings.FRONTEND_URL}/verify-email?token={verification_token}"
|
|
)
|
|
|
|
# Prepare email content
|
|
subject = "Verify Your Email Address"
|
|
|
|
# Plain text version
|
|
text_content = f"""
|
|
Hello{" " + user_name if user_name else ""},
|
|
|
|
Thank you for signing up! Please verify your email address by clicking the link below:
|
|
|
|
{verification_url}
|
|
|
|
This link will expire in 24 hours.
|
|
|
|
If you didn't create an account, please ignore this email.
|
|
|
|
Best regards,
|
|
The {settings.PROJECT_NAME} Team
|
|
"""
|
|
|
|
# HTML version
|
|
html_content = f"""
|
|
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<style>
|
|
body {{ font-family: Arial, sans-serif; line-height: 1.6; color: #333; }}
|
|
.container {{ max-width: 600px; margin: 0 auto; padding: 20px; }}
|
|
.header {{ background-color: #2196F3; color: white; padding: 20px; text-align: center; }}
|
|
.content {{ padding: 20px; background-color: #f9f9f9; }}
|
|
.button {{ display: inline-block; padding: 12px 24px; background-color: #2196F3;
|
|
color: white; text-decoration: none; border-radius: 4px; margin: 20px 0; }}
|
|
.footer {{ padding: 20px; text-align: center; color: #777; font-size: 12px; }}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div class="header">
|
|
<h1>Verify Your Email</h1>
|
|
</div>
|
|
<div class="content">
|
|
<p>Hello{" " + user_name if user_name else ""},</p>
|
|
<p>Thank you for signing up! Please verify your email address by clicking the button below:</p>
|
|
<p style="text-align: center;">
|
|
<a href="{verification_url}" class="button">Verify Email</a>
|
|
</p>
|
|
<p>Or copy and paste this link into your browser:</p>
|
|
<p style="word-break: break-all; color: #2196F3;">{verification_url}</p>
|
|
<p><strong>This link will expire in 24 hours.</strong></p>
|
|
<p>If you didn't create an account, please ignore this email.</p>
|
|
</div>
|
|
<div class="footer">
|
|
<p>Best regards,<br>The {settings.PROJECT_NAME} Team</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
"""
|
|
|
|
try:
|
|
return await self.backend.send_email(
|
|
to=[to_email],
|
|
subject=subject,
|
|
html_content=html_content,
|
|
text_content=text_content,
|
|
)
|
|
except Exception as e:
|
|
logger.error(f"Failed to send verification email to {to_email}: {e!s}")
|
|
return False
|
|
|
|
|
|
# Global email service instance
|
|
email_service = EmailService()
|