使用django构建表单测试

本文涉及的产品
云原生网关 MSE Higress,422元/月
服务治理 MSE Sentinel/OpenSergo,Agent数量 不受限
Serverless 应用引擎免费试用套餐包,4320000 CU,有效期3个月
简介: 【6月更文挑战第14天】该文档介绍了如何对本地库进行自动化测试,特别是关注于代码结构和模型测试。作者鼓励为其他模型和表单创建类似的测试,并提及测试应避免对底层框架的重复验证。

1 本地库的测试

**一个完整的测试过程,应该包括测试方法、测试工具、测试范围、测试种类、测试的软件硬件环境、测试进度、测试人员的分工和职责以及测试流程进行详细的定义和整体的描述。

包括测试资源,工具,环境,风险评估,缺陷跟踪方式的说明。**

mandala曼德罗符号.png

但是这里只表达自动化测试代码的结构。表单测试可覆盖模型的各个部分,包括字段标签和长度等。

本文提供了一个Owner模型的测试示例,展示了如何创建测试用例,如测试字段标签和方法。表单测试遵循相似理念,确保字段、标签和帮助文本正确,同时验证输入的有效性。

我们已经知道了如何运行我们的测试以及我们需要测试什么样的东西,如果不清楚请查看文末的参考链接,
让我们看一些实际的例子。

这应该可以让您了解测试的工作原理,以及您还能做什么。

2 模型

如上所述,我们应该测试任何属于我们设计的一部分或由我们编写的代码定义的内容,而不是已经由 Django 或 Python 开发团队测试过的库/代码。

例如,考虑下面的模型。在这里,我们应该测试所有字段的标签,因为即使我们没有明确指定其中的大多数,我们有一个设计来说明这些值应该是什么。

如果我们不测试这些值,那么我们就不知道字段标签是否具有其预期值。
同样,虽然我们相信 Django会创建一个指定长度的字段Author,但值得为此长度指定一个测试以确保它按计划实现。

 class Owner(models.Model):
            first_name = models.CharField(max_length=100)
            last_name = models.CharField(max_length=100)
            date_of_birth = models.DateField(null=True, blank=True)
            date_of_death = models.DateField('Died', null=True, blank=True)

            def get_absolute_url(self):
                return reverse('author-detail', args=[str(self.id)])

            def __str__(self):
                return f'{self.last_name}, {self.first_name}'

打开我们的 /blog/tests/test_models.py,并将任何现有代码替换为模型的以下Owner测试代码。

在这里,您将看到我们首先使用描述性名称从中导入TestCase并派生我们的测试类 (AuthorModel),以便我们可以轻松识别测试输出中的任何失败测试。

然后,我们调用setUpTestData()创建一个作者对象,我们将在任何测试中使用但不会修改该对象。

    from django.test import TestCase

    from blog.models import Author

    class OwnerModelTest(TestCase):
        @classmethod
        def setUpTestData(cls):
            # Set up non-modified objects used by all test methods
            Author.objects.create(first_name='Big', last_name='Bob')

        def test_first_name_label(self):
            author = Owner.objects.get(id=1)
            field_label = author._meta.get_field('first_name').verbose_name
            self.assertEqual(field_label, 'first name')

        def test_date_of_death_label(self):
            author = Owner.objects.get(id=1)
            field_label = author._meta.get_field('date_of_death').verbose_name
            self.assertEqual(field_label, 'died')

        def test_first_name_max_length(self):
            author = Owner.objects.get(id=1)
            max_length = author._meta.get_field('first_name').max_length
            self.assertEqual(max_length, 100)

        def test_object_name_is_last_name_comma_first_name(self):
            author = Owner.objects.get(id=1)
            expected_object_name = f'{author.last_name}, {author.first_name}'
            self.assertEqual(str(author), expected_object_name)

        def test_get_absolute_url(self):
            author = Owner.objects.get(id=1)
            # This will also fail if the urlconf is not defined.
            self.assertEqual(author.get_absolute_url(), '/blog/author/1')

