django-constance-trbs 0.7.9

分叉

这是原始django-constance项目的分叉，可在以下位置找到

https://github.com/comoga/django-constance

分叉的主要原因是为了使django-constance与Django 1.4+兼容性修复可pip安装。

希望我们能够尽快将此分叉合并回官方仓库。

它还添加了使用缓存版本配置对象的功能。如果在非常频繁查找（每秒很多次）的情况下使用constance，则更倾向于使用值缓存版本，该版本会定期刷新。

功能

• 轻松将静态设置迁移到动态设置。

• 管理界面用于编辑动态设置。

安装

从PyPI安装django-constance后端特定版本

对于（默认）Redis后端

pip install django-constance[redis]

对于数据库后端

pip install django-constance[database]

或者 - 如果您确信依赖项已经安装，您也可以运行

pip install django-constance-trbs

或者使用

pip

pip install -e git+git://github.com/trbs/django-constance-trbs#egg=django-constance-trbs

配置

修改您的 settings.py。将 'constance' 添加到您的 INSTALLED_APPS 中，并将您想转换为动态设置的每个键移动到 CONSTANCE_CONFIG 部分，如下所示

INSTALLED_APPS = (
    ...
    'constance',
)

CONSTANCE_CONFIG = {
    'MY_SETTINGS_KEY': {
        'default': 42,
        'help_text': 'the answer to everything'
    },
}

在这里，42 是当在后端找不到时，键 MY_SETTINGS_KEY 的默认值。帮助文本将在管理员中显示。

如果您不希望在管理员中按字母顺序排序设置，则可以使用 django.utils.datastructures.SortedDict 或 collections.OrderedDict 用于 CONSTANCE_CONFIG。

请参阅后端部分了解如何设置后端。

CONSTANCE_BACKEND = 'constance.backends.redisd.RedisBackend'

CONSTANCE_BACKEND = 'constance.backends.database.DatabaseBackend'

INSTALLED_APPS = (
    # other apps
    'constance.backends.database',
)

pip install django-picklefield

CONSTANCE_DATABASE_CACHE_BACKEND = 'memcached://127.0.0.1:11211/'

CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
        'LOCATION': '127.0.0.1:11211',
    }
}
CONSTANCE_DATABASE_CACHE_BACKEND = 'default'

CONSTANCE_DATABASE_PREFIX = 'constance:myproject:'

使用方法

Constance 可以从您的 Python 代码和 Django 模板中调用。

• Python

  访问配置变量就像导入配置对象并使用属性查找访问变量一样简单。

  from constance import config
  
  # ...
  
  if config.MY_SETTINGS_KEY == 42:
      answer_the_question()

• Django 模板

  要从模板访问配置对象，您可以将其传递到模板上下文

  from django.shortcuts import render
  from constance import config
  
  def myview(request):
      return render(request, 'my_template.html', {'config': config})

  或者，您可以使用包含的配置上下文处理器。

  TEMPLATE_CONTEXT_PROCESSORS = (
      # ...
      'constance.context_processors.config',
  )

  这将把配置实例添加到使用 RequestContext 渲染的任何模板的上下文中。

  然后，在您的模板中，您可以像引用任何其他变量一样引用配置值，例如。

  <h1>Welcome on {{ config.SITE_NAME }}</h1>
  {% if config.BETA_LAUNCHED %}
      Woohoo! Head over <a href="/sekrit/">here</a> to use the beta.
  {% else %}
      Sadly we haven't launched yet, click <a href="/newsletter/">here</a>
      to signup for our newletter.
  {% endif %}

截图

变更日志