Python Django Testimine: TestCase vs. TransactionTestCase

Testimine on tarkvaraarenduse oluline aspekt, tagades, et teie rakendus käitub ootuspäraselt ja püsib aja jooksul töökindel. Django, populaarne Pythoni veebiraamistik, pakub võimsat testimisraamistikku, mis aitab teil kirjutada tõhusaid teste. See blogipostitus süveneb Django testimisraamistiku kahte põhiklassi: TestCase ja TransactionTestCase. Me uurime nende erinevusi, kasutusjuhtumeid ja toome praktilisi näiteid, et aidata teil valida oma testimisvajaduste jaoks õige klass.

Miks Testimine on Djangos Oluline

Enne kui sukeldume TestCase ja TransactionTestCase spetsiifikasse, arutame lühidalt, miks testmine on Django arenduses nii oluline:

• Tagab Koodi Kvaliteedi: Testid aitavad teil vead varakult arendusprotsessis tabada, hoides ära nende jõudmise tootmisesse.
• Lihtsustab Refaktoreerimist: Põhjaliku testikomplektiga saate koodi julgelt refaktoreerida, teades, et testid hoiatavad teid, kui teete regressioone.
• Parandab Koostööd: Hästi kirjutatud testid on teie koodi dokumentatsioon, muutes teistel arendajatel lihtsamaks mõista ja panustada.
• Toetab Testipõhist Arendust (TDD): TDD on arendusviis, kus kirjutate testid enne tegeliku koodi kirjutamist. See sunnib teid eelnevalt mõtlema oma rakenduse soovitud käitumisele, mis viib puhtama ja paremini hooldatava koodini.

Django Testimisraamistik: Kiire Ülevaade

Django testimisraamistik on üles ehitatud Pythoni sisseehitatud moodulile unittest. See pakub mitmeid funktsioone, mis muudavad Django rakenduste testimise lihtsamaks, sealhulgas:

• Testide avastamine: Django avastab ja käitab automaatselt teie projekti testid.
• Testikäivitaja: Django pakub testikäivitajat, mis käitab teie teste ja raporteerib tulemused.
• Väite meetodid: Django pakub hulga väite meetodeid, mida saate kasutada oma koodi oodatava käitumise kontrollimiseks.
• Klient: Django testiklient võimaldab teil simuleerida kasutajate interaktsioone teie rakendusega, näiteks vormide esitamist või API päringute tegemist.
• TestCase ja TransactionTestCase: Need on kaks põhiklassi Djangos testide kirjutamiseks, mida me üksikasjalikult uurime.

TestCase: Kiire ja Tõhus Ühiktestimine

TestCase on peamine klass Djangos ühiktestide kirjutamiseks. See pakub iga testjuhtumi jaoks puhast andmebaasikeskkonda, tagades, et testid on isoleeritud ja ei sega üksteist.

Kuidas TestCase Töötab

Kui kasutate TestCase, teeb Django iga testimismeetodi jaoks järgmised sammud:

1. Loob testandmebaasi: Django loob iga testkäivituse jaoks eraldi testandmebaasi.
2. Tühjendab andmebaasi: Enne iga testimismeetodit tühjendab Django testandmebaasi, eemaldades kõik olemasolevad andmed.
3. Käivitab testimismeetodi: Django käivitab teie määratud testimismeetodi.
4. Tühistab tehingu: Pärast iga testimismeetodit tühistab Django tehingu, tühistades tegelikult kõik testide ajal andmebaasis tehtud muudatused.

See lähenemine tagab, et iga testimismeetod algab puhta lehega ja et kõik andmebaasis tehtud muudatused tühistatakse automaatselt. See muudab TestCase ideaalseks ühiktestimiseks, kus soovite testida oma rakenduse üksikuid komponente isoleeritult.

Näide: Lihtsa Mudeli Testimine

Vaatleme lihtsat näidet Django mudeli testimisest, kasutades TestCase:

from django.test import TestCase
from .models import Product

class ProductModelTest(TestCase):
 def test_product_creation(self):
 product = Product.objects.create(name="Test Product", price=10.00)
 self.assertEqual(product.name, "Test Product")
 self.assertEqual(product.price, 10.00)
 self.assertTrue(isinstance(product, Product))

Selles näites testime Product mudeli eksemplari loomist. Meetod test_product_creation loob uue toote ja seejärel kasutab väite meetodeid, et kontrollida, kas toote atribuudid on õigesti seatud.

Millal TestCase'i Kasutada

TestCase on üldiselt eelistatud valik enamiku Django testimistsenaariumide jaoks. See on kiire, tõhus ja pakub iga testi jaoks puhast andmebaasikeskkonda. Kasutage TestCase, kui:

• Testite oma rakenduse üksikuid mudeleid, vaateid või muid komponente.
• Soovite tagada, et teie testid on isoleeritud ja ei sega üksteist.
• Teil pole vaja testida keerulisi andmebaasi interaktsioone, mis hõlmavad mitut tehingut.

