from __future__ import annotations __copyright__ = "Copyright (C) 2017 Dong Zhuang" __license__ = """ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. """ import datetime import re import unittest from django.core.management import CommandError from django.test import RequestFactory, TestCase from django.test.utils import override_settings from django.utils.dateformat import format from django.utils.formats import date_format, get_format from django.utils.translation import gettext_lazy as _ from course.models import Course from course.versioning import CourseCreationForm from course.views import EditCourseForm from manage import get_local_test_settings_file from relate.utils import ( format_datetime_local, get_outbound_mail_connection, is_maintenance_mode, render_email_template, ) from tests.base_test_mixins import SingleCourseTestMixin from tests.constants import DATE_TIME_PICKER_TIME_FORMAT from tests.test_utils import ( REAL_TRANSLATION_FUNCTION_TO_MOCK, real_trans_side_effect, ) from tests.utils import LocmemBackendTestsMixin, mail, mock LANGUAGES = [ ("en", _("English")), ("ko", _("Korean")), ("fr", _("French")), ] ASSERTION_ERROR_LANGUAGE_PATTERN = ( "%s page visiting results don't match in terms of " "whether the response contains Korean characters." ) ASSERTION_ERROR_CONTENT_LANGUAGE_PATTERN = ( "%s page visiting result don't match in terms of " "whether the response content-language are restored." ) VALIDATION_ERROR_LANG_NOT_SUPPORTED_PATTERN = ( "'%s' is currently not supported as a course specific language at " "this site." ) class CourseSpecificLangTestMixin(SingleCourseTestMixin, TestCase): # {{{ assertion method def response_contains_korean(self, resp): # Korean literals for 12th month (December) return "12월" in resp.content.decode("utf-8") def assertResponseContainsChinese(self, resp): # noqa self.assertTrue(self.response_contains_korean(resp)) def assertResponseNotContainsChinese(self, resp): # noqa self.assertFalse(self.response_contains_korean(resp)) # }}} # {{{ common tests def resp_info_with_diff_settings(self, url): contains_korean_result = [] response_content_language_result = [] with override_settings(USE_I18N=True, LANGUAGE_CODE="en-us"): resp = self.client.get(url) self.assertEqual(resp.status_code, 200) contains_korean_result.append(self.response_contains_korean(resp)) response_content_language_result.append(resp["content-language"]) resp = self.client.get(url, HTTP_ACCEPT_LANGUAGE="ko") self.assertEqual(resp.status_code, 200) contains_korean_result.append(self.response_contains_korean(resp)) response_content_language_result.append(resp["content-language"]) with override_settings(USE_I18N=False): resp = self.client.get(url) self.assertEqual(resp.status_code, 200) contains_korean_result.append(self.response_contains_korean(resp)) response_content_language_result.append(resp["content-language"]) resp = self.client.get(url, HTTP_ACCEPT_LANGUAGE="ko") self.assertEqual(resp.status_code, 200) contains_korean_result.append(self.response_contains_korean(resp)) response_content_language_result.append(resp["content-language"]) return contains_korean_result, response_content_language_result def home_resp_contains_korean_with_diff_settings(self): return self.resp_info_with_diff_settings("/") def course_resp_contains_korean_with_diff_settings(self): return self.resp_info_with_diff_settings(self.course_page_url) # }}} class CourseSpecificLangConfigureTest(CourseSpecificLangTestMixin, TestCase): # By default, self.course.force_lang is None def setUp(self): super().setUp() # We use faked time header to find out whether the expected Chinese # characters are rendered self.client.force_login(self.instructor_participation.user) fake_time = datetime.datetime(2038, 12, 31, 0, 0, 0, 0) set_fake_time_data = { "time": fake_time.strftime(DATE_TIME_PICKER_TIME_FORMAT), "set": [""]} self.post_set_fake_time(set_fake_time_data) def assertResponseBehaveLikeUnconfigured(self): # noqa # For each setting combinations, the response behaves the same # as before this functionality was introduced expected_result = ([False, True, False, True], ["en", "ko", "en", "ko"]) self.assertEqual( self.home_resp_contains_korean_with_diff_settings()[0], expected_result[0], ASSERTION_ERROR_LANGUAGE_PATTERN % "Home" ) self.assertEqual( self.home_resp_contains_korean_with_diff_settings()[1], expected_result[1], ASSERTION_ERROR_CONTENT_LANGUAGE_PATTERN % "Home" ) expected_result = ([False, True, False, True], ["en", "ko", "en", "ko"]) self.assertEqual( self.course_resp_contains_korean_with_diff_settings()[0], expected_result[0], ASSERTION_ERROR_LANGUAGE_PATTERN % "Course" ) self.assertEqual( self.course_resp_contains_korean_with_diff_settings()[1], expected_result[1], ASSERTION_ERROR_CONTENT_LANGUAGE_PATTERN % "Course" ) def assertResponseBehaveAsExpectedForCourseWithForceLang(self): # noqa # For each setting combinations, the response behaves as expected expected_result = ([False, True, False, True], ["en", "ko", "en", "ko"]) self.assertEqual( self.home_resp_contains_korean_with_diff_settings()[0], expected_result[0], ASSERTION_ERROR_LANGUAGE_PATTERN % "Home" ) self.assertEqual( self.home_resp_contains_korean_with_diff_settings()[1], expected_result[1], ASSERTION_ERROR_CONTENT_LANGUAGE_PATTERN % "Home" ) expected_result = ([True, True, True, True], ["en", "ko", "en", "ko"]) self.assertEqual( self.course_resp_contains_korean_with_diff_settings()[0], expected_result[0], ASSERTION_ERROR_LANGUAGE_PATTERN % "Course" ) self.assertEqual( self.course_resp_contains_korean_with_diff_settings()[1], expected_result[1], ASSERTION_ERROR_CONTENT_LANGUAGE_PATTERN % "Course" ) def set_course_lang_to_ko(self): self.course.force_lang = "ko" self.course.save() self.course.refresh_from_db() def test_languages_not_configured(self): self.assertResponseBehaveLikeUnconfigured() def test_languages_not_configured_course_has_force_lang(self): self.set_course_lang_to_ko() self.assertResponseBehaveAsExpectedForCourseWithForceLang() @override_settings(LANGUAGES=LANGUAGES) def test_languages_configured(self): # because self.course.force_lang is None self.assertResponseBehaveLikeUnconfigured() @override_settings(LANGUAGES=LANGUAGES) def test_languages_configured_course_has_force_lang(self): self.set_course_lang_to_ko() self.assertResponseBehaveAsExpectedForCourseWithForceLang() @override_settings(LANGUAGES=LANGUAGES) def test_languages_configured_course_has_force_lang_get_language_none(self): self.set_course_lang_to_ko() with mock.patch("course.utils.translation.get_language")\ as mock_get_language, \ mock.patch("course.utils.translation.deactivate_all")\ as mock_deactivate_all: mock_get_language.return_value = None home_visit_result = self.home_resp_contains_korean_with_diff_settings() self.assertEqual( # Display Korean according to i18n, language_code and browser home_visit_result[0], [False, True, False, True]) self.assertEqual(mock_deactivate_all.call_count, 0) mock_deactivate_all.reset_mock() course_page_visit_result = ( self.course_resp_contains_korean_with_diff_settings()) self.assertEqual( # All display Korean course_page_visit_result[0], [True, True, True, True]) # There are 4 visit, each will call deactivate_all() self.assertEqual(mock_deactivate_all.call_count, 4) class CourseSpecificLangFormTest(SingleCourseTestMixin, TestCase): def test_edit_course_force_lang_invalid(self): course_kwargs = self.copy_course_dict_and_set_attrs_for_post( {"force_lang": "foo"}) form = EditCourseForm(course_kwargs, instance=self.course) self.assertTrue("force_lang" in form.fields) self.assertFalse(form.is_valid()) self.assertEqual(form.errors["force_lang"][0], VALIDATION_ERROR_LANG_NOT_SUPPORTED_PATTERN % "foo") def test_edit_course_force_lang_valid(self): course_kwargs = self.copy_course_dict_and_set_attrs_for_post( {"force_lang": "de"}) form = EditCourseForm(course_kwargs, instance=self.course) self.assertTrue(form.is_valid()) def test_create_course_force_lang_invalid(self): course_kwargs = self.copy_course_dict_and_set_attrs_for_post( {"force_lang": "foo"}) course_kwargs["identifier"] = "another-test-course" expected_course_count = Course.objects.count() form = CourseCreationForm(course_kwargs) self.assertTrue("force_lang" in form.fields) self.assertFalse(form.is_valid()) self.assertEqual(form.errors["force_lang"][0], VALIDATION_ERROR_LANG_NOT_SUPPORTED_PATTERN % "foo") self.assertEqual(Course.objects.count(), expected_course_count) class GetCurrentLanguageJsLangNameTest(TestCase): def setUp(self): super().setUp() from django.template.utils import EngineHandler self.engines = EngineHandler() def test_get_current_js_lang_name_tag(self): with override_settings(LANGUAGE_CODE="en-us"): template = self.engines["django"].from_string( "{% get_current_js_lang_name as LANG %}{{LANG}}") text = template.render() self.assertEqual(text, "en-US") with override_settings(LANGUAGE_CODE="de"): template = self.engines["django"].from_string( "{% get_current_js_lang_name as LANG %}{{LANG}}") text = template.render() self.assertEqual(text, "de") with override_settings(LANGUAGE_CODE="zh-hans"): template = self.engines["django"].from_string( "{% get_current_js_lang_name as LANG %}{{LANG}}") text = template.render() self.assertEqual(text, "zh-Hans") with override_settings(LANGUAGE_CODE="zh-hant"): template = self.engines["django"].from_string( "{% get_current_js_lang_name as LANG %}{{LANG}}") text = template.render() self.assertEqual(text, "zh-Hant") def test_get_current_js_lang_name_tag_failed(self): from django.template import TemplateSyntaxError msg = ("'get_current_js_lang_name' requires 'as variable' " "(got [u'get_current_js_lang_name'])") msg = msg.replace("u'", "'") with self.assertRaisesMessage(TemplateSyntaxError, expected_message=msg): self.engines["django"].from_string( "{% get_current_js_lang_name %}") msg = ("'get_current_js_lang_name' requires 'as variable' " "(got [u'get_current_js_lang_name', u'AS', u'LANG'])") msg = msg.replace("u'", "'") with self.assertRaisesMessage(TemplateSyntaxError, expected_message=msg): self.engines["django"].from_string( "{% get_current_js_lang_name AS LANG %}{{LANG}}") class HasPermissionTemplateFilterTest(SingleCourseTestMixin, TestCase): def setUp(self): super().setUp() from django.template.utils import EngineHandler self.engines = EngineHandler() def test_has_permission_with_no_arg(self): template = self.engines["django"].from_string( "{% if participation|has_permission:'view_gradebook' %}" "YES{% else %}NO{% endif %}") text = template.render({"participation": self.student_participation}) self.assertEqual(text, "NO") def test_has_permission_with_arg(self): # with spaces in filter value template = self.engines["django"].from_string( "{% if participation|has_permission:'access_files_for , student ' %}" "YES{% else %}NO{% endif %}") text = template.render({"participation": self.student_participation}) self.assertEqual(text, "YES") # with no spaces in filter value template = self.engines["django"].from_string( "{% if participation|has_permission:'access_files_for,student' %}" "YES{% else %}NO{% endif %}") text = template.render({"participation": self.student_participation}) self.assertEqual(text, "YES") def test_has_permission_fail_silently(self): with mock.patch( "course.models.Participation.has_permission") as mock_has_pperm: mock_has_pperm.side_effect = RuntimeError template = self.engines["django"].from_string( "{% if participation|has_permission:'access_files_for,public' %}" "YES{% else %}NO{% endif %}") text = template.render({"participation": self.student_participation}) self.assertEqual(text, "NO") class RelateSiteNameTest(SingleCourseTestMixin, LocmemBackendTestsMixin, TestCase): def setUp(self): super().setUp() def get_translation_count(self, mocked_method, literal): return len( [arg[0] for arg, kwarg in mocked_method.call_args_list if arg[0] == literal]) def verify_result_with_configure(self, my_site_name): # home page with mock.patch(REAL_TRANSLATION_FUNCTION_TO_MOCK) as mock_gettext: mock_gettext.side_effect = real_trans_side_effect resp = self.client.get("/") self.assertEqual(resp.status_code, 200) self.assertContains(resp, f"{my_site_name}", html=True) # Three translations in nav_bar brand, html title and # "Welcome to RELATE", respectively self.assertEqual( self.get_translation_count(mock_gettext, my_site_name), 3) mock_gettext.reset_mock() # course page resp = self.client.get(self.get_course_page_url()) self.assertEqual(resp.status_code, 200) test_site_name_re = re.compile( f".+.+-.+{my_site_name}.+.+", re.DOTALL) self.assertRegex(resp.content.decode(), test_site_name_re) # One translation in html title self.assertEqual( self.get_translation_count(mock_gettext, my_site_name), 1) # email with override_settings(RELATE_REGISTRATION_ENABLED=True, USE_I18N=True): # render() is mocked so as to count string translated in email rendering with \ mock.patch(REAL_TRANSLATION_FUNCTION_TO_MOCK) \ as mock_gettext_global, \ mock.patch("course.auth._") as mock_gettext_auth, \ mock.patch("course.auth.messages"), \ mock.patch("course.auth.render"): mock_gettext_global.return_value = "foo" mock_gettext_auth.return_value = "foo" with self.temporarily_switch_to_user(None): resp = self.post_sign_up( data={"username": "Jack", "email": "jack@example.com"}, follow=False ) self.assertTrue(resp.status_code, 200) self.assertEqual(len(mail.outbox), 1) # In the view, translating RELATE for email title. self.assertEqual( self.get_translation_count( mock_gettext_auth, my_site_name), 1) # Three RELATE in the email template self.assertEqual( self.get_translation_count( mock_gettext_global, my_site_name), 3) @override_settings() def test_default_configure(self): self.verify_result_with_configure("RELATE") @override_settings(RELATE_SITE_NAME="My RELATE") def test_custom_configure(self): self.verify_result_with_configure("My RELATE") class MaintenanceModeTest(SingleCourseTestMixin, TestCase): """test relate.utils.is_maintenance_mode""" def setUp(self): rf = RequestFactory() self.request = rf.get("/") def test_is(self): with override_settings(RELATE_MAINTENANCE_MODE=True): self.assertTrue(is_maintenance_mode(self.request)) self.client.get("/") self.assertTemplateUsed("maintenance.html") def test_exceptions(self): with override_settings( RELATE_MAINTENANCE_MODE=True, RELATE_MAINTENANCE_MODE_EXCEPTIONS=[ "192.168.1.1", "127.0.0.1"]): meta = self.request.META meta["REMOTE_ADDR"] = "192.168.1.1" self.assertFalse(is_maintenance_mode(self.request)) self.client.get("/") self.assertTemplateNotUsed("maintenance.html") class RenderEmailTemplateTest(unittest.TestCase): """test relate.utils.render_email_template, for not covered""" def test_context_is_none(self): with mock.patch( "django.template.loader.render_to_string") as mock_render_to_string: render_email_template("abcd", context=None) self.assertDictEqual(mock_render_to_string.call_args[0][1], {"relate_site_name": "RELATE"}) class GetOutboundMailConnectionTest(unittest.TestCase): """test relate.utils.get_outbound_mail_connection, for not covered""" def test_label_is_none(self): # simply make sure it worked from django.core.mail.backends.base import BaseEmailBackend self.assertIsInstance( get_outbound_mail_connection(None), BaseEmailBackend) # {{{ test relate.utils.format_datetime_local def date_format_side_effect(value, format=None, use_l10n=None): """mock django.utils.formats.date_format""" if format == "foo": raise AttributeError else: return date_format(value, format, use_l10n) def format_side_effectformat(value, format_string): """mock django.utils.dateformat.format""" if format_string == "foo": raise AttributeError else: return format(value, format_string) class FormatDatetimeLocalTest(unittest.TestCase): """test relate.utils.format_datetime_local""" def test_success(self): dtime = datetime.datetime(2019, 1, 1) format_str = "SHORT_DATETIME_FORMAT" self.assertEqual( format_datetime_local(dtime, format=format_str), date_format(dtime, format=format_str)) def test_attribute_error1(self): dtime = datetime.datetime(2019, 1, 1) with mock.patch("django.utils.formats.date_format") as mock_date_format: mock_date_format.side_effect = date_format_side_effect result = format_datetime_local( dtime, format="foo") self.assertEqual( result, date_format(dtime, format="foo")) def test_attribute_error2(self): dtime = datetime.datetime(2019, 1, 1) with mock.patch( "django.utils.formats.date_format" ) as mock_date_format, mock.patch( "django.utils.dateformat.format" ) as mock_format: mock_date_format.side_effect = date_format_side_effect mock_format.side_effect = format_side_effectformat result = format_datetime_local( dtime, format="foo") self.assertEqual( result, date_format(dtime, format=get_format("DATETIME_FORMAT"))) # }}} class GetLocalTestSettingsFileTest(unittest.TestCase): """test manage.get_local_test_settings_file""" def test_use_default_local_settings_example(self): self.assertEqual(get_local_test_settings_file( ["manage.py", "test", "foo"]), "local_settings_example.py") def test_error_use_local_settings(self): """test error when use local_settings.py as test settings""" with self.assertRaises(CommandError) as cm: get_local_test_settings_file( ["manage.py", "test", "--local_test_settings", "local_settings.py"]) self.assertIn( "Using production local_settings for tests is not " "allowed due to security reason.", str(cm.exception)) def test_error_local_test_setting_file_does_not_exist(self): """test error when use local_settings.py as test settings""" invalid_file = "foo/local_test_settings.py" with self.assertRaises(CommandError) as cm: get_local_test_settings_file( ["manage.py", "test", "--local_test_settings", invalid_file]) self.assertIn( f"file '{invalid_file}' does not exist", str(cm.exception)) def test_custom_local_test_setting_file(self): settings_file = "foo/local_test_settings.py" with mock.patch("os.path.isfile") as mock_is_file: mock_is_file.return_value = True self.assertEqual(get_local_test_settings_file( ["manage.py", "test", "foo", "--local_test_settings", settings_file]), settings_file) # vim: foldmethod=marker