A Django interactive command for configuration file generation.
Project description
django-settings-custom
A Django interactive command for configuration file generation.
Getting It
pip install django-settings-custom
Installing It
To enable django_settings_custom
in your project you need to add it to INSTALLED_APPS
in your projects
settings.py
file:
INSTALLED_APPS = (
...
'django_settings_custom',
...
)
Using It
Create a template for your target conf.ini like
[DATABASE]
NAME = { USER_VALUE }
HOST = { USER_VALUE }
PORT = { USER_VALUE }
[DATABASE_CREDENTIALS]
USER = { USER_VALUE }
PASSWORD = { ENCRYPTED_USER_VALUE }
[DJANGO]
KEY = { DJANGO_SECRET_KEY }
# A constant field
[LDAP]
LDAPGRP = 'ldaps://myldap'
Add settings.py
file
SETTINGS_TEMPLATE_FILE = 'PATH_TO_YOUR_TEMPLATE_CONFIGURATION_FILE'
SETTINGS_FILE_PATH = 'TARGET_FOR_CONFIGURATION_FILE'
Launch in command line
python manage.py generate_settings
Results
The command ask user to fill missing values from template:
[user@localhost a_project]$ ./manage.py generate_conf
** Configuration file generation: **
** Configuration file generation: **
Do you want to generate the secret key for Django ? (Y/n) : y
Django secret key generated
** Enter values for configuration file content **
Value for [DATABASE] NAME: database_name
Value for [DATABASE] HOST: database_host
Value for [DATABASE] PORT: 900
Value for [DATABASE_CREDENTIALS] USER: my_user
Value for [DATABASE_CREDENTIALS] PASSWORD (will be encrypted): my_pass
Writing file at /home/user/a_project/conf.ini:
Configuration file successfully generated.
[user@localhost a_project]$
It generates the file /home/user/a_project/conf.ini:
[DATABASE]
NAME = database_name
HOST = database_host
PORT = 900
[DATABASE_CREDENTIALS]
USER = my_user
PASSWORD = JbAwLj5Zwz8lMrvcUZq5sP/v6eaUFY5E7U8Fmg63vxI=
# A constant field
[LDAP]
LDAPGRP = 'ldaps://monldap'
[DJANGO]
KEY = w)r13ne4=id9_8xdojir)3)%%5m3r$co#jwj_)4d*_%%!0+f#sro
Customization
Don't use Django settings
If you want add variables to your Django settings file, you can inherit generate_settings.Command
to specify command options :
from django_settings_custom.management.commands import generate_settings
class Command(generate_settings.Command):
settings_template_file = 'The/settings/template/file_path.ini'
settings_file_path = 'The/target/settings/file_path.ini'
Adding custom tag
To add a custom tag, you can inherit generate_settings.Command
and override the method get_value
:
import random
from django_settings_custom.management.commands import generate_settings
class Command(generate_settings.Command):
@staticmethod
def get_value(section, key, value_type, secret_key):
if value_type == 'RANDOM_VALUE':
return random.uniform(0, 100)
return super(Command, Command).get_value(section, key, value_type, secret_key)
Or a little more complex example :
from django.core.management.base import CommandError
from django_settings_custom.management.commands import generate_settings
class Command(generate_settings.Command):
@staticmethod
def get_value(section, key, value_type, secret_key):
int_less_10 = value_type == 'INT_LESS_THAN_10'
if int_less_10:
value_type = 'USER_VALUE'
value = super(Command, Command).get_value(section, key, value_type, secret_key)
if int_less_10:
try:
value = int(value)
if value >= 10:
raise CommandError('This field needs an int less than 10.')
except ValueError:
raise CommandError('This field needs an int.')
return value
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-settings-custom-1.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f39ffc7c4f4ab70ddee4eeaea8410ec76dc402035b8486fdc6c9cadcb318ba19 |
|
MD5 | b77712bd0ba808f04f9b3a1de00872bf |
|
BLAKE2b-256 | 6f323052f8cf440408b5e6dad9b893c88fa3f8cc76a70bd0a1186222a2f54f57 |
Hashes for django_settings_custom-1.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7831bd5ff68431caca6f1d65297d5df736a6f2dfc5c969f1a87bd37fae149f3c |
|
MD5 | 001986d5eecbb57e1c166794d180369e |
|
BLAKE2b-256 | 9e934278369bc8090affc06d152286a6c134226a40b85a7d8edd5265a1998f1b |