TransactionTestCase: Keeruliste Andmebaasi Interaktsioonide Testimine

TransactionTestCase on teine ​​klass Djangos testide kirjutamiseks, kuid see erineb TestCase-st selle poolest, kuidas see andmebaasitehinguid haldab. Selle asemel, et tehingut pärast iga testimismeetodit tagasi pöörata, kinnitab TransactionTestCase tehingu. See muudab selle sobivaks keeruliste andmebaasi interaktsioonide testimiseks, mis hõlmavad mitut tehingut, näiteks signaalide või aatomtehingute korral.

Kuidas TransactionTestCase Töötab

Kui kasutate TransactionTestCase, teeb Django iga testjuhtumi jaoks järgmised sammud:

1. Loob testandmebaasi: Django loob iga testkäivituse jaoks eraldi testandmebaasi.
2. EI tühjenda andmebaasi: TransactionTestCase *ei* tühjenda andmebaasi automaatselt enne iga testi. See eeldab, et andmebaas on enne iga testi käivitamist järjepidevas olekus.
3. Käivitab testimismeetodi: Django käivitab teie määratud testimismeetodi.
4. Kinnitab tehingu: Pärast iga testimismeetodit kinnitab Django tehingu, muutes muudatused testandmebaasis püsivaks.
5. Kärbib tabelid: Kõigi TransactionTestCase'i testide *lõpus* kärbitakse tabelid andmete kustutamiseks.

Kuna TransactionTestCase kinnitab tehingu pärast iga testimismeetodit, on oluline tagada, et teie testid ei jätaks andmebaasi ebajärjepidevasse olekusse. Võimalik, et peate testide käigus loodud andmed käsitsi kustutama, et vältida järgnevate testide segamist.

Näide: Signaalide Testimine

Vaatleme näidet Django signaalide testimisest, kasutades TransactionTestCase:

from django.test import TransactionTestCase
from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import Product, ProductLog

@receiver(post_save, sender=Product)
def create_product_log(sender, instance, created, **kwargs):
 if created:
 ProductLog.objects.create(product=instance, action="Created")

class ProductSignalTest(TransactionTestCase):
 def test_product_creation_signal(self):
 product = Product.objects.create(name="Test Product", price=10.00)
 self.assertEqual(ProductLog.objects.count(), 1)
 self.assertEqual(ProductLog.objects.first().product, product)
 self.assertEqual(ProductLog.objects.first().action, "Created")

Selles näites testime signaali, mis loob ProductLog eksemplari iga kord, kui luuakse uus Product eksemplar. Meetod test_product_creation_signal loob uue toote ja seejärel kontrollib, kas vastav toote logikirje on loodud.

Millal TransactionTestCase'i Kasutada

TransactionTestCase kasutatakse tavaliselt konkreetsetes stsenaariumides, kus peate testima keerulisi andmebaasi interaktsioone, mis hõlmavad mitut tehingut. Kaaluge TransactionTestCase kasutamist, kui:

• Testite signaale, mida käivitavad andmebaasi toimingud.
• Testite aatomtehinguid, mis hõlmavad mitut andmebaasi toimingut.
• Peate kontrollima andmebaasi olekut pärast rida seotud toiminguid.
• Kasutate koodi, mis tugineb testide vahel püsimiseks automaatselt suurenevale ID-le (kuigi seda peetakse üldiselt halvaks tavaks).

Olulised Kaalutlused TransactionTestCase Kasutamisel

Kuna TransactionTestCase kinnitab tehinguid, on oluline olla teadlik järgmistest kaalutlustest:

• Andmebaasi puhastamine: Võimalik, et peate testide käigus loodud andmed käsitsi kustutama, et vältida järgnevate testide segamist. Kaaluge testandmete haldamiseks meetodite setUp ja tearDown kasutamist.
• Testi isoleerimine: TransactionTestCase ei paku sama testide isoleerimise taset kui TestCase. Olge teadlik võimalikest interaktsioonidest testide vahel ja veenduge, et teie testid ei sõltuks eelmiste testide andmebaasi olekust.
• Jõudlus: TransactionTestCase võib olla aeglasem kui TestCase, kuna see hõlmab tehingute kinnitamist. Kasutage seda mõistlikult ja ainult vajadusel.

Parimad Praktikad Django Testimiseks

Siin on mõned parimad praktikad, mida Djangos teste kirjutades meeles pidada:

