Skip to main content

This Django app allows you to export certain settings to your templates.

Project description

Often it is needed to make some of your Django project’s settings accessible from within templates. This app provides a simple mechanism for doing just that.

It tries to make settings management easier by:

  • Requiring you to be explicit about what settings should be exported to templates.
  • Failing loudly if an undefined or unexported setting is accessed.

Installation

$ pip install django-settings-export

Add 'django_settings_export.export_settings' to TEMPLATE_CONTEXT_PROCESSORS in your settings.py:

TEMPLATE_CONTEXT_PROCESSORS = [
    # [...]
    'django_settings_export.export_settings',
]

Usage

All settings that should be made accessible from templates need to be explicitly listed in settings.SETTINGS_EXPORT:

# settings.py

DEBUG = True
GA_ID = 'UA-00000-0'

SETTINGS_EXPORT = [
    'DEBUG',
    'GA-ID',
]

Now you can access those exported settings from your templates via settings.<KEY>:

{% if not settings.DEBUG %}
    <script>ga('create', '{{ settings.GA_ID }}', 'auto');</script>
{% endif %}

Exceptions:

  • Listing an undefined setting key in SETTINGS_EXPORT results in an UndefinedSettingError.
  • Accessing a unexported setting key on the settings object in a template results in an UnexportedSettingError.

Development

Run tests:

$ cd demo
$ python manage.py test

Licence

BSD. See LICENCE for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-settings-export, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size django-settings-export-1.0.tar.gz (2.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page