152 lines
6.1 KiB
Python
152 lines
6.1 KiB
Python
"""
|
|
Student and course analytics.
|
|
|
|
Serve miscellaneous course and student data
|
|
"""
|
|
from shoppingcart.models import PaidCourseRegistration, CouponRedemption
|
|
from django.contrib.auth.models import User
|
|
import xmodule.graders as xmgraders
|
|
|
|
|
|
STUDENT_FEATURES = ('id', 'username', 'first_name', 'last_name', 'is_staff', 'email')
|
|
PROFILE_FEATURES = ('name', 'language', 'location', 'year_of_birth', 'gender',
|
|
'level_of_education', 'mailing_address', 'goals')
|
|
ORDER_ITEM_FEATURES = ('list_price', 'unit_cost', 'order_id')
|
|
ORDER_FEATURES = ('purchase_time',)
|
|
|
|
AVAILABLE_FEATURES = STUDENT_FEATURES + PROFILE_FEATURES
|
|
|
|
|
|
def purchase_transactions(course_id, features):
|
|
"""
|
|
Return list of purchased transactions features as dictionaries.
|
|
|
|
purchase_transactions(course_id, ['username, email', unit_cost])
|
|
would return [
|
|
{'username': 'username1', 'email': 'email1', unit_cost:'cost1 in decimal'.}
|
|
{'username': 'username2', 'email': 'email2', unit_cost:'cost2 in decimal'.}
|
|
{'username': 'username3', 'email': 'email3', unit_cost:'cost3 in decimal'.}
|
|
]
|
|
"""
|
|
|
|
purchased_courses = PaidCourseRegistration.objects.filter(course_id=course_id, status='purchased')
|
|
|
|
def purchase_transactions_info(purchased_course, features):
|
|
""" convert purchase transactions to dictionary """
|
|
coupon_code_dict = dict()
|
|
student_features = [x for x in STUDENT_FEATURES if x in features]
|
|
order_features = [x for x in ORDER_FEATURES if x in features]
|
|
order_item_features = [x for x in ORDER_ITEM_FEATURES if x in features]
|
|
|
|
# Extracting user information
|
|
student_dict = dict((feature, getattr(purchased_course.user, feature))
|
|
for feature in student_features)
|
|
|
|
# Extracting Order information
|
|
order_dict = dict((feature, getattr(purchased_course.order, feature))
|
|
for feature in order_features)
|
|
|
|
# Extracting OrderItem information
|
|
order_item_dict = dict((feature, getattr(purchased_course, feature))
|
|
for feature in order_item_features)
|
|
order_item_dict.update({"orderitem_id": getattr(purchased_course, 'id')})
|
|
|
|
try:
|
|
coupon_redemption = CouponRedemption.objects.select_related('coupon').get(order_id=purchased_course.order_id)
|
|
except CouponRedemption.DoesNotExist:
|
|
coupon_code_dict = {'coupon_code': 'None'}
|
|
else:
|
|
coupon_code_dict = {'coupon_code': coupon_redemption.coupon.code}
|
|
|
|
student_dict.update(dict(order_dict.items() + order_item_dict.items() + coupon_code_dict.items()))
|
|
student_dict.update({'course_id': course_id.to_deprecated_string()})
|
|
return student_dict
|
|
|
|
return [purchase_transactions_info(purchased_course, features) for purchased_course in purchased_courses]
|
|
|
|
|
|
def enrolled_students_features(course_id, features):
|
|
"""
|
|
Return list of student features as dictionaries.
|
|
|
|
enrolled_students_features(course_id, ['username, first_name'])
|
|
would return [
|
|
{'username': 'username1', 'first_name': 'firstname1'}
|
|
{'username': 'username2', 'first_name': 'firstname2'}
|
|
{'username': 'username3', 'first_name': 'firstname3'}
|
|
]
|
|
"""
|
|
students = User.objects.filter(
|
|
courseenrollment__course_id=course_id,
|
|
courseenrollment__is_active=1,
|
|
).order_by('username').select_related('profile')
|
|
|
|
def extract_student(student, features):
|
|
""" convert student to dictionary """
|
|
student_features = [x for x in STUDENT_FEATURES if x in features]
|
|
profile_features = [x for x in PROFILE_FEATURES if x in features]
|
|
|
|
student_dict = dict((feature, getattr(student, feature))
|
|
for feature in student_features)
|
|
profile = student.profile
|
|
if profile is not None:
|
|
profile_dict = dict((feature, getattr(profile, feature))
|
|
for feature in profile_features)
|
|
student_dict.update(profile_dict)
|
|
return student_dict
|
|
|
|
return [extract_student(student, features) for student in students]
|
|
|
|
|
|
def dump_grading_context(course):
|
|
"""
|
|
Render information about course grading context
|
|
(e.g. which problems are graded in what assignments)
|
|
Useful for debugging grading_policy.json and policy.json
|
|
|
|
Returns HTML string
|
|
"""
|
|
hbar = "{}\n".format("-" * 77)
|
|
msg = hbar
|
|
msg += "Course grader:\n"
|
|
|
|
msg += '%s\n' % course.grader.__class__
|
|
graders = {}
|
|
if isinstance(course.grader, xmgraders.WeightedSubsectionsGrader):
|
|
msg += '\n'
|
|
msg += "Graded sections:\n"
|
|
for subgrader, category, weight in course.grader.sections:
|
|
msg += " subgrader=%s, type=%s, category=%s, weight=%s\n"\
|
|
% (subgrader.__class__, subgrader.type, category, weight)
|
|
subgrader.index = 1
|
|
graders[subgrader.type] = subgrader
|
|
msg += hbar
|
|
msg += "Listing grading context for course %s\n" % course.id.to_deprecated_string()
|
|
|
|
gcontext = course.grading_context
|
|
msg += "graded sections:\n"
|
|
|
|
msg += '%s\n' % gcontext['graded_sections'].keys()
|
|
for (gsomething, gsvals) in gcontext['graded_sections'].items():
|
|
msg += "--> Section %s:\n" % (gsomething)
|
|
for sec in gsvals:
|
|
sdesc = sec['section_descriptor']
|
|
frmat = getattr(sdesc, 'format', None)
|
|
aname = ''
|
|
if frmat in graders:
|
|
gform = graders[frmat]
|
|
aname = '%s %02d' % (gform.short_label, gform.index)
|
|
gform.index += 1
|
|
elif sdesc.display_name in graders:
|
|
gform = graders[sdesc.display_name]
|
|
aname = '%s' % gform.short_label
|
|
notes = ''
|
|
if getattr(sdesc, 'score_by_attempt', False):
|
|
notes = ', score by attempt!'
|
|
msg += " %s (format=%s, Assignment=%s%s)\n"\
|
|
% (sdesc.display_name, frmat, aname, notes)
|
|
msg += "all descriptors:\n"
|
|
msg += "length=%d\n" % len(gcontext['all_descriptors'])
|
|
msg = '<pre>%s</pre>' % msg.replace('<', '<')
|
|
return msg
|