Tertarik dalam memberikan kembali ke komunitas sedikit? Mungkin anda telah menemukan kesalahan di Django yang anda ingin melihat diperbaiki, atau mungkin terdapat fitur baru yang anda ingin tambahkan.
\nMembantu kembali Django itu sendiri adalah jalan terbaik untuk melihat masalah anda sendiri ditangani. Ini mungkin terlihat menakutkan pertama kali, tetapi itu sangat mudah. Kami akan berjalan bersama anda melalui pengolahan seluruhnya, sehingga anda dapat belajar berdasarkan contoh.
\nUntuk tutorial ini, kami berharap bahwa anda mempunyai setidaknya pengertian dasar bagaimana Django bekerja. Ini berarti anda harus nyaman melalui tutorial yang ada pada menulis aplikasi Django pertama anda. Sebagai tambahan, anda harus mempunyai pemahaman bagus dari Phyton itu sendiri. Tetapi jika anda tidak, Dive Into Python adalah luar biasa (dan gratis) buku daring untuk programer pemula Phyton.
\nBagi anda yang tidak akrab dengan vesi kendali sistem dan Trac akan menemukan bahwa tutorial ini dan tautannya memasukkan informasi cukup untuk memulai. Bagaimanapun, anda akan mungkin membaca beberapa lebih alat berbeda jika anda berencana sering untuk membantu Django.
\nUntuk sebagian besar, tutorial ini mencoba menjelaskan sebanyak mungkin, sehingga itu dapat digunakan pada pendengar luas.
\n\nKami akan berjalan bersama anda dalam membantu tambakan ke Django untuk pertama kali. Pada akhir tutorial ini, anda harus mempunyai pengertian dasar dari kedua alat dan pengolahan yang terlibat. Khususnya, kami akan mencangkup berikut:
\nMemasang Git
Bagaimana mengunduh pengembangan salinan Django.
Menjalankan rangkaian percobaan Django.
Menulis percobaan untuk tambalan anda.
Menulis kode untuk tambalan anda.
Mencoba tambahan anda.
Membangkitkan berkas tambalan untuk perubahan anda.
Dimana mencari untuk informasi lebih.
Sekali anda selesai dengan tutorial, anda dapat mencari sisa Dokumentasi Django pada menyumbang. Itu mengandung banyak informasi hebat dan harus dibaca untuk siapapun yang suka menjadi penyumbang rutin ke Django. Jika anda mendapatkan pertanyaan, itu mungkin mendapatkan jawaban.
\n\n\nSebagai penyumbang, anda dapat membantu kami menjaga komunitas Django terbuka dan inklusif. Silahkan baca dan ikuti Kode Etik kami.
\nUntuk tutorial ini, anda akan membutuhkan Git terpasang untuk mengunduh versi pengembangan saat ini dari Django dan membangkitkan berkas tambalan untuk perubahan anda buat.
\nUntuk memeriksa apakah atau tidak anda telah terpasang Git, masukkan git ke baris perintah. Jika anda mendapatkan pesan dimana perintah ini tidak ditemukan, anda akan perlu mengunduh dan memasangnya, lihat Halaman unduh Git.
Jika anda tidak akrab dengan Git, anda dapat selalu menemukan lebih tentang perintahnya (pertama dia dipasang) dengan mengetik git help kedalam baris perintah.
langkah pertama untuk membantu Django adalah mendapatkan salinan dari sumber kode. Dari baris perintah, gunakan perintah cd untuk mengarah ke direktori dimana anda akan ingin salinan lokal Django berjalan.
Unduh gudang kode sumber Django menggunakan perintah berikut:
\n$ git clone https://github.com/django/django.git\nSekarang bahwa anda mempunyai salinan lokal Django, anda dapat memasangnya seperti anda akan memasang paket apapun menggunakan pip. Cara paling mudah melakukannya adalah dengan menggunakan virtual environment (or virtualenv) dimana fitur tersebut dibangun kedalam Phyton yang mengizinkan anda untuk menjaga direktori terpisah dari paket terpasang untuk setiap proyek anda sehingga mereka tidak mengganggu satu sama lain.
Adalah ide bagus untuk menjaga virtualenv anda dalam satu tempat, sebagai contoh dalam .virtualenvs/ di direktori rumah anda. Buatlah jika itu tidak ada:
$ mkdir ~/.virtualenvs\nSekarang buat virtualenv baru dengan menjalankan:
\n$ python3 -m venv ~/.virtualenvs/djangodev\nJalur dimana lingkungan baru akan disimpan ke komputer anda.
\n\n\nLangkah akhir dalam mengatur virtualenv anda adalah untuk mengaktifkannya:
\n$ source ~/.virtualenvs/djangodev/bin/activate\nJika perintah source tidak tersedua, anda dapat mencoba menggunakan titik:
$ . ~/.virtualenvs/djangodev/bin/activate\nAnda harus mengaktifkan virtualenv kapanpun anda membuka jendela terminal baru. virtualenvwrapper adalah alat berguna untuk membuat ini lebih mudah.
\nApapun anda pasang mealui pip mulai sekarang akan dipasang di virtualenv baru anda, terpencil dari lingkungan lain dan paket sistem-lebar. Juga, nama dari virtualenv yang diaktifkan saat ini ditampilkan pada baris perintah untuk membantu anda tetap melacak yang mana anda gunakan. Pergilah dan pasang salinan kloning sebelumnya dari Django:
$ pip install -e /path/to/your/local/clone/django/\nVersi terpasang dari Django sekarang menunjuk pada salinan lokal anda. Anda akan segera melihat perubahan apapun anda buat, yang merupakan bantuan hebat ketika menulis tambalan pertama anda.
\nUntuk tutorial ini, kami akan menggunakan tiket #24788 sebagai pembelajaran kasus, jadi kami akan memutar kembali sejarah versi Django di git sebelum tambalan tiket tersebut diberlakukan. Ini akan mengizinkan kami melalui semua langkah terlibat dalam penulisan tambalan dari coretan, termasuk menjalankan deretan percobaan Django.
\nIngat-ingat bahwa selama kami akan menggunakan perubahan lama dari trunk Django untuk tujuan dari tutorial dibawah, anda harus selalu menggunakan perubahan pengembangan saat ini dari Django ketika bekerja pada tambahan sendiri untuk tiket!
\n\nJelajahi kedalam direktori akar Django (itu yang mengandung django, docs, tests, AUTHORS, etc.). Anda dapat lalu memeriksa perbaikan lama Django yang akan kita gunakan dalam tutorial dibawah:
$ git checkout 4ccfc4439a7add24f8db4ef3960d02ef8ae09887\nKetika membantu Django sangat penting bahwa perubahan kode anda tidak menimbulkan kesalahan kedalam kawasan lain dari Django. Satu cara memeriksa bahwa Django masih bekerja setelah anda membuat perubahan adalah dengan menjalankan deretan percobaan Django. Jika semua percobaan masih terlewati, lalu anda dapat beralasan yakin bahwa perubahan anda tidak akan merusak Django. Jika anda tidak pernah menjalankan deretan percobaan Django sebelumnya, adalah ide bagus untuk menjalankannya sekali sebelumnya untuk mendapatkan keakraban dengan keluarannya sesuai dengan seharusnya.
\nSebelum menjalankan deretan percobaan, pasang ketergantungannya dengan pertama men cd kan kedalam direktori tests/ Django dan kemudian jalankan:
$ pip install -r requirements/py3.txt\nSekarang kita siap menjalankan deretan percobaan. Jika anda menggunakan GNU/Linux, Mac OS X atau beberapa Unix rasa lainnya, jalankan:
\n$ ./runtests.py\nSekarang duduk dan santai, Deretan percobaan keseluruhan Django telah lebih 9,600 percobaan berbeda, sehingga itu dapat diambil dimanapun dari 5 sampai 15 menit untuk berjalan, tergantung pada kecepatan komputer anda.
\nSelama deretan percobaan Django berjalan, anda akan melihat aliran karakter yang mewakili keadaan dari setiap percobaan ketika itu berjalan. E mengindikasikan bahwa sebuah kesalahan muncul selama percobaan, dan F mengindikasikan bahwa pernyataan percobaan gagal. Kedua dari ini dianggap menjadi kegagalan percobaan. Sementara itu, x dan s mengindikasikan kegagalan yang diharapkan dan melewati percobaan, masing-masing. Titik mengindikasikan lulus percobaan.
Percobaan dilewati merupakan khas karena kehilangan pustaka eksternal yang dibutuhkan untuk menjalankan percobaan; lihat Running all the tests untuk daftar ketergantungan dan pastikan memasang apapun untuk percobaan pada perubahan anda buat (kami tidak akan butuh untuk tutorial ini).
\nOnce the tests complete, you should be greeted with a message informing you\nwhether the test suite passed or failed. Since you haven't yet made any changes\nto Django's code, the entire test suite should pass. If you get failures or\nerrors make sure you've followed all of the previous steps properly. See\nMenjalankan satuan percobaan for more information. If you're using Python 3.5+,\nthere will be a couple failures related to deprecation warnings that you can\nignore. These failures have since been fixed in Django.
\nCatat bahwa trunk Django terakhir mungkin tidak selalu stabil. Ketika mengembangkan terhadap bagasi, anda dapat memeriksa Bangun terpadu lanjut Django untuk menentukan jika kegagalan spesifik ke mesin anda atau jika mereka juga hadir di bangun resmi Django. Jika anda klik untuk melihat bangun tertentu, anda dapat melihat "Konfigurasi Matrix" yang menampilkkan kegagalan dibongkar oleh versi Phyton dan backend basisdata.
\n\nDalam kebanyakan kasus, untuk tambalan diterima kedalam Django dia harus disertakan percobaan. Untuk tambalan perbaikan kesalahan, ini berarti menulis percobaan pemulihan untuk memastikan bahwa kesalahan tidak pernah diperkenalkan kembali kedalam Django kemudian. Percobaan pemulihan harus ditulis dalam cara tersebut yang dia akan gagal selama kesalahan masih ada dan lulus ketika kesalahan telah diperbaiki. Untuk tambalan mengandung fitur baru, anda akan butuh menyertakan percobaan yang memastikan fitur baru bekerja dengan benar. Mereka juga akan gagal ketika fitur baru tidak hadir, dan lalu lulus ketika dia telah diterapkan.
\nJalan baik untuk melakukannya ini adalah pertama menulis percobaan baru anda, sebelum membuat perubahan apapun ke kode. Gaya ini dari pengembangan dipanggil test-driven development dan dapat diberlakukan untuk kedua proyek keseluruhan dan tambalan tunggal. Setelah menulis percobaan anda, anda kemudian jalankan mereka untuk memastikan bahwa mereka memang gagal (sejak anda belum memperbaiki kesalahan tersebut atau ditambahkan fitur tersebut). Jika percobaan baru anda tidak gagal, anda akan butuh memperbaiki mereka sehingga mereka melakukannya. Lagipula, percobaan pemulihan yang lulus tanpa memperhatikan apakah kesalahan hadir tidak sangat membantu dalam mencegah kesalahan dari terjadi di jalan.
\nSekarang untuk contoh meneruskan kami.
\nTiket #24788 mengajukan tambahan fitur kecil: kemampuan untuk menentukan atribut tingkatan kelas awalan pada Bentuk kelas, sehingga:
[…] forms which ship with apps could effectively namespace themselves such\nthat N overlapping form fields could be POSTed at once and resolved to the\ncorrect form.\nUntuk menyelesaikan tiket ini, kami akan menambahkan atribut awalan pada kelas BaseForm. Ketika membuat instance dari kelas ini, melewati awalan ke cara __init__() akan masih menyetel awalan tersebut di instance dibuat. Tetapi tidak melewatkan awalan (atai melewati None) akan menggunakan awalan tingkatan-kelas. Sebelum kami membuat perubahan tersebut, kami akan menulis sepasang percobaan untuk mengecek bahwa perubahan fungsi kami benar dan lanjut ke fungsi benar di masa datang.
Arahkan ke pelipat tests/forms_tests/tests/ Django dan buka berkas test_forms.py. Tambah kode berikut di baris 1674 tepat sebelum fungsi test_forms_with_null_boolean
def test_class_prefix(self):\n # Prefix can be also specified at the class level.\n class Person(Form):\n first_name = CharField()\n prefix = 'foo'\n\n p = Person()\n self.assertEqual(p.prefix, 'foo')\n\n p = Person(prefix='bar')\n self.assertEqual(p.prefix, 'bar')\nPercobaan baru ini memeriksa bahwa pengaturan awalan tingkatan kelas bekerja sesuai yang diharapkan, dan bahwa melewati parameter awalan ketika membuat sebuah instance masih bekerja juga.
Ingat bahwa kita belum sebenarnya membuat perubahan apapun pada BaseForm, jadi percobaan kami akan gagal. Mari kita menjalankan semua percobaan di pelipat forms_tests untuk memastikan bahwa itu memang terjadi. Dari baris perintah, cd kedalam direktori tests/ Django dan jalankan:
$ ./runtests.py forms_tests\nJika percobaan berjalan dengan benar, anda harus melihat satu kegagalan terhubung dengan cara percobaan yang kita tambahkan. Jika semua percobaan lulus, lalu anda akan ingin memastikan bahwa anda menambahkan percobaan baru ke pelipat dan kelas yang sesuai.
\nSelanjutnya kami akan menambahkan fungsi digambarkan di tiket #24788 ke Django.
\nNavigasikan ke pelipat django/django/forms/ dan buka berkas forms.py. Temukan kelas BaseForm di baris 72 dan tambah atribut kelas awalan tepat setelah atribut field_order
class BaseForm(object):\n # This is the main implementation of all the Form logic. Note that this\n # class is different than Form. See the comments by the Form class for\n # more information. Any improvements to the form API should be made to\n # *this* class, not to the Form class.\n field_order = None\n prefix = None\nSekali anda telah selesai merubah Django, kami butuh memastikan bahwa percobaan kami tulis sebelumnya lulus, sehingga kami dapat melihat kode kami tulis diatas bekerja dengan benar. Untuk menjalankan percobaan di pelipat forms_tests, cd kedalam direktori tests/ Django dan jalankan:
$ ./runtests.py forms_tests\nUps, hal baik kami menulis percobaan tersebut! Anda harus masih melihat satu kegagalan dengan pengecualian berikut:
\nAssertionError: None != 'foo'\nKami lupa menambahkan pernyataan kondisi di cara __init__. Lanjutkan dan rubah self.prefix = prefix yang sekarang di baris 87 dari django/forms/forms.py, menambahkan pernyataan tambahan:
if prefix is not None:\n self.prefix = prefix\nJalankan-kembali percobaan dan semuanya harus lewati. Jika itu tidak, pastikan anda benar merubah kelas BaseForm seperti ditunjukkan diatas dan menyalin percobaan baru dengan benar.
Ketika anda telah memeriksa bahwa tambalan anda dan percobaan anda bekerja dengan benar, adalah ide bagus untuk menjalankan deretan percobaan Django keseluruhan hanya untuk menmeriksa bahwa perubahan anda tidak memunculkan kesalahan apapun kedalam kawasan lain Django. Ketika berhasil lulus deretan percobaan keseluruhan tidak menjamin kode anda bebas kesalahan, itu membantu mencirikan banyak kesalahan dan kemunduran yang mungkin tidak diketahui.
\nUntuk menjalankan seluruh rangkaian percobaan Django, cd kedalam direktori test/ Django dan jalankan:
$ ./runtests.py\nSelama anda tidak melihat kegagalan apapun, anda bagus untuk berjalan.
\nIni adalahfitur baru, sehingga harus didokumentasikan. Tambah bagian berikut pada baris 1068 (di akhir berkas) dari django/docs/ref/forms/api.txt:
The prefix can also be specified on the form class::\n\n >>> class PersonForm(forms.Form):\n ... ...\n ... prefix = 'person'\n\n.. versionadded:: 1.9\n\n The ability to specify ``prefix`` on the form class was added.\nSejak fitur baru ini akan berada di terbitan akan datang itu juga ditambahkan ke catatan terbitan untuk Django 1.9, di baris 164 dibawah bagian "Forms" di berkas docs/releases/1.9.txt:
* A form prefix can be specified inside a form class, not only when\n instantiating a form. See :ref:`form-prefix` for details.\nUntuk informasi lebih dalam menulis dokumen, termasuk penjelasan dari apa semua tentang bit versionadded, lihat Menulis dokumentasi. Halaman itu juga menyertakan sebuah penjelasan dari bagaimana membangun salinan dari dokumentasi secara lokal, sehingga anda dapat meninjau HTML yang akan dibangkitkan.
Sekarang waktunya membangkitkan berkas tambalan yang dapat diunggah untuk Trac atau diberlakukan ke salinan Django lainnya. Untuk mendapatkan melihat isi dari tambalan anda, jalankan perintah berikut:
\n$ git diff\nIni akan menampilkan perbedaan diantara salinan saat ini Django (dengan perubahan anda) dan versi yang anda pertama periksa sebelumnya di tutorial.
\nSekali anda telah selesai mencari tambalan, pukul kunci q untuk keluar kembali ke baris perintah. Jika isi tambalan terlihat oke, anda dapat menjalankan perintah berikut untuk menyimpan berkas tambalan ke direktori pekerjaan saat ini:
$ git diff > 24788.diff\nAnda harus mempunyai berkas di akar direktori Django disebut 24788.diff. Berkas tambalan ini mengandung semua perubahan anda dan harus seperti ini:
diff --git a/django/forms/forms.py b/django/forms/forms.py\nindex 509709f..d1370de 100644\n--- a/django/forms/forms.py\n+++ b/django/forms/forms.py\n@@ -75,6 +75,7 @@ class BaseForm(object):\n # information. Any improvements to the form API should be made to *this*\n # class, not to the Form class.\n field_order = None\n+ prefix = None\n\n def __init__(self, data=None, files=None, auto_id='id_%s', prefix=None,\n initial=None, error_class=ErrorList, label_suffix=None,\n@@ -83,7 +84,8 @@ class BaseForm(object):\n self.data = data or {}\n self.files = files or {}\n self.auto_id = auto_id\n- self.prefix = prefix\n+ if prefix is not None:\n+ self.prefix = prefix\n self.initial = initial or {}\n self.error_class = error_class\n # Translators: This is the default suffix added to form field labels\ndiff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt\nindex 3bc39cd..008170d 100644\n--- a/docs/ref/forms/api.txt\n+++ b/docs/ref/forms/api.txt\n@@ -1065,3 +1065,13 @@ You can put several Django forms inside one ``<form>`` tag. To give each\n >>> print(father.as_ul())\n <li><label for="id_father-first_name">First name:</label> <input type="text" name="father-first_name" id="id_father-first_name" /></li>\n <li><label for="id_father-last_name">Last name:</label> <input type="text" name="father-last_name" id="id_father-last_name" /></li>\n+\n+The prefix can also be specified on the form class::\n+\n+ >>> class PersonForm(forms.Form):\n+ ... ...\n+ ... prefix = 'person'\n+\n+.. versionadded:: 1.9\n+\n+ The ability to specify ``prefix`` on the form class was added.\ndiff --git a/docs/releases/1.9.txt b/docs/releases/1.9.txt\nindex 5b58f79..f9bb9de 100644\n--- a/docs/releases/1.9.txt\n+++ b/docs/releases/1.9.txt\n@@ -161,6 +161,9 @@ Forms\n :attr:`~django.forms.Form.field_order` attribute, the ``field_order``\n constructor argument , or the :meth:`~django.forms.Form.order_fields` method.\n\n+* A form prefix can be specified inside a form class, not only when\n+ instantiating a form. See :ref:`form-prefix` for details.\n+\n Generic Views\n ^^^^^^^^^^^^^\n\ndiff --git a/tests/forms_tests/tests/test_forms.py b/tests/forms_tests/tests/test_forms.py\nindex 690f205..e07fae2 100644\n--- a/tests/forms_tests/tests/test_forms.py\n+++ b/tests/forms_tests/tests/test_forms.py\n@@ -1671,6 +1671,18 @@ class FormsTestCase(SimpleTestCase):\n self.assertEqual(p.cleaned_data['last_name'], 'Lennon')\n self.assertEqual(p.cleaned_data['birthday'], datetime.date(1940, 10, 9))\n\n+ def test_class_prefix(self):\n+ # Prefix can be also specified at the class level.\n+ class Person(Form):\n+ first_name = CharField()\n+ prefix = 'foo'\n+\n+ p = Person()\n+ self.assertEqual(p.prefix, 'foo')\n+\n+ p = Person(prefix='bar')\n+ self.assertEqual(p.prefix, 'bar')\n+\n def test_forms_with_null_boolean(self):\n # NullBooleanField is a bit of a special case because its presentation (widget)\n # is different than its data. This is handled transparently, though.\nSelamat, anda telah membangkitkan tambalan Django pertama anda! Sekarang bahwa anda telah mendapatkannya dibawah sabuk anda, anda dapat menaruh keahlian tersebut dengan baik untuk memperbaiki basiskode Django. Membangkitkan tambalan dan lampirankan mereka ke tiket Trac sangat berguna, bagaimanapun, sejak kami menggunakan git - mengadopsi lebih alurkerja orientasi git sangat disarankan.
\nSejak kami tidak perbah menyerahkan perubahan secara lokal, lakukan berikut untuk mendapatkan cabang got kembali untuk titik awal yang baik:
\n$ git reset --hard HEAD\n$ git checkout master\nSebelum anda terlalu kedalam menulis tambalan untuk Django, terdapat sedikit informasi lebih di bantuan yang anda harus mungkin lihat pada:
\nAnda harus pastikan membaca dokumentasi Django di menyatakan tiket dan mengajukan tambalan. Itu melingkup tata cara Trac, bagaimana menyatakan tiket untuk anda sendiri, gaya pengkodean yang diharapkan untuk tambalan, dan banyak rincian penting lain.
Pertama kali penyumbang harus juga membaca dokumentasi untuk penyumbang pertama kali Django. Itu mempunyai banyak saran baik untuk siapa dari kita yang baru untuk dibantu dengan Django.
Setelah itu, jika anda masih terburu-buru untuk informasi lebih tentang bantuan, anda dapat selalu menjelajah melalui sisa Django's documentation on contributing. Itu mengandung ton dari informasi berguna dan harus menjadi sumber pertama anda untuk menjawab pertanyaan papun anda mungkin punya.
Ketika anda telah mencari beberapa informasi itu, anda akan siap keluar dan menemukan tiket dari milik anda untuk menulis tambalan. Perhatian khusus ke tiket dengan standar "pemetikan mudah". Tiket ini sering banyak sederhana di alam dan hebat untuk pertama kali penyumbang. Ketika anda akrab dengan membantu ke Django, anda dapat pindah ke menulis tambalan untuk tiket lebih sulit dan rumit.
\nJika anda hanya ingin segera mulai (dan tidak siapapun akan menyalahkan anda!), coba lihatlah daftar dari tiket mudah yang butuh tambalan dan tiket mudah yang mempunyai tambalan yang butuh perbaikan. Jika anda akrab dengan menulis percobaan, anda dapat juga melihat daftar tiket mudah yang butuh percobaan. Hanya ingat untuk mengikuti panduanberikut tentang menyatakan tiket yang disebutkan di tautan pada dokumentasi Django di menyatakan tiket dan mengajukan tambalan.
\nSetelah tiket mempunyai tambalan, itu butuh ditinjau dengan sekumpulan mata kedua. Setelah mengunggah tambalan atau mengajukan permintaan penarikan, pastikan untuk memperbaharui metadata tiket dengan mengatur bendera di tiket untuk mengatakan "punya tambalan", "tidak butuh percobaan", dll, sehingga lainnya dapat menemukannya untuk ditinjau. Membantu tidak perlu selalu berartu menulis tambalan dari awal. Meninjau tambalan yang ada juga sangat membantu. Lihat Mendahulukan tiket untuk rinci.
\n