字段测试检查字段标签 (verbose_name) 的值以及字符字段的大小是否符合预期。这些方法都有描述性名称,并遵循相同的模式:

获取一个测试对象

    author = Owner.objects.get(id=1)

获取必填字段的元数据并使用它来查询必填字段数据

    field_label = author._meta.get_field('first_name').verbose_name

将值与预期结果进行比较

      self.assertEqual(field_label, 'first name')

需要注意的有趣事情是:

我们不能直接使用 author.first_name.verbose_name ,因为是一个字符串verbose_name(不是我们可以用来访问其属性的对象的句柄)。

相反,我们需要使用作者的属性来获取字段的实例,并使用它来查询其他信息。

    author.first_name
    first_name_meta

我们选择使用 .而不是这样做的原因是,如果测试失败,前者的输出会告诉您标签的实际内容,这使得调试问题变得更加容易。

    assertEqual(field_label,'first name')
    assertTrue(field_label == 'first name')

省略了对last_name 和 date_of_birth标签的测试以及对字段长度的测试。
按照上面显示的命名约定和方法,立即添加last_name到您自己的测试集。

我们还需要测试我们的自定义方法。

这些本质上只是检查对象名称是否按照我们的预期使用“姓氏”、“名字”格式构造,以及我们获得的Author项目的 URL 是否符合我们的预期。

    def test_object_name_is_last_name_comma_first_name(self):
        author = Author.objects.get(id=1)
        expected_object_name = f'{author.last_name}, {author.first_name}'
        self.assertEqual(str(author), expected_object_name)

如果urlconf没有被提前定义,这个用例将会失败。

    def test_get_absolute_url(self):
        author = Author.objects.get(id=1)
        # 测试点
        self.assertEqual(author.get_absolute_url(), '/blog/author/1')

立即运行测试。

如果按照模型教程中所述创建了作者模型,则很可能会收到如下所示的date_of_death标签错误。

测试失败了,因为它是期望标签定义遵循 Django的约定,即不大写标签的第一个字母(Django 为你这样做)。

        ======================================================================
    FAIL: test_date_of_death_label (blog.tests.test_models.AuthorModelTest)
    ----------------------------------------------------------------------
    Traceback (most recent call last):
      File "D:\...\blog\tests\test_models.py", line 32, in test_date_of_death_label
        self.assertEqual(field_label,'died')
    AssertionError: 'Died' != 'died'
    - Died
    ? ^
    + died
    ? ^

这是一个非常小的错误,但它确实强调了编写测试如何更彻底地检查您可能所做的任何假设。

将字段 (/blog/models.py) 的date_of_death标签更改为“Died”,然后重新运行测试。

测试其他模型的模式类似,因此我们不会继续进一步讨论这些模式。请随意为我们的其他模型创建自己的测试。

3 表单测试

测试表单的理念与测试模型的理念相同;
您需要测试已编码或设计指定的任何内容,但不需要测试底层框架和其他第三方库的行为。

通常,这意味着您应该测试表单是否具有所需的字段,并且这些字段是否以适当的标签和帮助文本显示。

你不需要验证 Django 是否正确验证了字段类型(除非你创建了自己的自定义字段和验证)——也就是说,你不需要测试电子邮件字段是否只接受电子邮件。

但是,您需要测试您希望对字段执行的任何其他验证以及代码将针对错误生成的任何消息。

考虑我们更新书籍的形式。这只有一个用于续订日期的字段,该字段将具有我们需要验证的标签和帮助文本。

图书管理员更新书籍的表格。检查日期是否不是过去的日期。

    class RenewBookForm(forms.Form):

        renewal_date = forms.DateField(help_text="Enter a date between now and 4 weeks (default 3).")

        def clean_renewal_date(self):
            data = self.cleaned_data['renewal_date']

检查日期是否不是过去的日期。

            if data < datetime.date.today():
                raise ValidationError(_('Invalid date - renewal in past'))

检查日期是否在允许的范围内(+从今天起 4 周).

            if data > datetime.date.today() + datetime.timedelta(weeks=4):
                raise ValidationError(_('Invalid date - renewal more than 4 weeks ahead'))

