File: PKG-INFO

package info (click to toggle)
zope-maildrophost 2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, wheezy
  • size: 412 kB
  • ctags: 161
  • sloc: python: 1,181; sh: 290; makefile: 38
file content (256 lines) | stat: -rw-r--r-- 10,696 bytes parent folder | download | duplicates (2)
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
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
Metadata-Version: 1.0
Name: Products.MaildropHost
Version: 2.3
Summary: Asynchronous transaction-aware MailHost replacement for Zope 2
Home-page: http://pypi.python.org/pypi/Products.MaildropHost
Author: Jens Vagelpohl
Author-email: jens@dataflake.org
License: ZPL 2.1 (http://www.zope.org/Resources/License/ZPL-2.1)
Description: =======================
        Products.MaildropHost
        =======================
        
        .. contents::
        
        The MaildropHost product provides support for sending email from
        within the Zope environment using MaildropHost objects. Unlike the
        built-in MailHost object, the sending is done asynchronously from
        a separate process. Furthermore, MaildropHost can optionally
        integrate with the Zope transaction machinery to ensure that
        retried transactions do not lead to multiple emails being created.
        
        The advantage is that sending mail from within web pages becomes
        much faster because invoking the mail machinery can be slow. With
        MaildropHost the web page will return immediately.
        
        MaildropHost uses a separate Python process to monitor the mail
        spool inside the product and handle mail in intervals that can be
        set by the administrator. There are separate start scripts included
        with the product which can be used to start this monitor process.
        
        Mails that cannot be sent successfully stay in the internal spool.
        Every attempt to send email is logged to a log file kept by the
        monitor process. This log file is closed after each maildrop run,
        so it is safe to rotate it without sending any special signals to
        the maildrop daemon.
        
        The maildrop daemon that delivers mail supports StartTLS and even
        authenticated SMTP.
        
        Starting with Zope version 2.11.0-beta the standard MailHost
        implementation does asynchronous mail handling as well. If you run
        Zope 2.11 and up you should look at the standard MailHost product
        first and see if it fits your requirement before installing the
        MaildropHost product.
        
        Bug tracker
        ===========
        
        Please post questions, bug reports or feature requests to the bug tracker
        at http://www.dataflake.org/tracker/
        
        SVN version
        ===========
        
        You can retrieve the latest code from Subversion using setuptools or
        zc.buildout via this URL:
        
        http://svn.dataflake.org/svn/Products.MaildropHost/trunk#egg=Products.MaildropHost
        
        
        Usage
        =====
        
        Follow these steps to use the product after installation:
        
        - edit the "config" configuration script in the toplevel
        MaildropHost folder to reflect your particular needs, or
        (optionally) add your own config file in a different location
        on the filesystem. See below for how to use a configuration
        file from a non-standard location.
        
        - start the mail spool checker by running the "start_maildrop"
        script or with the other start scripts included in the package,
        which can be found in maildrop/bin underneath the toplevel
        MaildropHost folder. Edit the startup script to point to your
        chosen configuration file.
        
        - instantiate a MaildropHost instance in your ZODB; if you
        created a config file in a different location, specify the
        filesystem path using the 'Configuration file path' setting
        on the ZMI 'Edit' tab.
        
        - Now you can create emails using e.g. the dtml-sendmail tag and
        point the sendmail tag to the MaildropHost instance using the
        mailhost="XYZ" argument inside the sendmail tag, or by using
        the MailHost API (see the Zope Help System).
        
        Instead of using dtml-sendmail and a MaildropHost instance you can
        create email messages any way you like. As long as the formatting is
        correct (so that the mail spool checker can parse it, see the file
        SAMPLE_MAIL.txt for an example) and you write it to the spool
        directory which is at $MAILDROP_HOME/spool (or $MAILDROP_SPOOL if
        defined) then the mail spool checker will pick it up and try to
        deliver it.
        
        To add more choices to the 'Configuration file path' option in
        the ZMI, you need to add them to your Zope instance configuration
        file, zope.conf. You need to create a section named 'product-config
        maildrophost' and list paths as keys starting with 'config-path'::
        
        <product-config maildrophost>
        config-path-1 /tmp/myconfig
        config-path-2 /usr/local/mail/maildropconfig
        </product-config>
        
        The keys must be unique since ZConfig does not allow duplicate keys in
        a 'product-config' configuration section. You have to restart Zope
        for those changes to be visible in the ZMI.
        
        If you use different MaildropHost configurations you will need to
        copy the start/stop scripts found in maildrop/bin and adjust the
        configuration file path accordingly.
        
        
        Mail file format
        ================
        
        The format for a mail file (see SAMPLE_MAIL.txt) is very simple. The
        first line contains the recipient address, prefixed by "##To:". The
        second line is the sender address, prefixed by "##From:". These are
        equivalent to the "envelope" sender and receiver addresses.
        
        The next few lines are headers that become part of the message body,
        they are "To: <recipient>", "From: <sender>" and "Subject: <subject>".
        
        The actual message is separated from the headers by a blank line.
        
        
        ------------------------------------------------------------
        
        Installation requirements
        =========================
        
        - a working SMTP server
        
        - Zope 2.8.0 or higher
        
        - A UNIX operating system to run the maildrop daemon. It does not work
        on Windows.
        
        
        Installation
        ============
        
        If you do not install MaildropHost as an egg, you can manually copy the
        MaildropHost folder from Products.MaildropHost/Products/MaildropHost
        into a place where Zope can find it, like the "Products" directory:
        
        $ cp -r Products.MaildropHost/Products/MaildropHost <zope>/lib/python/Products/
        
        Do not forget to restart Zope afterwards.
        
        You will find a file named "config" in the MaildropHost folder.
        This file contains all site-specific settings and you must
        edit it to suit your needs. IMPORTANT: Since this file is also
        sourced by a few shell scripts you must not put any whitespace
        around equal (=) signs!
        
        Startup scripts for the standalone maildrop daemon, which processes
        mail items generated by the MaildropHost Zope product, can be found
        inside the <MaildropHost>/maildrop/bin-folder. What these scripts
        do and how to use them is described in a separate README inside that
        folder.
        
        
        Upgrade notes
        =============
        
        - 1.21 to 1.22: The configuration file parsing mechanism changed, it's no
        longer a Python import. The code will now look for a file named `config`
        instead of `config.py`. However, the file contents have not changed, your
        existing MaildropHost configuration file contents remain valid.
        
        
        ------------------------------------------------------------
        
        MaildropHost change log
        =======================
        
        2.3 (2009-10-09)
        ----------------
        
        - Feature: Added a method for extending the list of configuration
        file paths programatically.
        (http://www.dataflake.org/tracker/issue_00649)
        
        
        2.2 (2009-05-29)
        ----------------
        
        - Bug: If a configuration file path has been set, but the file is
        removed later, Zope would no longer start up as the
        MaildropHost code attempts to load the file but fails. Now it
        will fall back to the default file path in this case.
        (http://www.dataflake.org/tracker/issue_00642)
        
        - Bug: Replace file paths pointing to config.py as opposed to
        the new config in stop_maildrop and testing/start_maildrop
        (http://www.dataflake.org/tracker/issue_00641)
        
        - Remove a few extraneous log file close calls in maildrop.py
        (http://www.dataflake.org/tracker/issue_00636)
        
        - fix testing to detect Zope trunk
        
        
        2.1 (2008-11-03)
        ----------------
        
        - compatibility work for Zope 2.11
        
        
        2.0 (2008-11-01)
        ----------------
        
        - Switch to releasing MaildropHost as egg
        
        - clean up Python module preambles based on the standard set by Zope
        itself.
        
        - clean up Subversion keyword tagging to use the Id tag all over
        
        - major test refactoring and simplifications
        
        - The MaildropHost class is now marked to implement IMailHost, just
        like the standard Zope 2 MailHost.
        
        - The configuration file for each MaildropHost instance can now be selected
        in the ZMI on the 'Edit' tab. By default, the dropdown will show the file
        'config' in the MaildropHost directory. The site administrator can add
        more paths using the Zope instance configuration file zope.conf. Please
        see README.txt to find out how.
        
        - cleaned up the help system content and use the name "MaildropHost" as
        opposed to "Maildrop Host" wherever possible.
        
        
        Previous releases
        -----------------
        
        See HISTORY.txt
        
        ------------------------------------------------------------
        
        Download
        ========
Keywords: web zope zope2 mail smtp
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Zope2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Software Development