Changeset 13124 for main/waeup.kofa/trunk/src/waeup

Timestamp:

1 Jul 2015, 16:24:58 (9 years ago)

Author:

Henrik Bettermann

Message:

More docs.

Location:

main/waeup.kofa/trunk/src/waeup/kofa

Files:

• students/utils.py (modified) (13 diffs)
• utils/utils.py (modified) (6 diffs)

main/waeup.kofa/trunk/src/waeup/kofa/students/utils.py

@@ -323 +323 @@
         """ Define what happens after school fee payment
         depending on the student's senate verdict.
-
         In the base configuration current level is always increased
         by 100 no matter which verdict has been assigned.
@@ -334 +333 @@
         """ Define what happens after school fee payment
         depending on the student's senate verdict.
-
-        This method folllows the same algorithm as getReturningData but
+        This method folllows the same algorithm as `getReturningData` but
         it also sets the new values.
         """
@@ -376 +374 @@
     def setPaymentDetails(self, category, student,
             previous_session, previous_level):
-        """Create a payment ticket object and set the payment data of a
+        """Create a payment ticket and set the payment data of a
         student for the payment category specified.
         """
@@ -491 +489 @@
     def setBalanceDetails(self, category, student,
             balance_session, balance_level, balance_amount):
-        """Create Payment object and set the payment data of a student for.
-
+        """Create a balance payment ticket and set the payment data
+        as selected by the student.
         """
         p_item = u'Balance'
@@ -519 +517 @@
     def increaseMatricInteger(self, student):
         """Increase counter for matric numbers.
-
         This counter can be a centrally stored attribute or an attribute of 
         faculties, departments or certificates. In the base package the counter
-        is as an attribute of the site configuration object.
+        is as an attribute of the site configuration container.
         """
         grok.getSite()['configuration'].next_matric_integer += 1
@@ -530 +527 @@
         """Fetch the matric number counter which fits the student and
         construct the new matric number of the student.
-
         In the base package the counter is returned which is as an attribute
-        of the site configuration object.
+        of the site configuration container.
         """
         next_integer = grok.getSite()['configuration'].next_matric_integer
@@ -540 +536 @@
 
     def setMatricNumber(self, student):
-        """Set matriculation number of student.
-
-        If the student's matric number is unset a new matric number is
+        """Set matriculation number of student. If the student's matric number
+        is unset a new matric number is
         constructed according to the matriculation number construction rules
-        defined in the constructMatricNumber method. The new matric number is 
+        defined in the `constructMatricNumber` method. The new matric number is
         set, the students catalog updated. The corresponding matric number
         counter is increased by one.
@@ -550 +545 @@
         This method is tested but not used in the base package. It can
         be used in custom packages by adding respective views
-        and by customizing increaseMatricInteger and constructMatricNumber
+        and by customizing `increaseMatricInteger` and `constructMatricNumber`
         according to the university's matriculation number construction rules.
 
@@ -607 +602 @@
     def selectBed(self, available_beds):
         """Select a bed from a list of available beds.
-
         In the base configuration we select the first bed found,
         but can also randomize the selection if we like.
@@ -680 +674 @@
     def getPDFCreator(self, context):
         """Get a pdf creator suitable for `context`.
-
         The default implementation always returns the default creator.
         """
@@ -800 +793 @@
                   omit_fields=(),
                   tableheader=None):
-        """Render pdf slips for transcript.
+        """Render pdf slips for transcripts.
         """
         portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
@@ -905 +898 @@
     def maxCredits(self, studylevel):
         """Return maximum credits.
-
-        In some universities maximum credits is not constant, it
-        depends on the student's study level. Set maxCredits None or 0
+        At some universities maximum credits is not constant, it
+        depends on the student's study level. Set `maxCredits` None or 0
         in order to deactivate the limitation.
         """
@@ -921 +913 @@
     def getBedCoordinates(self, bedticket):
         """Return bed coordinates.
-
-        This method can be used to customize the display_coordinates
+        This method can be used to customize the `display_coordinates`
         property method.
         """

main/waeup.kofa/trunk/src/waeup/kofa/utils/utils.py

@@ -80 +80 @@
 class KofaUtils(grok.GlobalUtility):
     """A collection of parameters and methods subject to customization.
-
     """
     grok.implements(IKofaUtils)
@@ -242 +241 @@
     @property
     def tzinfo(self):
+        """Time zone of the university.
+        """
         # For Nigeria: pytz.timezone('Africa/Lagos')
         # For Germany: pytz.timezone('Europe/Berlin')
@@ -247 +248 @@
 
     def fullname(self, firstname, lastname, middlename=None):
-        """Full name constructor.
+        """Construct fullname.
         """
         # We do not necessarily have the middlename attribute
@@ -263 +264 @@
 
     def sendCredentials(self, user, password=None, url_info=None, msg=None):
-        """Send credentials as email.
-
-        Input is the applicant for which credentials are sent and the
-        password.
-
-        Returns True or False to indicate successful operation.
+        """Send credentials as email. Input is the user for which credentials
+        are sent and the password. Method returns True or False to indicate
+        successful operation.
         """
         subject = 'Your Kofa credentials'
@@ -308 +306 @@
 
     def getPaymentItem(self, payment):
-        """Return payment item.
-
-        This method can be used to customize the display_item property method.
+        """Return payment item. This method can be used to customize the
+        `display_item` property attribute, e.g. in order to hide bed coordinates
+        if maintenance fee is not paid.
         """
         return payment.p_item
@@ -316 +314 @@
     def expensive_actions_allowed(self, type=None, request=None):
         """Tell, whether expensive actions are currently allowed.
-
         Check system load/health (or other external circumstances) and
         locally set values to see, whether expensive actions should be
         allowed (`True`) or better avoided (`False`).
-
         Use this to allow or forbid exports, report generations, or
         similar actions.