[7358] | 1 | ## $Id: utils.py 17376 2023-04-06 17:29:31Z 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 | ## |
---|
[7819] | 18 | """General helper utilities for Kofa. |
---|
[7358] | 19 | """ |
---|
| 20 | import grok |
---|
[11815] | 21 | import psutil |
---|
[7365] | 22 | import string |
---|
[8181] | 23 | import pytz |
---|
[15476] | 24 | import decimal |
---|
[9866] | 25 | from copy import deepcopy |
---|
[8181] | 26 | from random import SystemRandom as r |
---|
[7734] | 27 | from zope.i18n import translate |
---|
[7819] | 28 | from waeup.kofa.interfaces import IKofaUtils |
---|
[7811] | 29 | from waeup.kofa.interfaces import MessageFactory as _ |
---|
| 30 | from waeup.kofa.smtp import send_mail as send_mail_internally |
---|
[7969] | 31 | from waeup.kofa.utils.helpers import get_sorted_preferred |
---|
[13617] | 32 | from waeup.kofa.utils.degrees import DEGREES_DICT |
---|
[7358] | 33 | |
---|
[11814] | 34 | |
---|
| 35 | def send_mail(from_name, from_addr, |
---|
| 36 | rcpt_name, rcpt_addr, |
---|
[16299] | 37 | subject, body, config, |
---|
| 38 | cc=None, bcc=None): |
---|
[7811] | 39 | """Wrapper for the real SMTP functionality in :mod:`waeup.kofa.smtp`. |
---|
[7382] | 40 | |
---|
[7471] | 41 | Merely here to stay compatible with lots of calls to this place. |
---|
[7400] | 42 | """ |
---|
[7471] | 43 | mail_id = send_mail_internally( |
---|
| 44 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
[16299] | 45 | subject, body, config, cc, bcc) |
---|
[7399] | 46 | return True |
---|
| 47 | |
---|
[11814] | 48 | |
---|
[7874] | 49 | #: A list of phone prefixes (order num, country, prefix). |
---|
| 50 | #: Items with same order num will be sorted alphabetically. |
---|
| 51 | #: The lower the order num, the higher the precedence. |
---|
| 52 | INT_PHONE_PREFIXES = [ |
---|
| 53 | (99, _('Germany'), '49'), |
---|
[11814] | 54 | (1, _('Nigeria'), '234'), |
---|
[7874] | 55 | (99, _('U.S.'), '1'), |
---|
| 56 | ] |
---|
| 57 | |
---|
[11814] | 58 | |
---|
| 59 | def sorted_phone_prefixes(data=INT_PHONE_PREFIXES, request=None): |
---|
[7874] | 60 | """Sorted tuples of phone prefixes. |
---|
| 61 | |
---|
| 62 | Ordered as shown above and formatted for use in select boxes. |
---|
| 63 | |
---|
| 64 | If request is given, we'll try to translate all country names in |
---|
| 65 | order to sort alphabetically correctly. |
---|
| 66 | |
---|
| 67 | XXX: This is a function (and not a constant) as different |
---|
| 68 | languages might give different orders. This is not tested yet. |
---|
| 69 | |
---|
| 70 | XXX: If we really want to use alphabetic ordering here, we might |
---|
| 71 | think about caching results of translations. |
---|
| 72 | """ |
---|
| 73 | if request is not None: |
---|
| 74 | data = [ |
---|
| 75 | (x, translate(y, context=request), z) |
---|
| 76 | for x, y, z in data] |
---|
| 77 | return tuple([ |
---|
[11814] | 78 | ('%s (+%s)' % (x[1], x[2]), '+%s' % x[2]) |
---|
[7874] | 79 | for x in sorted(data) |
---|
| 80 | ]) |
---|
| 81 | |
---|
[11814] | 82 | |
---|
[7831] | 83 | class KofaUtils(grok.GlobalUtility): |
---|
[7678] | 84 | """A collection of parameters and methods subject to customization. |
---|
[7358] | 85 | """ |
---|
[7831] | 86 | grok.implements(IKofaUtils) |
---|
[13132] | 87 | |
---|
| 88 | #: This the only place where we define the portal language |
---|
| 89 | #: which is used for the translation of system messages |
---|
| 90 | #: (e.g. object histories) pdf slips. |
---|
[7744] | 91 | PORTAL_LANGUAGE = 'en' |
---|
[7358] | 92 | |
---|
[13617] | 93 | DEGREES_DICT = DEGREES_DICT |
---|
| 94 | |
---|
[7701] | 95 | PREFERRED_LANGUAGES_DICT = { |
---|
[11814] | 96 | 'en': (1, u'English'), |
---|
| 97 | 'fr': (2, u'Français'), |
---|
| 98 | 'de': (3, u'Deutsch'), |
---|
| 99 | 'ha': (4, u'Hausa'), |
---|
| 100 | 'yo': (5, u'Yoruba'), |
---|
| 101 | 'ig': (6, u'Igbo'), |
---|
[7701] | 102 | } |
---|
| 103 | |
---|
[17094] | 104 | MONTHS_DICT = { |
---|
[17211] | 105 | '1': _('January'), |
---|
| 106 | '2': _('February'), |
---|
| 107 | '3': _('March'), |
---|
| 108 | '4': _('April'), |
---|
| 109 | '5': _('May'), |
---|
| 110 | '6': _('June'), |
---|
| 111 | '7': _('July'), |
---|
| 112 | '8': _('August'), |
---|
| 113 | '9': _('September'), |
---|
| 114 | '10': _('October'), |
---|
| 115 | '11': _('November'), |
---|
| 116 | '12': _('December'), |
---|
[17094] | 117 | } |
---|
| 118 | |
---|
[7874] | 119 | #: A function to return |
---|
| 120 | @classmethod |
---|
| 121 | def sorted_phone_prefixes(cls, data=INT_PHONE_PREFIXES, request=None): |
---|
| 122 | return sorted_phone_prefixes(data, request) |
---|
[7871] | 123 | |
---|
[7841] | 124 | EXAM_SUBJECTS_DICT = { |
---|
[7843] | 125 | 'math': 'Mathematics', |
---|
| 126 | 'computer_science': 'Computer Science', |
---|
[7841] | 127 | } |
---|
[7836] | 128 | |
---|
[7917] | 129 | #: Exam grades. The tuple is sorted as it should be displayed in |
---|
| 130 | #: select boxes. |
---|
| 131 | EXAM_GRADES = ( |
---|
| 132 | ('A', 'Best'), |
---|
| 133 | ('B', 'Better'), |
---|
| 134 | ('C', 'Good'), |
---|
| 135 | ) |
---|
[7836] | 136 | |
---|
[7841] | 137 | INST_TYPES_DICT = { |
---|
[8084] | 138 | 'none': '', |
---|
[7681] | 139 | 'faculty': 'Faculty of', |
---|
| 140 | 'department': 'Department of', |
---|
| 141 | 'school': 'School of', |
---|
| 142 | 'office': 'Office for', |
---|
| 143 | 'centre': 'Centre for', |
---|
[16811] | 144 | 'centre_of': 'Centre of', |
---|
[7681] | 145 | 'institute': 'Institute of', |
---|
| 146 | 'school_for': 'School for', |
---|
[8084] | 147 | 'college': 'College of', |
---|
[10302] | 148 | 'directorate': 'Directorate of', |
---|
[7681] | 149 | } |
---|
| 150 | |
---|
[7841] | 151 | STUDY_MODES_DICT = { |
---|
[9131] | 152 | 'transfer': 'Transfer', |
---|
[16828] | 153 | 'transferred': 'Transferred', |
---|
[7843] | 154 | 'ug_ft': 'Undergraduate Full-Time', |
---|
| 155 | 'ug_pt': 'Undergraduate Part-Time', |
---|
[7993] | 156 | 'pg_ft': 'Postgraduate Full-Time', |
---|
| 157 | 'pg_pt': 'Postgraduate Part-Time', |
---|
[7681] | 158 | } |
---|
| 159 | |
---|
[11451] | 160 | DISABLE_PAYMENT_GROUP_DICT = { |
---|
| 161 | 'sf_all': 'School Fee - All Students', |
---|
| 162 | } |
---|
| 163 | |
---|
[7841] | 164 | APP_CATS_DICT = { |
---|
[7843] | 165 | 'basic': 'Basic Application', |
---|
[7681] | 166 | 'no': 'no application', |
---|
| 167 | 'pg': 'Postgraduate', |
---|
| 168 | 'sandwich': 'Sandwich', |
---|
| 169 | 'cest': 'Part-Time, Diploma, Certificate' |
---|
| 170 | } |
---|
| 171 | |
---|
[7841] | 172 | SEMESTER_DICT = { |
---|
[10437] | 173 | 1: '1st Semester', |
---|
| 174 | 2: '2nd Semester', |
---|
[7681] | 175 | 3: 'Combined', |
---|
[16812] | 176 | 4: '1st Term', |
---|
| 177 | 5: '2nd Term', |
---|
| 178 | 6: '3rd Term', |
---|
| 179 | 9: 'N/A', |
---|
| 180 | 11: 'Module I', |
---|
| 181 | 12: 'Module II', |
---|
| 182 | 13: 'Module III', |
---|
[7681] | 183 | } |
---|
| 184 | |
---|
[14638] | 185 | COURSE_CATEGORY_DICT = { |
---|
| 186 | } |
---|
| 187 | |
---|
[9400] | 188 | SPECIAL_HANDLING_DICT = { |
---|
| 189 | 'regular': 'Regular Hostel', |
---|
| 190 | 'blocked': 'Blocked Hostel', |
---|
[10831] | 191 | 'pg': 'Postgraduate Hostel' |
---|
[9400] | 192 | } |
---|
| 193 | |
---|
[10831] | 194 | SPECIAL_APP_DICT = { |
---|
| 195 | 'transcript': 'Transcript Fee Payment', |
---|
[11575] | 196 | 'clearance': 'Acceptance Fee', |
---|
[10831] | 197 | } |
---|
| 198 | |
---|
[9405] | 199 | PAYMENT_CATEGORIES = { |
---|
| 200 | 'schoolfee': 'School Fee', |
---|
| 201 | 'clearance': 'Acceptance Fee', |
---|
| 202 | 'bed_allocation': 'Bed Allocation Fee', |
---|
| 203 | 'hostel_maintenance': 'Hostel Maintenance Fee', |
---|
| 204 | 'transfer': 'Transfer Fee', |
---|
| 205 | 'gown': 'Gown Hire Fee', |
---|
[9866] | 206 | 'application': 'Application Fee', |
---|
[15553] | 207 | 'app_balance': 'Application Fee Balance', |
---|
[10449] | 208 | 'transcript': 'Transcript Fee', |
---|
[15664] | 209 | 'late_registration': 'Late Course Registration Fee', |
---|
[15685] | 210 | 'combi': 'Combi Payment', |
---|
[17016] | 211 | 'donation': 'Donation', |
---|
[9405] | 212 | } |
---|
| 213 | |
---|
[16431] | 214 | #: If PAYMENT_OPTIONS is empty, payment option fields won't show up. |
---|
| 215 | PAYMENT_OPTIONS = { |
---|
| 216 | #'credit_card': 'Credit Card', |
---|
| 217 | #'debit_card': 'Debit Card', |
---|
| 218 | } |
---|
| 219 | |
---|
[15432] | 220 | def selectable_payment_categories(self, student): |
---|
| 221 | return self.PAYMENT_CATEGORIES |
---|
[9730] | 222 | |
---|
[16431] | 223 | def selectable_payment_options(self, student): |
---|
| 224 | return self.PAYMENT_OPTIONS |
---|
| 225 | |
---|
[15432] | 226 | PREVIOUS_PAYMENT_CATEGORIES = deepcopy(PAYMENT_CATEGORIES) |
---|
[9862] | 227 | |
---|
[12564] | 228 | REPORTABLE_PAYMENT_CATEGORIES = { |
---|
| 229 | 'schoolfee': 'School Fee', |
---|
| 230 | 'clearance': 'Acceptance Fee', |
---|
| 231 | 'hostel_maintenance': 'Hostel Maintenance Fee', |
---|
| 232 | 'gown': 'Gown Hire Fee', |
---|
| 233 | } |
---|
| 234 | |
---|
[9868] | 235 | BALANCE_PAYMENT_CATEGORIES = { |
---|
[9867] | 236 | 'schoolfee': 'School Fee', |
---|
| 237 | } |
---|
[9864] | 238 | |
---|
[17016] | 239 | APPLICANT_BALANCE_PAYMENT_CATEGORIES = { |
---|
| 240 | 'donation': 'Donation', |
---|
| 241 | } |
---|
| 242 | |
---|
[15664] | 243 | COMBI_PAYMENT_CATEGORIES = { |
---|
| 244 | 'gown': 'Gown Hire Fee', |
---|
| 245 | 'transcript': 'Transcript Fee', |
---|
| 246 | 'late_registration': 'Late Course Registration Fee', |
---|
| 247 | } |
---|
| 248 | |
---|
[9649] | 249 | MODE_GROUPS = { |
---|
[11814] | 250 | 'All': ('all',), |
---|
| 251 | 'Undergraduate Full-Time': ('ug_ft',), |
---|
| 252 | 'Undergraduate Part-Time': ('ug_pt',), |
---|
| 253 | 'Postgraduate Full-Time': ('pg_ft',), |
---|
| 254 | 'Postgraduate Part-Time': ('pg_pt',), |
---|
[9649] | 255 | } |
---|
| 256 | |
---|
[13125] | 257 | VERDICTS_DICT = { |
---|
| 258 | '0': _('(not yet)'), |
---|
| 259 | 'A': 'Successful student', |
---|
| 260 | 'B': 'Student with carryover courses', |
---|
| 261 | 'C': 'Student on probation', |
---|
| 262 | } |
---|
| 263 | |
---|
[11800] | 264 | #: Set positive number for allowed max, negative for required min |
---|
| 265 | #: avail. |
---|
| 266 | #: Use integer for bytes value, float for percent |
---|
| 267 | #: value. `cpu-load`, of course, accepts float values only. |
---|
| 268 | #: `swap-mem` = Swap Memory, `virt-mem` = Virtual Memory, |
---|
[11969] | 269 | #: `cpu-load` = CPU load in percent. |
---|
[11800] | 270 | SYSTEM_MAX_LOAD = { |
---|
| 271 | 'swap-mem': None, |
---|
| 272 | 'virt-mem': None, |
---|
| 273 | 'cpu-load': 100.0, |
---|
| 274 | } |
---|
| 275 | |
---|
[15430] | 276 | #: Maximum number of files listed in `finished` subfolder |
---|
| 277 | MAX_FILES = 100 |
---|
| 278 | |
---|
[15833] | 279 | #: Maximum size in Bytes of passport images in the applicants and |
---|
| 280 | #: students section |
---|
| 281 | MAX_PASSPORT_SIZE = 50 * 1024 |
---|
| 282 | |
---|
[15609] | 283 | #: Temporary passwords and parents password validity period |
---|
| 284 | TEMP_PASSWORD_MINUTES = 10 |
---|
| 285 | |
---|
[17376] | 286 | def sortCertificates(self, context, resultset): |
---|
| 287 | """Sort already filtered certificates in `CertificateSource`. |
---|
| 288 | """ |
---|
| 289 | return sorted(resultset, key=lambda value: value.code) |
---|
| 290 | |
---|
| 291 | def getCertTitle(self, context, value): |
---|
| 292 | """Compose the titles in `CertificateSource`. |
---|
| 293 | """ |
---|
| 294 | return "%s - %s" % (value.code, value.title) |
---|
| 295 | |
---|
[11814] | 296 | def sendContactForm(self, from_name, from_addr, rcpt_name, rcpt_addr, |
---|
[16299] | 297 | from_username, usertype, portal, body, subject, |
---|
| 298 | bcc_to=None): |
---|
[7358] | 299 | """Send an email with data provided by forms. |
---|
| 300 | """ |
---|
| 301 | config = grok.getSite()['configuration'] |
---|
[16213] | 302 | text = _(u"""${e} |
---|
[7358] | 303 | |
---|
[16213] | 304 | --- |
---|
| 305 | ${a} (id: ${b}) |
---|
| 306 | ${d} |
---|
[7734] | 307 | """) |
---|
[11814] | 308 | text = _(text, mapping={ |
---|
| 309 | 'a': from_name, |
---|
| 310 | 'b': from_username, |
---|
| 311 | 'c': usertype, |
---|
| 312 | 'd': portal, |
---|
| 313 | 'e': body}) |
---|
[7811] | 314 | body = translate(text, 'waeup.kofa', |
---|
[7734] | 315 | target_language=self.PORTAL_LANGUAGE) |
---|
[8436] | 316 | if not (from_addr and rcpt_addr): |
---|
| 317 | return False |
---|
[7400] | 318 | return send_mail( |
---|
[11814] | 319 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
[16299] | 320 | subject, body, config, None, bcc_to) |
---|
[7359] | 321 | |
---|
[15964] | 322 | def getUsers(self): |
---|
| 323 | users = sorted( |
---|
| 324 | grok.getSite()['users'].items(), key=lambda x: x[1].title) |
---|
| 325 | for key, val in users: |
---|
| 326 | yield(dict(name=key, val="%s (%s)" % (val.title, val.name))) |
---|
| 327 | |
---|
[8181] | 328 | @property |
---|
| 329 | def tzinfo(self): |
---|
[13124] | 330 | """Time zone of the university. |
---|
| 331 | """ |
---|
[8181] | 332 | # For Nigeria: pytz.timezone('Africa/Lagos') |
---|
[9543] | 333 | # For Germany: pytz.timezone('Europe/Berlin') |
---|
[8181] | 334 | return pytz.utc |
---|
| 335 | |
---|
[11814] | 336 | def fullname(self, firstname, lastname, middlename=None): |
---|
[13124] | 337 | """Construct fullname. |
---|
[7477] | 338 | """ |
---|
[7359] | 339 | # We do not necessarily have the middlename attribute |
---|
| 340 | if middlename: |
---|
[8603] | 341 | name = '%s %s %s' % (firstname, middlename, lastname) |
---|
[7359] | 342 | else: |
---|
[8603] | 343 | name = '%s %s' % (firstname, lastname) |
---|
[13492] | 344 | if '<' in name: |
---|
| 345 | return 'XXX' |
---|
[11814] | 346 | return string.capwords( |
---|
| 347 | name.replace('-', ' - ')).replace(' - ', '-') |
---|
[7365] | 348 | |
---|
[15287] | 349 | def genPassword(self, length=4, chars=string.letters + string.digits): |
---|
[7477] | 350 | """Generate a random password. |
---|
| 351 | """ |
---|
[15287] | 352 | return ''.join([ |
---|
| 353 | r().choice(string.uppercase) + |
---|
| 354 | r().choice(string.lowercase) + |
---|
| 355 | r().choice(string.digits) for i in range(length)]) |
---|
[7365] | 356 | |
---|
[8853] | 357 | def sendCredentials(self, user, password=None, url_info=None, msg=None): |
---|
[13124] | 358 | """Send credentials as email. Input is the user for which credentials |
---|
| 359 | are sent and the password. Method returns True or False to indicate |
---|
| 360 | successful operation. |
---|
[7365] | 361 | """ |
---|
[17064] | 362 | subject = _('Your Kofa credentials') |
---|
[7734] | 363 | text = _(u"""Dear ${a}, |
---|
[7365] | 364 | |
---|
[7734] | 365 | ${b} |
---|
[7365] | 366 | Student Registration and Information Portal of |
---|
[7734] | 367 | ${c}. |
---|
[7365] | 368 | |
---|
[7734] | 369 | Your user name: ${d} |
---|
| 370 | Your password: ${e} |
---|
[8853] | 371 | ${f} |
---|
[7365] | 372 | |
---|
| 373 | Please remember your user name and keep |
---|
| 374 | your password secret! |
---|
| 375 | |
---|
[7382] | 376 | Please also note that passwords are case-sensitive. |
---|
| 377 | |
---|
[7365] | 378 | Regards |
---|
[7734] | 379 | """) |
---|
[7399] | 380 | config = grok.getSite()['configuration'] |
---|
| 381 | from_name = config.name_admin |
---|
[7402] | 382 | from_addr = config.email_admin |
---|
[7407] | 383 | rcpt_name = user.title |
---|
| 384 | rcpt_addr = user.email |
---|
[11814] | 385 | text = _(text, mapping={ |
---|
| 386 | 'a': rcpt_name, |
---|
| 387 | 'b': msg, |
---|
| 388 | 'c': config.name, |
---|
| 389 | 'd': user.name, |
---|
| 390 | 'e': password, |
---|
| 391 | 'f': url_info}) |
---|
[7734] | 392 | |
---|
[7811] | 393 | body = translate(text, 'waeup.kofa', |
---|
[7734] | 394 | target_language=self.PORTAL_LANGUAGE) |
---|
[7399] | 395 | return send_mail( |
---|
[11814] | 396 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
| 397 | subject, body, config) |
---|
[9987] | 398 | |
---|
[16551] | 399 | def informNewStudent(self, user, pw, login_url, rpw_url): |
---|
| 400 | """Inform student that a new student account has been created. |
---|
| 401 | """ |
---|
[17067] | 402 | subject = _('Your new Kofa student account') |
---|
[16551] | 403 | text = _(u"""Dear ${a}, |
---|
| 404 | |
---|
| 405 | Your student record of the Student Registration and Information Portal of |
---|
| 406 | ${b} has been created for you. |
---|
| 407 | |
---|
| 408 | Your user name: ${c} |
---|
| 409 | Your password: ${d} |
---|
| 410 | Login: ${e} |
---|
| 411 | |
---|
| 412 | Or request a new secure password here: ${f} |
---|
| 413 | |
---|
| 414 | Regards |
---|
| 415 | """) |
---|
| 416 | config = grok.getSite()['configuration'] |
---|
| 417 | from_name = config.name_admin |
---|
| 418 | from_addr = config.email_admin |
---|
| 419 | rcpt_name = user.title |
---|
| 420 | rcpt_addr = user.email |
---|
| 421 | |
---|
| 422 | text = _(text, mapping={ |
---|
| 423 | 'a': rcpt_name, |
---|
| 424 | 'b': config.name, |
---|
| 425 | 'c': user.name, |
---|
| 426 | 'd': pw, |
---|
| 427 | 'e': login_url, |
---|
| 428 | 'f': rpw_url |
---|
| 429 | }) |
---|
| 430 | body = translate(text, 'waeup.kofa', |
---|
| 431 | target_language=self.PORTAL_LANGUAGE) |
---|
| 432 | return send_mail( |
---|
| 433 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
| 434 | subject, body, config) |
---|
| 435 | |
---|
| 436 | |
---|
[16976] | 437 | def informApplicant(self, applicant): |
---|
| 438 | """Inform applicant that the application form was successfully |
---|
| 439 | submitted. |
---|
| 440 | """ |
---|
| 441 | if not getattr(applicant.__parent__, 'send_email', False): |
---|
| 442 | return |
---|
| 443 | subject = 'Your application form was successfully submitted' |
---|
| 444 | text = _(u"""Dear ${a}, |
---|
| 445 | |
---|
| 446 | Your application ${b} has been successfully submitted to ${c}. |
---|
| 447 | |
---|
| 448 | Regards |
---|
| 449 | """) |
---|
| 450 | config = grok.getSite()['configuration'] |
---|
| 451 | from_name = config.name_admin |
---|
| 452 | from_addr = config.email_admin |
---|
| 453 | rcpt_name = applicant.display_fullname |
---|
| 454 | rcpt_addr = applicant.email |
---|
| 455 | session = '%s/%s' % ( |
---|
| 456 | applicant.__parent__.year, applicant.__parent__.year+1) |
---|
| 457 | text = _(text, mapping={ |
---|
| 458 | 'a': rcpt_name, |
---|
| 459 | 'b': applicant.applicant_id, |
---|
| 460 | 'c': config.name, |
---|
| 461 | }) |
---|
| 462 | body = translate(text, 'waeup.kofa', |
---|
| 463 | target_language=self.PORTAL_LANGUAGE) |
---|
| 464 | return send_mail( |
---|
| 465 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
| 466 | subject, body, config) |
---|
| 467 | |
---|
[14014] | 468 | def inviteReferee(self, referee, applicant, url_info=None): |
---|
| 469 | """Send invitation email to referee. |
---|
| 470 | """ |
---|
| 471 | config = grok.getSite()['configuration'] |
---|
| 472 | subject = 'Request for referee report from %s' % config.name |
---|
| 473 | text = _(u"""Dear ${a}, |
---|
| 474 | |
---|
[14040] | 475 | The candidate with Id ${b} and name ${c} applied to |
---|
| 476 | the ${d} to study ${e} for the ${f} session. |
---|
[16777] | 477 | The candidate has listed you as referee. You are, therefore, required to, |
---|
| 478 | kindly, provide your referral remarks on or before ${g}. Please use the |
---|
| 479 | following form: |
---|
[14014] | 480 | |
---|
[14040] | 481 | ${h} |
---|
| 482 | |
---|
| 483 | Thank You |
---|
| 484 | |
---|
| 485 | The Secretary |
---|
[16777] | 486 | School of Postgraduate Studies |
---|
[14040] | 487 | ${d} |
---|
[14014] | 488 | """) |
---|
| 489 | from_name = config.name_admin |
---|
| 490 | from_addr = config.email_admin |
---|
| 491 | rcpt_name = referee.name |
---|
| 492 | rcpt_addr = referee.email |
---|
[14040] | 493 | session = '%s/%s' % ( |
---|
| 494 | applicant.__parent__.year, applicant.__parent__.year+1) |
---|
[14014] | 495 | text = _(text, mapping={ |
---|
| 496 | 'a': rcpt_name, |
---|
[14040] | 497 | 'b': applicant.applicant_id, |
---|
| 498 | 'c': applicant.display_fullname, |
---|
| 499 | 'd': config.name, |
---|
| 500 | 'e': applicant.course1.title, |
---|
| 501 | 'f': session, |
---|
| 502 | 'g': applicant.__parent__.enddate, |
---|
| 503 | 'h': url_info, |
---|
| 504 | }) |
---|
[14014] | 505 | |
---|
| 506 | body = translate(text, 'waeup.kofa', |
---|
| 507 | target_language=self.PORTAL_LANGUAGE) |
---|
| 508 | return send_mail( |
---|
| 509 | from_name, from_addr, rcpt_name, rcpt_addr, |
---|
| 510 | subject, body, config) |
---|
| 511 | |
---|
[9987] | 512 | def getPaymentItem(self, payment): |
---|
[13124] | 513 | """Return payment item. This method can be used to customize the |
---|
| 514 | `display_item` property attribute, e.g. in order to hide bed coordinates |
---|
| 515 | if maintenance fee is not paid. |
---|
[9987] | 516 | """ |
---|
| 517 | return payment.p_item |
---|
[11815] | 518 | |
---|
| 519 | def expensive_actions_allowed(self, type=None, request=None): |
---|
| 520 | """Tell, whether expensive actions are currently allowed. |
---|
| 521 | Check system load/health (or other external circumstances) and |
---|
| 522 | locally set values to see, whether expensive actions should be |
---|
| 523 | allowed (`True`) or better avoided (`False`). |
---|
| 524 | Use this to allow or forbid exports, report generations, or |
---|
| 525 | similar actions. |
---|
| 526 | """ |
---|
| 527 | max_values = self.SYSTEM_MAX_LOAD |
---|
[11816] | 528 | for (key, func) in ( |
---|
| 529 | ('swap-mem', psutil.swap_memory), |
---|
[11818] | 530 | ('virt-mem', psutil.virtual_memory), |
---|
[11816] | 531 | ): |
---|
| 532 | max_val = max_values.get(key, None) |
---|
| 533 | if max_val is None: |
---|
| 534 | continue |
---|
| 535 | mem_val = func() |
---|
[11815] | 536 | if isinstance(max_val, float): |
---|
[11816] | 537 | # percents |
---|
[11821] | 538 | if max_val < 0.0: |
---|
| 539 | max_val = 100.0 + max_val |
---|
[11816] | 540 | if mem_val.percent > max_val: |
---|
[11815] | 541 | return False |
---|
| 542 | else: |
---|
[11816] | 543 | # number of bytes |
---|
[11821] | 544 | if max_val < 0: |
---|
| 545 | max_val = mem_val.total + max_val |
---|
[11816] | 546 | if mem_val.used > max_val: |
---|
[11815] | 547 | return False |
---|
| 548 | return True |
---|
[13198] | 549 | |
---|
| 550 | def export_disabled_message(self): |
---|
| 551 | export_disabled_message = grok.getSite()[ |
---|
| 552 | 'configuration'].export_disabled_message |
---|
| 553 | if export_disabled_message: |
---|
| 554 | return export_disabled_message |
---|
[14473] | 555 | return None |
---|
| 556 | |
---|
| 557 | def format_float(self, value, prec): |
---|
[15476] | 558 | # >>> 4.6 * 100 |
---|
| 559 | # 459.99999999999994 |
---|
| 560 | value = decimal.Decimal(str(value)) |
---|
[14473] | 561 | # cut floating point value |
---|
| 562 | value = int(pow(10, prec)*value) / (1.0*pow(10, prec)) |
---|
| 563 | return '{:{width}.{prec}f}'.format(value, width=0, prec=prec) |
---|