• Kirjutage selged ja lühikesed testid: Testid peaksid olema kergesti mõistetavad ja hooldatavad. Kasutage testimismeetodite ja väidete jaoks kirjeldavaid nimesid.
• Testige ühte asja korraga: Iga testimismeetod peaks keskenduma teie koodi ühe aspekti testimisele. See muudab tõrkeallika tuvastamise lihtsamaks, kui test ebaõnnestub.
• Kasutage sisukaid väiteid: Kasutage väite meetodeid, mis väljendavad selgelt teie koodi oodatavat käitumist. Django pakub erinevate stsenaariumide jaoks rikkaliku komplekti väite meetodeid.
• Järgige Korralda-Tegutse-Väida mustrit: Struktureerige oma testid vastavalt Korralda-Tegutse-Väida mustrile: Korraldage testandmed, Tegutsege testitava koodi suhtes ja Väitke oodatud tulemus.
• Hoidke oma testid kiired: Aeglased testid võivad arendajaid testide sagedasest käitamisest heidutada. Optimeerige oma teste, et minimeerida käivitusaega.
• Kasutage testandmete jaoks fikstuure: Fikstuurid on mugav viis algandmete laadimiseks oma testandmebaasi. Kasutage fikstuure järjepidevate ja korduvkasutatavate testandmete loomiseks. Kaaluge loomulike võtmete kasutamist fikstuurides, et vältida ID-de kõvakodeerimist.
• Kaaluge testimisteegi, näiteks pytest, kasutamist: Kuigi Django sisseehitatud testimisraamistik on võimas, võivad teegid nagu pytest pakkuda täiendavaid funktsioone ja paindlikkust.
• Püüdke saavutada kõrge testikatvus: Püüdke saavutada kõrge testikatvus, et tagada teie koodi põhjalik testimine. Kasutage katvusvahendeid oma testikatvuse mõõtmiseks ja alade tuvastamiseks, mis vajavad rohkem testimist.
• Integreerige testid oma CI/CD torujuhtmesse: Käivitage oma testid automaatselt oma pideva integratsiooni ja pideva juurutuse (CI/CD) torujuhtme osana. See tagab, et kõik regressioonid tabatakse varakult arendusprotsessis.
• Kirjutage teste, mis peegeldavad reaalseid stsenaariume: Testige oma rakendust viisidel, mis jäljendavad seda, kuidas kasutajad sellega tegelikult suhtlevad. See aitab teil avastada vigu, mis ei pruugi lihtsates ühiktestides ilmneda. Näiteks kaaluge rahvusvaheliste aadresside ja telefoninumbrite variatsioone vormide testimisel.

Rahvusvahelistamine (i18n) ja Testimine

Djangos globaalse vaatajaskonna jaoks rakendusi arendades on oluline arvestada rahvusvahelistamise (i18n) ja lokaliseerimisega (l10n). Veenduge, et teie testid hõlmavad erinevaid keeli, kuupäevavorminguid ja valuutasümboleid. Siin on mõned näpunäited:

• Testige erinevate keele seadetega: Kasutage Django dekoraatorit override_settings, et testida oma rakendust erinevate keele seadetega.
• Kasutage oma testides lokaliseeritud andmeid: Kasutage oma testfikstuurides ja testimismeetodites lokaliseeritud andmeid, et tagada, et teie rakendus käsitleb erinevaid kuupäevavorminguid, valuutasümboleid ja muid lokaadispetsiifilisi andmeid õigesti.
• Testige oma tõlkestringe: Kontrollige, kas teie tõlkestringid on õigesti tõlgitud ja kas need renderdatakse erinevates keeltes õigesti.
• Kasutage mallisilti localize: Kasutage oma mallides mallisilti localize, et vormindada kuupäevi, numbreid ja muid lokaadispetsiifilisi andmeid vastavalt kasutaja praegusele lokaadile.

Näide: Testimine Erinevate Keele Seadetega

from django.test import TestCase
from django.utils import translation
from django.conf import settings

class InternationalizationTest(TestCase):

 def test_localized_date_format(self):
 original_language = translation.get_language()
 try:
 translation.activate('de') # Aktiveeri saksa keel
 with self.settings(LANGUAGE_CODE='de'): # Määra keel seadetes
 from django.utils import formats
 from datetime import date
 d = date(2024, 1, 20)
 formatted_date = formats.date_format(d, 'SHORT_DATE_FORMAT')
 self.assertEqual(formatted_date, '20.01.2024')
 finally:
 translation.activate(original_language) # Taasta algne keel

See näide demonstreerib, kuidas testida kuupäeva vormindamist erinevate keele seadetega, kasutades Django mooduleid translation ja formats.

Järeldus

TestCase ja TransactionTestCase erinevuste mõistmine on Djangos tõhusate ja usaldusväärsete testide kirjutamiseks hädavajalik. TestCase on üldiselt eelistatud valik enamiku testimistsenaariumide jaoks, pakkudes kiiret ja tõhusat viisi oma rakenduse üksikute komponentide isoleeritult testimiseks. TransactionTestCase on kasulik keerukate andmebaasi interaktsioonide testimiseks, mis hõlmavad mitut tehingut, näiteks signaalide või aatomtehingute korral. Järgides parimaid praktikaid ja arvestades rahvusvahelistamise aspekte, saate luua tugeva testikomplekti, mis tagab teie Django rakenduste kvaliteedi ja hooldatavuse.

Edasine Õppimine

• Django Testimise Dokumentatsioon
• Python unittest Dokumentatsioon
• pytest Dokumentatsioon