zulip/zerver/management/commands/send_custom_email.py

from argparse import ArgumentParser
from typing import Any

from zerver.lib.management import CommandError, ZulipBaseCommand
from zerver.lib.send_email import send_custom_email
from zerver.models import UserProfile


class Command(ZulipBaseCommand):
    help = """
    Send a custom email with Zulip branding to the specified users.

    Useful to send a notice to all users of a realm or server.

    The From and Subject headers can be provided in the body of the Markdown
    document used to generate the email, or on the command line."""

    def add_arguments(self, parser: ArgumentParser) -> None:
        parser.add_argument(
            '--entire-server', action="store_true", help="Send to every user on the server."
        )
        parser.add_argument(
            '--markdown-template-path',
            '--path',
            required=True,
            help='Path to a Markdown-format body for the email.',
        )
        parser.add_argument(
            '--subject',
            help='Subject for the email. It can be declared in Markdown file in headers',
        )
        parser.add_argument(
            '--from-name',
            help='From line for the email. It can be declared in Markdown file in headers',
        )
        parser.add_argument('--reply-to', help='Optional reply-to line for the email')
        parser.add_argument(
            '--admins-only', help='Send only to organization administrators', action='store_true'
        )

        self.add_user_list_args(
            parser,
            help="Email addresses of user(s) to send emails to.",
            all_users_help="Send to every user on the realm.",
        )
        self.add_realm_args(parser)

    def handle(self, *args: Any, **options: str) -> None:
        if options["entire_server"]:
            users = UserProfile.objects.filter(is_active=True, is_bot=False, is_mirror_dummy=False)
        else:
            realm = self.get_realm(options)
            try:
                users = self.get_users(options, realm, is_bot=False)
            except CommandError as error:
                if str(error) == "You have to pass either -u/--users or -a/--all-users.":
                    raise CommandError(
                        "You have to pass -u/--users or -a/--all-users or --entire-server."
                    )
                raise error

        send_custom_email(users, options)