Django源代码库

将Django应用程序部署到真正的生产环境中时,几乎总是要使用官方打包版本的Django

但是,如果您想试用即将发布的版本中的开发代码或为Django的开发作出贡献,则需要获取Django源代码存储库的克隆。

本文档涵盖了代码库的布局方式以及如何使用和查找内容。

高级概述

The Django source code repository uses Git to track changes to the code over time, so you’ll need a copy of the Git client (a program called git) on your computer, and you’ll want to familiarize yourself with the basics of how Git works.

Git的网站提供各种操作系统的下载。 该网站还包含大量的文档

Django Git仓库位于github.com/django/django的在线。 它包含所有Django版本的完整源代码,您可以在线浏览。

Git仓库包含几个分支

  • master包含主要的开发代码,它将成为Django的下一个打包版本。 这是大多数发展活动的重点。
  • stable/A.B.x are the branches where release preparation work happens. 它们也用于在功能版本的初始版本之后根据需要发生的错误修复和安全版本。
  • soc20XX/<project> branches were used by students who worked on Django during the 2009 and 2010 Google Summer of Code programs.
  • attic/<project>分支用于开发主要的或实验性的新功能,而不影响Django的其他代码。

Git仓库还包含标签 这些是从1.0版本开始生成包装Django版本的确切修订版本。

The source code for the Djangoproject.com website can be found at github.com/django/djangoproject.com.

主分支

如果您想尝试下一个Django发行版的开发代码,或者想要通过修复错误或开发新功能来为Django做贡献,则需要从主分支中获取代码。

Note that this will get all of Django: in addition to the top-level django module containing Python code, you’ll also get a copy of Django’s documentation, test suite, packaging scripts and other miscellaneous bits. Django的代码将作为名为django的目录存在于您的克隆中。

要使用您自己的应用程序试用开发代码,只需将包含您的克隆的目录放置在Python导入路径中。 然后,用于查找Django的import语句将在您的克隆中找到django模块。

如果你打算使用Django的代码(比如修复一个bug或者开发一个新的特性),那么你可能会停下来阅读,然后转到the documentation for contributing to Django,涵盖了喜欢的编码风格以及如何生成和提交补丁等内容。

其他分支

Django使用分支来准备释放Django。

在Django托管在Subversion的过去,分支也被用于特性开发。 现在,Django托管在Git上,功能开发是在贡献者的分支上完成的,但Subversion特性分支仍然保留在Git中供历史参考。

稳定的分支

这些分支可以作为stable/A.B.x分支在存储库中找到,并且将在第一个alpha被标记后立即创建。

例如,紧接在Django 1.5 alpha 1标签之后,创建了分支stable/1.5.x,并且完成了为最终的1.5版本准备代码的所有工作那里。

这些分支机构还为最近发布的Django版本提供了有限的bug修复支持,并为最近发布的两个版本的Django提供了安全支持。

例如,在Django 1.5发布之后,分支stable/1.5.x只接收修补程序的安全性和临界稳定性错误,最终以Django 1.5.1等等stable/1.4.x仅接收安全修复程序,stable/1.3.x不再接收任何更新。

历史信息

这个处理stable/A.B.x分支的策略是从Django 1.5发布周期开始的。

以前,这些分支直到版本发布之后才被创建,并且主存储库分支上发生了稳定工作。 因此,在下一个版本的Django中没有新的功能开发工作可以在最终发布之前进行。

例如,在Django 1.3发布后不久,分支stable/1.3.x被创建。 对该版本的官方支持已经过期,因此不再接受来自Django项目的直接维护。 然而,所有其他类似命名的分支仍然存在,感兴趣的社区成员偶尔使用它们来提供对Django旧版本的非官方支持。

功能开发分支

历史信息

自从2012年Django转移到Git以来,任何人都可以克隆存储库并创建自己的分支机构,从而减轻对源代码库中官方分支的需求。

如果您正在探索存储库的历史记录,那么以下部分最为有用,例如,如果您想了解某些功能是如何设计的。

功能开发分支的性质往往是暂时的。 一些产生了成功的特性,这些特性被合并到Django的主人当中,成为官方发布的一部分,但其他人却没有;在这两种情况下,都有一段时间,分支机构不再由任何开发人员积极开展工作。 此时该分支被认为是关闭的。

不幸的是,Django过去一直使用Subversion版本控制系统进行维护,没有标准的方式来表示这一点。 作为一种解决方法,Django的分支已经关闭,不再维护,它们被移动到attic中。

作为参考,以下是其代码最终成为Django本身的一部分的分支,因此不再单独维护:

  • boulder-oracle-sprint: Added support for Oracle databases to Django’s object-relational mapper. 自从1.0版本以来,这已经是Django的一部分了。
  • gis: Added support for geographic/spatial queries to Django’s object-relational mapper. 自从1.0版本以来,这已经是Django的一部分,作为捆绑的应用程序django.contrib.gis
  • i18n: Added internationalization support to Django. 这是自0.90版本以来Django的一部分。
  • magic-removal:对Django的对象关系映射器的内部和公共API进行了重大的重构。 这是自0.95发布以来Django的一部分。
  • multi-auth: A refactoring of Django’s bundled authentication framework which added support for authentication backends. 这是自0.95发布以来Django的一部分。
  • new-admin: A refactoring of Django’s bundled administrative application. 在0.91版本中这成为了Django的一部分,但在Django 1.0版本之前被另一个重构(参见下一个列表)所取代。
  • newforms-admin:Django捆绑管理应用程序的第二个重构。 This became part of Django as of the 1.0 release, and is the basis of the current incarnation of django.contrib.admin.
  • queryset-refactor: A refactoring of the internals of Django’s object-relational mapper. 从1.0版本开始,这成为了Django的一部分。
  • unicode:Django内部的重构,在Django和Django应用程序中的大部分地方始终使用基于Unicode的字符串。 从1.0版本开始,这成为了Django的一部分。

当Django从SVN转移到Git时,关于分支合并的信息没有保存在源代码库中。 这意味着Django的master分支不包含上述分支的合并提交。

然而,这个信息是作为移植文件 您可以通过在本地克隆的.git/info/grafts中放置以下行来恢复它:

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

另外,下面的分支也关闭了,但是他们的代码从来没有合并到Django中,他们实现的功能从未完成:

  • 全史
  • 通用-AUTH
  • 多数据库支持
  • 每个对象的权限
  • 架构演进
  • 架构演进-NG
  • 搜索API
  • SQLAlchemy的

所有上述分支现在都住在attic

最后,资源库包含用于Google Summer of Code项目的soc2009/xxxsoc2010/xxx功能分支。

标记¶ T0>

每个Django版本都由发布者进行标记和签名。

这些标签可以在GitHub的标签页面上找到。