{"title":"Satuan percobaan","version":"2.1","locale":"id","docname":"internals/contributing/writing-code/unit-tests","url":"/id/2.1/internals/contributing/writing-code/unit-tests/","canonical":"https://djangodocs.dev/id/2.1/internals/contributing/writing-code/unit-tests/","summary":"Django datang dengan deretan percobaan dia sendiri, di pelipat tests dari kode dasar. Itu kebijakan kami untuk memastikan semua percobaan selalu lolos. Kami…","html":"

Satuan percobaanLink to this heading#

\n

Django datang dengan deretan percobaan dia sendiri, di pelipat tests dari kode dasar. Itu kebijakan kami untuk memastikan semua percobaan selalu lolos.

\n

Kami menghargai apapun dan semua bantuan pada deretan percobaan!

\n

Percobaan Django semua menggunakan infrastruktur percobaan yang dikirim dengan Django untuk aplikasi percobaan. Lihat Menulis dan menjalankan percobaan untuk sebuah penjelasan bagaimana menulis percobaan baru.

\n
\n

Menjalankan satuan percobaanLink to this heading#

\n
\n

Mulai cepatLink to this heading#

\n

Pertama, fork Django on GitHub.

\n

Kedua, buat dan aktifkan lingkungan maya. Jika anda tidak akrab dengan bagaimana melakukan itu, baca contributing tutorial kami.

\n

Selanjutnya, klon fork anda, pasang beberapa persyaratan, dan jalankan percobaan:

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

Memasang membutuhkan akan sepertinya membutuhkan beberapa paket sistem operasi dimana komputer anda tidak dipasang. Anda dapat biasanya mencari tahu paket mana untuk dipasang dengan melakukan pencarian Jaringan untuk baris terakhir atau selanjutnya dari pesan kesalahan. Coba menambahkan sistem operasi anda pada permintaan pencarian jika dibutuhkan.

\n

Jika anda mempunyai masalah memasang persyaratan, anda dapat melewatkan langkah itu. Lihat Menjalankan semua percobaan untuk rincian pada memasang pilihan percobaan ketergantungan. Jika anda tidak mempunyai pilihan ketergantungan terpasang, percobaan yang membutuhkan itu akan dilewatkan.

\n

Menjalankan percobaan membutuhkan modul pengaturan Django yang menentukan basisdata untuk digunakan. Untuk membuatnya mudah dijalankan, Django menyediakan dan menggunakan contoh modul pengaturan yang menggunakan basisdata SQLite. Lihat Gunakan modul pengaturan lain untuk mempelajari bagaimana pebedaan modul pengaturan untuk menjalankan percobaan dengan basisdata berbeda.

\n\n

Mempunyai masalah? Lihat Menyelesaikan masalah untuk beberapa masalah umum.

\n
\n
\n

Menjalankan percobaan menggunakan toxLink to this heading#

\n

Tox adalah sebuah alat untuk menjalankan percobaan dalam lingkungan maya berbeda. Django menyertakan sebuah dasar tox.ini yang mengotomatisasi beberapa pemeriksaan peladen yang kami bangun melakukan pada pull request. Untuk menjalankan satuan percobaan dan pemeriksaan lain (seperti import sorting 1, the documentation spelling checker 2, dan code formatting 3), pasang dan jalankan perintah tox dari tempat manapun dalam pohon sumber Django:

\n
Shell
$ pip install tox\n$ tox\n
\n

Secara awalan, tox menjalankan rangkaian percobaan dengan gabungan berkas pengaturan percobaan untuk SQLite, flake8, isort, dan dokumentasi pemeriksa ejaan. Sebagai tambahan pada ketergantungan sistem dicatat di tempat lain dalam dokumentasi ini, perintah python3 harus berada pada jalur anda dan terkait ke versi sesuai dari Python. Daftar dari lingkungan awal dapat dilihat sebagai berikut:

\n
Shell
$ tox -l\npy3\nflake8\ndocs\nisort\n
\n
\n

Mencoba versi Python lain dan backend basisdataLink to this heading#

\n

Sebagai tambahan ke lingkungan awalan, tox mendukung menjalankan rangkaian satuan untuk versi lain dari Python dan backend basisdata lain. Sejak rangkaian percobaan Django tidak menggabungkan sebuah berkas pengaturan untuk backend basisdata selain dari SQLite, bagaimanapun, anda harus create and provide your own test settings. Sebagai contoh, untuk menjalankan percobaan pada Python 3.5 menggunakan PostgreSQL:

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

Perintah ini menyetel lingkungan maya Python 3.5, memasang ketergantungan rangkaian percobaan Django (termasuk itu untuk PostgreSQL), dan memanggil runtests.py dengan argumen didukung (dalam kasus ini, --settings=my_postgres_settings).

\n

Sisa dari dokumentasi ini menunjukkan perintah untuk menjalankan percobaan tanpa tox, bagaimanapun, pilihan apapun dilewatkan ke runtests.py dapat juga dilewatkan ke tox dengan menaruh di awalan daftar argumen dengan --, seperti diatas.

\n

Tox juga menghormati variabel lingkungan DJANGO_SETTINGS_MODULE, jika disetel. Sebagai contoh, berikut adalah setara pada perintah diatas:

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

Menjalankan percobaan JavaScriptLink to this heading#

\n

Django menyertakan sekumpulan dari JavaScript unit tests untuk fungsi-fungsi dalam aplikasi bantuan tertentu. Percobaan JavaScript tidak berjalan secara awalan menggunakan tox karena mereka membutuhkan Node.js untuk dipasang dan tidak perlu untuk tambalan-tambalan kebanyakan. Untuk menjalankan percobaan JavaScript menggunakan tox:

\n
Shell
$ tox -e javascript\n
\n

Perintah ini menjalankan npm install untuk memastikan persyaratan percobaan terperbaharui dan kemudian menjalankan npm test.

\n
\n
\n
\n

Gunakan modul pengaturan lainLink to this heading#

\n

Modul pengaturan disertakan (tests/test_sqlite.py) mengizinkan anda menjalankan deretan percobaan menggunakan SQLite. Jika anda ingin menjalankan percobaan menggunakan basisdata berbeda, anda akan butuh menentukan berkas pengaturan anda. Beberapa percobaan, seperti itu untuk contrib.postgres, adalah khusus untuk backend basisdata tertentu dan akan dilewati jika berjalan dengan backend berbeda.

\n

Untuk menjalankan percobaan dengan pengaturan berbeda, pastikan bahwa modul berada di PYTHONPATH anda dan lewati modul dengan --settings.

\n

Pengaturan DATABASES dalam modul pengaturan percobaan apapun butuh menentukan dua basisdata:

\n\n

Jika anda menggunakan backend yang bukan SQLite, anda akan butuh menyediakan rincian lain untuk setiap basisdata:

\n\n

Basisdata percobaan mendapatkan nama-nama mereka dengan mengawali test_ pada nilai dari pengaturan NAME untuk basisdata ditentukan di DATABASES. Basisdata percobaan ini dihapus ketika percobaan selesai.

\n

Anda akan juga butuh memastikan bahwa basisdata anda menggunakan UTF-8 sebagai kumpulan karakter awal. Jika peladen basisdata anda tidak menggunakan UTF-8 sebagai kumpulan karakter awal, anda akan butuh menyertakan sebuah nilai untuk CHARSET di kamus pengaturan untuk basisdata yang berlaku.

\n
\n
\n

Menjalankan hanya beberapa untuk percobaanLink to this heading#

\n

Deretan percobaan keseluruhan Django perlu waktu untuk berjalan, dan menjalankan setiap percobaan tunggal yang dapat berulang jika, katakan, anda cukup menambahkan percobaan pada Django yang anda ingin jalankan secara cepat tanpa menjalankan yang lainnya. Anda dapat menjalankan subkumpulan dari satuan percobaan dengan menambahkan nama-nama dari modul percobaan pada runtests.py di baris perintah.

\n

Sebagai contoh, jika anda ingin menjalankan percobaan hanya untuk hubungan umum dan internasionalisasi, ketik:

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

Bagaimana anda menemukan nama-nama dari percobaan perorangan? Lihat di tests/ — setiap nama pelipat ada nama dari percobaan.

\n

Jika anda hanya ingin menjalankan kelas tertentu dari percobaan, anda dapat menentukan daftar jalur-jalur dari kelas-kelas percobaan perseorangan. Sebagai contoh, untuk menjalankan TranslationTests dari modul i18n, ketik:

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

Melampaui itu, anda dapat menentukan sebuah cara percobaan perorangan seperti ini:

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

Menjalankan percobaan SeleniumLink to this heading#

\n

Beberapa percobaan membutuhkan Selenium dan perambah Jaringan. Untuk menjalankan percobaan ini, anda harus memasang paket selenium dan menjalankan percobaan dengan pilihan --selenium=<BROWSERS>. Sebagai contoh, jika anda mempunyai Firefox dan Google Chrome terpasang:

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

Lihat paket selenium.webdriver untuk daftar perambah tersedia.

\n

Menentukan --selenium otomatis menyetel --tags=selenium untuk berjalan hanya percobaan yang membutuhkan selenium.

\n
\n
\n

Menjalankan semua percobaanLink to this heading#

\n

Jika anda ingin menjalankan deretan lengkap dari percobaan, anda akan butuh memasang sejumlah ketergantungan:

\n\n

Anda dapat menemukan ketergantungan ini di pip requirements files dalam pelipat tests/requirements dari pohon sumber Django dan pasang mereka seperti itu:

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

Jika anda menjumpai sebuah kesalahan selama pemasangan, sistem anda mungkin kehilangan ketergantungan dari satu atau lebih paket-paket Python. Rundingkan dokumentasi paket-paket gagal atau cari Jaringan dengan pesan kesalahan yang anda jumpai.

\n

Anda dapat juga memasang pencocok basisdata dari pilihan anda menggunakan oracle.txt`, mysql.txt, atau postgres.txt.

\n

Jika anda ingin mencoba backend penyimpanan memcache, anda akan juga butuh menentukan pengaturan CACHES yang menunjuk pada contoh memcache anda.

\n

Untuk menjalankan percobaan GeoDjango, anda akan butuh untuk setup a spatial database and install the Geospatial libraries.

\n

Masing-masing ketergantungan ini adalah pilihan. Jika anda kehilangan salah satu dari mereka, percobaan terkait akan dilewati.

\n
\n
\n

Cakupan kodeLink to this heading#

\n

Pembantu mendorong menjalankan cakupan pada deretan percobaan untuk mencirikan kawasan yang butuh percobaan tambahan. Pemasangan alat cakupan dan penggunaan digambarkan dalam testing code coverage.

\n

Cakupan harus berjalan di pengolahan tunggal untuk mendapatkan statistik yang tepat. Untuk menjalankan cakupan pada deretan percobaan Django menggunakan pengaturan percobaan biasa:

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

Setelah menjalankan cakupan, bangkitkan laporan html dengan menjalankan:

\n
Shell
$ coverage html\n
\n

Ketika menjalankan cakupan untuk percobaan Django, pengaturan .coveragerc yang disertakan menentukan coverage_html sebagai pelipat keluaran untuk laporan dan juga mengecualikan beberapa pelipat tidak terkait pada hasil (kode percobaan atau kode dikecualikan disertakan di Django).

\n
\n
\n
\n

Aplikasi bantuanLink to this heading#

\n

Percobaan untuk aplikasi bantuan dapat ditemukan dalam pelipat tests/, khususnya dibawah <app_name>_tests. Sebagai contoh, percobaan untuk contrib.auth ditempatkan dalam tests/auth_tests.

\n
\n
\n

Menyelesaikan masalahLink to this heading#

\n
\n

Banyak percobaan gagal dengan UnicodeEncodeErrorLink to this heading#

\n

Jika paket locales tidak terpasang, beberapa percobaan akan gagal dengan UnicodeEncodeError.

\n

Anda dapat menyelesaikan pada sistem berbasis-Debian, sebagai contoh, dengan menjalankan:

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

Anda dapat menyelesaikan untuk sistem macOS dengan mengkonfigurasi lokal shell anda:

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

Jalankan perintah locale untuk menegaskan perubahan. Pilihannya, tambah perintah ekpos tersebut pada berkas awalan shell anda (sebagai contoh ~/.bashrc untuk Bash) untuk menghindari mengetik kembali mereka.

\n
\n
\n

Percobaan hanya gagal di kombinasiLink to this heading#

\n

Dalam hal sebuah percobaan lulus ketika berjalan di pemisahan tetapi gagal dalam deretan keseluruhan, kami mempunyai beberapa alat untuk membantu menganalisa masalah.

\n

Pilihan --bisect dari runtests.py akan menjalankan percobaan kegagalan selama separuh kumpulan percobaan yang dijalankan bersama-sama pada setiap putaran, sering membuatnya memungkinkan untuk mencirikan sejumlah kecil dari percobaan yang mungkin terkait terhadap kegagalan.

\n

Sebagai contoh, andaikan percobaan gagal bekerja dengan sendirinya adalah ModelTest.test_eq, lalu gunakan:

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

akan mencoba menentukan percobaan yang mencampuri dengan satu yang diberikan. Pertama, percobaan berjalan dengan babak pertama dari deretan percobaan. Jika kegagalan muncul, babak pertama dari deretan percobaan dipisah dalam dua kelompok dan setiap kelompok berjalan dengan percobaan yang ditentukan. Jika tidak ada kegagalan dengan babak pertama dari deretan percobaan, babak kedua dari deretan percobaan berjalan dengan percobaan yang ditentukan dan dipisah dengan benar seperti digambarkan di awal. Pengolahan berulang sampai kumpulan percobaan kegagalan kecil.

\n

Pilihan --pair menjalankan percobaan yang diberikan disamping setiap percobaan lain dari deretan, membiarkan anda memeriksa jika percobaan lain mempunyai efek-samping yang menyebabkan kegagal. Jadi:

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

akan memperbaiki test_eq dengan setiap label percobaan.

\n

Dengan kedua --bisect dan --pair, jika anda sudah menduga kasus mana mungkin bertanggungjawab untuk kegagalan, anda mungkin membatasi percobaan untuk dianalisa silang oleh specifying further test labels setelah satu yang pertama:

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

Anda dapat juga mencoba menjalankan kumpulan apapun dari percobaan dalam membalikkan menggunakan pilihan --reverse untuk mengecek bahwa percobaan yang dijalankan di perintah berbeda tidak menyebabkan masalah apapun:

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

Melihat permintaan SQL berjalan selama percobaanLink to this heading#

\n

Jika anda berharap menguji SQL yang sedang berjalan dalam percobaan kegagalan, anda dapat menyalakan SQL logging menggunakan pilihan --debug-sql. Jika anda menggabungkan ini dengan --verbosity=2, semua permintaan SQL akan mengeluarkan:

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

Melihat melacak kembali penuh dari kegagalan percobaanLink to this heading#

\n

Secara awal percobaan berjalan di paralel dengan satu pengolahan per inti. Ketika percobaan berjalan di paralel, bagaimanapun, anda akan hanya melihat pelacakan terpotong untuk tiap kegagalan percobaan. Anda dapat menyesuaikan kebiasaan ini dengan pilihan --parallel:

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

Anda dapat juga menggunakan variabel lingkungan DJANGO_TEST_PROCESSES untuk tujuan ini.

\n
\n
\n

Tip untuk menulis percobaanLink to this heading#

\n
\n

Mengasingkan pendaftaran modelLink to this heading#

\n

Untuk menghindari registrar apps global dan mencegah pembuatan tabel tidak diperlukan, model ditentukan dalam cara percobaan harus diikat ke instance Apps sementara:

\n
Python
from django.apps.registry import Apps\nfrom django.db import models\nfrom django.test import SimpleTestCase\n\nclass TestModelDefinition(SimpleTestCase):\n    def test_model_definition(self):\n        test_apps = Apps(['app_label'])\n\n        class TestModel(models.Model):\n            class Meta:\n                apps = test_apps\n        ...\n
\n
\n
\ndjango.test.utils.isolate_apps(*app_labels, attr_name=None, kwarg_name=None)Link to this definition#
\n
\n\n

Sejak corak ini melibatkan banyak boilerplate, Django menyediakan penghias isolate_apps(). Itu digunakan seperti ini:

\n
Python
from django.db import models\nfrom django.test import SimpleTestCase\nfrom django.test.utils import isolate_apps\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

Penghias dapat juga diberlakukan ke kelas-kelas:

\n
Python
from django.db import models\nfrom django.test import SimpleTestCase\nfrom django.test.utils import isolate_apps\n\n@isolate_apps('app_label')\nclass TestModelDefinition(SimpleTestCase):\n    def test_model_definition(self):\n        class TestModel(models.Model):\n            pass\n        ...\n
\n

Instance Apps sementara digunakan untuk mengasingkan pendaftaran model dapat ditarik sebagai sebuah atribut ketika digunakan sebagai kelas penghias dengan menggunakan parameter attr_name:

\n
Python
from django.db import models\nfrom django.test import SimpleTestCase\nfrom django.test.utils import isolate_apps\n\n@isolate_apps('app_label', attr_name='apps')\nclass TestModelDefinition(SimpleTestCase):\n    def test_model_definition(self):\n        class TestModel(models.Model):\n            pass\n        self.assertIs(self.apps.get_model('app_label', 'TestModel'), TestModel)\n
\n

Atau sebagai sebuah argumen pada cara percobaan ketika digunakan sebagai cara penghias dengan menggunakan parameter kwarg_name:

\n
Python
from django.db import models\nfrom django.test import SimpleTestCase\nfrom django.test.utils import isolate_apps\n\nclass TestModelDefinition(SimpleTestCase):\n    @isolate_apps('app_label', kwarg_name='apps')\n    def test_model_definition(self, apps):\n        class TestModel(models.Model):\n            pass\n        self.assertIs(apps.get_model('app_label', 'TestModel'), TestModel)\n
\n
\n
\n
","rootId":"unit-tests","toc":[{"title":"Menjalankan satuan percobaan","anchor":"running-the-unit-tests","children":[{"title":"Mulai cepat","anchor":"quickstart","children":[]},{"title":"Menjalankan percobaan menggunakan tox","anchor":"running-tests-using-tox","children":[{"title":"Mencoba versi Python lain dan backend basisdata","anchor":"testing-other-python-versions-and-database-backends","children":[]},{"title":"Menjalankan percobaan JavaScript","anchor":"running-the-javascript-tests","children":[]}]},{"title":"Gunakan modul pengaturan lain","anchor":"using-another-settings-module","children":[]},{"title":"Menjalankan hanya beberapa untuk percobaan","anchor":"running-only-some-of-the-tests","children":[]},{"title":"Menjalankan percobaan Selenium","anchor":"running-the-selenium-tests","children":[]},{"title":"Menjalankan semua percobaan","anchor":"running-all-the-tests","children":[]},{"title":"Cakupan kode","anchor":"code-coverage","children":[]}]},{"title":"Aplikasi bantuan","anchor":"contrib-apps","children":[]},{"title":"Menyelesaikan masalah","anchor":"troubleshooting","children":[{"title":"Banyak percobaan gagal dengan UnicodeEncodeError","anchor":"many-test-failures-with-unicodeencodeerror","children":[]},{"title":"Percobaan hanya gagal di kombinasi","anchor":"tests-that-only-fail-in-combination","children":[]},{"title":"Melihat permintaan SQL berjalan selama percobaan","anchor":"seeing-the-sql-queries-run-during-a-test","children":[]},{"title":"Melihat melacak kembali penuh dari kegagalan percobaan","anchor":"seeing-the-full-traceback-of-a-test-failure","children":[]},{"title":"Tip untuk menulis percobaan","anchor":"tips-for-writing-tests","children":[{"title":"Mengasingkan pendaftaran model","anchor":"isolating-model-registration","children":[]}]}]}],"breadcrumbs":[{"docname":"internals/index","title":"Dalam Django","url":"/id/2.1/internals/"},{"docname":"internals/contributing/index","title":"Membantu untuk Django","url":"/id/2.1/internals/contributing/"},{"docname":"internals/contributing/writing-code/index","title":"Penulisan kode","url":"/id/2.1/internals/contributing/writing-code/"}],"prev":{"docname":"internals/contributing/writing-code/coding-style","title":"Gaya pengkodean","url":"/id/2.1/internals/contributing/writing-code/coding-style/"},"next":{"docname":"internals/contributing/writing-code/submitting-patches","title":"Mengajukan tambalan","url":"/id/2.1/internals/contributing/writing-code/submitting-patches/"},"formats":{"html":"/id/2.1/internals/contributing/writing-code/unit-tests/","markdown":"/id/2.1/internals/contributing/writing-code/unit-tests.md","json":"/id/2.1/internals/contributing/writing-code/unit-tests.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/internals/contributing/writing-code/unit-tests.txt","official":"https://docs.djangoproject.com/id/2.1/internals/contributing/writing-code/unit-tests/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}