请记住始终返回清理后的数据。

            return data

打开我们的 /blog/tests/test_forms.py 文件,并将任何现有代码替换为表单的以下测试代码。

我们首先导入我们的表单以及一些 Python 和 Django 库来帮助测试与时间相关的功能。

然后,我们以与模型相同的方式声明表单测试类RenewBookForm,为派生的测试类使用描述性名称。

    import datetime

    from django.test import TestCase
    from django.utils import timezone

    from blog.forms import RenewBookForm

    class RenewBookFormTest(TestCase):
        def test_renew_form_date_field_label(self):
            form = RenewBookForm()
            self.assertTrue(form.fields['renewal_date'].label is None or form.fields['renewal_date'].label == 'renewal date')

        def test_renew_form_date_field_help_text(self):
            form = RenewBookForm()
            self.assertEqual(form.fields['renewal_date'].help_text, 'Enter a date between now and 4 weeks (default 3).')

        def test_renew_form_date_in_past(self):
            date = datetime.date.today() - datetime.timedelta(days=1)
            form = RenewBookForm(data={'renewal_date': date})
            self.assertFalse(form.is_valid())

        def test_renew_form_date_too_far_in_future(self):
            date = datetime.date.today() + datetime.timedelta(weeks=4) + datetime.timedelta(days=1)
            form = RenewBookForm(data={'renewal_date': date})
            self.assertFalse(form.is_valid())

        def test_renew_form_date_today(self):
            date = datetime.date.today()
            form = RenewBookForm(data={'renewal_date': date})
            self.assertTrue(form.is_valid())

        def test_renew_form_date_max(self):
            date = timezone.localtime() + datetime.timedelta(weeks=4)
            form = RenewBookForm(data={'renewal_date': date})
            self.assertTrue(form.is_valid())

前两个函数测试字段是否与预期一致。
我们必须使用字段字典访问字段(例如label)。

请注意,我们还必须测试标签值help_text 是否为form.fields['renewal_date'],
因为即使 Django 会渲染正确的标签,如果没有显式设置值,它也会返回 None

其余函数测试表单是否对可接受范围内的续订日期有效,而对范围之外的值无效。

请注意我们如何围绕当前日期 (datetime.date.today()) 构建测试日期值(在本例中指定天数或周数)。
然后,我们只需创建表单,传入我们的数据,并测试它是否有效。datetime.timedelta()

4 小结

在这里,我们实际上并不使用数据库或测试客户端。请考虑修改SimpleTestCase这些测试以使用 。

如果表单无效,我们还需要验证是否引发正确的错误,但这通常是作为视图处理的一部分完成的,因此我们将在下一节中处理这个问题。

如果ModelForm 使用 RenewBookForm(forms.Form)类而不是RenewBookModelForm(forms.ModelForm)类,
则表单字段名称将为“due_back”而不是“renewal_date”。

这就是表格的全部内容;我们确实有一些其他的,但它们是由我们通用的基于类的编辑视图自动创建的,应该在那里进行测试!运行测试并确认我们的代码仍然通过!

如果有兴趣可以参考 测试模块的结构说明

    https://juejin.cn/post/7243060470863953976
