45 lines
1.5 KiB
Python
45 lines
1.5 KiB
Python
"""
|
|
Helpers functions for grades and scores.
|
|
"""
|
|
|
|
|
|
def compare_scores(earned1, possible1, earned2, possible2, treat_undefined_as_zero=False):
|
|
"""
|
|
Returns a tuple of:
|
|
1. Whether the 2nd set of scores is higher than the first.
|
|
2. Grade percentage of 1st set of scores.
|
|
3. Grade percentage of 2nd set of scores.
|
|
If ``treat_undefined_as_zero`` is True, this function will treat
|
|
cases where ``possible1`` or ``possible2`` is 0 as if
|
|
the (earned / possible) score is 0. If this flag is false,
|
|
a ZeroDivisionError is raised.
|
|
"""
|
|
try:
|
|
percentage1 = float(earned1) / float(possible1)
|
|
except ZeroDivisionError:
|
|
if not treat_undefined_as_zero:
|
|
raise
|
|
percentage1 = 0.0
|
|
|
|
try:
|
|
percentage2 = float(earned2) / float(possible2)
|
|
except ZeroDivisionError:
|
|
if not treat_undefined_as_zero:
|
|
raise
|
|
percentage2 = 0.0
|
|
|
|
is_higher = percentage2 >= percentage1
|
|
return is_higher, percentage1, percentage2
|
|
|
|
|
|
def is_score_higher_or_equal(earned1, possible1, earned2, possible2, treat_undefined_as_zero=False):
|
|
"""
|
|
Returns whether the 2nd set of scores is higher than the first.
|
|
If ``treat_undefined_as_zero`` is True, this function will treat
|
|
cases where ``possible1`` or ``possible2`` is 0 as if
|
|
the (earned / possible) score is 0. If this flag is false,
|
|
a ZeroDivisionError is raised.
|
|
"""
|
|
is_higher_or_equal, _, _ = compare_scores(earned1, possible1, earned2, possible2, treat_undefined_as_zero)
|
|
return is_higher_or_equal
|