def pm_write(sender,
recipient,
subject,
body='',
skip_notification=False,
auto_archive=False,
auto_delete=False,
auto_moderators=None,
job=None,
project=None):
"""
Write a message to a User.
Contrary to pm_broadcast(), the message is archived and/or deleted on
the sender side only if requested.
The message may come from an untrusted application, a gateway for example,
so it may be useful to involve some auto moderators in the processing.
Optional arguments:
``skip_notification``: if the normal notification event is not wished
``auto_archive``: to mark the message as archived on the sender side
``auto_delete``: to mark the message as deleted on the sender side
``auto_moderators``: a list of auto-moderation functions
"""
message = Message(subject=subject,
body=body,
sender=sender,
recipient=recipient)
if job:
message.job = job
message.project = job.project
if project:
message.project = project
initial_status = message.moderation_status
if auto_moderators:
message.auto_moderate(auto_moderators)
else:
message.moderation_status = STATUS_ACCEPTED
message.clean_moderation(initial_status)
if auto_archive:
message.sender_archived = True
if auto_delete:
message.sender_deleted_at = now()
message.save()
if not skip_notification:
message.notify_users(initial_status, _get_site())
return message
