def _sendFailureNotification(self, notify_owner, log):
"""Send a failure notification to the distribution's mirror admins and
to the mirror owner, in case notify_owner is True.
"""
template = get_email_template(
'notify-mirror-owner.txt', app='registry')
fromaddress = format_address(
"Launchpad Mirror Prober", config.canonical.noreply_from_address)
replacements = {
'distro': self.distribution.title,
'mirror_name': self.name,
'mirror_url': canonical_url(self),
'log_snippet': "\n".join(log.split('\n')[:20]),
'logfile_url': self.last_probe_record.log_file.http_url}
message = template % replacements
subject = "Launchpad: Verification of %s failed" % self.name
mirror_admin_address = get_contact_email_addresses(
self.distribution.mirror_admin)
simple_sendmail(fromaddress, mirror_admin_address, subject, message)
if notify_owner:
owner_address = get_contact_email_addresses(self.owner)
if len(owner_address) > 0:
simple_sendmail(fromaddress, owner_address, subject, message)
def _sendFailureNotification(self, notify_owner, log):
"""Send a failure notification to the distribution's mirror admins and
to the mirror owner, in case notify_owner is True.
"""
template = get_email_template('notify-mirror-owner.txt',
app='registry')
fromaddress = format_address("Launchpad Mirror Prober",
config.canonical.noreply_from_address)
replacements = {
'distro': self.distribution.title,
'mirror_name': self.name,
'mirror_url': canonical_url(self),
'log_snippet': "\n".join(log.split('\n')[:20]),
'logfile_url': self.last_probe_record.log_file.http_url
}
message = template % replacements
subject = "Launchpad: Verification of %s failed" % self.name
mirror_admin_address = get_contact_email_addresses(
self.distribution.mirror_admin)
simple_sendmail(fromaddress, mirror_admin_address, subject, message)
if notify_owner:
owner_address = get_contact_email_addresses(self.owner)
if len(owner_address) > 0:
simple_sendmail(fromaddress, owner_address, subject, message)
def test_user_with_preferredemail(self):
user = self.factory.makePerson(
email='*****@*****.**',
name='user',
)
result = get_contact_email_addresses(user)
self.assertEqual(set(['*****@*****.**']), result)
def notify_specification_subscription_modified(specsub, event):
"""Notify a subscriber to a blueprint that their
subscription has changed.
"""
user = IPerson(event.user)
spec = specsub.specification
person = specsub.person
# Only send a notification if the
# subscription changed by someone else.
if person == user:
return
subject = specification_notification_subject(spec)
if specsub.essential:
specsub_type = 'Participation essential'
else:
specsub_type = 'Participation non-essential'
mailwrapper = MailWrapper(width=72)
body = mailwrapper.format(
'Your subscription to the blueprint '
'%(blueprint_name)s - %(blueprint_title)s '
'has changed to [%(specsub_type)s].\n\n'
'--\n %(blueprint_url)s' %
{'blueprint_name': spec.name,
'blueprint_title': spec.title,
'specsub_type': specsub_type,
'blueprint_url': canonical_url(spec)})
for address in get_contact_email_addresses(person):
simple_sendmail_from_person(user, address, subject, body)
def test_person_with_hidden_email(self):
user = self.factory.makePerson(
email='*****@*****.**',
hide_email_addresses=True,
name='user')
result = get_contact_email_addresses(user)
self.assertEqual(set(['*****@*****.**']), result)
def _getAndCheckSentNotifications(self, notifications_to_send):
"""Return the notifications that were successfully sent.
It calls get_email_notifications() with the supplied
notifications and return the ones that were actually sent. It
also checks that the notifications got sent to the correct
addresses.
"""
email_notifications = get_email_notifications(notifications_to_send)
to_addresses = set()
sent_notifications = []
for notifications, omitted, messages in email_notifications:
for message in messages:
to_addresses.add(message['to'])
recipients = {}
for notification in notifications:
for recipient in notification.recipients:
for address in get_contact_email_addresses(
recipient.person):
recipients[address] = recipient
expected_to_addresses = recipients.keys()
self.assertEqual(
sorted(expected_to_addresses), sorted(to_addresses))
sent_notifications += notifications
return sent_notifications
def test_private_team(self):
email = '*****@*****.**'
team = self.factory.makeTeam(name='breaks-things',
email=email,
visibility=PersonVisibility.PRIVATE)
result = get_contact_email_addresses(team)
self.assertEqual(set(['*****@*****.**']), result)
def test_private_team(self):
email = '*****@*****.**'
team = self.factory.makeTeam(
name='breaks-things',
email=email,
visibility=PersonVisibility.PRIVATE)
result = get_contact_email_addresses(team)
self.assertEqual(set(['*****@*****.**']), result)
def send_bug_details_to_new_bug_subscribers(
bug, previous_subscribers, current_subscribers, subscribed_by=None,
event_creator=None):
"""Send an email containing full bug details to new bug subscribers.
This function is designed to handle situations where bugtasks get
reassigned to new products or sourcepackages, and the new bug subscribers
need to be notified of the bug.
A boolean is returned indicating whether any emails were sent.
"""
prev_subs_set = set(previous_subscribers)
cur_subs_set = set(current_subscribers)
new_subs = cur_subs_set.difference(prev_subs_set)
if (event_creator is not None
and not event_creator.selfgenerated_bugnotifications):
new_subs.discard(event_creator)
to_addrs = set()
for new_sub in new_subs:
to_addrs.update(get_contact_email_addresses(new_sub))
if not to_addrs:
return False
from_addr = format_address(
'Launchpad Bug Tracker',
"%s@%s" % (bug.id, config.launchpad.bugs_domain))
# Now's a good a time as any for this email; don't use the original
# reported date for the bug as it will just confuse mailer and
# recipient.
email_date = datetime.datetime.now()
# The new subscriber email is effectively the initial message regarding
# a new bug. The bug's initial message is used in the References
# header to establish the message's context in the email client.
references = [bug.initial_message.rfc822msgid]
recipients = bug.getBugNotificationRecipients()
bug_notification_builder = BugNotificationBuilder(bug, event_creator)
for to_addr in sorted(to_addrs):
reason, rationale = recipients.getReason(to_addr)
subject, contents = generate_bug_add_email(
bug, new_recipients=True, subscribed_by=subscribed_by,
reason=reason, event_creator=event_creator)
msg = bug_notification_builder.build(
from_addr, to_addr, contents, subject, email_date,
rationale=rationale, references=references)
sendmail(msg)
return True
def notify_specification_subscription_created(specsub, event):
"""Notify a user that they have been subscribed to a blueprint."""
user = IPerson(event.user)
spec = specsub.specification
person = specsub.person
subject = specification_notification_subject(spec)
mailwrapper = MailWrapper(width=72)
body = mailwrapper.format(
'You are now subscribed to the blueprint '
'%(blueprint_name)s - %(blueprint_title)s.\n\n'
'-- \n%(blueprint_url)s' %
{'blueprint_name': spec.name,
'blueprint_title': spec.title,
'blueprint_url': canonical_url(spec)})
for address in get_contact_email_addresses(person):
simple_sendmail_from_person(user, address, subject, body)
def notify(self):
"""Send a notification email to the given person about the export.
If there is a failure, a copy of the email is also sent to the
Launchpad error mailing list for debugging purposes.
"""
if self.failure is None and self.url is not None:
# There is no failure, so we have a full export without
# problems.
body = self._getSuccessEmailBody()
elif self.failure is not None and self.url is None:
body = self._getFailureEmailBody()
elif self.failure is not None and self.url is not None:
raise AssertionError(
'We cannot have a URL for the export and a failure.')
else:
raise AssertionError('On success, an exported URL is expected.')
recipients = list(get_contact_email_addresses(self.person))
for recipient in [str(recipient) for recipient in recipients]:
simple_sendmail(
from_addr=config.rosetta.notification_address,
to_addrs=[recipient],
subject='Launchpad translation download: %s' % self.name,
body=body)
if self.failure is None:
# There are no errors, so nothing else to do here.
return
# The export process had errors that we should notify admins about.
try:
admins_email_body = self._getAdminFailureNotificationEmailBody()
except UnicodeDecodeError:
# Unfortunately this happens sometimes: invalidly-encoded data
# makes it into the exception description, possibly from error
# messages printed by msgfmt. Before we can fix that, we need to
# know what exports suffer from this problem.
admins_email_body = self._getUnicodeDecodeErrorEmailBody()
simple_sendmail(
from_addr=config.rosetta.notification_address,
to_addrs=[config.launchpad.errors_address],
subject=(
'Launchpad translation download errors: %s' % self.name),
body=admins_email_body)
def notify(self):
"""Send a notification email to the given person about the export.
If there is a failure, a copy of the email is also sent to the
Launchpad error mailing list for debugging purposes.
"""
if self.failure is None and self.url is not None:
# There is no failure, so we have a full export without
# problems.
body = self._getSuccessEmailBody()
elif self.failure is not None and self.url is None:
body = self._getFailureEmailBody()
elif self.failure is not None and self.url is not None:
raise AssertionError(
'We cannot have a URL for the export and a failure.')
else:
raise AssertionError('On success, an exported URL is expected.')
recipients = list(get_contact_email_addresses(self.person))
for recipient in [str(recipient) for recipient in recipients]:
simple_sendmail(from_addr=config.rosetta.notification_address,
to_addrs=[recipient],
subject='Launchpad translation download: %s' %
self.name,
body=body)
if self.failure is None:
# There are no errors, so nothing else to do here.
return
# The export process had errors that we should notify admins about.
try:
admins_email_body = self._getAdminFailureNotificationEmailBody()
except UnicodeDecodeError:
# Unfortunately this happens sometimes: invalidly-encoded data
# makes it into the exception description, possibly from error
# messages printed by msgfmt. Before we can fix that, we need to
# know what exports suffer from this problem.
admins_email_body = self._getUnicodeDecodeErrorEmailBody()
simple_sendmail(from_addr=config.rosetta.notification_address,
to_addrs=[config.launchpad.errors_address],
subject=('Launchpad translation download errors: %s' %
self.name),
body=admins_email_body)
def notificationRecipientAddresses(self):
"""See ISpecification."""
related_people = [
self.owner, self.assignee, self.approver, self.drafter]
related_people = [
person for person in related_people if person is not None]
subscribers = [
subscription.person for subscription in self.subscriptions]
notify_people = set(related_people + subscribers)
without_access = set(
getUtility(IService, 'sharing').getPeopleWithoutAccess(
self, notify_people))
notify_people -= without_access
addresses = set()
for person in notify_people:
addresses.update(get_contact_email_addresses(person))
return sorted(addresses)
def notificationRecipientAddresses(self):
"""See ISpecification."""
related_people = [
self.owner, self.assignee, self.approver, self.drafter]
related_people = [
person for person in related_people if person is not None]
subscribers = [
subscription.person for subscription in self.subscriptions]
notify_people = set(related_people + subscribers)
without_access = set(
getUtility(IService, 'sharing').getPeopleWithoutAccess(
self, notify_people))
notify_people -= without_access
addresses = set()
for person in notify_people:
addresses.update(get_contact_email_addresses(person))
return sorted(addresses)
def _importEntry(self, entry):
"""Perform the import of one entry, and notify the uploader."""
target = entry.import_into
self.logger.info('Importing: %s' % target.title)
(mail_subject, mail_body) = target.importFromQueue(entry, self.logger)
if mail_subject is not None and self._shouldNotify(entry.importer):
# A `mail_subject` of None indicates that there
# is no notification worth sending out.
from_email = config.rosetta.notification_address
katie = getUtility(ILaunchpadCelebrities).katie
if entry.importer == katie:
# Email import state to Debian imports email.
to_email = None
else:
to_email = get_contact_email_addresses(entry.importer)
if to_email:
text = MailWrapper().format(mail_body)
simple_sendmail(from_email, to_email, mail_subject, text)
def _handleUnpushedBranch(self, productseries):
"""Branch has never been scanned. Notify owner.
This means that as far as the Launchpad database knows, there is
no actual bzr branch behind this `IBranch` yet.
"""
branch = productseries.translations_branch
self.logger.info("Notifying %s of unpushed branch %s." % (
branch.owner.name, branch.bzr_identity))
template = get_email_template('unpushed-branch.txt', 'translations')
text = template % {
'productseries': productseries.title,
'branch_url': branch.bzr_identity,
}
recipients = get_contact_email_addresses(branch.owner)
sender = format_address(
"Launchpad Translations", config.canonical.noreply_from_address)
subject = "Launchpad: translations branch has not been set up."
self._sendMail(sender, recipients, subject, text)
def new_import(code_import, event):
"""Email the vcs-imports team about a new code import."""
if (event.user is None
or IUnauthenticatedPrincipal.providedBy(event.user)):
# If there is no logged in user, then we are most likely in a
# test.
return
user = IPerson(event.user)
subject = 'New code import: %s/%s' % (
code_import.branch.target.name, code_import.branch.name)
if code_import.rcs_type == RevisionControlSystems.CVS:
location = '%s, %s' % (code_import.cvs_root, code_import.cvs_module)
else:
location = code_import.url
rcs_type_map = {
RevisionControlSystems.CVS: 'CVS',
RevisionControlSystems.SVN: 'subversion',
RevisionControlSystems.BZR_SVN: 'subversion',
RevisionControlSystems.GIT: 'git',
RevisionControlSystems.BZR: 'bazaar',
}
body = get_email_template('new-code-import.txt', app='code') % {
'person': code_import.registrant.displayname,
'branch': canonical_url(code_import.branch),
'rcs_type': rcs_type_map[code_import.rcs_type],
'location': location,
}
from_address = format_address(
user.displayname, user.preferredemail.email)
vcs_imports = getUtility(ILaunchpadCelebrities).vcs_imports
headers = {'X-Launchpad-Branch': code_import.branch.unique_name,
'X-Launchpad-Message-Rationale':
'Operator @%s' % vcs_imports.name,
'X-Launchpad-Notification-Type': 'code-import',
}
for address in get_contact_email_addresses(vcs_imports):
simple_sendmail(from_address, address, subject, body, headers)
def new_import(code_import, event):
"""Email the vcs-imports team about a new code import."""
if (event.user is None
or IUnauthenticatedPrincipal.providedBy(event.user)):
# If there is no logged in user, then we are most likely in a
# test.
return
user = IPerson(event.user)
subject = 'New code import: %s/%s' % (code_import.branch.target.name,
code_import.branch.name)
if code_import.rcs_type == RevisionControlSystems.CVS:
location = '%s, %s' % (code_import.cvs_root, code_import.cvs_module)
else:
location = code_import.url
rcs_type_map = {
RevisionControlSystems.CVS: 'CVS',
RevisionControlSystems.SVN: 'subversion',
RevisionControlSystems.BZR_SVN: 'subversion',
RevisionControlSystems.GIT: 'git',
RevisionControlSystems.BZR: 'bazaar',
}
body = get_email_template('new-code-import.txt', app='code') % {
'person': code_import.registrant.displayname,
'branch': canonical_url(code_import.branch),
'rcs_type': rcs_type_map[code_import.rcs_type],
'location': location,
}
from_address = format_address(user.displayname, user.preferredemail.email)
vcs_imports = getUtility(ILaunchpadCelebrities).vcs_imports
headers = {
'X-Launchpad-Branch': code_import.branch.unique_name,
'X-Launchpad-Message-Rationale': 'Operator @%s' % vcs_imports.name,
'X-Launchpad-Notification-Type': 'code-import',
}
for address in get_contact_email_addresses(vcs_imports):
simple_sendmail(from_address, address, subject, body, headers)
def test_person_with_hidden_email(self):
user = self.factory.makePerson(email='*****@*****.**',
hide_email_addresses=True,
name='user')
result = get_contact_email_addresses(user)
self.assertEqual(set(['*****@*****.**']), result)
def notify(self, extra_info=None):
"""See `IPackageBuild`.
If config.buildmaster.build_notification is disable, simply
return.
If config.builddmaster.notify_owner is enabled and SPR.creator
has preferredemail it will send an email to the creator, Bcc:
to the config.builddmaster.default_recipient. If one of the
conditions was not satisfied, no preferredemail found (autosync
or untouched packages from debian) or config options disabled,
it will only send email to the specified default recipient.
This notification will contain useful information about
the record in question (all states are supported), see
doc/build-notification.txt for further information.
"""
if not config.builddmaster.send_build_notification:
return
if self.status == BuildStatus.FULLYBUILT:
return
recipients = set()
fromaddress = format_address(
config.builddmaster.default_sender_name,
config.builddmaster.default_sender_address)
extra_headers = {
'X-Launchpad-Build-State': self.status.name,
'X-Launchpad-Build-Component': self.current_component.name,
'X-Launchpad-Build-Arch':
self.distro_arch_series.architecturetag,
}
# XXX cprov 2006-10-27: Temporary extra debug info about the
# SPR.creator in context, to be used during the service quarantine,
# notify_owner will be disabled to avoid *spamming* Debian people.
creator = self.source_package_release.creator
extra_headers['X-Creator-Recipient'] = ",".join(
get_contact_email_addresses(creator))
# Currently there are 7038 SPR published in edgy which the creators
# have no preferredemail. They are the autosync ones (creator = katie,
# 3583 packages) and the untouched sources since we have migrated from
# DAK (the rest). We should not spam Debian maintainers.
# Please note that both the package creator and the package uploader
# will be notified of failures if:
# * the 'notify_owner' flag is set
# * the package build (failure) occurred in the original
# archive.
package_was_not_copied = (
self.archive == self.source_package_release.upload_archive)
if package_was_not_copied and config.builddmaster.notify_owner:
if (self.archive.is_ppa and creator.inTeam(self.archive.owner)
or
not self.archive.is_ppa):
# If this is a PPA, the package creator should only be
# notified if they are the PPA owner or in the PPA team.
# (see bug 375757)
# Non-PPA notifications inform the creator regardless.
recipients = recipients.union(
get_contact_email_addresses(creator))
dsc_key = self.source_package_release.dscsigningkey
if dsc_key:
recipients = recipients.union(
get_contact_email_addresses(dsc_key.owner))
# Modify notification contents according to the targeted archive.
# 'Archive Tag', 'Subject' and 'Source URL' are customized for PPA.
# We only send build-notifications to 'buildd-admin' celebrity for
# main archive candidates.
# For PPA build notifications we include the archive.owner
# contact_address.
if not self.archive.is_ppa:
buildd_admins = getUtility(ILaunchpadCelebrities).buildd_admin
recipients = recipients.union(
get_contact_email_addresses(buildd_admins))
archive_tag = '%s primary archive' % self.distribution.name
subject = "[Build #%d] %s" % (self.id, self.title)
source_url = canonical_url(self.distributionsourcepackagerelease)
else:
recipients = recipients.union(
get_contact_email_addresses(self.archive.owner))
# For PPAs we run the risk of having no available contact_address,
# for instance, when both, SPR.creator and Archive.owner have
# not enabled it.
if len(recipients) == 0:
return
archive_tag = '%s PPA' % get_ppa_reference(self.archive)
subject = "[Build #%d] %s (%s)" % (
self.id, self.title, archive_tag)
source_url = 'not available'
extra_headers['X-Launchpad-PPA'] = get_ppa_reference(self.archive)
# XXX cprov 2006-08-02: pending security recipients for SECURITY
# pocket build. We don't build SECURITY yet :(
# XXX cprov 2006-08-02: find out a way to glue parameters reported
# with the state in the build worflow, maybe by having an
# IBuild.statusReport property, which could also be used in the
# respective page template.
if self.status in [
BuildStatus.NEEDSBUILD, BuildStatus.SUPERSEDED]:
# untouched builds
buildduration = 'not available'
buildlog_url = 'not available'
builder_url = 'not available'
elif self.status == BuildStatus.UPLOADING:
buildduration = 'uploading'
buildlog_url = 'see builder page'
builder_url = 'not available'
elif self.status == BuildStatus.BUILDING:
# build in process
buildduration = 'not finished'
buildlog_url = 'see builder page'
builder_url = canonical_url(self.buildqueue_record.builder)
else:
# completed states (success and failure)
buildduration = DurationFormatterAPI(
self.duration).approximateduration()
buildlog_url = self.log_url
builder_url = canonical_url(self.builder)
if self.status == BuildStatus.FAILEDTOUPLOAD:
assert extra_info is not None, (
'Extra information is required for FAILEDTOUPLOAD '
'notifications.')
extra_info = 'Upload log:\n%s' % extra_info
else:
extra_info = ''
template = get_email_template('build-notification.txt', app='soyuz')
replacements = {
'source_name': self.source_package_release.name,
'source_version': self.source_package_release.version,
'architecturetag': self.distro_arch_series.architecturetag,
'build_state': self.status.title,
'build_duration': buildduration,
'buildlog_url': buildlog_url,
'builder_url': builder_url,
'build_title': self.title,
'build_url': canonical_url(self),
'source_url': source_url,
'extra_info': extra_info,
'archive_tag': archive_tag,
'component_tag': self.current_component.name,
}
message = template % replacements
for toaddress in recipients:
simple_sendmail(
fromaddress, toaddress, subject, message,
headers=extra_headers)
def test_user_with_preferredemail(self):
user = self.factory.makePerson(
email='*****@*****.**', name='user',)
result = get_contact_email_addresses(user)
self.assertEqual(set(['*****@*****.**']), result)
def run(self):
"""See `IMembershipNotificationJob`."""
from lp.services.scripts import log
from_addr = format_address(
self.team.displayname, config.canonical.noreply_from_address)
admin_emails = self.team.getTeamAdminsEmailAddresses()
# person might be a self.team, so we can't rely on its preferredemail.
self.member_email = get_contact_email_addresses(self.member)
# Make sure we don't send the same notification twice to anybody.
for email in self.member_email:
if email in admin_emails:
admin_emails.remove(email)
if self.reviewer != self.member:
self.reviewer_name = self.reviewer.unique_displayname
else:
self.reviewer_name = 'the user'
if self.last_change_comment:
comment = ("\n%s said:\n %s\n" % (
self.reviewer.displayname, self.last_change_comment.strip()))
else:
comment = ""
replacements = {
'member_name': self.member.unique_displayname,
'recipient_name': self.member.displayname,
'team_name': self.team.unique_displayname,
'team_url': canonical_url(self.team),
'old_status': self.old_status.title,
'new_status': self.new_status.title,
'reviewer_name': self.reviewer_name,
'comment': comment}
template_name = 'membership-statuschange'
subject = (
'Membership change: %(member)s in %(team)s'
% {
'member': self.member.name,
'team': self.team.name,
})
if self.new_status == TeamMembershipStatus.EXPIRED:
template_name = 'membership-expired'
subject = '%s expired from team' % self.member.name
elif (self.new_status == TeamMembershipStatus.APPROVED and
self.old_status != TeamMembershipStatus.ADMIN):
if self.old_status == TeamMembershipStatus.INVITED:
subject = ('Invitation to %s accepted by %s'
% (self.member.name, self.reviewer.name))
template_name = 'membership-invitation-accepted'
elif self.old_status == TeamMembershipStatus.PROPOSED:
subject = '%s approved by %s' % (
self.member.name, self.reviewer.name)
else:
subject = '%s added by %s' % (
self.member.name, self.reviewer.name)
elif self.new_status == TeamMembershipStatus.INVITATION_DECLINED:
subject = ('Invitation to %s declined by %s'
% (self.member.name, self.reviewer.name))
template_name = 'membership-invitation-declined'
elif self.new_status == TeamMembershipStatus.DEACTIVATED:
subject = '%s deactivated by %s' % (
self.member.name, self.reviewer.name)
elif self.new_status == TeamMembershipStatus.ADMIN:
subject = '%s made admin by %s' % (
self.member.name, self.reviewer.name)
elif self.new_status == TeamMembershipStatus.DECLINED:
subject = '%s declined by %s' % (
self.member.name, self.reviewer.name)
else:
# Use the default template and subject.
pass
# Must have someone to mail, and be a non-open team (because open
# teams are unrestricted, notifications on join/ leave do not help the
# admins.
if (len(admin_emails) != 0 and
self.team.membership_policy != TeamMembershipPolicy.OPEN):
admin_template = get_email_template(
"%s-bulk.txt" % template_name, app='registry')
for address in admin_emails:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
msg = MailWrapper().format(
admin_template % replacements, force_wrap=True)
simple_sendmail(from_addr, address, subject, msg)
# The self.member can be a self.self.team without any
# self.members, and in this case we won't have a single email
# address to send this notification to.
if self.member_email and self.reviewer != self.member:
if self.member.is_team:
template = '%s-bulk.txt' % template_name
else:
template = '%s-personal.txt' % template_name
self.member_template = get_email_template(
template, app='registry')
for address in self.member_email:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
msg = MailWrapper().format(
self.member_template % replacements, force_wrap=True)
simple_sendmail(from_addr, address, subject, msg)
log.debug('MembershipNotificationJob sent email')
def notify_team_join(event):
"""Notify team admins that someone has asked to join the team.
If the team's policy is Moderated, the email will say that the membership
is pending approval. Otherwise it'll say that the person has joined the
team and who added that person to the team.
"""
person = event.person
team = event.team
membership = getUtility(ITeamMembershipSet).getByPersonAndTeam(
person, team)
assert membership is not None
approved, admin, proposed = [
TeamMembershipStatus.APPROVED, TeamMembershipStatus.ADMIN,
TeamMembershipStatus.PROPOSED]
admin_addrs = team.getTeamAdminsEmailAddresses()
from_addr = format_address(
team.displayname, config.canonical.noreply_from_address)
reviewer = membership.proposed_by
if reviewer != person and membership.status in [approved, admin]:
reviewer = membership.reviewed_by
# Somebody added this person as a member, we better send a
# notification to the person too.
member_addrs = get_contact_email_addresses(person)
headers = {}
if person.is_team:
templatename = 'new-member-notification-for-teams.txt'
subject = '%s joined %s' % (person.name, team.name)
header_rational = "Indirect member (%s)" % team.name
footer_rationale = (
"You received this email because "
"%s is the new member." % person.name)
else:
templatename = 'new-member-notification.txt'
subject = 'You have been added to %s' % team.name
header_rational = "Member (%s)" % team.name
footer_rationale = (
"You received this email because you are the new member.")
if team.mailing_list is not None:
template = get_email_template(
'team-list-subscribe-block.txt', app='registry')
editemails_url = urlappend(
canonical_url(getUtility(ILaunchpadRoot)),
'people/+me/+editemails')
list_instructions = template % dict(editemails_url=editemails_url)
else:
list_instructions = ''
template = get_email_template(templatename, app='registry')
replacements = {
'reviewer': '%s (%s)' % (reviewer.displayname, reviewer.name),
'team_url': canonical_url(team),
'member': '%s (%s)' % (person.displayname, person.name),
'team': '%s (%s)' % (team.displayname, team.name),
'list_instructions': list_instructions,
}
headers = {'X-Launchpad-Message-Rationale': header_rational}
for address in member_addrs:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
send_team_email(
from_addr, address, subject, template, replacements,
footer_rationale, headers)
# The member's email address may be in admin_addrs too; let's remove
# it so the member don't get two notifications.
admin_addrs = set(admin_addrs).difference(set(member_addrs))
# Yes, we can have teams with no members; not even admins.
if not admin_addrs:
return
# Open teams do not notify admins about new members.
if team.membership_policy == TeamMembershipPolicy.OPEN:
return
replacements = {
'person_name': "%s (%s)" % (person.displayname, person.name),
'team_name': "%s (%s)" % (team.displayname, team.name),
'reviewer_name': "%s (%s)" % (reviewer.displayname, reviewer.name),
'url': canonical_url(membership)}
headers = {}
if membership.status in [approved, admin]:
template = get_email_template(
'new-member-notification-for-admins.txt', app='registry')
subject = '%s joined %s' % (person.name, team.name)
elif membership.status == proposed:
# In the UI, a user can only propose himself or a team he
# admins. Some users of the REST API have a workflow, where
# they propose users that are designated as mentees (Bug 498181).
if reviewer != person:
headers = {"Reply-To": reviewer.preferredemail.email}
template = get_email_template(
'pending-membership-approval-for-third-party.txt',
app='registry')
else:
headers = {"Reply-To": person.preferredemail.email}
template = get_email_template(
'pending-membership-approval.txt', app='registry')
subject = "%s wants to join" % person.name
else:
raise AssertionError(
"Unexpected membership status: %s" % membership.status)
for address in admin_addrs:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
if recipient.is_team:
header_rationale = 'Admin (%s via %s)' % (
team.name, recipient.name)
footer_rationale = (
"you are an admin of the %s team\n"
"via the %s team." % (
team.displayname, recipient.displayname))
elif recipient == team.teamowner:
header_rationale = 'Owner (%s)' % team.name
footer_rationale = (
"you are the owner of the %s team." % team.displayname)
else:
header_rationale = 'Admin (%s)' % team.name
footer_rationale = (
"you are an admin of the %s team." % team.displayname)
footer = 'You received this email because %s' % footer_rationale
headers['X-Launchpad-Message-Rationale'] = header_rationale
send_team_email(
from_addr, address, subject, template, replacements,
footer, headers)
def sendExpirationWarningEmail(self):
"""See `ITeamMembership`."""
if self.dateexpires is None:
raise AssertionError(
'%s in team %s has no membership expiration date.' %
(self.person.name, self.team.name))
if self.dateexpires < datetime.now(pytz.timezone('UTC')):
# The membership has reached expiration. Silently return because
# there is nothing to do. The member will have received emails
# from previous calls by flag-expired-memberships.py
return
member = self.person
team = self.team
if member.is_team:
recipient = member.teamowner
templatename = 'membership-expiration-warning-bulk.txt'
subject = '%s will expire soon from %s' % (member.name, team.name)
else:
recipient = member
templatename = 'membership-expiration-warning-personal.txt'
subject = 'Your membership in %s is about to expire' % team.name
if team.renewal_policy == TeamMembershipRenewalPolicy.ONDEMAND:
how_to_renew = (
"If you want, you can renew this membership at\n"
"<%s/+expiringmembership/%s>"
% (canonical_url(member), team.name))
elif not self.canChangeExpirationDate(recipient):
admins_names = []
admins = team.getDirectAdministrators()
assert admins.count() >= 1
if admins.count() == 1:
admin = admins[0]
how_to_renew = (
"To prevent this membership from expiring, you should "
"contact the\nteam's administrator, %s.\n<%s>"
% (admin.unique_displayname, canonical_url(admin)))
else:
for admin in admins:
admins_names.append(
"%s <%s>" % (admin.unique_displayname,
canonical_url(admin)))
how_to_renew = (
"To prevent this membership from expiring, you should "
"get in touch\nwith one of the team's administrators:\n")
how_to_renew += "\n".join(admins_names)
else:
how_to_renew = (
"To stay a member of this team you should extend your "
"membership at\n<%s/+member/%s>"
% (canonical_url(team), member.name))
to_addrs = get_contact_email_addresses(recipient)
if len(to_addrs) == 0:
# The user does not have a preferred email address, he was
# probably suspended.
return
formatter = DurationFormatterAPI(
self.dateexpires - datetime.now(pytz.timezone('UTC')))
replacements = {
'recipient_name': recipient.displayname,
'member_name': member.unique_displayname,
'team_url': canonical_url(team),
'how_to_renew': how_to_renew,
'team_name': team.unique_displayname,
'expiration_date': self.dateexpires.strftime('%Y-%m-%d'),
'approximate_duration': formatter.approximateduration()}
msg = get_email_template(templatename, app='registry') % replacements
from_addr = format_address(
team.displayname, config.canonical.noreply_from_address)
simple_sendmail(from_addr, to_addrs, subject, msg)
def notify_team_join(event):
"""Notify team admins that someone has asked to join the team.
If the team's policy is Moderated, the email will say that the membership
is pending approval. Otherwise it'll say that the person has joined the
team and who added that person to the team.
"""
person = event.person
team = event.team
membership = getUtility(ITeamMembershipSet).getByPersonAndTeam(
person, team)
assert membership is not None
approved, admin, proposed = [
TeamMembershipStatus.APPROVED, TeamMembershipStatus.ADMIN,
TeamMembershipStatus.PROPOSED
]
admin_addrs = team.getTeamAdminsEmailAddresses()
from_addr = format_address(team.displayname,
config.canonical.noreply_from_address)
reviewer = membership.proposed_by
if reviewer != person and membership.status in [approved, admin]:
reviewer = membership.reviewed_by
# Somebody added this person as a member, we better send a
# notification to the person too.
member_addrs = get_contact_email_addresses(person)
headers = {}
if person.is_team:
templatename = 'new-member-notification-for-teams.txt'
subject = '%s joined %s' % (person.name, team.name)
header_rational = "Indirect member (%s)" % team.name
footer_rationale = ("You received this email because "
"%s is the new member." % person.name)
else:
templatename = 'new-member-notification.txt'
subject = 'You have been added to %s' % team.name
header_rational = "Member (%s)" % team.name
footer_rationale = (
"You received this email because you are the new member.")
if team.mailing_list is not None:
template = get_email_template('team-list-subscribe-block.txt',
app='registry')
editemails_url = urlappend(
canonical_url(getUtility(ILaunchpadRoot)),
'people/+me/+editemails')
list_instructions = template % dict(editemails_url=editemails_url)
else:
list_instructions = ''
template = get_email_template(templatename, app='registry')
replacements = {
'reviewer': '%s (%s)' % (reviewer.displayname, reviewer.name),
'team_url': canonical_url(team),
'member': '%s (%s)' % (person.displayname, person.name),
'team': '%s (%s)' % (team.displayname, team.name),
'list_instructions': list_instructions,
}
headers = {'X-Launchpad-Message-Rationale': header_rational}
for address in member_addrs:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
send_team_email(from_addr, address, subject, template,
replacements, footer_rationale, headers)
# The member's email address may be in admin_addrs too; let's remove
# it so the member don't get two notifications.
admin_addrs = set(admin_addrs).difference(set(member_addrs))
# Yes, we can have teams with no members; not even admins.
if not admin_addrs:
return
# Open teams do not notify admins about new members.
if team.membership_policy == TeamMembershipPolicy.OPEN:
return
replacements = {
'person_name': "%s (%s)" % (person.displayname, person.name),
'team_name': "%s (%s)" % (team.displayname, team.name),
'reviewer_name': "%s (%s)" % (reviewer.displayname, reviewer.name),
'url': canonical_url(membership)
}
headers = {}
if membership.status in [approved, admin]:
template = get_email_template('new-member-notification-for-admins.txt',
app='registry')
subject = '%s joined %s' % (person.name, team.name)
elif membership.status == proposed:
# In the UI, a user can only propose himself or a team he
# admins. Some users of the REST API have a workflow, where
# they propose users that are designated as mentees (Bug 498181).
if reviewer != person:
headers = {"Reply-To": reviewer.preferredemail.email}
template = get_email_template(
'pending-membership-approval-for-third-party.txt',
app='registry')
else:
headers = {"Reply-To": person.preferredemail.email}
template = get_email_template('pending-membership-approval.txt',
app='registry')
subject = "%s wants to join" % person.name
else:
raise AssertionError("Unexpected membership status: %s" %
membership.status)
for address in admin_addrs:
recipient = getUtility(IPersonSet).getByEmail(address)
replacements['recipient_name'] = recipient.displayname
if recipient.is_team:
header_rationale = 'Admin (%s via %s)' % (team.name,
recipient.name)
footer_rationale = ("you are an admin of the %s team\n"
"via the %s team." %
(team.displayname, recipient.displayname))
elif recipient == team.teamowner:
header_rationale = 'Owner (%s)' % team.name
footer_rationale = ("you are the owner of the %s team." %
team.displayname)
else:
header_rationale = 'Admin (%s)' % team.name
footer_rationale = ("you are an admin of the %s team." %
team.displayname)
footer = 'You received this email because %s' % footer_rationale
headers['X-Launchpad-Message-Rationale'] = header_rationale
send_team_email(from_addr, address, subject, template, replacements,
footer, headers)
