Metadata-Version: 1.1
Name: django-admin-conf-vars
Version: 0.1
Summary: A simple Django app to have configuration variables for your project with the Django admin.
Home-page: https://github.com/maoaiz/django-admin-conf-vars
Author: Mauricio Aizaga
Author-email: mauricioaizaga@gmail.com
License: BSD License
Description: # Django Administrable configuration varialbes
        The django `django_admin_conf_vars` app allows you to have configuration variables for your project with the Django admin
        
        
        ### Installation
        
        1. Install from [pypi](https://pypi.python.org/pypi/django-admin-conf-vars): `pip install django-admin-conf-vars`
        
        2. Add `django_admin_conf_vars` to your INSTALLED_APPS
        
        3. Migrate `python manage.py migrate`
        
        4. Create a file 'my_settings_conf.py' next to your settings.py and define your variables
            ```python
            from django_admin_conf_vars.global_vars import config
            config.set("MY_TIME_VAR", default=60)
            config.set("MY_OTHER_VAR", default="/some/path")
            ```
        
        5. Add to your settings.py file:
            ```python
            GLOBAL_VARS_PATH = 'my_settings_conf'
            ```
        The variable GLOBAL_VARS_PATH must to have the name of your new file (point 4)
        
        Ready! Now you have configuration variables with [django admininistration](http://localhost:8000/admin/django_admin_conf_vars/confvar/).
        
        ### Differences between normal settings variables and django_admin_conf_vars
        ----
        
        #### Normal:
        Your vars in the  settings.py
        
        ```python
        MY_TIME_VAR =  60
        MY_OTHER_VAR = "/some/path"
        ```
        
        Using your vars in a view.py
        ```python
        from django.conf import settings
        
        def my_view(request):
            ...
            a = settings.MY_TIME_VAR
            b = settings.MY_OTHER_VAR
        ```
        
        Conclusion: You have static variables written in your settings.py
        
        but... what happen if you want to edit some of those variables in production? You need to edit the settings and reload your server. (Ͼ˳Ͽ)..!!!
        
        #### With django_admin_conf_vars
        You writte your variables and use them like normal usage.
        
        Your vars in my_var_settings_file.py
        
        ```python
        from django_admin_conf_vars.global_vars import config
        
        config.set("MY_TIME_VAR", default=60)
        config.set("MY_OTHER_VAR", default="/some/path")
        ```
        
        And using your vars in a view.py
        ```python
        from django_admin_conf_vars.global_vars import config
        
        def my_view(request):
            ...
            a = config.MY_TIME_VAR
            b = config.MY_OTHER_VAR
        ```
        
        Now you can edit those variables with the [django admin](http://localhost:8000/admin/django_admin_conf_vars/confvar/):
        
        
        
        ### Author
        Created by [Mauricio Aizaga](https://github.com/maoaiz)
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
