Django-Authority 项目教程

Django-Authority 项目教程

django-authorityA Django app that provides generic per-object-permissions for Django's auth app and helpers to create custom permission checks.项目地址:https://gitcode.com/gh_mirrors/dj/django-authority

1. 项目的目录结构及介绍

Django-Authority 项目的目录结构如下：

django-authority/
├── AUTHORS
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── MANIFEST.in
├── README.rst
├── coveragerc
├── django_authority.egg-info/
├── docs/
├── example/
├── setup.cfg
├── setup.py
├── tox.ini
└── authority/
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── checks.py
    ├── fields.py
    ├── forms.py
    ├── management/
    ├── migrations/
    ├── models.py
    ├── permissions.py
    ├── templatetags/
    ├── urls.py
    └── views.py

目录介绍

• AUTHORS: 项目贡献者列表。
• CODE_OF_CONDUCT.md: 行为准则。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• MANIFEST.in: 打包清单文件。
• README.rst: 项目说明文档。
• coveragerc: 代码覆盖率配置文件。
• django_authority.egg-info/: 包信息目录。
• docs/: 项目文档目录。
• example/: 示例项目目录。
• setup.cfg: 安装配置文件。
• setup.py: 安装脚本。
• tox.ini: 自动化测试配置文件。
• authority/: 核心应用目录。
  • __init__.py: 包初始化文件。
  • admin.py: Django 管理后台配置。
  • apps.py: 应用配置。
  • checks.py: 自定义检查。
  • fields.py: 自定义字段。
  • forms.py: 表单定义。
  • management/: 管理命令目录。
  • migrations/: 数据库迁移文件。
  • models.py: 模型定义。
  • permissions.py: 权限定义。
  • templatetags/: 模板标签目录。
  • urls.py: URL 配置。
  • views.py: 视图定义。

2. 项目的启动文件介绍

Django-Authority 项目的启动文件主要是 example/manage.py，它是一个标准的 Django 项目管理脚本。

#!/usr/bin/env python
import os
import sys

if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "example.settings")
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)

启动步骤

1. 进入 example 目录。
2. 运行 python manage.py migrate 进行数据库迁移。
3. 运行 python manage.py runserver 启动开发服务器。

3. 项目的配置文件介绍

Django-Authority 项目的配置文件主要是 example/settings.py，它包含了 Django 项目的所有配置。

import os

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

SECRET_KEY = 'your-secret-key'

DEBUG = True

ALLOWED_HOSTS = []

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'authority',
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.

django-authorityA Django app that provides generic per-object-permissions for Django's auth app and helpers to create custom permission checks.项目地址:https://gitcode.com/gh_mirrors/dj/django-authority