source: main/waeup.kofa/trunk/src/waeup/kofa/students/studycourse.py @ 8472

## $Id: studycourse.py 8472 2012-05-20 09:57:09Z henrik $
##
## 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
##
"""
Container which holds the data of the student study courses
and contains the (student) study level objects.
"""
import grok
from zope.component.interfaces import IFactory
from zope.component import createObject
from zope.interface import implementedBy
from waeup.kofa.students.interfaces import (
    IStudentStudyCourse, IStudentNavigation, IStudentStudyLevel)
from waeup.kofa.students.studylevel import CourseTicket
from waeup.kofa.students.workflow import CLEARED, RETURNING, PAID
from waeup.kofa.utils.helpers import attrs_to_fields

class StudentStudyCourse(grok.Container):
    """This is a container for study levels.
    """
    grok.implements(IStudentStudyCourse, IStudentNavigation)
    grok.provides(IStudentStudyCourse)

    def __init__(self):
        super(StudentStudyCourse, self).__init__()
        return

    def getStudent(self):
        return self.__parent__

    @property
    def next_session_allowed(self):
        if self.getStudent().state in (CLEARED, RETURNING):
            return True
        if self.getStudent().state == PAID \
            and self.getStudent().is_postgrad:
            return True
        return False

    def addStudentStudyLevel(self, cert, studylevel):
        """Add a study level object.
        """
        if not IStudentStudyLevel.providedBy(studylevel):
            raise TypeError(
                'StudentStudyCourses contain only IStudentStudyLevel instances')
        self[str(studylevel.level)] = studylevel

        #Create course tickets automatically
        if cert is not None:
            for key, val in cert.items():
                if val.level != studylevel.level:
                    continue
                ticket = createObject(u'waeup.CourseTicket')
                ticket.code = val.getCourseCode()
                ticket.automatic = True
                ticket.mandatory = val.mandatory
                ticket.title = val.course.title
                ticket.fcode = val.course.__parent__.__parent__.__parent__.code
                ticket.dcode = val.course.__parent__.__parent__.code
                ticket.credits = val.course.credits
                ticket.passmark = val.course.passmark
                ticket.semester = val.course.semester
                ticket.carry_over = False
                self[str(studylevel.level)][ticket.code] = ticket
        # Collect carry-over courses in base levels (not in repeating levels)
        try:
            co_enabled = grok.getSite()['configuration'].carry_over
        except TypeError:
            # In tests we might not have a site object
            co_enabled = True
        if not co_enabled or studylevel.level % 100 != 0:
            return
        levels = sorted(self.keys())
        index = levels.index(str(studylevel.level))
        if index <= 0:
            return
        previous_level = self[levels[index-1]]
        for key, val in previous_level.items():
            if val.score >= val.passmark:
                continue
            if key in self[str(studylevel.level)]:
                # Carry-over ticket exists
                continue
            co_ticket = createObject(u'waeup.CourseTicket')
            for name in ['code', 'title', 'credits', 'passmark',
                         'semester', 'mandatory', 'fcode', 'dcode']:
                setattr(co_ticket, name, getattr(val, name))
            co_ticket.automatic = True
            co_ticket.carry_over = True
            self[str(studylevel.level)][co_ticket.code] = co_ticket
        return

    @property
    def is_postgrad(self):
        cert = getattr(self, 'certificate', None)
        if cert is not None:
            return cert.study_mode.startswith('pg')
            #return cert.start_level == 999 or cert.end_level == 999
        return False

StudentStudyCourse = attrs_to_fields(StudentStudyCourse)

class StudentStudyCourseFactory(grok.GlobalUtility):
    """A factory for student study courses.
    """
    grok.implements(IFactory)
    grok.name(u'waeup.StudentStudyCourse')
    title = u"Create a new student study course.",
    description = u"This factory instantiates new student study course instances."

    def __call__(self, *args, **kw):
        return StudentStudyCourse()

    def getInterfaces(self):
        return implementedBy(StudentStudyCourse)