使用 Django 進行測試驅動開發
所謂測試驅動開發(TDD),就是先編寫測試用例,然後編寫代碼來滿足測試用例,具體包含以下步驟:
- 編寫測試用例。
- 編寫代碼滿足測試用例中的需求。
- 運行測試用例。
- 如果通過,說明代碼滿足瞭測試用例所定義的需求。
- 如果未通過,則需要重構代碼,直到通過。
- 重復以上步驟,直到通過全部的測試用例。
通常情況下,我們都是先寫代碼,然後編寫測試用例,因此測試驅動開發是反直覺的,那為什麼還要這麼做呢?基於以下幾點原因:
- TDD 可以被認為是根據測試用例來說明需求。此後編寫源代碼,重點是滿足這些要求。當測試最終通過時,你可以確信已滿足要求。這種專註可以幫助開發人員避免范圍蔓延。
- TDD 可以通過較短的開發周期提高開發效率。一次解決測試用例中的個別需求可以最大限度地減少幹擾因素。重大更改將更容易跟蹤和解決,減少瞭調試工作,提高瞭效率,並且將更多時間花在開發上。
- 編寫測試時考慮到瞭需求。正因為如此,它們更有可能被寫成明確的,可以理解的。這樣的測試可以作為代碼庫的優質文檔。
- 先編寫測試用例可確保您的源代碼始終具有可測試性,它還保證隨著代碼庫的增長,測試覆蓋率始終保持在合理的百分比。
然而,測試驅動開發也不是銀彈,以下情形並不適合測試驅動開發:
- 當需求不明確時,有時續期會隨著開發的進行而逐漸明確,在這種情況下最初編寫的任何測試可能會過時。
- 開發的目的是為瞭證明某一概念時——例如在黑客馬拉松期間,測試通常不是優先事項。
瞭解瞭測試驅動開發之後,我們用 Django 來演示一下測試驅動開發的過程。(Python 3.7 以上,Django 2.0 以上)
首先描述需求,我們要實現這樣一個單位換算功能的 Web 應用,可以在厘米、米、英裡直接互相轉換,Web 界面如圖所示:
創建項目
首先,我們創建一個名字叫 convert 的項目:
pip install django django-admin startproject converter
此時 Django 已經為我們生成瞭 converter 目錄及基本的項目文件:
converter/ converter/ __init__.py settings.py urls.py wsgi.py manage.py
然後,進入 converter 目錄,創建一個名字叫 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')), ]
這樣一個沒有任何業務邏輯的項目就創建成功瞭,接下來編寫測試用例:
編寫測試用例
在 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 開發沒什麼兩樣,先編寫一個 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>
然後編寫最重要的視圖函數 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})
執行測試
執行策四並不需要啟動 django 的 runserver:
出現 OK 說明測試通過,啟動 django:
python manage.py runserver
打開瀏覽器,訪問 http://localhost:8000/length/convert/ 即可看到界面:
最後的話
本文分享瞭什麼是測試驅動開發,並用測試驅動開發的方式 創建瞭一個簡單的 Django 應用程序,用於長度轉換。和一般開發的區別就是先寫好測試用例,編碼是為瞭讓測試用例通過,這樣的方式可以使得需求更明確,開發周期更短,增量可控,提高開發效率,保證測試覆蓋率。
到此這篇關於使用 Django 進行測試驅動開發的文章就介紹到這瞭,更多相關Django測試驅動開發內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- Django路由層如何獲取正確的url
- Django中url與path及re_path的區別說明
- Django利用AJAX技術實現博文實時搜索
- Django中session進行權限管理的使用
- 利用Python創建第一個Django框架程序