source: main/waeup.kofa/trunk/src/waeup/kofa/students/accommodation.py @ 9820

Last change on this file since 9820 was 9424, checked in by Henrik Bettermann, 12 years ago

Fix docstrings.

In my old ZODB which I used for testing there were orphaned catalog entries. I don't know why. The tests show clearly that the catalog is updated whenever a hostel is removed or cleared. However, to be 100% that nothing goes wrong I added some extra safety belts.

  • Property svn:keywords set to Id
File size: 3.2 KB
RevLine 
[7190]1## $Id: accommodation.py 9424 2012-10-26 17:17:10Z henrik $
2##
[6635]3## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
4## This program is free software; you can redistribute it and/or modify
5## it under the terms of the GNU General Public License as published by
6## the Free Software Foundation; either version 2 of the License, or
7## (at your option) any later version.
8##
9## This program is distributed in the hope that it will be useful,
10## but WITHOUT ANY WARRANTY; without even the implied warranty of
11## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12## GNU General Public License for more details.
13##
14## You should have received a copy of the GNU General Public License
15## along with this program; if not, write to the Free Software
16## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17##
18"""
[7599]19Student accommodation components.
[6635]20"""
[6992]21from datetime import datetime
[6635]22import grok
[8182]23from zope.component import getUtility
[6635]24from zope.component.interfaces import IFactory
[7256]25from zope.interface import implementedBy
[8182]26from waeup.kofa.interfaces import academic_sessions_vocab, IKofaUtils
[7811]27from waeup.kofa.students.interfaces import (
[6989]28    IStudentAccommodation, IStudentNavigation, IBedTicket)
[7811]29from waeup.kofa.utils.helpers import attrs_to_fields
[6635]30
31class StudentAccommodation(grok.Container):
[9423]32    """This is a container for bed tickets.
[6635]33    """
[6642]34    grok.implements(IStudentAccommodation, IStudentNavigation)
[6635]35    grok.provides(IStudentAccommodation)
36
37    def __init__(self):
38        super(StudentAccommodation, self).__init__()
39        return
40
[6989]41    def addBedTicket(self, bedticket):
42        """Add a bed ticket object.
43        """
44        if not IBedTicket.providedBy(bedticket):
45            raise TypeError(
46                'StudentAccommodation containers contain only IBedTicket instances')
[9423]47        self[str(bedticket.booking_session)] = bedticket
[6989]48        return
49
[8736]50    @property
51    def student(self):
[6642]52        return self.__parent__
53
[8735]54    def writeLogMessage(self, view, message):
55        return self.__parent__.writeLogMessage(view, message)
56
[6989]57StudentAccommodation = attrs_to_fields(StudentAccommodation)
58
59class BedTicket(grok.Model):
[9424]60    """This is a bed ticket which shows that the student has booked a bed.
[6989]61    """
62    grok.implements(IBedTicket, IStudentNavigation)
63    grok.provides(IBedTicket)
64
65    def __init__(self):
66        super(BedTicket, self).__init__()
[8194]67        self.booking_date = datetime.utcnow()
[6996]68        self.bed = None
[6989]69        return
70
[8736]71    @property
72    def student(self):
73        try:
74            return self.__parent__.__parent__
75        except AttributeError:
76            return None
[6989]77
[8735]78    def writeLogMessage(self, view, message):
79        return self.__parent__.__parent__.writeLogMessage(view, message)
80
[6994]81    def getSessionString(self):
82        return academic_sessions_vocab.getTerm(
83            self.booking_session).title
84
[6992]85BedTicket = attrs_to_fields(BedTicket)
86
87# Bed tickets must be importable. So we might need a factory.
88class BedTicketFactory(grok.GlobalUtility):
89    """A factory for bed tickets.
90    """
91    grok.implements(IFactory)
92    grok.name(u'waeup.BedTicket')
93    title = u"Create a new bed ticket.",
94    description = u"This factory instantiates new bed ticket instances."
95
96    def __call__(self, *args, **kw):
97        return BedTicket()
98
99    def getInterfaces(self):
[7811]100        return implementedBy(BedTicket)
Note: See TracBrowser for help on using the repository browser.