django extra settings下载-django extra settings中文版下载-源码网

django-extra-settings

仅使用Django Admin进行配置和管理键入的额外设置。

安装

运行pip install django-extra-settings
将extra_settings添加到settings.INSTALLED_APPS
运行python manage.py migrate
运行python manage.py collectstatic
重新启动您的应用程序服务器
只需转到可以create ， update和delete设置的管理员即可。

用法

设置

所有这些设置都是可选的，如果未在settings.py中定义。

 # the name of the installed app for registering the extra settings admin.
EXTRA_SETTINGS_ADMIN_APP = "extra_settings"

 # the name of the cache to use, if not found the "default" cache will be used.
EXTRA_SETTINGS_CACHE_NAME = "extra_settings"

 # a list of settings that will be available by default, each item must contain "name", "type" and "value".
# check the #types section to see all the supported settings types.
EXTRA_SETTINGS_DEFAULTS = [
    {
        "name" : "SETTING_NAME" ,
        "type" : "string" ,
        "value" : "Hello World" ,
    },
    # ...
]

 # if True, settings names will be forced to honor the standard django settings format
EXTRA_SETTINGS_ENFORCE_UPPERCASE_SETTINGS = True

 # if True, the template tag will fallback to django.conf.settings,
# very useful to retrieve conf settings such as DEBUG.
EXTRA_SETTINGS_FALLBACK_TO_CONF_SETTINGS = True

 # the upload_to path value of settings of type 'file'
EXTRA_SETTINGS_FILE_UPLOAD_TO = "files"

 # the upload_to path value of settings of type 'image'
EXTRA_SETTINGS_IMAGE_UPLOAD_TO = "images"

 # if True, settings name prefix list filter will be shown in the admin changelist
EXTRA_SETTINGS_SHOW_NAME_PREFIX_LIST_FILTER = False

 # if True, settings type list filter will be shown in the admin changelist
EXTRA_SETTINGS_SHOW_TYPE_LIST_FILTER = False

 # the package name displayed in the admin
EXTRA_SETTINGS_VERBOSE_NAME = "Settings"

芹菜

警告

当将芹菜的autodiscover_tasks与force=True一起使用时，它会触发一个激进的任务发现，该发现在完全初始化之前访问Django设置。此过早访问可防止django-extra-settings正确设置其默认配置值。更多信息在这里。

行政

您可以使用EXTRA_SETTINGS_ADMIN_APP设置在另一个安装的应用程序组中显示设置模型管理员。

您还可以通过使用多个已安装的应用程序注册设置管理员并使用queryset_processor参数过滤每个应用程序设置来具有更高级的控件。

配x如果您执行以上任一项操作，则必须为每个应用程序运行将在其管理员中显示extra_settings模型管理员的迁移（因为Django甚至为代理模型创建迁移） 。

管理员高级配置示例

在您的自定义应用程序photos.admin中。Admin模块：

 from extra_settings . admin import register_extra_settings_admin

register_extra_settings_admin (
    app = __name__ ,
    queryset_processor = lambda qs : qs . filter ( name__istartswith = "PHOTOS_" ),
    unregister_default = True ,
)

在您的自定义应用程序videos.admin模块中：

 from extra_settings . admin import register_extra_settings_admin

register_extra_settings_admin (
    app = __name__ ,
    queryset_processor = lambda qs : qs . filter ( name__istartswith = "VIDEOS_" ),
    unregister_default = True ,
)

默认情况下， "extra_settings"应用程序具有其自己的管理应用程序组。

缓存

您可以使用settings.CACHES["extra_settings"]设置自定义应用程序缓存选项，否则将使用"default"缓存：

 CACHES = {
    # ...
    "extra_settings" : {
        "BACKEND" : "django.core.cache.backends.locmem.LocMemCache" ,
        "TIMEOUT" : 60 ,
    },
    # ...
}

默认情况下，使用"extra_settings"缓存，如果要使用另一个缓存，则可以使用EXTRA_SETTINGS_CACHE_NAME设置设置它。

