MMRoster/ 40775 1000 144 0 7115504234 10663 5 ustar klm users MMRoster/MMRoster.py 100444 1000 144 16441 7115504234 13064 0 ustar klm users #!/bin/env python
# Set this to the root of your mailman installation:
MAILMAN_HOME = "~mailman"
# Establish the environment so that we can instantiate a mailing list...
import os
import sys
import string
import Acquisition
import AccessControl.Role
import OFS.SimpleItem
from Globals import HTMLFile, MessageDialog, Persistent
sys.path.insert(0, os.path.expanduser(MAILMAN_HOME))
from Mailman.MailList import MailList
from Mailman import Utils
DEBUG = 0
tracefname = "/tmp/MMRoster.log"
tracef = None
def trace(msg, *args):
"""Convenience for trace-flag debugging - writes to file iff DEBUG."""
global tracef
# We want to make sure to do msg % args to expose problems in the
# format string whether or not DEBUG is set - otherwise bugs there will
# be hidden until debugging is activated...
report = msg % args
if DEBUG:
from time import strftime, localtime, time
if not tracef:
tracef = open(tracefname, 'a')
os.chmod(tracefname, 0777)
report = (strftime("%m/%d %H:%M:%S ", localtime(time()))
+ " " + report)
tracef.write(report)
tracef.flush()
elif tracef:
tracef.close()
tracef = None
return report
# The publishable MMRoster class derives from this BaseMMRoster, further below.
class BaseMMRoster:
"""An interface for getting member rosters from mailman mailing lists."""
trace("BaseMMRoster class...\n")
def __init__(self, id, title, name=""):
trace("__init__...\n")
self.id = id
self.title = title
self.name = ""
if name:
self.use_list(name)
# We get and stash the members lists for a single use.
self.members = self.digest_members = None
trace("... __init__ done.\n")
def unsync(self):
"""Force us to resync with the list object on next reference."""
self.members = self.digest_members = None
def use_list(self, name="", lock=0):
"""Obtain a maillist object.
By default the list is unlocked (so we don't jam up the works.)"""
trace("use_list...\n")
if name in self.list_names():
self.name = name
mlist = MailList(name, lock=lock)
self.optionsURL = mlist.GetAbsoluteScriptURL('options')
self.members = mlist.members
self.digest_members = mlist.digest_members
else:
raise ValueError, 'No such list "%s" found' % name
trace("... use_list.\n")
def list_names(self):
"""Return a list of names of all mm mailing lists on the system."""
return Utils.list_names()
def regular_members_links(self):
"""Return a list of all regular members on the list."""
if not self.members and self.name:
self.use_list(self.name)
if self.members:
return linkify(self.optionsURL, self.members.keys())
else:
return []
def digest_members_links(self):
"""Return a list of all digest members on the list."""
if not self.digest_members and self.name:
self.use_list(self.name)
if self.digest_members:
return linkify(self.optionsURL, self.digest_members.keys())
else:
return []
trace("... BaseMMRoster class.\n")
def linkify(url, members):
"""Massage list of members addrs, formatted as "obscure" URLs."""
replace = string.replace
got = []
for i in members:
oi = replace(i, "__at__", "@")
toi = replace(i, "__at__", " at ")
got.append('%s'
% (url, oi, toi))
return got
class MMRoster(BaseMMRoster,
Acquisition.Implicit,
Persistent,
AccessControl.Role.RoleManager,
OFS.SimpleItem.Item,
):
"""A publishable Product interface to mailman list membership rosters.
This class has the Zope plumbing to make BaseMMRoster into a Product."""
trace("MMRoster class...\n")
icon='misc_/MMRoster/mmroster'
meta_type = 'MMRoster'
manage_options=({'label': 'Properties', 'action': 'manage_main'},
{'label': 'View', 'action': ''},
{'label': 'Security', 'action': 'manage_access'},
)
__ac_permissions__ = (
('View management screens', ('manage_tabs', 'manage_main')),
('Change permissions', ('manage_access',)),
('Change Mailman Roster', ('manage_edit')),
('View', ('', 'name', 'list_names', 'unsync',
'regular_members_links', 'digest_members_links',
'toggle_DEBUG',
),
('Anonymous', 'Manage', 'Mailman')),
)
index_html = HTMLFile("mmroster", globals())
manage_main = HTMLFile('editMMRosterForm', globals())
def __getstate__(self):
"""Pickle so that the members lists will be redetermined later."""
trace("__getstate__...\n")
self.members = self.digest_members = None
# Use some ExtensionClass magic to get the generic __getstate__.
got = MMRoster.inheritedAttribute('__getstate__')(self)
trace("... __getstate__ (nearly) done.\n")
return got
def user_edit(self, name, REQUEST=None):
"""(Re)set the mailing list name used by the roster."""
trace('user_edit in...\n')
if self.name != name:
self.use_list(name)
if REQUEST is not None:
# Just return to the list, presumably freshly named...
return REQUEST['RESPONSE'].redirect(REQUEST['URL1'])
def manage_edit(self, title, name, REQUEST=None):
"""(Re)set the mailing list name used by the roster."""
trace('manage_edit in...\n')
was_title = self.title
was_name = self.name
if title:
self.title = title
self.use_list(name)
if REQUEST is not None:
changes = []
if was_title != self.title:
changes.append("Title changed from %s" % `was_title`)
if was_name != self.name:
changes.append("List changed from %s" % `was_name`)
return self.manage_main(self, REQUEST, changes=changes)
trace("... MMRoster class.\n")
def toggle_DEBUG(self, REQUEST=None):
"""Url-accessible toggle of trace flag logging."""
global DEBUG
if DEBUG:
trace("DEACTIVATING debug logging.\n")
DEBUG = not DEBUG
if DEBUG:
trace("Debug logging ACTIVATED.\n")
if REQUEST is not None:
# Just return to the list, presumably freshly named...
return REQUEST['RESPONSE'].redirect(REQUEST['URL1'])
addMMRosterForm = HTMLFile('addMMRosterForm', globals())
def addMMRoster(self, id, title, REQUEST=None):
"""Create an MMRoster and install it in its parent Folder.
The argument 'self' will be bound to the parent Folder."""
roster = MMRoster(id, title)
self._setObject(id, roster)
if REQUEST is not None:
# Proceed right to the list-selection screen, using a redirect so
# the URL and context (environment, etc) is all correct.
return REQUEST['RESPONSE'].redirect("%s/%s/manage_main"
% (REQUEST['URL1'],
id))
trace("... MMRoster.py.\n")
MMRoster/__init__.py 100444 1000 144 1236 7115504234 13067 0 ustar klm users """Init for the mailman maillist roster publishing Zope product."""
import MMRoster, ImageFile
meta_types=({'name': 'MMRoster',
'action': 'manage_addMMRosterForm'
},
)
methods = {'manage_addMMRosterForm': MMRoster.addMMRosterForm,
'manage_addMMRoster': MMRoster.addMMRoster,
}
__ac_permissions__ = (('Add MMRoster', ('manage_addMMRosterForm',
'manage_addMMRoster')),
('Change Mailman Roster', ()),
('View', ()),
)
misc_ = {'mmroster': ImageFile.ImageFile('stolen_icon.gif',globals()),
}
MMRoster/getlist.py 100644 1000 144 624 7115504234 12765 0 ustar klm users """Set the environment so that we can instantiate a mailing list."""
MAILMAN_HOME = "~mailman"
import os, sys
sys.path.insert(0, os.path.expanduser(MAILMAN_HOME))
from Mailman.MailList import MailList
from Mailman import Utils
def getlist(name="", lock=0):
"""Obtain a maillist object.
By default the list is unlocked (so we don't jam up the works.)"""
return MailList(name, lock=lock)
MMRoster/addMMRosterForm.dtml 100444 1000 144 1265 7115504234 14647 0 ustar klm users
Add MMRoster
MMRoster/mmroster.dtml 100444 1000 144 5365 7115504234 13517 0 ustar klm users
<!--#var name capitalize--> Maillist Members Roster
Maillist Members Roster
Subscribers -
Total
Click on your address to visit your subscription
options page. (Parenthesized entries have list delivery
disabled.) (... except this simplistic prototype
doesn't currently do that.)