/usr/share/pyshared/zope/sendmail/zcml.py is in python-zope.sendmail 3.7.5-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | ##############################################################################
#
# Copyright (c) 2001, 2002 Zope Corporation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""'mail' ZCML Namespaces Schemas
$Id: zcml.py 126456 2012-05-23 13:20:12Z tseaver $
"""
__docformat__ = 'restructuredtext'
from zope.component import queryUtility
from zope.component.zcml import handler
from zope.configuration.fields import Path
from zope.configuration.exceptions import ConfigurationError
from zope.interface import Interface
from zope.schema import TextLine, BytesLine, Int, Bool
from zope.sendmail.delivery import QueuedMailDelivery, DirectMailDelivery
from zope.sendmail.interfaces import IMailer, IMailDelivery
from zope.sendmail.mailer import SMTPMailer
from zope.sendmail.queue import QueueProcessorThread
try:
from zope.component.security import proxify
from zope.security.zcml import Permission
except ImportError:
SECURITY_SUPPORT = False
from zope.schema import TextLine as Permission
else:
SECURITY_SUPPORT = True
def _assertPermission(permission, interfaces, component):
if not SECURITY_SUPPORT:
raise ConfigurationError("security proxied components are not "
"supported because zope.security is not available")
return proxify(component, provides=interfaces, permission=permission)
class IDeliveryDirective(Interface):
"""This abstract directive describes a generic mail delivery utility
registration."""
name = TextLine(
title=u"Name",
description=u'Specifies the Delivery name of the mail utility. '\
u'The default is "Mail".',
default=u"Mail",
required=False)
mailer = TextLine(
title=u"Mailer",
description=u"Defines the mailer to be used for sending mail.",
required=True)
permission = Permission(
title=u"Permission",
description=u"Defines the permission needed to use this service.",
required=False)
class IQueuedDeliveryDirective(IDeliveryDirective):
"""This directive creates and registers a global queued mail utility. It
should be only called once during startup."""
queuePath = Path(
title=u"Queue Path",
description=u"Defines the path for the queue directory.",
required=True)
processorThread = Bool(
title=u"Run Queue Processor Thread",
description=u"Indicates whether to run queue processor in a thread "
"in this process.",
required=False,
default=True)
def queuedDelivery(_context, queuePath, mailer, permission=None, name="Mail",
processorThread=True):
def createQueuedDelivery():
delivery = QueuedMailDelivery(queuePath)
if permission is not None:
delivery = _assertPermission(permission, IMailDelivery, delivery)
handler('registerUtility', delivery, IMailDelivery, name)
mailerObject = queryUtility(IMailer, mailer)
if mailerObject is None:
raise ConfigurationError("Mailer %r is not defined" %mailer)
if processorThread:
thread = QueueProcessorThread()
thread.setMailer(mailerObject)
thread.setQueuePath(queuePath)
thread.start()
_context.action(
discriminator = ('utility', IMailDelivery, name),
callable = createQueuedDelivery,
args = () )
class IDirectDeliveryDirective(IDeliveryDirective):
"""This directive creates and registers a global direct mail utility. It
should be only called once during startup."""
def directDelivery(_context, mailer, permission=None, name="Mail"):
def createDirectDelivery():
mailerObject = queryUtility(IMailer, mailer)
if mailerObject is None:
raise ConfigurationError("Mailer %r is not defined" %mailer)
delivery = DirectMailDelivery(mailerObject)
if permission is not None:
delivery = _assertPermission(permission, IMailDelivery, delivery)
handler('registerUtility', delivery, IMailDelivery, name)
_context.action(
discriminator = ('utility', IMailDelivery, name),
callable = createDirectDelivery,
args = () )
class IMailerDirective(Interface):
"""A generic directive registering a mailer for the mail utility."""
name = TextLine(
title=u"Name",
description=u"Name of the Mailer.",
required=True)
class ISMTPMailerDirective(IMailerDirective):
"""Registers a new SMTP mailer."""
hostname = BytesLine(
title=u"Hostname",
description=u"Hostname of the SMTP host.",
default="localhost",
required=False)
port = Int(
title=u"Port",
description=u"Port of the SMTP server.",
default=25,
required=False)
username = TextLine(
title=u"Username",
description=u"A username for SMTP AUTH.",
required=False)
password = TextLine(
title=u"Password",
description=u"A password for SMTP AUTH.",
required=False)
def smtpMailer(_context, name, hostname="localhost", port="25",
username=None, password=None):
_context.action(
discriminator = ('utility', IMailer, name),
callable = handler,
args = ('registerUtility',
SMTPMailer(hostname, port, username, password), IMailer, name)
)
|