# Copyright (C) 2002-2011 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. """ confirm Confirm an action. The confirmation-string is required and should be supplied by a mailback confirmation notice. """ from Mailman import mm_cfg from Mailman import Errors from Mailman import Pending from Mailman.i18n import _ STOP = 1 def gethelp(mlist): return _(__doc__) def process(res, args): mlist = res.mlist if len(args) <> 1: res.results.append(_('Usage:')) res.results.append(gethelp(mlist)) return STOP cookie = args[0] try: results = mlist.ProcessConfirmation(cookie, res.msg) except Errors.MMBadConfirmation, e: # Express in approximate days days = int(mm_cfg.PENDING_REQUEST_LIFE / mm_cfg.days(1) + 0.5) res.results.append(_("""\ Invalid confirmation string. Note that confirmation strings expire approximately %(days)s days after the initial subscription request. If your confirmation has expired, please try to re-submit your original request or message.""")) except Errors.MMNeedApproval: res.results.append(_("""\ Your request has been forwarded to the list moderator for approval.""")) except Errors.MMAlreadyAMember: # Some other subscription request for this address has # already succeeded. res.results.append(_('You are already subscribed.')) except Errors.NotAMemberError: # They've already been unsubscribed res.results.append(_("""\ You are not currently a member. Have you already unsubscribed or changed your email address?""")) except Errors.MembershipIsBanned: owneraddr = mlist.GetOwnerEmail() res.results.append(_("""\ You are currently banned from subscribing to this list. If you think this restriction is erroneous, please contact the list owners at %(owneraddr)s.""")) except Errors.HostileSubscriptionError: res.results.append(_("""\ You were not invited to this mailing list. The invitation has been discarded, and both list administrators have been alerted.""")) except Errors.MMBadPasswordError: res.results.append(_("""\ Bad approval password given. Held message is still being held.""")) else: if ((results[0] == Pending.SUBSCRIPTION and mlist.send_welcome_msg) or (results[0] == Pending.UNSUBSCRIPTION and mlist.send_goodbye_msg)): # We don't also need to send a confirmation succeeded message res.respond = 0 else: if results[0] == Pending.HELD_MESSAGE: if results[1] == mm_cfg.APPROVE: res.results.append(_('Confirmation succeeded') + ' (' + _('Approve') + ')') else: res.results.append(_('Confirmation succeeded') + ' (' + _('Discard') + ')') else: res.results.append(_('Confirmation succeeded')) # Consume any other confirmation strings with the same cookie so # the user doesn't get a misleading "unprocessed" message. # Also consume any Approve(d): line as it was processed. match = 'confirm ' + cookie unprocessed = [] for line in res.commands: try: if (line.lstrip() == match or line.lstrip().lower().startswith('approved:') or line.lstrip().lower().startswith('approve:')): continue except UnicodeError: pass unprocessed.append(line) res.commands = unprocessed # Process just one confirmation string per message return STOP