4

Django 3.2 新功能尝鲜

 3 years ago
source link: https://pylixm.top/posts/2021-03-09-django-3.2.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

Django 3 版本系列的 LTS（长期支持版本）马上就要在 4 月份发布，这个版本将会陪伴我们两年之久。在新版本发布前夕来提前了解下有哪些有趣的新功能，这些功能在发布时应该不会变动了。

image

安装一个 3.2 的 Django 版本

截止到 3 月 9 日，已发布Django beta2版本。Django 3.2 仅支持 Python3.6、3.7、3.8 和 3.9，安装时注意 Python 版本。

1、创建虚拟环境

$ mkdir django3
$ cd django3
$ python3.6 -m venv venv
$ source venv/bin/activate

2、安装 django3.2 b1

(venv) $ pip install git+https://github.com/django/[email protected]

3、创建新的项目和 app ，防止你本地环境影响，这里直接使用虚拟环境中的命令来创建

(venv) $ venv/bin/django-admin startproject django3
(venv) $ cd django3
(venv) $ python manage.py startapp blog

4、将 app 添加到 settings。

# settings.py

INSTALLED_APPS = [
    # ...
    'blog',
]

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'django3',
        'USER': 'root',
        'PASSWORD': 'Root1024',
        'HOST': '127.0.0.1',
        'PORT': '3306',
    }
}

5、创建 model 用来测试：

from django.db import models


class Blog(models.Model):
    title = models.CharField(max_length=1000)
    create_at = models.DateTimeField()

6、生成数据表：

(venv) $ python manage.py makemigrations
(venv) $ python manage.py migrate

7、随便构造点数据：

import string
import datetime
import random
import pytz
import os
import sys

BASE_DIR = os.path.dirname(os.path.dirname(__file__))
sys.path.append(os.path.join(BASE_DIR, '..'))
os.environ['DJANGO_SETTINGS_MODULE'] = 'django3.settings'
import django

django.setup()

from blog.models import Blog

starting_at = pytz.UTC.localize(datetime.datetime(2020, 1, 1))
DAY = datetime.timedelta(days=1)

Blog.objects.bulk_create((Blog(
    title=''.join(random.choices(string.ascii_letters + ' ' * 10, k=random.randint(10, 20))),
    create_at=starting_at + (DAY * random.random() * 365),
) for _ in range(10000)))

好了，现在我们有 Django3.2 的环境了，下面开始搞起。

新功能体验

模型自增主键的类型修改

在之前的版本中，当模型中没有定义主键时，django 会自动增加一个类型为 AutoField 的字段 id作为主键，它是 IntegerField 的子类，范围为-2147483648 to 2147483647 。

在 Django 3.2 版本中，自增主键的类型替换为 BigAutoField 范围为 1 to 9223372036854775807。除此之外，在settings配置中显式的增加了 DEFAULT_AUTO_FIELD 变量。若你不想修改源数据库的字段类型话，在升级时，在settings中最好显式的添加如下配置：

DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'

admin 站点新的装饰器

在自定义 admin 模型展示字段的时候，之前是在所需字段直接赋值，现在使用 display 使代码变得更优雅。

# docs see https://docs.djangoproject.com/en/dev/releases/3.2/#new-decorators-for-the-admin-site
from django.contrib import admin

from .models import Blog


@admin.register(Blog)
class BlogAdmin(admin.ModelAdmin):
    list_display = (
        'id',
        'create_at',
        'create_at_year',
        'title',
    )

    # 老的实现方式
    # def create_at_year(self, obj: Blog) -> str:
    #     return obj.create_at.year
    # create_at_year.admin_order_field = 'create_at__year'
    # create_at_year.short_description = 'Year created'

    @admin.display(ordering='create_at__year', description='Year created')
    def create_at_year(self, obj: Blog) -> str:
        return obj.create_at.year

admin 后端支持主题配置

admin 的样式颜色采用了 css 变量来定义，我们可以直接重新 base.html 模板，在其中定义 css变量即可，不用再去重新覆盖具体的css文件。官网的例子：

{% extends 'admin/base.html' %}

