一个简单的django应用程序,用于管理鸟类繁殖群体
django-bird-colon的Python项目详细描述
鸟类群落
鸟群是一个Django应用程序,用于管理鸟群(包括繁殖群)。 你可能会发现它也可以用于非鸟类物种。还支持存储与群体中动物相关的样本信息,如基因组DNA或歌曲记录。
管理界面是用于创建和更新bird记录的主要工具,但是有越来越多的视图可用于浏览数据库和执行常见更新(如添加离合器)。还有一个json api支持各种搜索查询。
Bird Colony是根据GNU公共许可证第3版授权您使用的。有关详细信息,请参见复制
快速启动
您需要基本了解如何使用Django。
使用pip:
pip install django-bird-colony
安装包。值得一试。将
birds
和一些依赖项添加到已安装的应用程序设置中,如下所示:
INSTALLED_APPS=(...'rest_framework','django_filters','birds',)
- 在项目url.py中包含birds urlconf,如下所示:
url(r'^birds/',include('birds.urls'))
运行
python manage.py migrate
创建数据库表。如果这是一个新的django安装,请运行python migrate.py createsuperuser
来创建管理员用户。运行
python manage.py loaddata bird_colony_starter_kit
创建一些有用的初始记录。启动开发服务器(
python manage.py runserver
)并访问http://127.0.0.1:8000/admin/birds/ 建立殖民地,如下一节所述访问http://127.0.0.1:8000/birds/以使用视图。
如果您非常关心安全性,请务必查阅django的部署文档。
初始设置
这是一项正在进行的工作。在你开始进入鸟类和活动之前,你需要 使用django管理应用程序设置一些表。
所需步骤:
- 编辑
Species
表中的物种记录。这个bird_colony_starter_kit
装置将为斑马雀创建一个记录。code
字段用于给动物命名,因此如果您有斑马雀并且使用zebf
作为代码,那么您的鸟将被命名为zebf_red_1
等等。 - 编辑位置并将其添加到
Locations
表中您需要至少创建一个位置。此字段的主要用途是通过查看最后一个事件来查找鸟的位置。 - 在
Status codes
表中编辑并创建新的事件类型。常见的事件类型包括hatched
、added
、moved
、died
、used for anatomy
等。对于每个状态代码,指示它是添加鸟还是从群集中删除鸟。当您创建移除鸟的事件时,它将显示为不再活动。hatched
事件是特殊的,因为如果使用此代码使用Add new bird
视图将鸟添加到数据库中,系统将要求您输入鸟的父级。(如果您不知道鸟的父母,可以在管理界面中手动创建)
可选步骤:
- 如果您的波段是彩色的,请将您的颜色添加到
Colors
表中。这会影响你的动物的简称 - 如果要向数据库中添加示例,请在管理界面中添加或编辑
Sample locations
和Sample types
。 - 向数据库中添加其他用户。如果您希望允许特定用户保留动物,这一点特别有用
- 如果您想更改一些输入表单上的样板文本,则需要从源代码安装应用程序。模板位于源目录中的
birds/templates/birds
下。
变更日志
在0.4.0版本中,动物记录的主键变成了动物的uuid要从以前的版本迁移,数据必须在0.3.999版本下导出为json,然后在0.4.0版本下导入