目录
相关文章
|
16天前
|
人工智能 自然语言处理 JavaScript
Playwright MCP在UI回归测试中的实战:构建AI自主测试智能体
Playwright MCP结合AI智能体,革新UI回归测试:通过自然语言驱动浏览器操作,降低脚本编写门槛,提升测试效率与覆盖范围。借助快照解析、智能定位与Jira等工具集成,实现从需求描述到自动化执行的闭环,推动测试迈向智能化、民主化新阶段。
|
5月前
|
边缘计算 安全 5G
高精度时钟同步测试仪:构建全场景时间同步生态
在数字化转型中,时间同步至关重要。西安同步电子科技的 SYN5106 高精度时钟测试仪,具备±20ns 时差测量精度与 GPS/北斗双模授时能力,广泛应用于电力、通信、金融和科研领域。它解决变电站时间偏差、5G 基站同步误差及高频交易延迟等问题,助力智能电网、5G 网络和科研实验。产品便携可靠,支持多协议,满足国家安全要求,为各行业提供精准时间同步解决方案。未来将探索量子通信与深空探测等领域,持续推动技术创新。
|
2月前
|
存储 人工智能 文字识别
从零开始打造AI测试平台:文档解析与知识库构建详解
AI时代构建高效测试平台面临新挑战。本文聚焦AI问答系统知识库建设,重点解析文档解析关键环节,为测试工程师提供实用技术指导和测试方法论
|
11月前
|
监控 jenkins 测试技术
自动化测试框架的构建与实践
【10月更文挑战第40天】在软件开发周期中,测试环节扮演着至关重要的角色。本文将引导你了解如何构建一个高效的自动化测试框架,并深入探讨其设计原则、实现方法及维护策略。通过实际代码示例和清晰的步骤说明,我们将一起探索如何确保软件质量,同时提升开发效率。
244 1
|
11月前
|
测试技术 开发者 Python
自动化测试之美:从零构建你的软件质量防线
【10月更文挑战第34天】在数字化时代的浪潮中,软件成为我们生活和工作不可或缺的一部分。然而,随着软件复杂性的增加,如何保证其质量和稳定性成为开发者面临的一大挑战。自动化测试,作为现代软件开发过程中的关键实践,不仅提高了测试效率,还确保了软件产品的质量。本文将深入浅出地介绍自动化测试的概念、重要性以及实施步骤,带领读者从零基础开始,一步步构建起属于自己的软件质量防线。通过具体实例,我们将探索如何有效地设计和执行自动化测试脚本,最终实现软件开发流程的优化和产品质量的提升。无论你是软件开发新手,还是希望提高项目质量的资深开发者,这篇文章都将为你提供宝贵的指导和启示。
|
9月前
|
分布式计算 Shell MaxCompute
odps测试表及大量数据构建测试
odps测试表及大量数据构建测试
|
7月前
|
机器学习/深度学习 设计模式 测试技术
Python 高级编程与实战:构建自动化测试框架
本文深入探讨了Python中的自动化测试框架,包括unittest、pytest和nose2,并通过实战项目帮助读者掌握这些技术。文中详细介绍了各框架的基本用法和示例代码,助力开发者快速验证代码正确性,减少手动测试工作量。学习资源推荐包括Python官方文档及Real Python等网站。
|
11月前
|
敏捷开发 监控 测试技术
探索自动化测试框架的构建与优化####
在软件开发周期中,自动化测试扮演着至关重要的角色。本文旨在深入探讨如何构建高效的自动化测试框架,并分享一系列实用策略以提升测试效率和质量。我们将从框架选型、结构设计、工具集成、持续集成/持续部署(CI/CD)、以及最佳实践等多个维度进行阐述,为软件测试人员提供一套系统化的实施指南。 ####
|
11月前
|
jenkins 测试技术 持续交付
自动化测试框架的构建与优化:提升软件交付效率的关键####
本文深入探讨了自动化测试框架的核心价值,通过对比传统手工测试方法的局限性,揭示了自动化测试在现代软件开发生命周期中的重要性。不同于常规摘要仅概述内容,本部分强调了自动化测试如何显著提高测试覆盖率、缩短测试周期、降低人力成本,并促进持续集成/持续部署(CI/CD)流程的实施,最终实现软件质量和开发效率的双重飞跃。通过具体案例分析,展示了从零开始构建自动化测试框架的策略与最佳实践,包括选择合适的工具、设计高效的测试用例结构、以及如何进行性能调优等关键步骤。此外,还讨论了在实施过程中可能遇到的挑战及应对策略,为读者提供了一套可操作的优化指南。 ####
|
11月前
|
监控 安全 测试技术
构建高效的精准测试平台:设计与实现指南
在软件开发过程中,精准测试是确保产品质量和性能的关键环节。一个精准的测试平台能够自动化测试流程,提高测试效率,缩短测试周期,并提供准确的测试结果。本文将分享如何设计和实现一个精准测试平台,从需求分析到技术选型,再到具体的实现步骤。
469 1