Gudang sumber kode Django

Ketika menyebarkan apliaksi Django kedalam lingkungan produksi sebenarnya, anda akan hampir selalu ingin menggunakan an official packaged release of Django.

Bagaimanapun, jika anda suka mencoba kode dalam-pengembangan dari terbitan akan datang atau menyumbang ke pengembangan Django, anda akan butuh mendapatkan salinan dari gudang kode sumber Django.

Dokumen ini mencangkup cara gudang kode ditata dan bagaimana bekerja dengan dan menemukan hal-hal di dalamnya.

Ikhtisar tingkat-tinggi

Gudang kode sumber Django menggunakan Git_ untuk melacak perubahan pada kode setiap waktu, jadi anda akan butuh salinan dari Git client (sebuah program dipanggil git) di komputer anda, dan anda akan ingin mengakrabkan diri anda dengan dasar-dasar dari bagaimana Git bekerja.

Jaringan situs Git menawarkan unduhan untuk beragam sistem operasi. Situs juga mengandung jumlah besar documentation.

Gudang Git Django bertempat daring di github.com/django/django. Itu mengandung kode sumber penuh untuk semua terbitan Django, dimana anda dapat melihat-lihat secara daring.

Gudang Git menyertakan beberapa branches:

• master mengandung kode dalam-pengembangan utama yang akan menjadi terbitan paket selanjutnya dari Django. Ini dimana kebanyakan kegiatan pengembangan terfokus.
• stable/A.B.x adalah cabang-cabang dimana persiapan terbitan kerja terjadi. Mereka juga digunakan untuk perbaikan kesalahan dan terbitan keamanan yang muncul seperlunya setlah terbitan awal dari versi fitur.

Gudang GIT juga mengandung tags. Ini adalah perbaikan benar dari paket terbitan Django yang telah diproduksi, sejak versi 1.0.

Sejumlah etiket juga ada dibawah awalan archive/ untuk archived work.

Kode sumber untuk situs jaringan Djangoproject.com dapat ditemukan pada github.com/django/djangoproject.com.

Cabang master

Jika anda suka mencoba kode dalam pengembangan untuk terbitan selanjutnya dari Django, atau jika anda suka menyumbang pada Django dengan memperbaiki kesalahan atau mengembangkan fitur baru, anda akan ingin mendapatkan kode dari cabang master.

Catat bahwa ini akan mengambil semua dari Django: sebagai tambahan paad tingkat-tinggi modul django mengandung kode Python, anda akan juga mendapatkan salinan dokumentasi Django, deretan percobaan, tulisan pemaketan dan bit bermacam-macam lainnya. Kode Django akan hadir di kloning anda sebagai pelipat dinamai django.

Untuk mencoba kode dalam-pengembangan dengan aplikasi milik anda, tempatkan direktori mengandung kloning anda pada jalur impor Python. Kemudian pernyataan import yang mencari Django akan menemukan modul django dalam kloning anda.

Jika anda akan bekerja pada kode Django (katakan, memperbaiki kesalahan atau mengembangkan fitur baru), anda dapat mungkin berhenti membaca disini dan pindah ke the documentation for contributing to Django, yang melingkupi hal-hal seeprti gaya pengkodean yang dipilih dan bagaimana membangkitkan dan mengajukan sebuah tambalan.

Cabang stabil

Django menggunakan cabang untuk menyiapkan terbitan Django. Setiap deretan terbitan utama mempunyai cabang stabil sendiri.

Cabang-cabang ini dapat ditemukan dalam gudang sebagai cabang-cabang stable/A.B.x dan akan dibuat tepat setelah alpha pertama di labeli.

Sebagai contoh, segera setelah Django 1.5 alpha 1 ditandai, cabang stable/1.5.x dibuat dan semua pekerjaan lebih jauh pada persiapan kode untuk terbitan 1.5 akhir selesai disana.

Cabang-cabang ini juga menyediakan dukungan perbaikan kesalahan dan keamanan seperti digambarkan dalam Versi didukung.

Sebagai contoh, setelah terbitan Django 1.5, cabang stable/1.5.x hanya menerima perbaikan untuk keamanan dan kesalahan kestabilan kritis, yang biasanya diterbikan ketika Django 1.5.1 dan selanjutnya, stable/1.4.x hanya menerima perbaikan keamanan dan kehilangan data, dan stable/1.3.x tidak lagi menerima pembaharuan apapun.

Riwayat informasi

Kebijakan ini untuk menangani cabang-cabang stable/A.B.x telah dipungut dimulai dengan siklus terbitan Django 1.5.

