source: main/waeup.kofa/branches/uli-py3/src/waeup/kofa/utils/utils.py @ 17930

Last change on this file since 17930 was 15964, checked in by Henrik Bettermann, 5 years ago

Make getUsers customizable.

  • Property svn:keywords set to Id
File size: 13.7 KB
Line 
1## $Id: utils.py 15964 2020-01-28 12:39:18Z henrik $
2##
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"""General helper utilities for Kofa.
19"""
20import grok
21import psutil
22import string
23import pytz
24import decimal
25from copy import deepcopy
26from random import SystemRandom as r
27from zope.i18n import translate
28from waeup.kofa.interfaces import IKofaUtils
29from waeup.kofa.interfaces import MessageFactory as _
30from waeup.kofa.smtp import send_mail as send_mail_internally
31from waeup.kofa.utils.helpers import get_sorted_preferred
32from waeup.kofa.utils.degrees import DEGREES_DICT
33
34
35def send_mail(from_name, from_addr,
36              rcpt_name, rcpt_addr,
37              subject, body, config):
38    """Wrapper for the real SMTP functionality in :mod:`waeup.kofa.smtp`.
39
40    Merely here to stay compatible with lots of calls to this place.
41    """
42    mail_id = send_mail_internally(
43        from_name, from_addr, rcpt_name, rcpt_addr,
44        subject, body, config)
45    return True
46
47
48#: A list of phone prefixes (order num, country, prefix).
49#: Items with same order num will be sorted alphabetically.
50#: The lower the order num, the higher the precedence.
51INT_PHONE_PREFIXES = [
52    (99, _('Germany'), '49'),
53    (1, _('Nigeria'), '234'),
54    (99, _('U.S.'), '1'),
55    ]
56
57
58def sorted_phone_prefixes(data=INT_PHONE_PREFIXES, request=None):
59    """Sorted tuples of phone prefixes.
60
61    Ordered as shown above and formatted for use in select boxes.
62
63    If request is given, we'll try to translate all country names in
64    order to sort alphabetically correctly.
65
66    XXX: This is a function (and not a constant) as different
67    languages might give different orders. This is not tested yet.
68
69    XXX: If we really want to use alphabetic ordering here, we might
70    think about caching results of translations.
71    """
72    if request is not None:
73        data = [
74            (x, translate(y, context=request), z)
75            for x, y, z in data]
76    return tuple([
77        ('%s (+%s)' % (x[1], x[2]), '+%s' % x[2])
78        for x in sorted(data)
79        ])
80
81
82class KofaUtils(grok.GlobalUtility):
83    """A collection of parameters and methods subject to customization.
84    """
85    grok.implements(IKofaUtils)
86
87    #: This the only place where we define the portal language
88    #: which is used for the translation of system messages
89    #: (e.g. object histories) pdf slips.
90    PORTAL_LANGUAGE = 'en'
91
92    DEGREES_DICT = DEGREES_DICT
93
94    PREFERRED_LANGUAGES_DICT = {
95        'en': (1, u'English'),
96        'fr': (2, u'Français'),
97        'de': (3, u'Deutsch'),
98        'ha': (4, u'Hausa'),
99        'yo': (5, u'Yoruba'),
100        'ig': (6, u'Igbo'),
101        }
102
103    #: A function to return
104    @classmethod
105    def sorted_phone_prefixes(cls, data=INT_PHONE_PREFIXES, request=None):
106        return sorted_phone_prefixes(data, request)
107
108    EXAM_SUBJECTS_DICT = {
109        'math': 'Mathematics',
110        'computer_science': 'Computer Science',
111        }
112
113    #: Exam grades. The tuple is sorted as it should be displayed in
114    #: select boxes.
115    EXAM_GRADES = (
116        ('A', 'Best'),
117        ('B', 'Better'),
118        ('C', 'Good'),
119        )
120
121    INST_TYPES_DICT = {
122        'none': '',
123        'faculty': 'Faculty of',
124        'department': 'Department of',
125        'school': 'School of',
126        'office': 'Office for',
127        'centre': 'Centre for',
128        'institute': 'Institute of',
129        'school_for': 'School for',
130        'college': 'College of',
131        'directorate': 'Directorate of',
132        }
133
134    STUDY_MODES_DICT = {
135        'transfer': 'Transfer',
136        'ug_ft': 'Undergraduate Full-Time',
137        'ug_pt': 'Undergraduate Part-Time',
138        'pg_ft': 'Postgraduate Full-Time',
139        'pg_pt': 'Postgraduate Part-Time',
140        }
141
142    DISABLE_PAYMENT_GROUP_DICT = {
143        'sf_all': 'School Fee - All Students',
144        }
145
146    APP_CATS_DICT = {
147        'basic': 'Basic Application',
148        'no': 'no application',
149        'pg': 'Postgraduate',
150        'sandwich': 'Sandwich',
151        'cest': 'Part-Time, Diploma, Certificate'
152        }
153
154    SEMESTER_DICT = {
155        1: '1st Semester',
156        2: '2nd Semester',
157        3: 'Combined',
158        9: 'N/A'
159        }
160
161    COURSE_CATEGORY_DICT = {
162        }
163
164    SPECIAL_HANDLING_DICT = {
165        'regular': 'Regular Hostel',
166        'blocked': 'Blocked Hostel',
167        'pg': 'Postgraduate Hostel'
168        }
169
170    SPECIAL_APP_DICT = {
171        'transcript': 'Transcript Fee Payment',
172        'clearance': 'Acceptance Fee',
173        }
174
175    PAYMENT_CATEGORIES = {
176        'schoolfee': 'School Fee',
177        'clearance': 'Acceptance Fee',
178        'bed_allocation': 'Bed Allocation Fee',
179        'hostel_maintenance': 'Hostel Maintenance Fee',
180        'transfer': 'Transfer Fee',
181        'gown': 'Gown Hire Fee',
182        'application': 'Application Fee',
183        'app_balance': 'Application Fee Balance',
184        'transcript': 'Transcript Fee',
185        'late_registration': 'Late Course Registration Fee',
186        'combi': 'Combi Payment',
187        }
188
189    def selectable_payment_categories(self, student):
190        return self.PAYMENT_CATEGORIES
191
192    PREVIOUS_PAYMENT_CATEGORIES = deepcopy(PAYMENT_CATEGORIES)
193
194    REPORTABLE_PAYMENT_CATEGORIES = {
195        'schoolfee': 'School Fee',
196        'clearance': 'Acceptance Fee',
197        'hostel_maintenance': 'Hostel Maintenance Fee',
198        'gown': 'Gown Hire Fee',
199        }
200
201    BALANCE_PAYMENT_CATEGORIES = {
202        'schoolfee': 'School Fee',
203        }
204
205    COMBI_PAYMENT_CATEGORIES = {
206        'gown': 'Gown Hire Fee',
207        'transcript': 'Transcript Fee',
208        'late_registration': 'Late Course Registration Fee',
209        }
210
211    MODE_GROUPS = {
212        'All': ('all',),
213        'Undergraduate Full-Time': ('ug_ft',),
214        'Undergraduate Part-Time': ('ug_pt',),
215        'Postgraduate Full-Time': ('pg_ft',),
216        'Postgraduate Part-Time': ('pg_pt',),
217        }
218
219    VERDICTS_DICT = {
220        '0': _('(not yet)'),
221        'A': 'Successful student',
222        'B': 'Student with carryover courses',
223        'C': 'Student on probation',
224        }
225
226    #: Set positive number for allowed max, negative for required min
227    #: avail.
228    #: Use integer for bytes value, float for percent
229    #: value. `cpu-load`, of course, accepts float values only.
230    #: `swap-mem` = Swap Memory, `virt-mem` = Virtual Memory,
231    #: `cpu-load` = CPU load in percent.
232    SYSTEM_MAX_LOAD = {
233        'swap-mem': None,
234        'virt-mem': None,
235        'cpu-load': 100.0,
236        }
237
238    #: Maximum number of files listed in `finished` subfolder
239    MAX_FILES = 100
240
241    #: Maximum size in Bytes of passport images in the applicants and
242    #: students section
243    MAX_PASSPORT_SIZE = 50 * 1024
244
245    #: Temporary passwords and parents password validity period
246    TEMP_PASSWORD_MINUTES = 10
247
248    def sendContactForm(self, from_name, from_addr, rcpt_name, rcpt_addr,
249                        from_username, usertype, portal, body, subject):
250        """Send an email with data provided by forms.
251        """
252        config = grok.getSite()['configuration']
253        text = _(u"""Fullname: ${a}
254User Id: ${b}
255User Type: ${c}
256Portal: ${d}
257
258${e}
259""")
260        text = _(text, mapping={
261            'a': from_name,
262            'b': from_username,
263            'c': usertype,
264            'd': portal,
265            'e': body})
266        body = translate(text, 'waeup.kofa',
267            target_language=self.PORTAL_LANGUAGE)
268        if not (from_addr and rcpt_addr):
269            return False
270        return send_mail(
271            from_name, from_addr, rcpt_name, rcpt_addr,
272            subject, body, config)
273
274    def getUsers(self):
275        users = sorted(
276            grok.getSite()['users'].items(), key=lambda x: x[1].title)
277        for key, val in users:
278            yield(dict(name=key, val="%s (%s)" % (val.title, val.name)))
279
280    @property
281    def tzinfo(self):
282        """Time zone of the university.
283        """
284        # For Nigeria: pytz.timezone('Africa/Lagos')
285        # For Germany: pytz.timezone('Europe/Berlin')
286        return pytz.utc
287
288    def fullname(self, firstname, lastname, middlename=None):
289        """Construct fullname.
290        """
291        # We do not necessarily have the middlename attribute
292        if middlename:
293            name = '%s %s %s' % (firstname, middlename, lastname)
294        else:
295            name = '%s %s' % (firstname, lastname)
296        if '<' in name:
297            return 'XXX'
298        return string.capwords(
299            name.replace('-', ' - ')).replace(' - ', '-')
300
301    def genPassword(self, length=4, chars=string.letters + string.digits):
302        """Generate a random password.
303        """
304        return ''.join([
305            r().choice(string.uppercase) +
306            r().choice(string.lowercase) +
307            r().choice(string.digits) for i in range(length)])
308
309    def sendCredentials(self, user, password=None, url_info=None, msg=None):
310        """Send credentials as email. Input is the user for which credentials
311        are sent and the password. Method returns True or False to indicate
312        successful operation.
313        """
314        subject = 'Your Kofa credentials'
315        text = _(u"""Dear ${a},
316
317${b}
318Student Registration and Information Portal of
319${c}.
320
321Your user name: ${d}
322Your password: ${e}
323${f}
324
325Please remember your user name and keep
326your password secret!
327
328Please also note that passwords are case-sensitive.
329
330Regards
331""")
332        config = grok.getSite()['configuration']
333        from_name = config.name_admin
334        from_addr = config.email_admin
335        rcpt_name = user.title
336        rcpt_addr = user.email
337        text = _(text, mapping={
338            'a': rcpt_name,
339            'b': msg,
340            'c': config.name,
341            'd': user.name,
342            'e': password,
343            'f': url_info})
344
345        body = translate(text, 'waeup.kofa',
346            target_language=self.PORTAL_LANGUAGE)
347        return send_mail(
348            from_name, from_addr, rcpt_name, rcpt_addr,
349            subject, body, config)
350
351    def inviteReferee(self, referee, applicant, url_info=None):
352        """Send invitation email to referee.
353        """
354        config = grok.getSite()['configuration']
355        subject = 'Request for referee report from %s' % config.name
356        text = _(u"""Dear ${a},
357
358The candidate with Id ${b} and name ${c} applied to
359the ${d} to study ${e} for the ${f} session.
360The candidate has listed you as referee. You are thus required to kindly use
361the link below to provide your referral remarks on or before
362${g}.
363
364${h}
365
366Thank You
367
368The Secretary
369Post Graduate School
370${d}
371""")
372        from_name = config.name_admin
373        from_addr = config.email_admin
374        rcpt_name = referee.name
375        rcpt_addr = referee.email
376        session = '%s/%s' % (
377            applicant.__parent__.year, applicant.__parent__.year+1)
378        text = _(text, mapping={
379            'a': rcpt_name,
380            'b': applicant.applicant_id,
381            'c': applicant.display_fullname,
382            'd': config.name,
383            'e': applicant.course1.title,
384            'f': session,
385            'g': applicant.__parent__.enddate,
386            'h': url_info,
387            })
388
389        body = translate(text, 'waeup.kofa',
390            target_language=self.PORTAL_LANGUAGE)
391        return send_mail(
392            from_name, from_addr, rcpt_name, rcpt_addr,
393            subject, body, config)
394
395    def getPaymentItem(self, payment):
396        """Return payment item. This method can be used to customize the
397        `display_item` property attribute, e.g. in order to hide bed coordinates
398        if maintenance fee is not paid.
399        """
400        return payment.p_item
401
402    def expensive_actions_allowed(self, type=None, request=None):
403        """Tell, whether expensive actions are currently allowed.
404        Check system load/health (or other external circumstances) and
405        locally set values to see, whether expensive actions should be
406        allowed (`True`) or better avoided (`False`).
407        Use this to allow or forbid exports, report generations, or
408        similar actions.
409        """
410        max_values = self.SYSTEM_MAX_LOAD
411        for (key, func) in (
412            ('swap-mem', psutil.swap_memory),
413            ('virt-mem', psutil.virtual_memory),
414            ):
415            max_val = max_values.get(key, None)
416            if max_val is None:
417                continue
418            mem_val = func()
419            if isinstance(max_val, float):
420                # percents
421                if max_val < 0.0:
422                    max_val = 100.0 + max_val
423                if mem_val.percent > max_val:
424                    return False
425            else:
426                # number of bytes
427                if max_val < 0:
428                    max_val = mem_val.total + max_val
429                if mem_val.used > max_val:
430                    return False
431        return True
432
433    def export_disabled_message(self):
434        export_disabled_message = grok.getSite()[
435            'configuration'].export_disabled_message
436        if export_disabled_message:
437            return export_disabled_message
438        return None
439
440    def format_float(self, value, prec):
441        # >>> 4.6 * 100
442        # 459.99999999999994
443        value = decimal.Decimal(str(value))
444        # cut floating point value
445        value = int(pow(10, prec)*value) / (1.0*pow(10, prec))
446        return '{:{width}.{prec}f}'.format(value, width=0, prec=prec)
Note: See TracBrowser for help on using the repository browser.