Metadata-Version: 1.1
Name: django-global-permissions
Version: 0.2.2
Summary: Implementation of permissions not related to models
Home-page: https://github.com/eduardo-matos/django-global-permissions
Author: Eduardo Matos
Author-email: eduardo.matos.silva@gmail.com
License: BSD
Description: # Django Global Permissions
        
        [![Build Status](https://travis-ci.org/eduardo-matos/django-global-permissions.svg?branch=master)](https://travis-ci.org/eduardo-matos/django-global-permissions)
        Implementation of permissions not related to models
        
        # Quickstart
        
        Install django-global-permissions:
        
        ```
        pip install django-global-permissions
        ```
        
        Add to the installed apps:
        
        ```python
        INSTALLED_APPS += (global_permissions,)
        ```
        
        If you want co create a permission in the admin interface, then head to
        the Global Permissions section, then add a permission. Pick a name (which
        should be a human readable description), a code name (which will be used throughout
        the your apps), then save it.
        
        Then open the user edit page. Now you can choose the permission you've just created.
        
        Otherwise if you want to create a permission programmatically, just import the GlobalPermission
        model and create a new permission choosing a name and a codename.
        
        ```python
        from global_permissions.models import GlobalPermission
        
        GlobalPermission.objects.create(name='My Perm', codename='my_perm')
        ```
        
        ## Putting into action!
        
        Lets say you want to verify if the logged in user can do something (based on a permission).
        In your view, you can do the following
        
        ```python
        if user.has_perm('global_permissions.my_perm_codename'):
            pass # do something intersting!
        else:
            pass # ops, you're not allowed to do that. Sorry ¯\_(ツ)_/¯
        ```
        
        If you cant to verify a permission inside some template, you can do this way:
        
        ```htmldjango
        {% if perms.global_permissions.my_perm_codename %}
            Yay!
        {% else %}
            Not so lucky...
        {% endif %}
        ```
        
        ## Upgrade
        
        If you're upgrading from version 0.1.x to version 0.2.x, you have to manually update the old contentttype model attribute to the new one. The following script may do the trick:
        
        ```python
        from django.contrib.contenttypes.models import ContentType
        
        ContentType.objects.filter(name='global_permission', app_label='global_permissions').update(model='globalpermission')
        ```
        
        This change is required on django 1.7+ to avoid a prompt asking if you wanna remove staled content types after running a migration.
        
Keywords: django-global-permissions
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
