source: main/waeup.kofa/trunk/src/waeup/kofa/applicants/authentication.py @ 8059

## $Id: authentication.py 7811 2012-03-08 19:00:51Z uli $
## 
## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
## 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
"""
Authenticate applicants.
"""
import grok
from zope.pluggableauth.interfaces import IAuthenticatorPlugin
from waeup.kofa.interfaces import IAuthPluginUtility, IUserAccount
from waeup.kofa.applicants.interfaces import IApplicant
from waeup.kofa.students.authentication import (
    StudentAccount, StudentsAuthenticatorPlugin)

class ApplicantAccount(StudentAccount):
    """An adapter to turn applicant objects into accounts on-the-fly.
    """
    grok.context(IApplicant)
    grok.implements(IUserAccount)

    @property
    def name(self):
        return self.context.applicant_id

    @property
    def title(self):
        return self.context.display_fullname

    @property
    def user_type(self):
        return u'applicant'

class ApplicantsAuthenticatorPlugin(StudentsAuthenticatorPlugin):
    grok.implements(IAuthenticatorPlugin)
    grok.provides(IAuthenticatorPlugin)
    grok.name('applicants')

    def getAccount(self, login):
        """Look up a applicant identified by `login`. Returns an account.

        First we split the login name into the container part and
        the application number part. Then we simply look up the key under which
        the applicant is stored in the respective applicants cointainer of
        the portal.

        Returns not an applicant but an account object adapted from any
        applicant found.

        If no such applicant exists, ``None`` is returned.
        """
        site = grok.getSite()
        if site is None:
            return None
        applicantsroot = site.get('applicants', None)
        if applicantsroot is None:
            return None
        try:
            container, application_number = login.split('_')
        except ValueError:
            return None
        applicantscontainer = applicantsroot.get(container,None)
        if applicantscontainer is None:
            return None
        applicant = applicantscontainer.get(application_number, None)
        if applicant is None:
            return None
        return IUserAccount(applicant)

class ApplicantsAuthenticatorSetup(grok.GlobalUtility):
    """Register or unregister applicant authentication for a PAU.

    This piece is called when a new site is created.
    """
    grok.implements(IAuthPluginUtility)
    grok.name('applicants_auth_setup')

    def register(self, pau):
        plugins = list(pau.authenticatorPlugins)
        plugins.append('applicants')
        pau.authenticatorPlugins = tuple(plugins)
        return pau

    def unregister(self, pau):
        plugins = [x for x in pau.authenticatorPlugins
                   if x != 'applicants']
        pau.authenticatorPlugins = tuple(plugins)
        return pau