Plugins 插件清单

Comments

环境说明

  • Python 3.8.10
  • Django 3.2.6
  • Centos 8.1

优质插件

django-reversion 数据版本管理

功能介绍:

  • 数据版本管理，支持查看历史和还原数据.
  • 上手简单，配置非常便利. ★★★★☆
  • 对于复杂字段不支持，复杂字段只会显示最新的数据无法还原 (exp: manytomany)

使用步骤

步骤1: 安装包

1
2
pip install django-reversion
django-reversion==4.0.0

Add reversion to INSTALLED_APPS

Run manage.py migrate

步骤2: 注册版本管理模型

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 方法1：记录通过模型修改的操作
from django.contrib import admin
from reversion.admin import VersionAdmin
from django.db import models


class YourModel(models.Model):
    pro_id = models.CharField()


@admin.register(YourModel)
class YourModelAdmin(VersionAdmin):
    pass


# 方法2：记录通过 Api 修改的操作
from reversion.views import RevisionMixin
from rest_framework.viewsets import ModelViewSet


class APIView(RevisionMixin, ModelViewSet):
    def list(self, request, *args, **kwargs):
        pass

    def create(self, request, *args, **kwargs):
        pass

    def update(self, request, *args, **kwargs):
        pass

    def destroy(self, request, *args, **kwargs):
        pass

步骤3: 初始化数据

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 清除历史表 & 建表
python manager.py makemigrations reversion
python manager.py migrate reversion --fake
python manager.py migrate reversion
# 初始化
python manage.py createinitialrevisions
# 执行结果
# 执行结果
Creating revisions for 项目管理
- Created 48 / 48

# 会自动创建如下表 用于存储初始值 & 迭代版本
# reversion_version
# reversion_revision

其他使用 - 查询具体对象或者model中删除的历史记录

1
2
3
4
5
6
7
8
9
from django.shortcuts import get_object_or_404
from reversion.models import Version

# version_obj_id指某一个具体对象的id，model为要查询的table
instance = get_object_or_404(model, id=version_obj_id)
queryset = Version.objects.get_for_object(instance)

# 查询model中删除历史
queryset = Version.objects.get_deleted(model)

其他使用 - 恢复历史记录

1
2
3
4
5
from reversion.models import Version

# version_id为上一步查询出的历史记录的id
reversion = Version.objects.filter(id=version_id)
reversion[0].revision.revert()

TODO

  • 如何 指定历史版本说明文字
  • 如何 查看更明细的字段修改，比如 明确哪个字段变更, 以及字段从AA->BB
  • Api-RevisionMixin 没有版本说明文字,如何添加修改?

参考资源:

参考资源

插件清单

fansichaoData Engineer & SSE & CYO

个人简介。