做视频的软件模板下载网站,宁乡电商网站建设报价,公司建多个网站,网页游戏梦幻西游文章目录1. 前言2. 搭建测试环境3. 测试模型4. 测试视图5. 测试模板标签6. 测试辅助方法和类1. 前言
我们博客功能越来越来完善了#xff0c;但这也带来了一个问题#xff0c;我们不敢轻易地修改已有功能的代码了#xff01;
我们怎么知道代码修改后带来了预期的效果…
文章目录1. 前言2. 搭建测试环境3. 测试模型4. 测试视图5. 测试模板标签6. 测试辅助方法和类1. 前言
我们博客功能越来越来完善了但这也带来了一个问题我们不敢轻易地修改已有功能的代码了
我们怎么知道代码修改后带来了预期的效果万一改错了不仅新功能没有用原来已有的功能都可能被破坏。此前我们开发一个新的功能都是手工运行开发服务器去验证不仅费时而且极有可能验证不充分。
如何不用每次开发了新的功能或者修改了已有代码都得去人工验证呢解决方案就是编写自动化测试将人工验证的逻辑编写成脚本每次新增或修改代码后运行一遍测试脚本脚本自动帮我们完成全部测试工作。
接下来我们将进行两种类型的测试一种是单元测试一种是集成测试。
单元测试是一种比较底层的测试它将一个功能逻辑的代码块视为一个单元例如一个函数、方法、或者一个 if 语句块等单元应该尽可能小这样测试就会更加充分程序员编写测试代码去测试这个单元确保这个单元的逻辑代码按照预期的方式执行了。通常来说我们一般将一个函数或者方法视为一个单元对其进行测试。
集成测试则是一种更加高层的测试它站在系统角度测试由各个已经经过充分的单元测试的模块组成的系统其功能是否符合预期。
我们首先来进行单元测试确保各个单元的逻辑都没问题后然后进行集成测试测试整个博客系统的可用性。
Python 一般使用标准库 unittest 提供单元测试django 拓展了单元测试提供了一系列类用于不同的测试场合。其中最常用到的就是 django.test.TestCase 类博客应用的单元测试主要就是和这个类打交道。这个类和 Python 标准库的 unittest.TestCase 类似只是拓展了以下功能
1提供了一个 client 属性这个 client 是 Client 的实例。可以把 Client 看做一个发起 HTTP 请求的功能库类似于 requests这样我们可以方便地使用这个类测试视图函数。
2运行测试前自动创建数据库测试运行完毕后自动销毁数据库。我们肯定不希望自动生成的测试数据影响到真实的数据。
django 应用的单元测试包括
1测试 modelmodel 的方法是否返回了预期的数据对数据库的操作是否正确。
2测试表单数据验证逻辑是否符合预期
3测试视图针对特定类型的请求是否返回了预期的响应
4其它的一些辅助方法或者类等
接下来我们就逐一地来测试上述内容。
2. 搭建测试环境
测试写在 tests.py 里应用创建时就会自动创建这个文件首先来个冒烟测试用于验证测试功能是否正常在 blog\tests.py 文件写入如下代码
from django.test import TestCaseclass SmokeTestCase(TestCase):def test_smoke(self):self.assertEqual(1 1, 2)使用 manage.py 的 test 命令将自动发现 django 应用下的 tests 文件或者模块并且自动执行以 test_ 开头的方法。运行
pipenv run python manage.py testOK 表明我们的测试运行成功。
不过如果需要测试的代码比较多把全部测试逻辑一股脑塞入 tests.py这个模块就会变得十分臃肿不利于维护所以我们把 tests.py 文件升级为一个包不同的单元测试写到包下对应的模块中这样便于模块化地维护和管理。
删除 blog\tests.py 文件然后在 blog 应用下创建一个 tests 包再创建各个单元测试模块
test_models.py 存放和模型有关的单元测试 test_views.py 测试视图函数 test_templatetags.py 测试自定义的模板标签 test_utils.py 测试一些辅助方法和类等 注意tests 包中的各个模块必须以 test_ 开头否则 django 无法发现这些测试文件的存在从而不会运行里面的测试用例。
3. 测试模型
模型需要测试的不多因为基本上都是使用了 django 基类 models.Model 的特性自己的逻辑很少。拿最为复杂的 Post 模型举例它包括的逻辑功能主要有
1str 方法返回 title 用于模型实例的字符表示 2save 方法中设置文章创建时间created_time和摘要exerpt) 3) get_absolute_url 返回文章详情视图对应的 url 路径 4) increase_views 将 views 字段的值 1
单元测试就是要测试这些方法执行后的确返回了上面预期的结果我们在 test_models.py 中新增一个类叫做 PostModelTestCase在这个类中编写上述单元测试的用例。
from django.apps import appsclass PostModelTestCase(TestCase):def setUp(self):# 断开 haystack 的 signal测试生成的文章无需生成索引apps.get_app_config(haystack).signal_processor.teardown()user User.objects.create_superuser(usernameadmin, emailadminhellogithub.com, passwordadmin)cate Category.objects.create(name测试)self.post Post.objects.create(title测试标题,body测试内容,categorycate,authoruser,)def test_str_representation(self):self.assertEqual(self.post.__str__(), self.post.title)def test_auto_populate_modified_time(self):self.assertIsNotNone(self.post.modified_time)old_post_modified_time self.post.modified_timeself.post.body 新的测试内容self.post.save()self.post.refresh_from_db()self.assertTrue(self.post.modified_time old_post_modified_time)def test_auto_populate_excerpt(self):self.assertIsNotNone(self.post.excerpt)self.assertTrue(0 len(self.post.excerpt) 54)def test_get_absolute_url(self):expected_url reverse(blog:detail, kwargs{pk: self.post.pk})self.assertEqual(self.post.get_absolute_url(), expected_url)def test_increase_views(self):self.post.increase_views()self.post.refresh_from_db()self.assertEqual(self.post.views, 1)self.post.increase_views()self.post.refresh_from_db()self.assertEqual(self.post.views, 2)这里代码虽然比较多但做的事情很明确。setUp 方法会在每一个测试案例运行前执行这里做的事情是在数据库中创建一篇文章用于测试。 接下来的各个 test_* 方法就是对于各个功能单元的测试以 test_auto_populate_modified_time 为例这里我们要测试文章保存到数据库后modifited_time 被正确设置了值期待的值应该是文章保存时的时间。
self.assertIsNotNone(self.post.modified_time) 断言文章的 modified_time 不为空说明的确设置了值。TestCase 类提供了系列 assert* 方法用于断言测试单元的逻辑结果是否和预期相符一般从方法的命名中就可以读出其功能比如这里 assertIsNotNone 就是断言被测试的变量值不为 None。接着我们尝试通过
self.post.body 新的测试内容
self.post.save()修改文章内容并重新保存数据库。预期的结果应该是文章保存后modifited_time 的值也被更新为修改文章时的时间接下来的代码就是对这个预期结果的断言
self.post.refresh_from_db()
self.assertTrue(self.post.modified_time old_post_modified_time)这个 refresh_from_db 方法将刷新对象 self.post 的值为数据库中的最新值然后我们断言数据库中 modified_time 记录的最新时间比原来的时间晚如果断言通过说明我们更新文章后modified_time 的值也进行了相应更新来记录修改时间结果符合预期测试通过。
其它的测试方法都是做着类似的事情这里不再一一讲解请自行看代码分析。
4. 测试视图
视图函数测试的基本思路是向某个视图对应的 URL 发起请求视图函数被调用并返回预期的响应包括正确的 HTTP 响应码和 HTML 内容。
我们的博客应用包括以下类型的视图需要进行测试
1首页视图 IndexView访问它将返回全部文章列表。 2标签视图访问它将返回某个标签下的文章列表。如果访问的标签不存在返回 404 响应。 3分类视图访问它将返回某个分类下的文章列表。如果访问的分类不存在返回 404 响应。 4归档视图访问它将返回某个月份下的全部文章列表。 5详情视图访问它将返回某篇文章的详情如果访问的文章不存在返回 404。 5自定义的 admin添加文章后自动填充 author 字段的值。 6RSS返回全部文章的 RSS 内容。
首页视图、标签视图、分类视图、归档视图都是同一类型的视图他们预期的行为应该是
1返回正确的响应码成功返回200不存在则返回404。 2) 没有文章时正确地提示暂无文章。 3) 渲染了正确的 html 模板。 4) 包含关键的模板变量例如文章列表分页变量等。
我们首先来测试这几个视图。为了给测试用例生成合适的数据我们首先定义一个基类预先定义好博客的数据内容其它视图函数测试用例继承这个基类就不需要每次测试时都创建数据了。我们创建的测试数据如下
分类一、分类二标签一、标签二文章一属于分类一和标签一文章二属于分类二没有标签
class BlogDataTestCase(TestCase):def setUp(self):apps.get_app_config(haystack).signal_processor.teardown()# Userself.user User.objects.create_superuser(usernameadmin,emailadminhellogithub.com,passwordadmin)# 分类self.cate1 Category.objects.create(name测试分类一)self.cate2 Category.objects.create(name测试分类二)# 标签self.tag1 Tag.objects.create(name测试标签一)self.tag2 Tag.objects.create(name测试标签二)# 文章self.post1 Post.objects.create(title测试标题一,body测试内容一,categoryself.cate1,authorself.user,)self.post1.tags.add(self.tag1)self.post1.save()self.post2 Post.objects.create(title测试标题二,body测试内容二,categoryself.cate2,authorself.user,created_timetimezone.now() - timedelta(days100))以 CategoryViewTestCase 为例
class CategoryViewTestCase(BlogDataTestCase):def setUp(self):super().setUp()self.url reverse(blog:category, kwargs{pk: self.cate1.pk})self.url2 reverse(blog:category, kwargs{pk: self.cate2.pk})def test_visit_a_nonexistent_category(self):url reverse(blog:category, kwargs{pk: 100})response self.client.get(url)self.assertEqual(response.status_code, 404)def test_without_any_post(self):Post.objects.all().delete()response self.client.get(self.url2)self.assertEqual(response.status_code, 200)self.assertTemplateUsed(blog/index.html)self.assertContains(response, 暂时还没有发布的文章)def test_with_posts(self):response self.client.get(self.url)self.assertEqual(response.status_code, 200)self.assertTemplateUsed(blog/index.html)self.assertContains(response, self.post1.title)self.assertIn(post_list, response.context)self.assertIn(is_paginated, response.context)self.assertIn(page_obj, response.context)self.assertEqual(response.context[post_list].count(), 1)expected_qs self.cate1.post_set.all().order_by(-created_time)self.assertQuerysetEqual(response.context[post_list], [repr(p) for p in expected_qs])这个类首先继承自 BlogDataTestCasesetUp 方法别忘了调用父类的 stepUp 方法以便在每个测试案例运行时设置好博客测试数据。
然后就是进行了3个案例测试 访问一个不存在的分类预期返回 404 响应码。 没有文章的分类返回200但提示暂时还没有发布的文章渲染的模板为 index.html 访问的分类有文章则响应中应该包含系列关键的模板变量post_list、is_paginated、page_objpost_list 文章数量为1因为我们的测试数据中这个分类下只有一篇文章post_list 是一个 queryset预期是该分类下的全部文章时间倒序排序。
其它的 TagViewTestCase 等测试类似请自行参照代码分析。
博客文章详情视图的逻辑更加复杂一点所以测试用例也更多主要需要测试的点有
访问不存在文章返回404。文章每被访问一次访问量 views 加一。文章内容被 markdown 渲染并生成了目录。
测试代码如下
class PostDetailViewTestCase(BlogDataTestCase):def setUp(self):super().setUp()self.md_post Post.objects.create(titleMarkdown 测试标题,body# 标题,categoryself.cate1,authorself.user,)self.url reverse(blog:detail, kwargs{pk: self.md_post.pk})def test_good_view(self):response self.client.get(self.url)self.assertEqual(response.status_code, 200)self.assertTemplateUsed(blog/detail.html)self.assertContains(response, self.md_post.title)self.assertIn(post, response.context)def test_visit_a_nonexistent_post(self):url reverse(blog:detail, kwargs{pk: 100})response self.client.get(url)self.assertEqual(response.status_code, 404)def test_increase_views(self):self.client.get(self.url)self.md_post.refresh_from_db()self.assertEqual(self.md_post.views, 1)self.client.get(self.url)self.md_post.refresh_from_db()self.assertEqual(self.md_post.views, 2)def test_markdownify_post_body_and_set_toc(self):response self.client.get(self.url)self.assertContains(response, 文章目录)self.assertContains(response, self.md_post.title)post_template_var response.context[post]self.assertHTMLEqual(post_template_var.body_html, h1 id标题标题/h1)self.assertHTMLEqual(post_template_var.toc, lia href#标题标题/li)
接下来是测试 admin 添加文章和 rss 订阅内容这一块比较简单因为大部分都是 django 的逻辑django 已经为我们进行了测试我们需要测试的只是自定义的部分确保自定义的逻辑按照预期的定义运行并且得到了预期的结果。
对于 admin预期的结果就是发布文章后的确自动填充了 author
class AdminTestCase(BlogDataTestCase):def setUp(self):super().setUp()self.url reverse(admin:blog_post_add)def test_set_author_after_publishing_the_post(self):data {title: 测试标题,body: 测试内容,category: self.cate1.pk,}self.client.login(usernameself.user.username, passwordadmin)response self.client.post(self.url, datadata)self.assertEqual(response.status_code, 302)post Post.objects.all().latest(created_time)self.assertEqual(post.author, self.user)self.assertEqual(post.title, data.get(title))self.assertEqual(post.category, self.cate1)reverse(‘admin:blog_post_add’) 获取 admin 管理添加博客文章的 URLdjango admin 添加文章的视图函数名admin:blog_post_add一般 admin 后台操作模型的视图函数命名规则是 app_label_model_name _action。self.client.login(usernameself.user.username, password‘admin’) 登录用户相当于后台登录管理员账户。self.client.post(self.url, datadata) 向添加文章的 url 发起 post 请求post 的数据为需要发布的文章内容只指定了 titlebody和分类。
接着我们进行一系列断言确认是否正确创建了文章。
RSS 测试也类似我们期待的是它返回的内容中的确包含了全部文章的内容
class RSSTestCase(BlogDataTestCase):def setUp(self):super().setUp()self.url reverse(rss)def test_rss_subscription_content(self):response self.client.get(self.url)self.assertContains(response, AllPostsRssFeed.title)self.assertContains(response, AllPostsRssFeed.description)self.assertContains(response, self.post1.title)self.assertContains(response, self.post2.title)self.assertContains(response, [%s] %s % (self.post1.category, self.post1.title))self.assertContains(response, [%s] %s % (self.post2.category, self.post2.title))self.assertContains(response, self.post1.body)self.assertContains(response, self.post2.body)
5. 测试模板标签
全部模板引擎的测试套路都是一样构造需要的上下文构造模板使用上下文渲染模板断言渲染的模板内容符合预期。以为例
def test_show_recent_posts_with_posts(self):post Post.objects.create(title测试标题,body测试内容,categoryself.cate,authorself.user,)context Context(show_recent_posts(self.ctx))template Template({% load blog_extras %}{% show_recent_posts %})expected_html template.render(context)self.assertInHTML(h3 classwidget-title最新文章/h3, expected_html)self.assertInHTML(a href{}{}/a.format(post.get_absolute_url(), post.title), expected_html)
这个模板标签对应侧边栏的最新文章版块。我们进行了2处关键性的内容断言。一个是包含最新文章版块标题一个是内容中含有文章标题的超链接。
这里测试的核心内容是模板中 {% templatetag %} 被渲染成了正确的 HTML 内容。你可以看到测试代码中对应的代码
context Context(show_recent_posts(self.ctx))
template Template({% load blog_extras %}{% show_recent_posts %}
)
expected_html template.render(context)
注意模板标签本质上是一个 Python 函数第一句代码中我们直接调用了这个函数由于它需要接受一个 Context 类型的标量因此我们构造了一个空的 context 给它调用它将返回需要的上下文变量然后我们构造了一个需要的上下文变量。
接着我们构造了一个模板对象。
最后我们使用构造的上下文去渲染了这个模板。
我们调用了模板引擎的底层 API 来渲染模板视图函数会渲染模板返回响应但是我们没有看到这个过程是因为 django 帮我们在背后的调用了这个过程。
6. 测试辅助方法和类
我们的博客中只自定义了关键词高亮的一个逻辑。
class HighlighterTestCase(TestCase):def test_highlight(self):document 这是一个比较长的标题用于测试关键词高亮但不被截断。highlighter Highlighter(标题)expected 这是一个比较长的span classhighlighted标题/span用于测试关键词高亮但不被截断。self.assertEqual(highlighter.highlight(document), expected)highlighter Highlighter(关键词高亮)expected 这是一个比较长的标题用于测试span classhighlighted关键词高亮/span但不被截断。self.assertEqual(highlighter.highlight(document), expected)这里 Highlighter 实例化时接收搜索关键词作为参数然后 highlight 将搜索结果中关键词包裹上 span 标签。
Highlighter 事实上 haystack 为我们提供的类我们只是定义了 highlight 方法的逻辑。我们又是如何知道 highlight 方法的逻辑呢如何进行测试呢
我是看源码大致了解了 Highlighter 类的实现逻辑然后我从 haystack 的测试用例中找到了 highlight 的测试方法。
所以有时候不要惧怕去看源代码Python 世界里一切都是开源的源代码也没有什么神秘的地方都是人写的别人能写出来你学习后也一样能写出来。单元测试的代码一般比较冗长重复但目的也十分明确而且大都以顺序逻辑组织代码自成文档非常好读。
单纯看文章中的讲解你可能仍有迷惑但是好好读一遍示例项目中测试部分的源代码你一定会对单元测试有一个更加清晰的认识然后依葫芦画瓢写出对自己项目代码的单元测试。
