other versions
- wheezy 1:2.1.15-1+deb7u1
- wheezy-backports 1:2.1.18-2~bpo70+1
- jessie 1:2.1.18-2+deb8u1
- testing 1:2.1.23-1
- unstable 1:2.1.23-1
withlist(8) | System Manager's Manual | withlist(8) |
NAME¶
withlist - General framework for interacting with a Mailman mailing list object.SYNOPSIS¶
withlist [options] listname [args ...]OPTIONS¶
- -l, --lock
- Lock the list when opening. Normally the list is opened
unlocked (e.g. for read-only operations). You can always lock the file
after the fact by typing `m.Lock()'
- -i, --interactive
- Leaves you at an interactive prompt after all other processing is complete. This is the default unless the -r option is given.
- -r [module.]callable, --run [module.]callable
- This can be used to run a script with the opened MailList
object. This works by attempting to import module (which must
already be accessible on your sys.path), and then calling callable
from the module. callable can be a class or function; it is called
with the MailList object as the first argument. If additional args are
given on the command line, they are passed as subsequent positional args
to the callable.
- -a, --all
- This option only works with the -r option. Use this if you want to execute the script on all mailing lists. When you use -a you should not include a listname argument on the command line. The variable `r' will be a list of all the results.
- -q, --quiet
- Suppress all status messages.
- -h, --help
- Print a small help text and exit.
EXAMPLES¶
Here's an example of how to use the -r option. Say you have a file in the Mailman installation directory called `listaddr.py', with the following two functions:def listaddr(mlist):
print mlist.GetListEmail()
def requestaddr(mlist):
print mlist.GetRequestEmail()
% bin/withlist -r listaddr mylist
Loading list: mylist (unlocked)
Importing listaddr ...
Running listaddr.listaddr() ...
mylist@example.com
% bin/withlist -r listaddr.requestaddr mylist
Loading list: mylist (unlocked)
Importing listaddr ...
Running listaddr.requestaddr() ...
mylist-request@example.com
from Mailman.Errors import NotAMemberError
def changepw(mlist, addr, newpasswd):
try:
mlist.setMemberPassword(addr, newpasswd)
mlist.Save()
except NotAMemberError:
print 'No address matched:', addr
and run this from the command line:
% bin/withlist -l -r changepw mylist somebody@example.org foobar
AUTHOR¶
Author of Mailman is the Mailman Cabal, see http://www.list.org/ for information. This manpage is written for Debian by Bernd S. Brentrup <bsb@debian.org>, but may be used by others.SEE ALSO¶
Mailman documentation on http://www.list.org/ and in /usr/share/doc/mailman.2007-07-14 |