跳转到主要内容

将Django设置组织成多个文件和目录。轻松覆盖和修改设置。使用通配符和可选设置文件。

项目描述

django-split-settings logo


wemake.services Build Status Coverage Docs Python Version wemake-python-styleguide

将Django设置组织成多个文件和目录。轻松覆盖和修改设置。在设置文件路径中使用通配符并标记设置文件为可选。

阅读这篇博客文章获取更多信息。还可以查看这个示例项目

要求

虽然这个包可能与大多数版本的django一起工作,但我们官方不支持除最新发布版本和当前LTS版本以外的任何版本,目前是1.112.2

这个包本身没有依赖项。

如果您需要支持旧版本的python / django,则请考虑使用旧版本。

安装

pip install django-split-settings

用法

将现有的settings.py替换为组成Django设置的组件列表。最好创建一个包含所有文件的设置包。

以下是一个最小示例

from split_settings.tools import optional, include

include(
    'components/base.py',
    'components/database.py',
    optional('local_settings.py')
)

在示例中,按照顺序从名为 components/ 的子目录中包含了文件 base.pydatabase.py。如果存在,则包含同一目录下的 local_settings.py

注意:本地上下文被传递到每个文件中,因此每个后续文件都可以访问和修改前一个文件中声明的设置。

我们还制作了一个深入教程:管理 Django 设置

技巧和窍门

您可以在文件路径中使用通配符

include('components/my_app/*.py')

请注意,文件是按照 glob 返回的顺序包含的,可能和 ls -U 会列出的顺序相同。文件不是按字母顺序排列的。

您可以通过简单地导入它们来在环境设置中修改常用设置

# local_settings.py
from components.base import INSTALLED_APPS

INSTALLED_APPS += (
  'raven.contrib.django.raven_compat',
)

您想贡献吗?

阅读 CONTRIBUTING.md 文件。

版本历史

查看 CHANGELOG.md 文件。

项目详情


下载文件

下载您平台的文件。如果您不确定要选择哪一个,请了解更多关于 安装包 的信息。

源代码分发

split_settings-1.0.0.tar.gz (5.7 kB 查看哈希值)

上传时间 源代码

构建分发

split_settings-1.0.0-py3-none-any.whl (8.9 kB 查看哈希值)

上传时间 Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面