{"title":"Tástálacha aonaid","version":"5.2","locale":"ga","docname":"internals/contributing/writing-code/unit-tests","url":"/ga/5.2/internals/contributing/writing-code/unit-tests/","canonical":"https://djangodocs.dev/ga/5.2/internals/contributing/writing-code/unit-tests/","summary":"Tagann Django le sraith tástála féin, in eolaire ``tástálacha ``den bhonn cód. Is é ár mbeartas a chinntiú go dtéann gach tástáil i gcónaí.","html":"

Tástálacha aonaidLink to this heading#

\n

Tagann Django le sraith tástála féin, in eolaire ``tástálacha ``den bhonn cód. Is é ár mbeartas a chinntiú go dtéann gach tástáil i gcónaí.

\n

Táimid buíoch as aon ranníocaíochtaí go léir leis an tsraith tástála!

\n

Úsáideann tástálacha Django go léir an bonneagar tástála a sheolann le Django chun feidhmchláir a thástáil Féach:doc: /topics/tástáil/léirmheas le haghaidh míniú ar conas tástálacha nua a scríobh.

\n
\n

Tástálacha aonaid a rithLink to this heading#

\n
\n

Tosaigh gastaLink to this heading#

\n

< https://github.com/django/django/fork>Ar dtús, `fork Django ar Github`__.

\n

Ar an dara dul síos, cruthaigh agus gníomhachtaigh timpeallacht f Mura bhfuil tú eolach ar conas é sin a dhéanamh, léigh inn:doc: teagaisc rannchuidiúcháin </intro/contributing>.

\n

Ansin, clóin do fhorc, suiteáil roinnt riachtanais, agus reáchtáil na tástálacha:

\n

Linux / macOS

Shell
$ git clone https://github.com/YourGitHubName/django.git django-repo\n$ cd django-repo/tests\n$ python -m pip install -e ..\n$ python -m pip install -r requirements/py3.txt\n$ ./runtests.py\n
\n

Windows

Windows
...\\> git clone https://github.com/YourGitHubName/django.git django-repo\n...\\> cd django-repo\\tests\n...\\> py -m pip install -e ..\n...\\> py -m pip install -r requirements\\py3.txt\n...\\> runtests.py \n
\n

Is dócha go mbeidh gá le roinnt pacáistí córais oibriúcháin nach bhfuil suiteáilte ar do ríomhaire chun na ceanglais a shuiteáil. Is féidir leat a dhéanamh amach de ghnáth cén pacáiste atá le suiteáil trí chuardach gréasáin a dhéanamh don líne dheireanach nó mar sin den teachtaireacht earráide. Bain triail as do chóras oibriúcháin a chur leis an bhfiosrúchán cuardaigh más gá.

\n

Má tá deacracht agat na riachtanais a shuiteáil, is féidir leat an chéim sin a scipeáil. Féach: Ref: running-unit-tests-dependencies le haghaidh sonraí maidir leis na spleáchais tástála roghnacha a shuiteáil. Mura bhfuil spleáchas roghnach suiteáilte agat, scipeánfar na tástálacha a éilíonn é.

\n

Teastaíonn modúl socruithe Django a shainmhíníonn na bunachair sonraí atá le húsáid. Chun cabhrú leat tosú, soláthraíonn agus úsáideann Django modúl socruithe samplach a úsáideann bunachar sonraí SQLite. Féach:ref: running-unit-tests-settings chun foghlaim conas modúl socruithe difriúil a úsáid chun na tástálacha a reáchtáil le bunachar sonraí difriúil.

\n

Ag fadhbanna agat? Féach:ref: trouoting-unitt-tests le haghaidh roinnt saincheisteanna coitianta.

\n
\n
\n

Tástálacha reatha ag baint úsáide as tocsLink to this heading#

\n

Is uirlis é Tox chun tá< https://tox.wiki/> stálacha a reáchtáil i dtimpeallachtaí fíorúla difriúla Cuimsíonn Django bunúsach tox.ini a uathoibriú roinnt seiceálacha a dhéanann ár bhfreastalaí tógála ar iarratais tarraingthe. <coding-style-imports>Chun na tástálacha aonaid agus na seiceálacha eile a reáchtáil (mar shampla:ref: sórtáil allmhairiúcháin `, an:ref: `seiceálaí litrithe doiciméadaithe', agus <documentation-spelling-check>:ref: `formáidiú cód`<coding-style-python>), suiteáil agus reáchtáil an t-ordú `tox` ó aon áit sa chrann foinse Django:

\n

Linux / macOS

Shell
$ python -m pip install tox\n$ tox\n
\n

Windows

Windows
...\\> py -m pip install tox\n...\\> tox\n
\n

By default, tox runs the test suite with the bundled test settings file for\nSQLite, black, blacken-docs, flake8, isort, zizmor, and the\ndocumentation spelling checker. In addition to the system dependencies noted\nelsewhere in this documentation, the command python3 must be on your path\nand linked to the appropriate version of Python. A list of default environments\ncan be seen as follows:

\n

Linux / macOS

Shell
$ tox -l\npy3\nblack\nblacken-docs\nflake8>=3.7.0\ndocs\nisort>=7.0.0\nzizmor>=1.16.3\n
\n

Windows

Windows
...\\> tox -l\npy3\nblack\nblacken-docs\nflake8>=3.7.0\ndocs\nisort>=7.0.0\nzizmor>=1.16.3\n
\n
\n

Leaganacha Python eile agus cúltaca bunachar sonraí a thástáilLink to this heading#

\n

Chomh maith leis na timpeallachtaí réamhshocraithe, tacaíonn ``tox` le tástálacha aonaid a reáchtáil do leaganacha eile de Python agus cúltaca bunachar sonraí eile. <running-unit-tests-settings>Ós rud é nach gcuireann sraith tástála Django comhad socruithe le haghaidh cúltaca bunachar sonraí seachas SQLite, áfach, ní mór duit: ref: `do shocruithe tástála féin a chruthú agus a sholáthar `. Mar shampla, chun na tástálacha a reáchtáil ar Python 3.10 ag baint úsáide as PostgreSQL:

\n

Linux / macOS

Shell
$ tox -e py310-postgres -- --settings=my_postgres_settings\n
\n

Windows

Windows
...\\> tox -e py310-postgres -- --settings=my_postgres_settings\n
\n

Bunaíonn an t-ordú seo timpeallacht fhíorúil Python 3.10, suiteálann sé spleáchais sraith tástála Django (lena n-áirítear iad siúd do PostgreSQL), agus glaonn sé runtests.py leis na hargóintí a sholáthraítear (sa chás seo, --settings=my_postgres_settings).

\n

Taispeánann an chuid eile den doiciméadú seo orduithe chun tástálacha a reáchtáil gan tox, áfach, is féidir aon rogha a chuirtear chuig runtests.py` a chur chuig tox` tríd an liosta argóintí a réamhshocrú le --, mar atá thuas.

\n

Tá meas ag Tox freisin ar an athróg comhshaoil: envvar: DJANGO_SETTINGS_MODULE, má tá sé socraithe. Mar shampla, tá an méid seo a leanas comhionann leis an ordú thuas:

\n
Shell
$ DJANGO_SETTINGS_MODULE=my_postgres_settings tox -e py310-postgres\n
\n

Ba chóir d'úsáideoirí Windows a úsáid:

\n
Windows
...\\> set DJANGO_SETTINGS_MODULE=my_postgres_settings\n...\\> tox -e py310-postgres\n
\n
\n
\n

Na tástálacha JavaScript a rithLink to this heading#

\n

Cuimsíonn Django sraith de:ref: Tástálacha aonad JavaScript <javascript-tests>`le haghaidh feidhmeanna in aipeanna contrib áirithe. Ní reáchtáiltear na tástálacha JavaScript de réir réamhshocraithe ag baint úsáide as `tox` toisc go n-éilíonn siad Node.js ``a shuiteáil agus nach bhfuil gá le haghaidh formhór na bpaistí. Chun na tástálacha JavaScript a reáchtáil ag baint úsáide as ``tox:

\n

Linux / macOS

Shell
$ tox -e javascript\n
\n

Windows

Windows
...\\> tox -e javascript\n
\n

Ritheann an t-ordú seo npm install ``chun a chinntiú go bhfuil riachtanais tástála cothrom le dáta agus ansin ritheann sé ``npm tástáil.

\n
\n
\n
\n

Tástálacha a reáchtáil ag baint úsáide as django-docker-boxLink to this heading#

\n

Ligeann django-docker-box `_ duit sraith tástála Django a reáchtáil ar fud na bunachair sonraí go léir agus leaganacha python tacaithe. Féach leathanach tionscadail `django-docker-box le haghaidh treoracha suiteála agus úsáide.

\n
\n
\n

Ag baint úsáide as modúl eile ``socruithe ``Link to this heading#

\n

Ligeann an modúl socruithe san áireamh (tests/test_sqlite.py) duit an tsraith tástála a reáchtáil ag baint úsáide as SQLite. Más mian leat na tástálacha a reáchtáil ag baint úsáide as bunachar sonraí difriúil, beidh ort do chomhad socruithe féin a shainiú. Tá roinnt tástálacha, mar shampla iad siúd do contrib.postgres`, go sonrach le cúltaca bunachar sonraí áirithe agus scipeánfar iad má reáchtáiltear le cúltaca difriúil. Scaiptear roinnt tástálacha nó ag súil le teipeanna ar chúlcheann bunachar sonraí áirithe (féach DatabaseFeatures.django_test_skips agus`` databaseFeatures.django_test_expected_failures`` ar gach cúltaca).

\n

Chun na tástálacha a reáchtáil le socruithe éagsúla, cinntigh go bhfuil an modúl ar do: envvar: PYTHONPATH agus pas an modúl le ``--socruithe ``.

\n

Ní mór don socrú: SETTING: DATABASES in aon mhodúl socruithe tástála dhá bhunachar sonraí a shainiú:

\n\n

Má tá cúltaca á úsáid agat nach SQLite, beidh ort sonraí eile a sholáthar do gach bunachar sonraí:

\n\n

Faigheann bunachair shonraí tástála a n-ainmneacha trí tástáil_ a réamh-mheas ar luach na socruithe NAME do na bunachair shonraí atá sainmhínithe i :suíomh:`BUNACHTAÍ SONRAÍ`. Scriostar na bunachair shonraí tástála seo nuair a bhíonn na tástálacha críochnaithe.

\n

Beidh ort a chinntiú freisin go n-úsáideann do bhunachar sonraí UTF-8 mar an tacar carachtair réamhshocraithe. Mura n-úsáideann do fhreastala <TEST_CHARSET>í bunachar sonraí UTF-8 mar chartacar réamhshocraithe, beidh ort luach fao:setting: `CHARSET `a chur san áireamh sa fhoclóir socruithe tástála don bhunachar sonraí is infheidhme.

\n
\n
\n

Níl ach cuid de na tástálacha á rithLink to this heading#

\n

Tógann sé tamall le sraith tástála iomlán Django a rith, agus d'fhéadfadh sé a bheith iomarcach gach tástáil amháin a reáchtáil má chuir tú, abair, díreach tástáil le Django gur mhaith leat a rith go tapa gan gach rud eile a rith. Is féidir leat fo-thacar de na tástálacha aonaid a reáchtáil trí ainmneacha na modúil tástála a chur leis runtests.py ar an líne ordaithe.

\n

Mar shampla, más mian leat tástálacha a reáchtáil ach le haghaidh caidreamh cineálach agus idirnáisiúnú, clóscríobh:

\n

Linux / macOS

Shell
$ ./runtests.py --settings=path.to.settings generic_relations i18n\n
\n

Windows

Windows
...\\> runtests.py --settings=path.to.settings generic_relations i18n\n
\n

Conas a aimsíonn tú ainmneacha na dtástálacha aonair? Féach in tástálacha/ - gach ainm eolaire tá ainm tástála ann.

\n

Más mian leat ach aicme áirithe tástálacha a reáchtáil, is féidir leat liosta cosáin a shonrú chuig ranganna tástála aonair. Mar shampla, chun an TranslationTests` den mhodúl i18n a reáchtáil, cineál:

\n

Linux / macOS

Shell
$ ./runtests.py --settings=path.to.settings i18n.tests.TranslationTests\n
\n

Windows

Windows
...\\> runtests.py --settings=path.to.settings i18n.tests.TranslationTests\n
\n

Ag dul níos faide ná sin, is féidir leat modh tástála aonair mar seo a shonrú:

\n

Linux / macOS

Shell
$ ./runtests.py --settings=path.to.settings i18n.tests.TranslationTests.test_lazy_objects\n
\n

Windows

Windows
...\\> runtests.py --settings=path.to.settings i18n.tests.TranslationTests.test_lazy_objects\n
\n

Is féidir leat tástálacha a reáchtáil ag tosú ag modúl barrleibhéil sonraithe le rogha --start-at. Mar shampla:

\n

Linux / macOS

Shell
$ ./runtests.py --start-at=wsgi\n
\n

Windows

Windows
...\\> runtests.py --start-at=wsgi\n
\n

Is féidir leat tástálacha a reáchtáil freisin ag tosú tar éis modúl barrleibhéil sonraithe le rogha - start-after. Mar shampla:

\n

Linux / macOS

Shell
$ ./runtests.py --start-after=wsgi\n
\n

Windows

Windows
...\\> runtests.py --start-after=wsgi\n
\n

Tabhair faoi deara nach mbíonn tionchar ag an rogha --reverse ar roghanna --start-at nó ``--tús tar éis ``. Thairis sin ní féidir na roghanna seo a úsáid le lipéid tástála.

\n
\n
\n

Rith na tástálacha SeiléiniamLink to this heading#

\n

Éilíonn roinnt tástálacha Seiléiniam agus brabhsálaí gréasáin <BROWSERS>Chun na tástálacha seo a reáchtáil, ní mór duit an pacáiste: pypi: selenium a shuiteáil agus na tástálacha a reáchtáil leis an rogha ``--selenium= ``. Mar shampla, má tá Firefox agus Google Chrome suiteáilte agat:

\n

Linux / macOS

Shell
$ ./runtests.py --selenium=firefox,chrome\n
\n

Windows

Windows
...\\> runtests.py --selenium=firefox,chrome\n
\n

Féach an pacáiste selenium.webdriver le haghaidh liosta na mbrabhsálaithe atá ar fáil.

\n

Sonraíonn --selenium go huathoibríoch --tags=selenium chun na tástálacha a theastaíonn seiléiniam a reáchtáil.

\n

Tacaíonn roinnt brabhsálaithe (m.sh. Chrome nó Firefox) le tástáil gan cheann, rud a d'fhéadfadh a bheith níos gasta agus níos cobhsaí. Cuir an rogha ``--headless` leis chun an modh seo a chumasú.

\n
\n

Screenshot testsLink to this heading#

\n

Chun athruithe ar an gChomhéadan riaracháin a thástáil, is féidir na tástálacha seiléiniam a reáchtáil leis an rogha --screenshots` cumasaithe. Sábhálfar scáileáin scáileáin chuig an eolaire ``tástálacha/scanshots/.

\n

Chun a shainmhíniú cathain ba chóir scáileáin a ghlacadh le linn tástála seiléiniam, ní mór don rang tástála an maisitheoir @django .test.selenium.screenshot_cases a úsáid le liosta de chineálacha scáileáin tacaithe ("desktop_size", ``dark"`, agus ``"high_contrast “). Ansin is féidir leis glaoch ar ``self.take_screenshot (“unice-screenshot-name”) ``ag an bpointe atá ag teastáil chun na scannáin a ghiniúint. Mar shampla:

\n
Code
from django.test.selenium import SeleniumTestCase, screenshot_cases\nfrom django.urls import reverse\n\n\nclass SeleniumTests(SeleniumTestCase):\n    @screenshot_cases(["desktop_size", "mobile_size", "rtl", "dark", "high_contrast"])\n    def test_login_button_centered(self):\n        self.selenium.get(self.live_server_url + reverse("admin:login"))\n        self.take_screenshot("login")\n        ...\n
\n

Gineann sé seo scáileáin iolracha den leathanach logála isteach - ceann do scáileán deisce, ceann do scáileán soghluaiste, ceann do theangacha ar dheis go clé ar dheasc, ceann don mhodh dorcha ar dheasc, agus ceann do mhodh ardchodarsnachta ar dheasc agus chrome á úsáid agat.

\n\n
\n
\n
\n

Na tástálacha go léir á rithLink to this heading#

\n

Más mian leat an tsraith iomlán tástálacha a reáchtáil, beidh ort roinnt spleáchais a shuiteáil:

\n\n

Is féidir leat na spleáchais seo a fháil i gcomhaid `riachtanais píopa`_ taobh istigh den eolaire ``tástálach< https://pip.pypa.io/en/latest/user_guide/#requirements-files> a/riachtanais ``de chrann foinse Django agus iad a shuiteáil mar sin:

\n

Linux / macOS

Shell
$ python -m pip install -r tests/requirements/py3.txt\n
\n

Windows

Windows
...\\> py -m pip install -r tests\\requirements\\py3.txt\n
\n

Má thagann tú ar earráid le linn na suiteála, d'fhéadfadh spleáchas a bheith in easnamh ar do chóras le haghaidh ceann amháin nó níos mó de na pacáistí Python. Téigh i gcomhairle le doiciméadú an phacáiste a bhfuil ag teip air nó cuardaigh an gréasán leis an teachtaireacht earráide a thagann ort.

\n

Is féidir leat na cuibheoirí bunachar sonraí de do rogha a shuiteáil freisin ag baint úsáide as oracle.txt, mysql.txt`, nó postgres.txt.

\n

Más mian leat na cúltaca taisce memcached nó Redis a thástáil, beidh ort: socrú: CACHES a shainiú freisin a: socrú: CACHES a thugann pointe ar do shampla memcached nó Redis faoi seach.

\n

Chun na tástálacha GeoDjango a reáchtáil, beidh ort: doc: `bunachar sonraí spásúil a chur ar bun agus na leabharlanna Geospásúla a shuiteáil'</ref/contrib/gis/install/index>.

\n

Tá gach ceann de na spleáchais seo roghnach. Má tá aon cheann acu in easnamh agat, scipeánfar na tástálacha gaolmhara.

\n

Chun cuid de na tástálacha autoreload a reáchtáil, beidh ort an tseirbhís Watchman a shuiteáil < https://facebook.github.io/watchman/>.

\n
\n
\n

Clúdach códLink to this heading#

\n

Spreagtar ranníocóirí clúdach a reáchtáil ar an tsraith tástála chun réimsí a aithint a bhfuil tástálacha breise <topics-testing-code-coverage>Déantar cur síos ar shuiteáil agus úsáid na huirlisí clúdaigh in:ref: `clúdach cód tástála `.

\n

Chun clúdach a rith ar an tsraith tástála Django ag baint úsáide as na socruithe tástála caighdeánacha:

\n

Linux / macOS

Shell
$ coverage run ./runtests.py --settings=test_sqlite\n
\n

Windows

Windows
...\\> coverage run runtests.py --settings=test_sqlite\n
\n

Tar éis clúdach a rith, cuir na staitisticí clúdaigh go léir le chéile trí:

\n

Linux / macOS

Shell
$ coverage combine\n
\n

Windows

Windows
...\\> coverage combine\n
\n

Ina dhiaidh sin gineann an tuarascáil html trí rith:

\n

Linux / macOS

Shell
$ coverage html\n
\n

Windows

Windows
...\\> coverage html\n
\n

Agus clúdach á reáchtáil do na tástálacha Django, sainmhíníonn an comhad socruithe .coveragerc san áireamh ``coverage_html ``mar eolaire aschuir don tuarascáil agus ní chuimsíonn sé roinnt eolairí nach bhfuil ábhartha leis na torthaí (cód tástála nó cód seachtrach atá san áireamh i Django).

\n
\n
\n
\n

Aipeanna ContribLink to this heading#

\n

<app_name>Is féidir tástálacha le haghaidh aipeanna contrib a fháil san eolair:source: tests/, de ghnáth faoi _tástálacha. Mar shampla, tá tástálacha le haghaidh contrib.auth` lonnaithe in:source: tests/auth_tests.

\n
\n
\n

FabhtcheartúLink to this heading#

\n
\n

Crochtann nó taispeánann an tsraith tástála teipeanna ar bhrainse príomhLink to this heading#

\n

Cinntigh go bhfuil an scaoileadh pointe is déanaí agat de leagan Python arna thacú, mar is minic a bhíonn fabhtanna i leaganacha níos luaithe a d'fhéadfadh teip nó crochadh a dhéanamh ar an tsraith tástála.

\n

Ar macOS (High Sierra agus leaganacha níos nuaí), b'fhéidir go bhfeicfidh tú an teachtaireacht seo logáilte, agus ina dhiaidh sin crochann na tástálacha:

\n
Pytb
objc[42074]: +[__NSPlaceholderDate initialize] may have been in progress in\nanother thread when fork() was called.\n
\n

Chun é seo a sheachaint socraigh athróg comhshaoil OBJC_DISABLE_INITIALIZE_FORK_SAFETY, mar shampla:

\n
Shell
$ OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES ./runtests.py\n
\n

Nó cuir export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES le comhad tosaithe do bhlaosc (m.sh. ~/.profile).

\n
\n
\n

Go leor teipeanna tástála le UnicodeEncodeErrorLink to this heading#

\n

Mura bhfuil an pacáiste locales suiteáilte, teipeann ar roinnt tástálacha le UnicodeEncodeError.

\n

Is féidir leat é seo a réiteach ar chórais atá bunaithe ar Debian, mar shampla, trí rith:

\n
Shell
$ apt-get install locales\n$ dpkg-reconfigure locales\n
\n

Is féidir leat é seo a réiteach do chórais macOS trí logáil do bhlaosc a chumrú:

\n
Shell
$ export LANG="en_US.UTF-8"\n$ export LC_ALL="en_US.UTF-8"\n
\n

Rith an t-ordú locale chun an t-athrú a dhearbhú. Go roghnach, cuir na horduithe easpórtála sin le comhad tosaithe do bhlaosc (m.sh. ~/.bashrc` do Bash) chun seachaint a chur orthu a athchlóscríobh.