{% block extrahead %}{{ block.super }}
<style>
:root {
  --primary: #9774d5;
  --secondary: #785cab;
  --link-fg: #7c449b;
  --link-selected-fg: #8f5bb2;
}
</style>
{% endblock %}

我们会看到如下的 admin 页面。

image

Model 增加了个 JSONObject 函数

我们可以使用JSONOject功能函数实现自定义 json 字段的功能，如下 blog对象实例多了一个json格式的json_obj字段：

>>> from django.db.models.functions import JSONObject, Lower, TruncDay
>>> import pytz
>>> Blog.objects.annotate(json_obj=JSONObject(title=Lower('title'), creat_year=TruncDay('create_at', tzinfo=pytz.UTC)))
>>> blog = Blog.objects.annotate(json_obj=JSONObject(title=Lower('title'), creat_year=TruncDay('create_at', tzinfo=pytz.UTC))).first()
>>> blog.json_obj
{'title': 'zjy dqaiab ', 'creat_year': '2020-02-12 00:00:00.000000'}

带省略号的分页器

Django3.2 分页器 Paginator 对象增加了get_elided_page_range方法 ，它类似page_range ，输出的是页数区间的生成器，会根据配置将中间页数用省略号代替。该方法有两个参数on_each_side和on_ends，省略号前边显示页数个数为on_each_side+1，省略号后边页数个数为on_ends。以后我们在写分页的时候，再也不用自己处理了，期待。

>>> from django.core.paginator import Paginator
>>> page_obj = Paginator(blogs, page_size)
>>> page_obj.get_elided_page_range(on_each_side=3, on_ends=2)
<generator object Paginator.get_elided_page_range at 0x10fb2f620>
>>> list(page_obj.get_elided_page_range(on_each_side=3, on_ends=2))
[1, 2, 3, 4, '…', 999, 1000]

其他可能会用到的更新

  • 覆盖索引，文档描述「include is ignored for databases besides PostgreSQL. 」，在 mysql 数据库上使用，只会创建单字段索引，mysql 中只能使用联合索引以达到覆盖查询字段的效果。
  • 函数索引，文档描述Functional indexes are ignored with MySQL < 8.0.13 and MariaDB as neither supports them.，但我使用 8.0.17 测试仍有语法问题，期待正式版发布吧。
  • 文件上传增加新的[FileUploadHandler.upload_interrupted()](https://docs.djangoproject.com/en/dev/ref/files/uploads/#django.core.files.uploadhandler.FileUploadHandler.upload_interrupted “FileUploadHandler.upload_interrupted( “FileUploadHandler.upload_interrupted()")")信号用来通知上传中断，可以做些后续的工作。
  • QuerySet.select_for_update() 查询锁的实现，目前支持不是很好，需要的数据库版本都比较高。「Currently, the postgresql, oracle, and mysql database backends support select_for_update(). However, MariaDB 10.3+ supports only the nowait argument and MySQL 8.0.1+ supports the nowait, skip_locked, and of arguments. The no_key argument is supported only on PostgreSQL.」期待后续更新吧。
  • PostgreSQL 9.5 的上游支持将于 2021 年 2 月结束。Django3.2 支持 PostgreSQL 9.6 及更高版本。
  • 对 MySQL 5.6 的上游支持将于 2021 年 4 月结束。Django 3.2 支持 MySQL 5.7 和更高版本。

总的来说 Django3.2 并没有大的更新，延续了 3.1 的很多功能，对 Model 性能和实用性方面做了不少优化，针对 postgreSQL 偏多，有些功能要求 mysql 版本都在 8.0 以上。期待的异步功能并没有更新，看来“异步 Django”的愿望实现还需要时间。

上边完整代码可从github获取，地址为 https://github.com/pylixm/django_32_demo

好了，今天的分享就到这里吧，欢迎留言讨论你觉着超赞的Django新功能~

我是DeanWu，一个努力成为真正SRE的人。

关注公众号「码农吴先生」, 可第一时间获取最新文章。回复关键字「go」「python」获取我收集的学习资料，也可回复关键字「小二」，加我wx拉你进技术交流群，聊技术聊人生~


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK