Django-Guardian 技术文档

1. 安装指南

首先，确保您的环境中安装了 Python 3.5 或更高版本，以及支持的 Django 版本（目前为 2.2 或更高版本）。接下来，使用以下命令通过 pip 安装 Django-Guardian：

pip install django-guardian

2. 项目的使用说明

安装完成后，您需要将 Django-Guardian 集成到您的 Django 项目中。以下是集成步骤：

1. 将 'guardian' 添加到您的项目的 INSTALLED_APPS 列表中：

INSTALLED_APPS = (
    ...
    'guardian',
)

2. 在 settings.py 文件中添加额外的认证后端：

AUTHENTICATION_BACKENDS = (
    'django.contrib.auth.backends.ModelBackend', # 默认
    'guardian.backends.ObjectPermissionBackend',
)

3. 运行以下命令创建 guardian 数据库表：

python manage.py migrate

3. 项目API使用文档

使用 Django-Guardian，您可以为对象级别的权限进行操作。以下是一些基本使用的例子：

• 创建用户和组：

from django.contrib.auth.models import User, Group
jack = User.objects.create_user('jack', '[e-mail]', 'topsecretagentjack')
admins = Group.objects.create(name='admins')

• 检查用户是否具有对某个对象的特定权限：

jack.has_perm('change_group', admins)

• 分配权限给用户：

from guardian.models import UserObjectPermission
UserObjectPermission.objects.assign_perm('change_group', jack, obj=admins)

• 再次检查用户是否具有对某个对象的特定权限：

jack.has_perm('change_group', admins)

请注意，用户在全球范围内不会有 change_group 权限：

jack.has_perm('change_group')

4. 项目安装方式

Django-Guardian 的安装方式已在 "安装指南" 部分进行了说明，这里是简要回顾：

使用 pip 安装：

pip install django-guardian

确保您遵循了上述 "项目的使用说明" 中的集成步骤，以便在您的 Django 项目中使用 Django-Guardian。