ReviewRequestPublishedEmailHook¶

reviewboard.extensions.hooks.ReviewRequestPublishedEmailHook allows extensions to modify the recipients of e-mails generated from review publishing actvity

ReviewRequestPublishedEmailHook requires one arguments for initialization: the extension instance.

ReviewRequestPublishedEmailHook should be sub-classed to provide the desired behaviour. The default behaviour of the get_to_field() and get_cc_field() methods is to return the field unmodified.

Example¶

from typing import TYPE_CHECKING

from reviewboard.extensions.base import Extension
from reviewboard.extensions.hooks import ReviewRequestPublishedEmailHook

if TYPE_CHECKING:
    from django.contrib.auth.models import User
    from reviewboard.notifications.email.utils import RecipientList
    from reviewboard.reviews.models import ReviewRequest


class SampleEmailHook(ReviewRequestPublishedEmailHook):
    def get_to_field(
        self,
        to_field: RecipientList,
        review_request: ReviewRequest,
        user: User,
    ) -> RecipientList:
        to_field.add(user)
        return to_field

    def get_cc_field(
        self,
        cc_field: RecipientList,
        review_request: ReviewRequest,
        user: User,
    ) -> RecipientList:
        return set()

class SampleExtension(Extension):
    def initialize(self) -> None:
        SampleEmailHook(self)