1 files changed, 98 insertions, 0 deletions
diff --git a/src/mailman/commands/cmd_confirm.py b/src/mailman/commands/cmd_confirm.py
new file mode 100644
index 000000000..b5e4182bd
--- /dev/null
+++ b/src/mailman/commands/cmd_confirm.py
@@ -0,0 +1,98 @@
+# Copyright (C) 2002-2009 by the Free Software Foundation, Inc.
+#
+# This file is part of GNU Mailman.
+#
+# GNU Mailman 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 3 of the License, or (at your option)
+# any later version.
+#
+# GNU Mailman 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
+# GNU Mailman.  If not, see <http://www.gnu.org/licenses/>.
+
+"""
+    confirm <confirmation-string>
+        Confirm an action.  The confirmation-string is required and should be
+        supplied by a mailback confirmation notice.
+"""
+
+from mailman import Errors
+from mailman import Pending
+from mailman.config import config
+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(config.PENDING_REQUEST_LIFE / config.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:
+            res.results.append(_('Confirmation succeeded'))
+            # Consume any other confirmation strings with the same cookie so
+            # the user doesn't get a misleading "unprocessed" message.
+            match = 'confirm ' + cookie
+            unprocessed = []
+            for line in res.commands:
+                if line.lstrip() == match:
+                    continue
+                unprocessed.append(line)
+            res.commands = unprocessed
+    # Process just one confirmation string per message
+    return STOP