summaryrefslogtreecommitdiff
path: root/Mailman/Bouncers/BouncerAPI.py
blob: 7c6c5aabc89d6e0551bd7e4ec158d5140708edfc (plain) (blame)
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
# Copyright (C) 1998 by the Free Software Foundation, Inc.
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software 
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

"""Contains all the common functionality for msg bounce scanning API.

This module can also be used as the basis for a bounce detection testing
framework.  When run as a script, it expects two arguments, the listname and
the filename containing the bounce message.

"""

# testing kludge
if __name__ == '__main__':
    execfile('bin/paths.py')

from types import ListType
from Mailman import mm_cfg
from Mailman import Errors



# msg must be a mimetools.Message
def ScanMessages(mlist, msg, testing=0):
    pipeline = ['DSN',
                'Qmail',
                'Postfix',
                'Yahoo',
                'Caiwireless',
                'Smail',
                'Catchall',
                ]
    for modname in pipeline:
        mod = __import__('Mailman.Bouncers.'+modname)
        func = getattr(getattr(getattr(mod, 'Bouncers'), modname), 'process')
        addrs = func(mlist, msg)
        if addrs:
            for addr in addrs:
                # we found a bounce or a list of bounce addrs
                if not testing:
                    mlist.RegisterBounce(addr, msg)
                else:
                    print '    Bounce of %s detected by module %s' % (
                        addr, modname)
            # we saw some bounces
            return 1
    # no bounces detected
    return 0



# for testing
if __name__ == '__main__':
    import mimetools
    from Mailman import MailList

    def usage(code, msg=''):
        print __doc__
        if msg:
            print msg
        sys.exit(code)

    if len(sys.argv) < 3:
        usage(1, 'required arguments: <list> <file> [, <file> ...]')

    listname = sys.argv[1]
    mlist = MailList.MailList(listname, lock=0)

    for filename in sys.argv[2:]:
        print 'scanning file', filename
        fp = open(filename)
        msg = mimetools.Message(fp)
        ScanMessages(mlist, msg, testing=1)
        fp.close()