使用 Django 進行測試驅動開發(fā)

更新時間：2021年11月30日 09:28:44 作者：somenzz

本文分享了什么是測試驅動開發(fā)，并用測試驅動開發(fā)的方式創(chuàng)建了一個簡單的 Django 應用程序，感興趣的可以了解一下

TDD 可以被認為是根據(jù)測試用例來說明需求。此后編寫源代碼，重點是滿足這些要求。當測試最終通過時，你可以確信已滿足要求。這種專注可以幫助開發(fā)人員避免范圍蔓延。
TDD 可以通過較短的開發(fā)周期提高開發(fā)效率。一次解決測試用例中的個別需求可以最大限度地減少干擾因素。重大更改將更容易跟蹤和解決，減少了調試工作，提高了效率，并且將更多時間花在開發(fā)上。
編寫測試時考慮到了需求。正因為如此，它們更有可能被寫成明確的，可以理解的。這樣的測試可以作為代碼庫的優(yōu)質文檔。
先編寫測試用例可確保您的源代碼始終具有可測試性，它還保證隨著代碼庫的增長，測試覆蓋率始終保持在合理的百分比。

然而，測試驅動開發(fā)也不是銀彈，以下情形并不適合測試驅動開發(fā)：

當需求不明確時，有時續(xù)期會隨著開發(fā)的進行而逐漸明確，在這種情況下最初編寫的任何測試可能會過時。
開發(fā)的目的是為了證明某一概念時——例如在黑客馬拉松期間，測試通常不是優(yōu)先事項。

了解了測試驅動開發(fā)之后，我們用 Django 來演示一下測試驅動開發(fā)的過程。（Python 3.7 以上，Django 2.0 以上）

首先描述需求，我們要實現(xiàn)這樣一個單位換算功能的 Web 應用，可以在厘米、米、英里直接互相轉換，Web 界面如圖所示：

創(chuàng)建項目

首先，我們創(chuàng)建一個名字叫 convert 的項目：

pip install django
django-admin startproject converter

此時 Django 已經(jīng)為我們生成了 converter 目錄及基本的項目文件：

converter/
    converter/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    manage.py

然后，進入 converter 目錄，創(chuàng)建一個名字叫 length 的 app：

cd converter
python manage.py startapp length

然后你會看到這樣的目錄結構：

converter/
    converter/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    length/
        __init__.py
        admin.py
        apps.py
        migrations/
            __init__.py
        models.py
        tests.py
        views.py
    manage.py

配置 app

修改 converter/settings.py，在 INSTALLED_APPS 里加入 lengh ：

INSTALLED_APPS = [
    .
    .
    .
    'length',
]

然后在 length 目錄下新建 urls.py，寫入以下內容：

from django.urls import path

from length import views

app_name = 'length'
urlpatterns = [
    path('convert/', views.convert, name='convert'),
]

最后在 converter/urls.py 中指向 length/urls.py:

from django.contrib import admin
from django.urls import path, include
urlpatterns = [
    path('admin/', admin.site.urls),
    path('length/', include('length.urls')),
]

這樣一個沒有任何業(yè)務邏輯的項目就創(chuàng)建成功了，接下來編寫測試用例：

編寫測試用例

在 lengh 目錄下新建 tests.py，寫入以下內容：

from django.test import TestCase, Client
from django.urls import reverse


class TestLengthConversion(TestCase):
    """
    This class contains tests that convert measurements from one
    unit of measurement to another.
    """

    def setUp(self):
        """
        This method runs before the execution of each test case.
        """
        self.client = Client()
        self.url = reverse("length:convert")

    def test_centimetre_to_metre_conversion(self):
        """
        Tests conversion of centimetre measurements to metre.
        """
        data = {
            "input_unit": "centimetre",
            "output_unit": "metre",
            "input_value": 8096.894
        }
        response = self.client.get(self.url, data)
        self.assertContains(response, 80.96894)

    def test_centimetre_to_mile_conversion(self):
        data = {
            "input_unit": "centimetre",
            "output_unit": "mile",
            "input_value": round(985805791.3527409, 3)
        }
        response = self.client.get(self.url, data)
        self.assertContains(response, 6125.5113)

上述代碼有兩個測試用例，分別代表兩個需求。test_centimetre_to_metre_conversion 代表厘米轉米的需求，而 test_centimetre_to_mile_conversion 代表厘米轉英里的需求。

編寫代碼

這和 Django 開發(fā)沒什么兩樣，先編寫一個 forms.py，內容如下：

from django import forms

class LengthConverterForm(forms.Form):
    MEASUREMENTS = (
        ('centimetre', '厘米'),
        ('metre', '米'),
        ('mile', '英里')
    )
    input_unit = forms.ChoiceField(choices=MEASUREMENTS)
    input_value = forms.DecimalField(decimal_places=3)
    output_unit = forms.ChoiceField(choices=MEASUREMENTS)
    output_value = forms.DecimalField(decimal_places=3, required=False)

然后編寫 html，在 length 目錄下新建 templates/length.html，內容如下：

<html lang="en">
  <head>
    <title>Length Conversion</title>
  </head>
  <body>
    <form action={% url "length:convert" %} method="get">
      <div>
        {{ form.input_unit }}
        {{ form.input_value }}
      </div>
      <input type="submit" value="轉換為："/>
      <div>
        {{ form.output_unit }}
        {{ form.output_value }}
      </div>
   </form>
  </body>
</html>

然后編寫最重要的視圖函數(shù) views.py，內容如下：

from django.shortcuts import render

from length.forms import LengthConverterForm

convert_to_metre = {
    "centimetre": 0.01,
    "metre": 1.0,
    "mile": 1609.34
}
convert_from_metre = {
    "centimetre": 100,
    "metre": 1.0,
    "mile": 0.000621371
}

# Create your views here.
def convert(request):
    form = LengthConverterForm()
    if request.GET:
        input_unit = request.GET['input_unit']
        input_value = request.GET['input_value']
        output_unit = request.GET['output_unit']
        metres = convert_to_metre[input_unit] * float(input_value)
        print(f"{metres = }, {input_value = }")
        output_value = metres * convert_from_metre[output_unit]
        data = {
            "input_unit": input_unit,
            "input_value": input_value,
            "output_unit": output_unit,
            "output_value": round(output_value,5)
        }
        form = LengthConverterForm(initial=data)
        return render(
            request, "length.html", context={"form": form})
    return render(
        request, "length.html", context={"form": form})

執(zhí)行測試

執(zhí)行策四并不需要啟動 django 的 runserver：

出現(xiàn) OK 說明測試通過，啟動 django：

python manage.py runserver

打開瀏覽器，訪問 http://localhost:8000/length/convert/ 即可看到界面：

最后的話

本文分享了什么是測試驅動開發(fā)，并用測試驅動開發(fā)的方式創(chuàng)建了一個簡單的 Django 應用程序，用于長度轉換。和一般開發(fā)的區(qū)別就是先寫好測試用例，編碼是為了讓測試用例通過，這樣的方式可以使得需求更明確，開發(fā)周期更短，增量可控，提高開發(fā)效率，保證測試覆蓋率。

到此這篇關于使用 Django 進行測試驅動開發(fā)的文章就介紹到這了,更多相關Django測試驅動開發(fā)內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: