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
|
# Copyright (C) 2006-2007 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
# USA.
"""Initialize all global state.
Every entrance into the Mailman system, be it by command line, mail program,
or cgi, must call the initialize function here in order for the system's
global state to be set up properly. Typically this is called after command
line argument parsing, since some of the initialization behavior is controlled
by the command line arguments.
"""
import os
import sys
import pkg_resources
from zope.interface.verify import verifyObject
import Mailman.configuration
import Mailman.ext
import Mailman.loginit
from Mailman.interfaces import IDatabase
# These initialization calls are separated for the testing framework, which
# needs to do some internal calculations after config file loading and log
# initialization, but before database initialization. Generally all other
# code will just call initialize().
def initialize_1(config, propagate_logs):
# By default, set the umask so that only owner and group can read and
# write our files. Specifically we must have g+rw and we probably want
# o-rwx although I think in most cases it doesn't hurt if other can read
# or write the files. Note that the Pipermail archive has more
# restrictive permissions in order to handle private archives, but it
# handles that correctly.
os.umask(007)
Mailman.configuration.config.load(config)
# Create the queue and log directories if they don't already exist.
Mailman.configuration.config.ensure_directories_exist()
Mailman.loginit.initialize(propagate_logs)
# Set up site extensions directory
Mailman.ext.__path__.append(Mailman.configuration.config.EXT_DIR)
def initialize_2():
# Find all declared entry points in the mailman.database group. There
# must be exactly one or two such entry points defined. If there are two,
# then we remove the one called 'stock' since that's the one that we
# distribute and it's obviously being overridden. If we're still left
# with more than one after we filter out the stock one, it is an error.
entrypoints = list(pkg_resources.iter_entry_points('mailman.database'))
if len(entrypoints) == 0:
raise RuntimeError('No database entry points found')
elif len(entrypoints) == 1:
# Okay, this is the one to use.
entrypoint = entrypoints[0]
elif len(database) == 2:
# Find the one /not/ named 'stock'.
entrypoints = [ep for ep in entrypoints if ep.name <> 'stock']
if len(entrypoints) == 0:
raise RuntimeError('No database entry points found')
elif len(entrypoints) == 2:
raise RuntimeError('Too many database entry points defined')
else:
assert len(entrypoints) == 1, 'Insanity'
entrypoint = entrypoint[0]
else:
raise RuntimeError('Too many database entry points defined')
# Instantiate the database entry point, ensure that it's of the right
# type, and initialize it. Then stash the object on our configuration
# object.
ep_object = entrypoint.load()
db = ep_object()
verifyObject(IDatabase, db)
db.initialize()
Mailman.configuration.config.db = db
def initialize(config=None, propagate_logs=False):
initialize_1(config, propagate_logs)
initialize_2()
|
