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.
  • Cabang soc20XX/<project> telah digunakan oleh pelajar yang bekerja di Django selama 2009 dan 2010 program Google Summer of Code.
  • Cabang attic/<project> telah digunakan untuk mengembangkan fitur baru utama atau percobaan tanpa mempengaruhi sisa kode Django.

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

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 anda sendiri, cukup tempatkan pelipat mengandung kloningan anda pada jalur impor Python anda . lalu pernyataan import yang mencari Django akan menemukan modul django dalam kloningan 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 lainnya

Django menggunakan carang untuk mempersiapkan terbitan Django.

Di masa lampau Django disimpan di Subversion, cabang-cabang juga digunakan untuk pengembangan akan datang. Sekarang Django disimpan di Git dan pengembangan fitur selesai pada persimpangan penyumbang, tetapi cabang fitur Subversion di Git untuk riwayat acuan.

Cabang stabil

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 terbatas untuk versi terbitan paling terbaru dari Django dan dukungan keamanan untuk dua versi terbitan paling terbaru dari Django.

Sebagai contoh, setelah terbitan Django 1.5, cabang stable/1.5.x hanya menerima perbaikan untuk keamanan dan kesalahan kestabilan kritis, yang nantinya diterbitkan sebagai Django 1.5.1 dan selanjutnya, stable/1.4.x hanya menerima perbaikan keamanan, dan stable/1.3.x tidak lagi menerima perbaharuan 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 tepat setelah terbitan dan stabilisasi pekerjaan muncul pada cabang gudang utama. Dengan demikian, fitur baru pengembangan bekerja untuk terbitan selanjutnya dari Django dapat di perbaiki sampai terbitan akhir terjadi.

Sebagai contoh, sesaat setelah terbitan Django 1.3 cabang stable/1.3.x dibuat. Dukungan resmi untuk terbitan itu telah kadaluarsa, dan sehingga itu tidak lagi menerima perawatan langsung dari proyek Django. Bagaimanapun, itu dan semua lainnya sama halnya cabang-cabang bernama melanjutkan ke anggota komunitas yang ada dan tertarik terkadang menggunakan mereka menyediakan dukungan tidak resmi untuk terbitan Django lama.

Cabang pengembangan akan datang

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 pengembangan akan datang cenderung menurut sifatnya bersifat sementara. Beberapa menghasilkan fitur-fitur sukses yang digabung kembali ke dalam amster Django untuk menjadi bagian dari terbitan resmi, tetapi lainnya tidak; dalam kasus kedua ada saatnya ketika cabang tidak lagi menjadi aktif bekerja pada pengembang manapun. Pada titik ini cabang dipertimbangkan ditutup.

Sayangnya, Django biasanya dirawat dengan sistem kendali perubahan Subversion, yang tidak memiliki cara standar dari menandakan ini. Sebagai pemecahan masalah, cabang-cabang dari Django yang ditutup dan tidak lagi dirawat dipindahkan kedalam attic.

Untuk acuan, ikuti cabang-cabang yang kodenya akhirnya menjadi bagian dari Django itu sendiri, dan dipelihara tidak lagi secara terpisah:

  • 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.

Ketika Django pindah dari SVN ke Git, informasi tentang penggabungan cabang tidak dipertahankan dalam gudang kode sumber. Ini berarti bahwa cabang master dari Django tidak mengandung penggabungan perbaikan untuk cabang-cabang diatas.

Bagaimanapun, informasi ini available as a grafts file. Anda dapat menyimpan kembali dengan menaruh baris berikut di .git/info/grafts dalam kloning lokal anda:

ac64e91a0cadc57f4bc5cd5d66955832320ca7a1 553a20075e6991e7a60baee51ea68c8adc520d9a 0cb8e31823b2e9f05c4ae868c19f5f38e78a5f2e
79e68c225b926302ebb29c808dda8afa49856f5c d0f57e7c7385a112cb9e19d314352fc5ed5b0747 aa239e3e5405933af6a29dac3cf587b59a099927
5cf8f684237ab5addaf3549b2347c3adf107c0a7 cb45fd0ae20597306cd1f877efc99d9bd7cbee98 e27211a0deae2f1d402537f0ebb64ad4ccf6a4da
f69cf70ed813a8cd7e1f963a14ae39103e8d5265 d5dbeaa9be359a4c794885c2e9f1b5a7e5e51fb8 d2fcbcf9d76d5bb8a661ee73dae976c74183098b
aab3a418ac9293bb4abd7670f65d930cb0426d58 4ea7a11659b8a0ab07b0d2e847975f7324664f10 adf4b9311d5d64a2bdd58da50271c121ea22e397
ff60c5f9de3e8690d1e86f3e9e3f7248a15397c8 7ef212af149540aa2da577a960d0d87029fd1514 45b4288bb66a3cda401b45901e85b645674c3988
9dda4abee1225db7a7b195b84c915fdd141a7260 4fe5c9b7ee09dc25921918a6dbb7605edb374bc9 3a7c14b583621272d4ef53061287b619ce3c290d
a19ed8aea395e8e07164ff7d85bd7dff2f24edca dc375fb0f3b7fbae740e8cfcd791b8bccb8a4e66 42ea7a5ce8aece67d16c6610a49560c1493d4653
9c52d56f6f8a9cdafb231adf9f4110473099c9b5 c91a30f00fd182faf8ca5c03cd7dbcf8b735b458 4a5c5c78f2ecd4ed8859cd5ac773ff3a01bccf96
953badbea5a04159adbfa970f5805c0232b6a401 4c958b15b250866b70ded7d82aa532f1e57f96ae 5664a678b29ab04cad425c15b2792f4519f43928
471596fc1afcb9c6258d317c619eaf5fd394e797 4e89105d64bb9e04c409139a41e9c7aac263df4c 3e9035a9625c8a8a5e88361133e87ce455c4fc13
9233d0426537615e06b78d28010d17d5a66adf44 6632739e94c6c38b4c5a86cf5c80c48ae50ac49f 18e151bc3f8a85f2766d64262902a9fcad44d937

Tambahannya, cabang-cabang berikut ditutup, tetapi kode mereka tidak pernah digabung kedalam Django dan fitur-fitur mereka tuju untuk menerapkan tidak pernah selesai:

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

Semua cabang-cabang yang disebutkan diatas sekarang berada di attic.

Akhirnya, gudang mengandung fitur cabang soc2009/xxx dan soc2010/xxx, digunakan untuk proyek Google Summer of Code.

Tag

Setiap terbitan Django ditandai dan ditanda tangani oleh penerbit.

Etiket dapat ditemukan pada halaman tags GitHub.

Back to Top