Sebelumnya, cabang-cabang ini tidak dibuat sampai benar setelah diterbitkan dan stabilisasi pekerjaan muncul pada cabang gudang utama. Dengan demikian, tidak ada pekerjaan pengembangan baru untuk terbitan selanjutnya dari Django dapat diserahkan sampai terbitan akhir terjadi.

Sebagai contoh, pendeknya setelah terbitan dari Django 1.3 cabang stable/1.3.x dibuat. Dukungan resmi untuk terbitan itu telah berakhir, dan itu tidak lagi menerima perbaikan langsung dari proyek Django. Bagaimanapun, itu dan semua cabang-cabang yang bernama mirip lanjut tetap ada, dan anggota komunitas yang tertarik terkadang menggunakan mereka untuk menyediakan dukungan tidak resmi untuk terbitan Django lama.

Tag

Setiap terbitan Django ditandai dan ditanda tangani oleh penerbit.

Etiket dapat ditemukan pada halaman tags GitHub.

Arsip pekerjaan pengembangan-fitur

Riwayat informasi

Sejak Django pindah ke Git di 2012, siapapun dapat menggandakan gudang dan membuat cabang mereka sendiri, mengurangi kebutuhan cabang-cabang resmi di gudang kode sumber.

Bagian berikut kebanyakan berguna jika anda menjelajah riwayat gudang, sebagai contoh jika anda sedang memahami bagaimana beberapa fitur telah dirancang.

Cabang-cabang pengembagan-fitur cenderung secara alami untuk sementara. Beberapa menghasilkan fitur berhasil yang menggabungkan kembali ke pemilik Django untuk menjadi bagian dari terbitan resmi, tetapi lainnya tidak; dengan kata lain, ada saatnya ketika cabang tidak lagi aktif dikerjakan oleh pengembang manapun. pada titik ini cabang dianggap ditutup.

Django biasaya dirawat dengan sistem kendali perbaikan Subversion, yang tidak memiliki cara standar dari mengindikasikan ini. Sebagai sebuah solusi, cabang-cabang Django yang ditutup dan tidak lagi dirawat dipindahkan kedalam attic.

Sejumlah etiket ada dibawah awalan 11archive/`` untuk merawat acuan ke sini dan pekerjaan dari minat riwayat.

Etiket berikut dibawah awalan archive/attic/ mengacu ujung cabang dimana kode whose code akhirnya menjadi bagian dari Django itu sendiri:

• boulder-oracle-sprint: Ditambahkan dukungan untuk basisdata Oracle pada pemeta keterhubungan-obyek Django. Ini telah menjadi bagian Django sejak terbitan 1.0.
• gis: Ditambahkan dukungan untuk permintaan geografis/spasial ke pemetaan hubungan-obyek Django. Ini telah menjadi bagian dari Django sejak terbitan 1.0, sebagai aplikasi digabung django.contrib.gis.
• i18n: Added internationalization support ke Django. Ini telah menajdi bagian dari Django sejak terbitan 0.90.
• magic-removal: Refactor utama dari kedua API internal dan umum dari pemetaan hubungan obyek Django. Ini telah menjadi bagian dari Django sejak terbitan 0.95.
• multi-auth: Refaktor dari Django's bundled authentication framework yang menambahkan dukungan untuk authentication backends. Ini telah menjadi bagian dari Django sejak terbitan 0.95.
• new-admin: Refaktor dari Django's bundled administrative application. Ini menjadi bagian dari Django mulai terbitan 0.91, tetapi telah digantikan oleh refaktor lainnya (lihat daftar selanjutnya) sebelum terbitan Django 1.0.
• newforms-admin: Refaktor kedua dari aplikasi administratif gabungan Django. Ini menjadi bagian dari Django mulai terbitan 1.0, dan adalah dasar dari jelmaan saat ini dari django.contrib.admin.
• queryset-refactor: Refaktor dari pemetaan hubungan obyek Django internal. Ini menjadi bagian dari Django mulai terbitan 1.0.
• unicode: Refaktor dari internal Django pada ketetapan menggunakan deretan karakter berbasis Unicode di kebanyakan tempat dalam Django dan aplikasi Django. Ini menjadi bagian dari Django mulai terbitan 1.0.

Selain itu, etiket berikut dibawah awalan archive/attic/ mengacu ujung cabang yang telah ditutup, tetapi kodenya tidak pernah digabungkan kedalam Django, dan fitur-ditur yang mereka tuju untuk diterapkan tidak pernah selesai:

• full-history
• generic-auth
• multiple-db-support
• per-object-permissions
• schema-evolution
• schema-evolution-ng
• search-api
• sqlalchemy

Akhirnya, dibawah awalan archive/, gudang mengandung etiket soc20XX/<project> mengacu dari ujung cabang yang digunakan oleh siswa yang bekerja pada program Django selama 2009 dan 2010 di Google Summer of Code programs.