239 lines
9.7 KiB
Python
239 lines
9.7 KiB
Python
"""
|
|
Unit tests for bulk-email-related models.
|
|
"""
|
|
from django.test import TestCase
|
|
from django.core.management import call_command
|
|
|
|
from student.tests.factories import UserFactory
|
|
|
|
from mock import patch, Mock
|
|
from nose.plugins.attrib import attr
|
|
|
|
from bulk_email.models import (
|
|
CourseEmail,
|
|
SEND_TO_COHORT,
|
|
SEND_TO_STAFF,
|
|
CourseEmailTemplate,
|
|
CourseAuthorization,
|
|
BulkEmailFlag
|
|
)
|
|
from openedx.core.djangoapps.course_groups.models import CourseCohort
|
|
from opaque_keys.edx.keys import CourseKey
|
|
|
|
|
|
@attr(shard=1)
|
|
@patch('bulk_email.models.html_to_text', Mock(return_value='Mocking CourseEmail.text_message', autospec=True))
|
|
class CourseEmailTest(TestCase):
|
|
"""Test the CourseEmail model."""
|
|
|
|
def test_creation(self):
|
|
course_id = CourseKey.from_string('abc/123/doremi')
|
|
sender = UserFactory.create()
|
|
to_option = SEND_TO_STAFF
|
|
subject = "dummy subject"
|
|
html_message = "<html>dummy message</html>"
|
|
email = CourseEmail.create(course_id, sender, [to_option], subject, html_message)
|
|
self.assertEqual(email.course_id, course_id)
|
|
self.assertIn(SEND_TO_STAFF, [target.target_type for target in email.targets.all()])
|
|
self.assertEqual(email.subject, subject)
|
|
self.assertEqual(email.html_message, html_message)
|
|
self.assertEqual(email.sender, sender)
|
|
|
|
def test_creation_with_optional_attributes(self):
|
|
course_id = CourseKey.from_string('abc/123/doremi')
|
|
sender = UserFactory.create()
|
|
to_option = SEND_TO_STAFF
|
|
subject = "dummy subject"
|
|
html_message = "<html>dummy message</html>"
|
|
template_name = "branded_template"
|
|
from_addr = "branded@branding.com"
|
|
email = CourseEmail.create(
|
|
course_id, sender, [to_option], subject, html_message, template_name=template_name, from_addr=from_addr
|
|
)
|
|
self.assertEqual(email.course_id, course_id)
|
|
self.assertEqual(email.targets.all()[0].target_type, SEND_TO_STAFF)
|
|
self.assertEqual(email.subject, subject)
|
|
self.assertEqual(email.html_message, html_message)
|
|
self.assertEqual(email.sender, sender)
|
|
self.assertEqual(email.template_name, template_name)
|
|
self.assertEqual(email.from_addr, from_addr)
|
|
|
|
def test_bad_to_option(self):
|
|
course_id = CourseKey.from_string('abc/123/doremi')
|
|
sender = UserFactory.create()
|
|
to_option = "fake"
|
|
subject = "dummy subject"
|
|
html_message = "<html>dummy message</html>"
|
|
with self.assertRaises(ValueError):
|
|
CourseEmail.create(course_id, sender, to_option, subject, html_message)
|
|
|
|
def test_cohort_target(self):
|
|
course_id = CourseKey.from_string('abc/123/doremi')
|
|
sender = UserFactory.create()
|
|
to_option = 'cohort:test cohort'
|
|
subject = "dummy subject"
|
|
html_message = "<html>dummy message</html>"
|
|
CourseCohort.create(cohort_name='test cohort', course_id=course_id)
|
|
email = CourseEmail.create(course_id, sender, [to_option], subject, html_message)
|
|
self.assertEqual(len(email.targets.all()), 1)
|
|
target = email.targets.all()[0]
|
|
self.assertEqual(target.target_type, SEND_TO_COHORT)
|
|
self.assertEqual(target.short_display(), 'cohort-test cohort')
|
|
self.assertEqual(target.long_display(), 'Cohort: test cohort')
|
|
|
|
|
|
@attr(shard=1)
|
|
class NoCourseEmailTemplateTest(TestCase):
|
|
"""Test the CourseEmailTemplate model without loading the template data."""
|
|
|
|
def test_get_missing_template(self):
|
|
with self.assertRaises(CourseEmailTemplate.DoesNotExist):
|
|
CourseEmailTemplate.get_template()
|
|
|
|
|
|
@attr(shard=1)
|
|
class CourseEmailTemplateTest(TestCase):
|
|
"""Test the CourseEmailTemplate model."""
|
|
|
|
def setUp(self):
|
|
super(CourseEmailTemplateTest, self).setUp()
|
|
|
|
# load initial content (since we don't run migrations as part of tests):
|
|
call_command("loaddata", "course_email_template.json")
|
|
|
|
def _get_sample_plain_context(self):
|
|
"""Provide sample context sufficient for rendering plaintext template"""
|
|
context = {
|
|
'course_title': "Bogus Course Title",
|
|
'course_url': "/location/of/course/url",
|
|
'email_settings_url': "/location/of/email/settings/url",
|
|
'platform_name': 'edX',
|
|
'email': 'your-email@test.com',
|
|
}
|
|
return context
|
|
|
|
def _get_sample_html_context(self):
|
|
"""Provide sample context sufficient for rendering HTML template"""
|
|
context = self._get_sample_plain_context()
|
|
context['course_image_url'] = "/location/of/course/image/url"
|
|
return context
|
|
|
|
def _add_xss_fields(self, context):
|
|
""" Add fields to the context for XSS testing. """
|
|
context['course_title'] = "<script>alert('Course Title!');</alert>"
|
|
context['name'] = "<script>alert('Profile Name!');</alert>"
|
|
# Must have user_id and course_id present in order to do keyword substitution
|
|
context['user_id'] = 12345
|
|
context['course_id'] = "course-v1:edx+100+1"
|
|
return context
|
|
|
|
def test_get_template(self):
|
|
# Get the default template, which has name=None
|
|
template = CourseEmailTemplate.get_template()
|
|
self.assertIsNotNone(template.html_template)
|
|
self.assertIsNotNone(template.plain_template)
|
|
|
|
def test_get_branded_template(self):
|
|
# Get a branded (non default) template and make sure we get what we expect
|
|
template = CourseEmailTemplate.get_template(name="branded.template")
|
|
self.assertIsNotNone(template.html_template)
|
|
self.assertIsNotNone(template.plain_template)
|
|
self.assertIn(u"THIS IS A BRANDED HTML TEMPLATE", template.html_template)
|
|
self.assertIn(u"THIS IS A BRANDED TEXT TEMPLATE", template.plain_template)
|
|
|
|
def test_render_html_without_context(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
base_context = self._get_sample_html_context()
|
|
for keyname in base_context:
|
|
context = dict(base_context)
|
|
del context[keyname]
|
|
with self.assertRaises(KeyError):
|
|
template.render_htmltext("My new html text.", context)
|
|
|
|
def test_render_plaintext_without_context(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
base_context = self._get_sample_plain_context()
|
|
for keyname in base_context:
|
|
context = dict(base_context)
|
|
del context[keyname]
|
|
with self.assertRaises(KeyError):
|
|
template.render_plaintext("My new plain text.", context)
|
|
|
|
def test_render_html(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
context = self._get_sample_html_context()
|
|
template.render_htmltext("My new html text.", context)
|
|
|
|
def test_render_html_xss(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
context = self._add_xss_fields(self._get_sample_html_context())
|
|
message = template.render_htmltext(
|
|
"Dear %%USER_FULLNAME%%, thanks for enrolling in %%COURSE_DISPLAY_NAME%%.", context
|
|
)
|
|
self.assertNotIn("<script>", message)
|
|
self.assertIn("<script>alert('Course Title!');</alert>", message)
|
|
self.assertIn("<script>alert('Profile Name!');</alert>", message)
|
|
|
|
def test_render_plain(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
context = self._get_sample_plain_context()
|
|
template.render_plaintext("My new plain text.", context)
|
|
|
|
def test_render_plain_no_escaping(self):
|
|
template = CourseEmailTemplate.get_template()
|
|
context = self._add_xss_fields(self._get_sample_plain_context())
|
|
message = template.render_plaintext(
|
|
"Dear %%USER_FULLNAME%%, thanks for enrolling in %%COURSE_DISPLAY_NAME%%.", context
|
|
)
|
|
self.assertNotIn("<script>", message)
|
|
self.assertIn(context['course_title'], message)
|
|
self.assertIn(context['name'], message)
|
|
|
|
|
|
@attr(shard=1)
|
|
class CourseAuthorizationTest(TestCase):
|
|
"""Test the CourseAuthorization model."""
|
|
|
|
def tearDown(self):
|
|
super(CourseAuthorizationTest, self).tearDown()
|
|
BulkEmailFlag.objects.all().delete()
|
|
|
|
def test_creation_auth_on(self):
|
|
BulkEmailFlag.objects.create(enabled=True, require_course_email_auth=True)
|
|
course_id = CourseKey.from_string('abc/123/doremi')
|
|
# Test that course is not authorized by default
|
|
self.assertFalse(BulkEmailFlag.feature_enabled(course_id))
|
|
|
|
# Authorize
|
|
cauth = CourseAuthorization(course_id=course_id, email_enabled=True)
|
|
cauth.save()
|
|
# Now, course should be authorized
|
|
self.assertTrue(BulkEmailFlag.feature_enabled(course_id))
|
|
self.assertEqual(
|
|
cauth.__unicode__(),
|
|
"Course 'abc/123/doremi': Instructor Email Enabled"
|
|
)
|
|
|
|
# Unauthorize by explicitly setting email_enabled to False
|
|
cauth.email_enabled = False
|
|
cauth.save()
|
|
# Test that course is now unauthorized
|
|
self.assertFalse(BulkEmailFlag.feature_enabled(course_id))
|
|
self.assertEqual(
|
|
cauth.__unicode__(),
|
|
"Course 'abc/123/doremi': Instructor Email Not Enabled"
|
|
)
|
|
|
|
def test_creation_auth_off(self):
|
|
BulkEmailFlag.objects.create(enabled=True, require_course_email_auth=False)
|
|
course_id = CourseKey.from_string('blahx/blah101/ehhhhhhh')
|
|
# Test that course is authorized by default, since auth is turned off
|
|
self.assertTrue(BulkEmailFlag.feature_enabled(course_id))
|
|
|
|
# Use the admin interface to unauthorize the course
|
|
cauth = CourseAuthorization(course_id=course_id, email_enabled=False)
|
|
cauth.save()
|
|
|
|
# Now, course should STILL be authorized!
|
|
self.assertTrue(BulkEmailFlag.feature_enabled(course_id))
|