Django-Heroku 项目教程

Django-Heroku 项目教程

django-heroku[DEPRECATED] Do not use! See https://github.com/heroku/django-heroku/issues/56项目地址:https://gitcode.com/gh_mirrors/dja/django-heroku

1. 项目的目录结构及介绍

Django-Heroku 项目的目录结构如下：

django-heroku/
├── django_heroku/
│   ├── __init__.py
│   ├── core.py
│   ├── logging.py
│   ├── settings.py
│   ├── testrunner.py
│   └── utils.py
├── LICENSE
├── MANIFEST.in
├── README.md
├── setup.cfg
├── setup.py
└── tests/
    ├── __init__.py
    ├── test_core.py
    ├── test_logging.py
    ├── test_settings.py
    └── test_testrunner.py

目录结构介绍

• django_heroku/: 包含项目的主要代码文件。
  • __init__.py: 初始化文件，使目录成为一个 Python 包。
  • core.py: 核心功能实现。
  • logging.py: 日志配置相关功能。
  • settings.py: 设置配置相关功能。
  • testrunner.py: 测试运行器相关功能。
  • utils.py: 工具函数。
• LICENSE: 项目许可证文件。
• MANIFEST.in: 包含需要包含在发布包中的文件列表。
• README.md: 项目说明文档。
• setup.cfg: 安装配置文件。
• setup.py: 安装脚本。
• tests/: 包含项目的测试文件。
  • __init__.py: 初始化文件，使目录成为一个 Python 包。
  • test_core.py: 核心功能测试。
  • test_logging.py: 日志配置测试。
  • test_settings.py: 设置配置测试。
  • test_testrunner.py: 测试运行器测试。

2. 项目的启动文件介绍

Django-Heroku 项目没有传统的启动文件，因为它主要是一个库，用于配置 Django 项目在 Heroku 上的部署。通常，用户会在自己的 Django 项目的 settings.py 文件中引入并配置 Django-Heroku。

例如：

# settings.py
import django_heroku
django_heroku.settings(locals())

这段代码会自动配置 DATABASE_URL、ALLOWED_HOSTS 等设置。

3. 项目的配置文件介绍

Django-Heroku 的配置主要通过 django_heroku.settings 函数完成。以下是一些关键配置项：

自动配置项

• DATABASE_URL: 自动配置数据库连接。
• ALLOWED_HOSTS: 自动配置允许的主机。
• STATICFILES_STORAGE: 使用 WhiteNoise 处理静态文件。
• LOGGING: 自动配置日志。

禁用功能

可以通过传递关键字参数来禁用某些自动配置：

django_heroku.settings(locals(), databases=False, test_runner=False, staticfiles=False, allowed_hosts=False, logging=False, secret_key=False)

测试运行器

可以使用 Django-Heroku 提供的测试运行器：

TEST_RUNNER = 'django_heroku.HerokuDiscoverRunner'

总结

Django-Heroku 是一个用于简化 Django 项目在 Heroku 上部署的库。通过在 settings.py 中引入并配置 django_heroku.settings，可以自动完成数据库、静态文件、日志等配置，从而简化部署过程。

django-heroku[DEPRECATED] Do not use! See https://github.com/heroku/django-heroku/issues/56项目地址:https://gitcode.com/gh_mirrors/dja/django-heroku