Python

您可以以编程方式创建，读取，更新和删除设置：

类型

这是您可能需要使用的当前支持的设置类型的列表：

Setting.TYPE_BOOL
Setting.TYPE_DATE
Setting.TYPE_DATETIME
Setting.TYPE_DECIMAL
Setting.TYPE_DURATION
Setting.TYPE_EMAIL
Setting.TYPE_FILE
Setting.TYPE_FLOAT
Setting.TYPE_IMAGE
Setting.TYPE_INT
Setting.TYPE_JSON
Setting.TYPE_STRING
Setting.TYPE_TEXT
Setting.TYPE_TIME
Setting.TYPE_URL

创造

 from extra_settings . models import Setting

setting_obj = Setting (
    name = "SETTING_NAME" ,
    value_type = Setting . TYPE_STRING ,
    value = "django-extra-settings" ,
)
setting_obj . save ()

读

 from extra_settings . models import Setting

value = Setting . get ( "SETTING_NAME" , default = "django-extra-settings" )

更新

 from extra_settings . models import Setting

setting_obj = Setting (
    name = "SETTING_NAME" ,
    value_type = Setting . TYPE_BOOL ,
    value = True ,
)
setting_obj . value = False
setting_obj . save ()

删除

 from extra_settings . models import Setting

Setting . objects . filter ( name = "SETTING_NAME" ). delete ()

验证者

您可以为每个设置定义自定义验证器：

必须使用完整的Python路径来定义验证器，例如。 myapp.mymodule.my_validator 。
验证者称为传递单个参数（设置的值），如果该值有效，则应返回True ，否则返回False或None a ValidationError会提高。

模板

您可以在模板中检索设置：

{% load extra_settings %}

{% get_setting 'SETTING_NAME' default='django-extra-settings' %}

测试

您可以使用extra_settings.test.override_settings在测试过程中覆盖特定的设置。

它既可以用作装饰者，又可以用作上下文管理器：

 from extra_settings . test import override_settings

# decorator
@ override_settings ( SETTING_NAME_1 = "value for testing 1" , SETTING_NAME_2 = "value for testing 2" )
def test_with_custom_settings ( self ):
    pass

# context manager
def test_with_custom_settings ( self ):
    with override_settings ( SETTING_NAME_1 = "value for testing 1" , SETTING_NAME_2 = "value for testing 2" ):
        pass

测试

 # clone repository
git clone https://git**hub*.com/fabiocaccamo/django-extra-settings.git && cd django-extra-settings

# create virtualenv and activate it
python -m venv venv && . venv/bin/activate

# upgrade pip
python -m pip install --upgrade pip

# install requirements
pip install -r requirements.txt -r requirements-test.txt

# install pre-commit to run formatters and linters
pre-commit install --install-hooks

# run tests
tox
# or
python runtests.py
# or
python -m django test --settings " tests.settings "

执照

根据MIT许可发布。

支持

在Github上明星这个项目
在Github上关注我
?在蓝调上跟随我
?在Github上赞助我

参见

django-admin-interface默认的admin界面可由管理员本身自定义。弹出窗口被模式代替。 ??
django-cache-cleaner使用管理面板或管理命令轻松清除整个缓存或单个缓存。 ?
django-colorfield的简单颜色字段，在管理员中具有不错的颜色挑选。 ?
django-maintenance-mode - 显示维护模式打开时显示503错误页面。 ?
django-redirects完全控制的重定向。 ↪️
django-treenode可能是基于树的东西的最佳抽象模型 /管理员。 ?
python-benedict钥匙列表/键盘支持，I/O捷径（Base64，CSV，JSON，PICKLE，PLIST，PLIST，QUERY-String，Toml，XML，Yaml）和许多实用程序。
python-codicefiscale编码/解码意大利财政代码 - codifica/decodifica del codice Fiscale。 ????
python-fontbro友好的字体操作。 ?
python-fsutil懒惰开发人员的文件系统实用程序。 ?‍♂️

django extra settings