https://github.com/vintasoftware/django-role-permissions

A django app for role based permissions.
https://github.com/vintasoftware/django-role-permissions

django permissions python roles

Last synced: 1 day ago
JSON representation

A django app for role based permissions.

• Host: GitHub
• URL: https://github.com/vintasoftware/django-role-permissions
• Owner: vintasoftware
• License: mit
• Created: 2013-10-07T16:13:02.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2023-06-09T20:31:34.000Z (over 1 year ago)
• Last Synced: 2024-10-29T20:56:35.426Z (3 months ago)
• Topics: django, permissions, python, roles
• Language: Python
• Homepage: http://django-role-permissions.readthedocs.org/
• Size: 214 KB
• Stars: 729
• Watchers: 44
• Forks: 115
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

• awesome-django - django-role-permissions - Django app for role-based permissions management. (Third-Party Packages / Permissions)
• awesome-django-security - Django Role Permissions
• starred-awesome - django-role-permissions - A django app for role based permissions. (Python)

README

        
# django-role-permissions

[![Build Status](https://github.com/vintasoftware/django-role-permissions/actions/workflows/build.yml/badge.svg)](https://github.com/vintasoftware/django-role-permissions/actions/workflows/build.yml)

[![Coverage Status](https://coveralls.io/repos/github/vintasoftware/django-role-permissions/badge.svg?branch=master)](https://coveralls.io/github/vintasoftware/django-role-permissions?branch=master)

[![Current version at PyPI](https://img.shields.io/pypi/v/django-role-permissions.svg)](https://pypi.python.org/pypi/django-role-permissions)

![Supported Python Versions](https://img.shields.io/pypi/pyversions/django-role-permissions.svg)

``django-role-permissions`` is a django app for role based permissions. It's built on top of django ``contrib.auth`` user ```Group``` and ``Permission`` functionalities and it does not add any other models to your project.  

``django-role-permissions`` supports Django versions from 1.5 until the latest.

Version 2.x now supports multiple roles!

## Documentation

Documentation is available at:

[http://django-role-permissions.readthedocs.org/](http://django-role-permissions.readthedocs.org/)

If you are still using the 1.x version the old documentation is at:

[http://django-role-permissions.readthedocs.io/en/1.x/](http://django-role-permissions.readthedocs.io/en/1.x/)

## Running tests

This packages uses `tox` to run tests on multiple evironments, please make sure they are passing before submitting a pull request.

To run tests, install tox and run it in the command line from this project's folder:

``$ tox``

## Maintainers

### How to Release:

#### Pre release:

- Include the changes in `CHANGELOG`

- Update the version in `rolepermissions/__init__.py`

- Update the classifiers in `setup.py`

#### Release:

- Run the github action [release](https://github.com/vintasoftware/django-role-permissions/actions/workflows/release.yml)

#### Post release:

- Check if docs were updated at [readthedocs](http://django-role-permissions.readthedocs.org/).

## Help

If you have any questions or need help, please send an email to: [email protected]

## Commercial Support

[![alt text](https://avatars2.githubusercontent.com/u/5529080?s=80&v=4 "Vinta Logo")](https://www.vinta.com.br/)

This project is maintained by [Vinta Software](https://www.vinta.com.br/) and is used in products of Vinta's clients. We are always looking for exciting work, so if you need any commercial support, feel free to get in touch: [email protected]

Copyright (c) 2019 Vinta Serviços e Soluções Tecnológicas Ltda.

[MIT License](LICENSE.txt)