django-perm-trans 0.1.0

A simple way to translate the permissions of your Django project.

Django permissions translation

A simple way to translate the permissions of your Django project.

Overview

This package helps you translate the permissions of your Django project.
It's very useful when you have a project with multiple languages or when you use the Django Admin for end users.

Requirements

• Python 3.8+
• Django 4.2 (tested)

Installation

pip install django-perm-trans

settings.py

INSTALLED_APPS = [
    ...
    'django_perm_trans',
    ...
]

Configuration

DJANGO_PERM_TRANS = {
    'separator': '->', # Default: '|' - Separator between words (change | to ->)
    # 'capitalize_words': True, # Default: False
    # 'remove_app': True, # Default: False
    # 'remove_model': True, # Default: False
    
    # Custom function to translate the permission and format
    # ATTENTION: This function overrides the other options
    # 'custom_function': lambda perm: perm.name, # Default: None
}

Roadmap

• Apply of capitalize in the words.
• Separator configurable.
• Remove app name from the permission.
• Remove model name from the permission.
• Custom function to translate the permission.
• Unit tests.
• Compatibility tests (Django versions).
• Use translation from database (configurable in admin).
• Command to translate the permissions from API.
• Documentation.

License

MIT