mailer.py

# -*- coding: utf-8 -*-

# Copyright  Cloud Linux GmbH & Cloud Linux Software, Inc 2010-2021 All Rights Reserved
#
# Licensed under CLOUD LINUX LICENSE AGREEMENT
# http://cloudlinux.com/docs/LICENSE.TXT

"""
This module contains SSA Mailer class and helper tools
"""

import logging
import os
import smtplib
import subprocess
from configparser import ConfigParser, SectionProxy
from email.message import EmailMessage
from socket import gethostname

from clcommon.lib.cledition import is_cl_solo_edition
from jinja2 import Environment, FileSystemLoader, select_autoescape
from clcommon.lib.network import get_ip_addr

from .constants import mail_template_location
from .exceptions import SSAMailerError
from .utils import duration_cast, format_date

def _get_server_ip(hostname):
    return get_ip_addr(hostname) or 'UNKNOWN'

def render_report_table(report_data: dict) -> tuple:
    """
    Render an HTML table for e-mail report and a full e-mail message
    """
    env = Environment(
        loader=FileSystemLoader(mail_template_location),
        trim_blocks=True,
        lstrip_blocks=True,
        autoescape=select_autoescape(['html', 'xml']),
    )
    env.filters['duration_cast'] = duration_cast

table_template = env.get_template('report_table.html')
    report_table = table_template.render(
        domains=report_data['domains'],
        # [unification] make mail template same across all editions
        is_solo=is_cl_solo_edition(skip_jwt_check=True),
    )

mail_template = env.get_template('mail.html')
    hostname = gethostname()
    mail = mail_template.render(
        date=format_date(report_data['date']),
        report_table=report_table,
        hostname=hostname,
        ip_addr=_get_server_ip(hostname),
    )
    return report_table, mail

class Mailer:
    """
    Class contains SSA e-mail send logic
    """

def __init__(self):
        self.logger = logging.getLogger('mailer')
        self._sender = None

@property
    def mail_server(self) -> tuple:
        """
        Local mail server address
        """
        return ('localhost',)

@property
    def sender(self) -> str:
        """
        'From' mail address
        """
        return f"slow-site-analyzer@{gethostname()}"

@staticmethod
    def read_template(name: str) -> SectionProxy:
        """
        Get preformatted data for e-mail by name of template
        """
        tmpl = f'{mail_template_location}/{name}.ini'
        if os.path.exists(tmpl):
            config = ConfigParser(interpolation=None)
            config.read(tmpl)
            return config['data']
        raise SSAMailerError(f'Failed to find template {name} in {mail_template_location}')

def _smtp_send(self, message: EmailMessage) -> None:
        """
        Send preformatted e-mail via localhost SMTP
        """
        self.logger.info('Try to send via smtp')
        try:
            with smtplib.SMTP(*self.mail_server) as server:
                result = server.send_message(message)
                self.logger.info('Send result: %s', result)
        except smtplib.SMTPException as e:
            raise SSAMailerError(f'smtp mailing failed: {str(e)}')
        except (ConnectionError, OSError) as e:
            raise SSAMailerError(f'smtp connection failed: {str(e)}')

def _console_send(self, message: EmailMessage) -> None:
        """
        Send preformatted e-mail via sendmail utility
        """
        self.logger.info('Try to send via sendmail utility')
        cmd = ["/usr/sbin/sendmail", "-t", "-oi"]
        try:
            subprocess.run(cmd, input=message.as_string(), capture_output=True, text=True, check=True)
        except (OSError, ValueError, subprocess.CalledProcessError) as e:
            raise SSAMailerError(f'sendmail utility failed with {str(e)}')

def _send(self, mail: EmailMessage) -> None:
        """
        Try to send mail via localhost smtp server,
        if fails -- try to use sendmail utility
        """
        try:
            self._smtp_send(mail)
        except SSAMailerError as e:
            self.logger.error(str(e))
            try:
                self._console_send(mail)
            except SSAMailerError as e:
                self.logger.error(str(e))
                self.logger.critical('Both smtp and sendmail failed to send message to %s', mail['To'])

def send_simple_mail(self, recipient: str, template: str = 'ssa_report', **kwargs) -> None:
        """
        Create a message from given template, including additional kwargs,
        and send it to given recipient
        """
        self._send(self._message(recipient, template, **kwargs))

def _message(self, recipient: str, template: str, **kwargs) -> EmailMessage:
        """
        Form a message
        """
        data = self.read_template(template)

msg = EmailMessage()
        msg['Subject'] = data['subject'] % kwargs
        msg['From'] = self.sender
        msg['To'] = recipient
        msg.set_content(data['text'] % kwargs)
        msg.add_alternative(data['html'] % kwargs, subtype='html')

# log only metadata; the serialized body carries tenant URLs/PII
        self.logger.info("Generated mail from template '%s' for recipient '%s'", template, recipient)

return msg

docroot: /home/induvedam/public_html

curdir: /opt/cloudlinux/venv/lib/python3.11/site-packages/ssa/internal

	.	164
	..	4096
X	__init__.py	171
	__pycache__	4096
X	constants.py	915
X	exceptions.py	1288
X	mailer.py	5279
X	panel_data_snapshot.py	14117
X	tools.py	2417
X	utils.py	17639