Class EmailSender

keepercommander/email_service.py:985–1056

Main email sender class that routes to appropriate provider. Usage: config = EmailConfig(...) sender = EmailSender(config) sender.send(to='user@example.com', subject='Test', body='Hello', html=True)

class EmailSender:
    """
    Main email sender class that routes to appropriate provider.

    Usage:
        config = EmailConfig(...)
        sender = EmailSender(config)
        sender.send(to='user@example.com', subject='Test', body='Hello', html=True)
    """

    def __init__(self, config: EmailConfig):
        """
        Initialize email sender with configuration.

        Args:
            config: EmailConfig object

        Raises:
            ValueError: If provider is unknown or config invalid
        """
        self.config = config

        # Check provider compatibility with current installation
        dependencies_available, error_message = check_provider_dependencies(config.provider)
        if not dependencies_available:
            raise ValueError(error_message)

        # Create provider instance
        provider_map = {
            'smtp': SMTPEmailProvider,
            'sendgrid': SendGridEmailProvider,
            'ses': SESEmailProvider,
            'gmail-oauth': GmailOAuthProvider,
            'microsoft-oauth': MicrosoftOAuthProvider,
        }

        provider_class = provider_map.get(config.provider.lower())
        if not provider_class:
            raise ValueError(
                f"Unknown email provider: {config.provider}. "
                f"Supported: {', '.join(provider_map.keys())}"
            )

        self.provider = provider_class(config)

    def send(self, to: str, subject: str, body: str, html: bool = False) -> bool:
        """
        Send email via configured provider.

        Args:
            to: Recipient email address
            subject: Email subject
            body: Email body
            html: True if body is HTML

        Returns:
            True if sent successfully