Backported code for specifying settings file from OpenMalaria portal

Author: Baguage

.gitignore

@@ -72,3 +72,5 @@ apache/static/*
 
 # Sphinx documentation
 docs/build/
+
+config_local.py

README.md

@@ -89,17 +89,34 @@ DATABASES = {
 }
 ```
 
-# Production deployment checklist
+# Specifying settings file
+
+0. By default, website.settings.dev is used for manage.py and website.settings.prod is used in wsgi.py
+It is typically required to change default settings file used in manage.py in production and qa enviroments
+
+1. Exporting DJANGO_SETTINGS_MODULE variable
+
+This method works well on the command line, but it doesn't seem to work with apache - SetEnv doesn't seem to have any effect when mod_wsgi
+is initalizing wsgi application object.
+
+2. Creating config_local.py in the root folder (next to wsgi.py and manage.py)
+
+Note if DJANGO_SETTINGS_MODULE is defined, it takes precedence over settings_module in config_local.py
 
-1. Change database to PostgreSQL in settings_local.py
+Example:
+```python
+settings_module = "website.settings.qa"
+```
+Check wsgi.py and manage.py to see how it works - they are different from default versions generated by Django.
+
+
+# Production deployment checklist
 
-2. Set DEBUG to False in settings_local.py
+1. Copy config_local_example.py to config_local.py
 
-3. Generate new SECRET_KEY
- 
-4. Change ALLOWED_HOSTS and ADMINS accordingly
+2. Generate new SECRET_KEY in settings_local.py
 
-5. Set APP_ENV to 'production'
+3. Enable VecNet SSO
 
 # Enable VecNet SSO
 

config_local_example.py

@@ -0,0 +1 @@
+settings_module = "website.settings.prod"

manage.py

@@ -1,10 +1,16 @@
 #!/usr/bin/env python
 import os
 import sys
+try:
+    from config_local import settings_module
+    settings_module_message = "as defined in config_local.py file. DJANGO_SETTINGS_MODULE is ignored."
+except ImportError:
+    settings_module = "website.settings.dev"
+    settings_module_message = ""
 
 if __name__ == "__main__":
-    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "website.settings.dev")
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", settings_module)
 
     from django.core.management import execute_from_command_line
-
-    execute_from_command_line(sys.argv)
+    print("manage.py: Using settings: %s %s" % (os.environ.get("DJANGO_SETTINGS_MODULE"), settings_module_message))
+    execute_from_command_line(sys.argv)

wsgi.py

@@ -7,10 +7,16 @@
 https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/
 """
 
+
 import os
 
 from django.core.wsgi import get_wsgi_application
 
-os.environ.setdefault("DJANGO_SETTINGS_MODULE", "website.settings.prod")
+try:
+    from config_local import settings_module
+except ImportError:
+    settings_module = "website.settings.prod"
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", settings_module)
 
 application = get_wsgi_application()