\n
\n
\n

Tástálacha nach dteipeann ach i gcomhcheangalLink to this heading#

\n

I gcás go n-éiríonn le tástáil nuair a reáchtáiltear é ina haonar ach go dteipeann uirthi laistigh den tsraith iomlán, tá roinnt uirlisí againn chun cabhrú leis an bhfadhb a anailísiú.

\n

Reáchtálfaidh an rogha --bisect de runtests.py an tástáil a theip agus an tacar tástála a reáchtáiltear leis a leath ar gach athrú, rud a fhágann gur féidir líon beag tástálacha a d'fhéadfadh a bheith bainteach leis an teip a aithint go minic.

\n

Mar shampla, cuir i gceist gurb é ModelTest.test_eq` an tástáil teip a oibríonn leis féin, ansin ag baint úsáide as:

\n

Linux / macOS

Shell
$ ./runtests.py --bisect basic.tests.ModelTest.test_eq\n
\n

Windows

Windows
...\\> runtests.py --bisect basic.tests.ModelTest.test_eq\n
\n

déanfaidh sé iarracht tástáil a chuireann isteach ar an gceann a thugtar a chinneadh. Ar dtús, reáchtáiltear an tástáil leis an gcéad leath den tsraith tástála. Má tharlaíonn teip, roinntear an chéad leath den tsraith tástála ina dhá ghrúpa agus reáchtáiltear gach grúpa ansin leis an triail shonraithe. Mura dteipeann ar an gcéad leath den tsraith tástála, reáchtáiltear an dara leath den tsraith tástála leis an tástáil shonraithe agus roinntear go cuí mar a thuairiscítear níos luaithe. Athdhéantar an próiseas go dtí go n-íoslaghdaítear an tsraith tástálacha a dteipeann orthu.

\n

Ritheann an rogha ``--péire ``an tástáil ar leith in éineacht le gach tástáil eile ón tsraith, ag ligean duit seiceáil an bhfuil fo-iarsmaí ag tástáil eile a chúis leis an teip. Mar sin:

\n

Linux / macOS

Shell
$ ./runtests.py --pair basic.tests.ModelTest.test_eq\n
\n

Windows

Windows
...\\> runtests.py --pair basic.tests.ModelTest.test_eq\n
\n

péireoidh “test_eq” le gach lipéad tástála.

\n

<runtests-specifying-labels>Le --bisect agus ``--pair ``araon, má tá amhras ort cheana féin cé na cásanna a d'fhéadfadh a bheith freagrach as an teip, féadfaidh tú teorainn a chur ar thástálacha le tras-anailís trés:ref: `lipéid tástála breise a shonrú `tar éis an chéad cheann:

\n

Linux / macOS

Shell
$ ./runtests.py --pair basic.tests.ModelTest.test_eq queries transactions\n
\n

Windows

Windows
...\\> runtests.py --pair basic.tests.ModelTest.test_eq queries transactions\n
\n

Is féidir leat triail a bhaint as aon sraith tástálacha a rith in ord randamach nó droim ar ais ag baint úsáide as na roghanna --shuffle agus --reverse. Is féidir leis seo cabhrú lena fhíorú nach gcruthaítear trioblóid ar bith má dhéantar tástálacha in ord difriúil:

\n

Linux / macOS

Shell
$ ./runtests.py basic --shuffle\n$ ./runtests.py basic --reverse\n
\n

Windows

Windows
...\\> runtests.py basic --shuffle\n...\\> runtests.py basic --reverse\n
\n
\n
\n

Ag féachaint ar na ceisteanna SQL ag rith le linn tástálaLink to this heading#

\n

Más mian leat scrúdú a dhéanamh ar an SQL atá á reáchtáil i dtástálacha teip, is féidir leat: ref: Logáil SQL `a chasadh air ag baint úsáide as an rogha `--debu <django-db-logger>g-sql``. Má chomhcheanglaíonn tú é seo le --verbosity=2, aschur gach ceist SQL:

\n

Linux / macOS

Shell
$ ./runtests.py basic --debug-sql\n
\n

Windows

Windows
...\\> runtests.py basic --debug-sql\n
\n
\n
\n

Aisrianú iomlán teip tástála a fheiceáilLink to this heading#

\n

De réir réamhshocraithe déantar tástálacha a reáchtáil go comhthreomhar le próiseas amháin Nuair a reáchtar na tástálacha go comhthreomhar, áfach, ní fheicfidh tú ach rianú gearrtha le haghaidh aon teipeanna tástála. Is féidir leat an t-iompar seo a choigeartú leis an rogha --parallel:

\n

Linux / macOS

Shell
$ ./runtests.py basic --parallel=1\n
\n

Windows

Windows
...\\> runtests.py basic --parallel=1\n
\n

Is féidir leat an athróg comhshaoil: envvar: DJANGO_TEST_PROCESSES a úsáid freisin chun na críche seo.

\n
\n
\n
\n

Leideanna maidir le tástálacha scríLink to this heading#

\n
\n

Clárú samhail a leithliúLink to this heading#

\n

Chun truailliú a sheachaint ar an gclárlann domhanda: attr: ~django.apps.apps agus cruthú tábla gan ghá a chosc, ba cheart samhlacha a shainmhínítear i modh tástála a bheith ceangailte le sampla sealadach ``Apps`. Chun seo a dhéanamh, bain úsáid as an maisitheoir:: func: ~django.test.utils.isolate_apps:

\n
Code
from django.db import models\nfrom django.test import SimpleTestCase\nfrom django.test.utils import isolate_apps\n\n\nclass TestModelDefinition(SimpleTestCase):\n    @isolate_apps("app_label")\n    def test_model_definition(self):\n        class TestModel(models.Model):\n            pass\n\n        ...\n
\n\n
\n
","rootId":"unit-tests","toc":[{"title":"Tástálacha aonaid a rith","anchor":"running-the-unit-tests","children":[{"title":"Tosaigh gasta","anchor":"quickstart","children":[]},{"title":"Tástálacha reatha ag baint úsáide as tocs","anchor":"running-tests-using-tox","children":[{"title":"Leaganacha Python eile agus cúltaca bunachar sonraí a thástáil","anchor":"testing-other-python-versions-and-database-backends","children":[]},{"title":"Na tástálacha JavaScript a rith","anchor":"running-the-javascript-tests","children":[]}]},{"title":"Tástálacha a reáchtáil ag baint úsáide as django-docker-box","anchor":"running-tests-using-django-docker-box","children":[]},{"title":"Ag baint úsáide as modúl eile ``socruithe ``","anchor":"using-another-settings-module","children":[]},{"title":"Níl ach cuid de na tástálacha á rith","anchor":"running-only-some-of-the-tests","children":[]},{"title":"Rith na tástálacha Seiléiniam","anchor":"running-the-selenium-tests","children":[{"title":"Screenshot tests","anchor":"screenshot-tests","children":[]}]},{"title":"Na tástálacha go léir á rith","anchor":"running-all-the-tests","children":[]},{"title":"Clúdach cód","anchor":"code-coverage","children":[]}]},{"title":"Aipeanna Contrib","anchor":"contrib-apps","children":[]},{"title":"Fabhtcheartú","anchor":"troubleshooting","children":[{"title":"Crochtann nó taispeánann an tsraith tástála teipeanna ar bhrainse príomh","anchor":"test-suite-hangs-or-shows-failures-on-main-branch","children":[]},{"title":"Go leor teipeanna tástála le UnicodeEncodeError","anchor":"many-test-failures-with-unicodeencodeerror","children":[]},{"title":"Tástálacha nach dteipeann ach i gcomhcheangal","anchor":"tests-that-only-fail-in-combination","children":[]},{"title":"Ag féachaint ar na ceisteanna SQL ag rith le linn tástála","anchor":"seeing-the-sql-queries-run-during-a-test","children":[]},{"title":"Aisrianú iomlán teip tástála a fheiceáil","anchor":"seeing-the-full-traceback-of-a-test-failure","children":[]}]},{"title":"Leideanna maidir le tástálacha scrí","anchor":"tips-for-writing-tests","children":[{"title":"Clárú samhail a leithliú","anchor":"isolating-model-registration","children":[]}]}],"breadcrumbs":[{"docname":"internals/index","title":"Inmheánacha Django","url":"/ga/5.2/internals/"},{"docname":"internals/contributing/index","title":"Ag cur le Django","url":"/ga/5.2/internals/contributing/"},{"docname":"internals/contributing/writing-code/index","title":"Cód rannpháirteach","url":"/ga/5.2/internals/contributing/writing-code/"}],"prev":{"docname":"internals/contributing/writing-code/submitting-patches","title":"Ranníocaí a chur isteach","url":"/ga/5.2/internals/contributing/writing-code/submitting-patches/"},"next":{"docname":"internals/contributing/writing-code/working-with-git","title":"Ag obair le Git agus GitHub","url":"/ga/5.2/internals/contributing/writing-code/working-with-git/"},"formats":{"html":"/ga/5.2/internals/contributing/writing-code/unit-tests/","markdown":"/ga/5.2/internals/contributing/writing-code/unit-tests.md","json":"/ga/5.2/internals/contributing/writing-code/unit-tests.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/internals/contributing/writing-code/unit-tests.txt","official":"https://docs.djangoproject.com/ga/5.2/internals/contributing/writing-code/unit-tests/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}