注释

src/djangoblog-master/accounts/tests.py

@@ -11,10 +11,13 @@ from . import utils
 
 # Create your tests here.
 
+# xm: 账户功能测试类，继承自Django的TestCase
 class AccountTest(TestCase):
+    # xm: 测试初始化方法，每个测试方法执行前都会运行
     def setUp(self):
         self.client = Client()
         self.factory = RequestFactory()
+        # xm: 创建测试用户
         self.blog_user = BlogUser.objects.create_user(
             username="test",
             email="admin@admin.com",
@@ -22,27 +25,33 @@ class AccountTest(TestCase):
         )
         self.new_test = "xxx123--="
 
+    # xm: 测试账户验证功能
     def test_validate_account(self):
         site = get_current_site().domain
+        # xm: 创建超级用户
         user = BlogUser.objects.create_superuser(
             email="liangliangyy1@gmail.com",
             username="liangliangyy1",
             password="qwer!@#$ggg")
         testuser = BlogUser.objects.get(username='liangliangyy1')
 
+        # xm: 测试用户登录功能
         loginresult = self.client.login(
             username='liangliangyy1',
             password='qwer!@#$ggg')
         self.assertEqual(loginresult, True)
+        # xm: 测试管理员页面访问权限
         response = self.client.get('/admin/')
         self.assertEqual(response.status_code, 200)
 
+        # xm: 创建测试分类
         category = Category()
         category.name = "categoryaaa"
         category.creation_time = timezone.now()
         category.last_modify_time = timezone.now()
         category.save()
 
+        # xm: 创建测试文章
         article = Article()
         article.title = "nicetitleaaa"
         article.body = "nicecontentaaa"
@@ -52,44 +61,53 @@ class AccountTest(TestCase):
         article.status = 'p'
         article.save()
 
+        # xm: 测试文章管理页面访问权限
         response = self.client.get(article.get_admin_url())
         self.assertEqual(response.status_code, 200)
 
+    # xm: 测试用户注册功能
     def test_validate_register(self):
         self.assertEquals(
             0, len(
                 BlogUser.objects.filter(
                     email='user123@user.com')))
+        # xm: 模拟用户注册请求
         response = self.client.post(reverse('account:register'), {
             'username': 'user1233',
             'email': 'user123@user.com',
             'password1': 'password123!q@wE#R$T',
             'password2': 'password123!q@wE#R$T',
         })
+        # xm: 验证用户是否创建成功
         self.assertEquals(
             1, len(
                 BlogUser.objects.filter(
                     email='user123@user.com')))
         user = BlogUser.objects.filter(email='user123@user.com')[0]
+        # xm: 生成验证签名
         sign = get_sha256(get_sha256(settings.SECRET_KEY + str(user.id)))
         path = reverse('accounts:result')
         url = '{path}?type=validation&id={id}&sign={sign}'.format(
             path=path, id=user.id, sign=sign)
+        # xm: 测试验证页面访问
         response = self.client.get(url)
         self.assertEqual(response.status_code, 200)
 
+        # xm: 测试用户登录功能
         self.client.login(username='user1233', password='password123!q@wE#R$T')
         user = BlogUser.objects.filter(email='user123@user.com')[0]
         user.is_superuser = True
         user.is_staff = True
         user.save()
         delete_sidebar_cache()
+        # xm: 创建测试分类
         category = Category()
         category.name = "categoryaaa"
         category.creation_time = timezone.now()
         category.last_modify_time = timezone.now()
         category.save()
 
+        # xm: 创建测试文章
         article = Article()
         article.category = category
         article.title = "nicetitle333"
@@ -100,36 +118,45 @@ class AccountTest(TestCase):
         article.status = 'p'
         article.save()
 
+        # xm: 测试文章管理页面访问权限
         response = self.client.get(article.get_admin_url())
         self.assertEqual(response.status_code, 200)
 
+        # xm: 测试用户登出功能
         response = self.client.get(reverse('account:logout'))
         self.assertIn(response.status_code, [301, 302, 200])
 
+        # xm: 测试登出后访问文章管理页面的重定向
         response = self.client.get(article.get_admin_url())
         self.assertIn(response.status_code, [301, 302, 200])
 
+        # xm: 测试错误密码登录
         response = self.client.post(reverse('account:login'), {
             'username': 'user1233',
             'password': 'password123'
         })
         self.assertIn(response.status_code, [301, 302, 200])
 
+        # xm: 测试登录后访问文章管理页面
         response = self.client.get(article.get_admin_url())
         self.assertIn(response.status_code, [301, 302, 200])
 
+    # xm: 测试邮箱验证码功能
     def test_verify_email_code(self):
         to_email = "admin@admin.com"
         code = generate_code()
         utils.set_code(to_email, code)
         utils.send_verify_email(to_email, code)
 
+        # xm: 测试验证码验证成功情况
         err = utils.verify("admin@admin.com", code)
         self.assertEqual(err, None)
 
+        # xm: 测试验证码验证失败情况
         err = utils.verify("admin@123.com", code)
         self.assertEqual(type(err), str)
 
+    # xm: 测试忘记密码验证码发送成功情况
     def test_forget_password_email_code_success(self):
         resp = self.client.post(
             path=reverse("account:forget_password_code"),
@@ -139,6 +166,7 @@ class AccountTest(TestCase):
         self.assertEqual(resp.status_code, 200)
         self.assertEqual(resp.content.decode("utf-8"), "ok")
 
+    # xm: 测试忘记密码验证码发送失败情况
     def test_forget_password_email_code_fail(self):
         resp = self.client.post(
             path=reverse("account:forget_password_code"),
@@ -152,6 +180,7 @@ class AccountTest(TestCase):
         )
         self.assertEqual(resp.content.decode("utf-8"), "错误的邮箱")
 
+    # xm: 测试忘记密码重置成功情况
     def test_forget_password_email_success(self):
         code = generate_code()
         utils.set_code(self.blog_user.email, code)
@@ -167,13 +196,14 @@ class AccountTest(TestCase):
         )
         self.assertEqual(resp.status_code, 302)
 
-        # 验证用户密码是否修改成功
+        # xm: 验证用户密码是否修改成功
         blog_user = BlogUser.objects.filter(
             email=self.blog_user.email,
         ).first()  # type: BlogUser
         self.assertNotEqual(blog_user, None)
         self.assertEqual(blog_user.check_password(data["new_password1"]), True)
 
+    # xm: 测试不存在的用户忘记密码情况
     def test_forget_password_email_not_user(self):
         data = dict(
             new_password1=self.new_test,
@@ -188,7 +218,7 @@ class AccountTest(TestCase):
 
         self.assertEqual(resp.status_code, 200)
 
-
+    # xm: 测试验证码错误的忘记密码情况
     def test_forget_password_email_code_error(self):
         code = generate_code()
         utils.set_code(self.blog_user.email, code)