Nótaí scaoilte Django 3.1Link to this heading#

Tuairimí asincrónacha agus tacaíocht lár-earraíLink to this heading#

Tacaíonn Django anois le cosán iarratais go hiomlán asincrónach, lena n-áirítear:

• <async-views>:ref: `Tuairimí asincrónacha `

• <async-middleware>:ref: `Meán-earraí asincrónach `

• <async-tests>:ref: `Tástálacha asincrónacha agus cliant tástála `

Chun tús a chur le tuairimí async, ní mór duit radharc a dhearbhú ag baint úsáide as async def:

async def my_view(request):
    await asyncio.sleep(0.5)
    return HttpResponse("Hello, async world!")

Tacaítear le gach gné asincrónach cibé an bhfuil tú ag rith faoi mhodh WSGI nó ASGI. Mar sin féin, beidh pionóis feidhmíochta ann ag baint úsáide as cód async i mód WSGI. Is féidir leat tuilleadh a léamh faoi na sonraí in:doc: /topics/async doiciméadú.

Tá saor ort tuairimí async agus sync, middleware, agus tástálacha a mheascadh an oiread agus is mian leat. Cinnteoidh Django go mbeidh an comhthéacs forghníomhaithe ceart agat i gcónaí. Táimid ag súil go gcoinneoidh formhór na dtionscadail formhór a gcuid tuairimí sioncrónach, agus níl ach cúpla rogha acu ag rith i mód async - ach is é do rogha go hiomlán é.

Ní thacaíonn ORM Django, ciseal taisce, agus píosaí eile cód a dhéanann glaonna líonra fadtéarmach le rochtain async fós. Táimid ag súil go gcuirfear tacaíocht dóibh in eisiúintí atá le teacht. Tá tuairimí async oiriúnach, áfach, má tá a lán glaonna API nó HTTP á dhéanamh agat taobh istigh de do radharc, is féidir leat na glaonna HTTP sin go léir a dhéanamh go dúchasach anois go comhthreomhar chun forghníomhú do radharc a bhrostú go mór.

Ba cheart go mbeadh tacaíocht asincrónach go hiomlán comhoiriúnach ar gcúl agus rinneamar iarracht a chinntiú nach bhfuil aon aischéimniú luais ann do do chód sioncrónach reatha. Níor cheart go mbeadh aon éifeacht shuntasach aige ar aon tionscadail Django atá ann cheana féin.

JSONField do gach cúltaca bunachar sonraí tacaitheLink to this heading#

<django.forms.JSONField>Cuimsíonn Django anois:class: .Models.JSONField agus:class: `Forms.JSONField `is féidir a úsáid ar gach cúltaca bunachar sonraí tacaithe. Tacaíonn an dá réimse le húsáid ionchódóirí agus díchódóirí saincheaptha JSON. Tacaíonn an réimse samhail leis an ionspéireacht, :ref: `lookups, agus athraitheann <querying-jsonfield>`a bhí roimhe seo PostgreSQL amháin:

from django.db import models


class ContactInfo(models.Model):
    data = models.JSONField()


ContactInfo.objects.create(
    data={
        "name": "John",
        "cities": ["London", "Cambridge"],
        "pets": {"dogs": ["Rufus", "Meg"]},
    }
)
ContactInfo.objects.filter(
    data__name="John",
    data__pets__has_key="dogs",
    data__cities__contains="London",
).delete()

Má úsáideann do thionscadal django.contrib.postgres.fields.jsonfield, móide an réimse foirme gaolmhara agus athfhoirmithe, ba cheart duit coigeartú chun na réimsí nua a úsáid, agus imirce bunachar sonraí a ghiniúint agus a chur i bhfeidhm. <deprecated-jsonfield>Go dtí seo, fágtar na sean-réimsí agus na claochruithe mar thagairt do na cinn nua agus tá siad: ref: `díscothaithe ó eisiúint seo `.

Socruithe DEFAULT_HASHING_ALGORITHMLink to this heading#

Ligeann an suíomh idirthréimhseach nua DEFAULT_HASHING_ALGORITHM an algartam hashing réamhshocraithe le húsáid le haghaidh fianáin a ionchódú, comharthaí athshocraithe pasfhocal ar an suíomh riaracháin, seisiúin úsáideora agus sínithe cruthaithe ar:class: Django.core.signing.signer agus:meth: django.core.signing.dumps.

Cuireadh tacaíocht do SHA-256 i Django 3.1. Má tá cásanna iolracha den tionscadal céanna á uasghrádú agat go Django 3.1, ba cheart duit DEFAULT_HASHING_ALGORITHM a shocrú go sha1'` le linn an aistrithe, d'fhonn comhoiriúnacht a cheadú leis na leaganacha níos sine de Django. Tabhair faoi deara go dteastaíonn Django 3.1.1+ air seo. Nuair a bheidh an t-aistriú go 3.1 críochnaithe is féidir leat stop a chur le `DEFAULT_HASHING_ALGORITHM a shárú.

Tá an socrú seo imithe amhail an eisiúint seo, toisc go mbainfear tacaíocht do chomharthaí, fianáin, seisiúin agus sínithe a úsáideann algartam SHA-1 i Django 4.0.

MionghnéitheLink to this heading#

API cúltaca bunachar sonraíLink to this heading#

Déanann an rannán seo cur síos ar athruithe a d’fhéadfadh a bheith ag teastáil ar dhroim bhunachar sonraí tríú páirtí.

• DatabaseOperations.fetch_returned_insert_Columns () teastaíonn argóint breise `returning_params anois.

• <DATABASE-TIME_ZONE>Tá maoin connection.timezone anois UTC' de réir réamhshocraithe, nó an:setting: TIME_ZONE `nuai:setting: `USE_TZ True ar bhunachair sonraí a thacaíonn le criosanna ama. Roimhe seo, bhí sé None ar bhunachair sonraí a thacaíonn le criosanna ama.

• nasc. Athraítear maoin _nodb_connection go dtí an nasc. Modh _nodb_cursor () ``agus filleann bainisteoir comhthéacs anois a thugann cúrsóir agus a dhúnann an cúrsóir agus an nasc go huathoibríoch nuair a fhágann sé an ráiteas ``with.

• Teastaíonn DatabaseClient.runShell () ``argóint breise ``paraiméadair` anois mar liosta d'argóintí breise le cur ar aghaidh chuig an gcliant líne ordaithe.

• Cuirtear an argóint boolean eochairfhocal amháin reset_sequences in ionad an argóint seasaimh seicheamh de databaseOperations.sql_flush () `. Má tá “Fíor”, athshocrófar seicheamh na dtáblaí gearrtha.

• Is argóint eochairfhocal amháin é an argóint allow_cascade` de `databaseOperations.sql_flush () ``anois.

• Baintear an argóint seasaimh úsáid de databaseOperations.execute_SQL_Flush () `. Úsáideann an modh bunachar sonraí an chás ar a dtugtar air anois.

• Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht do JSONField` a chur i bhfeidhm nó DatabaseFeatures.supports_JSON_Field a shocrú go False. Mura dtacaítear le príomhiontacha a stóráil, socraigh DatabaseFeatures.supports_primitives_in_json_field go False. Má tá fíor-chineál sonraí ann do JSON, socraigh DatabaseFeatures.has_Native_JSON_Field go True. Más rud é nach dtacaítear le lookup: jsonfield.contains agus:lookup: jsonfield.contained_by, socraigh databaseFeatures.supports_json_field_contains go False.

• Caithfidh cúltaca bunachar sonraí tríú páirtí introspection a chur i bhfeidhm do Jsonfield` nó can_introspect_json_field a shocrú go False.

Tacaíocht titim do MariaDB 10.1Link to this heading#

Críochnaíonn tacaíocht suas srutha do MariaDB 10.1 i mí Dheireadh Fómhair 2020. Tacaíonn Django 3.1 le MariaDB 10.2 agus níos airde.

Tacaíocht brabhsálaí contrib.adminLink to this heading#

Ní thacaíonn an riarachán le brabhsálaí oidhreachta Internet Explorer a thuilleadh Féach:ref: `an Ceisteanna Coitianta riaracháin <admin-browser-support>`le haghaidh sonraí faoi bhrabhsálaithe tacaithe.

<django.contrib.auth.models.User.first_name>:attr: `Abstractuser.first_name ```max_length ``méadaithe go 150Link to this heading#

Tá imirce le haghaidh: attr: django.contrib.auth.models.user.first_name san áireamh. Má tá samhail úsáideora saincheaptha agat ag oidhreacht ó ``AbstractUser`, beidh ort imirce bunachar sonraí a ghiniúint agus a chur i bhfeidhm do do mhúnla úsáideora.

Más mian leat an teorainn 30 carachtar a chaomhnú do chéad ainmneacha, bain úsáid as foirm saincheaptha:

from django import forms
from django.contrib.auth.forms import UserChangeForm


class MyUserChangeForm(UserChangeForm):
    first_name = forms.CharField(max_length=30, required=False)

Más mian leat an srian seo a choinneáil sa riarachán agus tú ag eagarthóireacht úsáideoirí, socraigh UserAdmin.form chun an fhoirm seo a úsáid:

from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User


class MyUserAdmin(UserAdmin):
    form = MyUserChangeForm


admin.site.unregister(User)
admin.site.register(User, MyUserAdmin)

IlghnéitheachLink to this heading#

• Tá na heochracha taisce a úsáideann: ttag: cache agus arna ghineadh ar:func: ~django.core.cache.utils.make_template_fragment_key difriúil ó na heochracha a ghineann leaganacha níos sine de Django. Tar éis uasghrádú a dhéanamh go Django 3.1, is é an chéad iarratas ar aon bhrúin teimpléad a chosáilte roimhe seo ná caillte taisce.

• Tá an loighic taobh thiar den chinneadh titim atreoraithe nó freagra 204 HTTP a thabhairt ar ais ón amharc: func: ~django.views.i18n.set_language bunaithe anois ar an gceannteideal HTTP `Accept in ionad an X-Requested-With` HTTP láithreacht.

• Baintear allmhairí comhoiriúnachta django.core.exceptions.emptyResultSet i django.db.models.query`, django.db.models.sql`, agus django.db.models.sql.datastructures.

• Baintear allmhairiú comhoiriúnachta Django.Core.Exceptions.FieldDoesNotExist i django.db.models.fields.

• Baintear allmhairí comhoiriúnachta django.forms.utils.pretty_name () ``agus ``django.forms.boundfield.boundfield i django.forms.forms`.

• Baintear allmhairí comhoiriúnachta Context, ContextPopException`, agus RequestContext i django.template.base`.

• Baintear allmhairiú comhoiriúnachta django.contrib.admin.helpers.ACTION_CHECKBOX_NAME i django.contrib.admin.

• Tá na socruithe STATIC_URL agus MEDIA_URL socraithe chuig cosáin choibhneasta socraithe anois ag an luach arna sholáthar ag an bhfreastalaí de SCRIPT_NAME (nó / mura bhfuil sé socraithe). Níor cheart go gcuirfeadh an t-athrú seo isteach ar shocruithe a shocraítear chuig URLanna bailí nó ar bhealaí iomlána.

• ConditionalGetMiddleware no longer adds the ETag header to responses with an empty content.

• django.utils.decorators.classproperty() decorator is made public and moved to django.utils.functional.classproperty.

• floatformat template filter now outputs (positive) 0 for negative numbers which round to zero.

• Meta.ordering and Meta.unique_together options on models in django.contrib modules that were formerly tuples are now lists.

• Láimhseálann an giuirléid féilire riaracháin bliana dhá dhigit anois de réir Sonraíocht an Ghrúpa Oscailte, ie déantar luachanna idir 69 agus 99 a mhapáil leis an gcéad roimhe seo, agus déantar luachanna idir 0 agus 68 a mhapáil leis an gcéad reatha.

• Baintear formáidí dáta amháin ón liosta réamhshocraithe le haghaidh: setting: DATETIME_INPUT_FORMATS.

• Ní dhéanann an giuirléid: Class: ~django.forms.FileInput leis an tréith HTML riachtan a thuilleadh nuair a bhíonn sonraí tosaigh ann.

• Baintear an rang Django.Views.Debug.ExceptionReporterFilter neamhdhoiciméadaithe. De réir na doiciméadaithe: ref: custom-error-reports `, ní mór ranganna atá le húsáid le:setting: `DEFAULT_EXCEPTION_REPORTER_FILTER oidhreacht ó:class: django.views.debug.safeEXCEPtionReporterFilter.

• Tá tosaíocht anois ag maisitheoir an t-am taisce arna leagan síos ag: func: ~django.views.decorators.cache.cache_page os cionn an treoir max-age ón gceannteideal Cache-Control.

• Réimse iargúlta neamh-áitiúil a sholáthar san argóint: attr: .foreignKey.to_field anois:class: ~django.core.exceptions.fielderror.

• SECURE_REFERRER_POLICY now defaults to 'same-origin'. See the What's New Security section above for more details.

• : djadmin: Ritheann ordú bainistíochta check seiceálacha an chórais ``bunachar sonraí ``anois ach amháin le haghaidh ainmneacha bunachar sonraí a shonraítear ag baint úsáid:option: check --database rogha.

• migrate management command now runs the database system checks only for a database to migrate.

• Baintear na ranganna CSS riaracháin row1 agus row2 i bhfabhar bréagaicmí :nth-child (odd) ``agus ``:nth-child (even).

• Éilíonn an fheidhm:func: ~django.contrib.auth.hashers.make_password anois go mbeadh a argóint ina shreang nó béite. Ba chóir cineálacha eile a chaitheamh go sainráite chuig ceann acu seo.

• Baintear an paraiméadar version neamhdhoiciméadaithe chuig an bhfeidhm:class: ~django.contrib.gis.db.models.functions.askml.

• JSON and YAML serializers, used by dumpdata, now dump all data with Unicode by default. If you need the previous behavior, pass ensure_ascii=True to JSON serializer, or allow_unicode=False to YAML serializer.

• Ní dhéanann an t-uathlódálaí monatóireacht a thuilleadh ar athruithe i gcomhaid aistriúcháin Django ionsuite.

• Méadaítear an leagan íosta tacaithe de mysqlclient` ó 1.3.13 go 1.4.0.

• Bogtar na django.contrib.postgres.forms.invalidjsonInput agus Django.contrib.postgres.forms.jsonString neamhdhoiciméadaithe chuig django.forms.fields.

• Baintear an rang Django.contrib.postgres.fields.jsonb.jsonAdapter neamhdhoiciméadaithe.

• Ní thuilleadh an scagaire: ttag: {% localize off%} agus: <localize>tfilter: unlocalize a thuilleadh: socrú: DECIMAL_SEPARATOR.

• Méadaítear an leagan íosta tacaithe de asgiref` ó 3.2 go 3.2.10.

• </topics/forms/media> < https://html.spec.whatwg.org/multipage/scripting.html#the-script-element>Déanann rang:doc: Meáin `clibeanna `` anois gan an tréith ``cineál` le moltaí `WHATWG `_ a <script>leanúint.

• ModelChoiceIterator, used by ModelChoiceField and ModelMultipleChoiceField, now yields 2-tuple choices containing ModelChoiceIteratorValue instances as the first value element in each choice. In most cases this proxies transparently, but if you need the field value itself, use the ModelChoiceIteratorValue.value attribute instead.

PostgreSQL JsonfieldLink to this heading#

<django.forms.JSONField>Tá Django.Contrib.Postgres.Fields.JsonField agus Django.Contrib.Postgres.Forms.JsonField a dhíchur i bhfabhar: .Models.JSONField agus:class: Forms.JSONField.

Tá na django.contrib.postgres.fields.jsonb.keytransform` agus Django.contrib.postgres.fields.jsonb.keytextTransform neamhdhoiciméadaithe i bhfabhar na n-athfhoirmithe i django.db.models.fields.json`.

Is féidir an JSONFields, KeyTransform`, agus KeyTextTransform` nua a úsáid ar gach cúltaca bunachar sonraí tacaithe.

IlghnéitheachLink to this heading#

• Tá socrú PASSWORD_RESET_TIMEOUT_DAYS a dhíchur i bhfabhr:setting: PASSWORD_RESET_TIMEOUT.

• Úsáid neamhdhoiciméadaithe an chuardaigh: lookup: isnull le luachanna neamh-boolean de réir mar a dhéantar an taobh na láimhe deise a dhíchur, bain úsáid as True` nó False` ina ionad sin.

• Tá an rang eisceachta Django.db.Models.Query_Utils.InvalidQuery doiciméadaithe ar éigean i bhfabhar: ~Django.Core.Exceptions.FieldDoesNotExist agus:class: ~Django.Core.Exceptions.FieldDoesNotExist agus:class: ~Django.Core.Exceptions.Fielderror.

• Tá an pointe iontrála django-admin.py a dhíchur i bhfabhar ``django-admin ``.

• < https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API>Tá an modh HttpRequest.is_ajax () `díluaite toisc go raibh sé ag brath ar bhealach JQuery-shonrach chun glaonna AJAX a léiriú, agus is gnách go n-úsáideann úsáid reatha an JavaScript `Fetch API `_. Ag brath ar do chás úsáide, is féidir leat do mhodh braite AJAX féin a scríobh, nó an modh nua: meth: `.httpRequest.Accepts a úsáid má bhraitheann do chód ar cheannteideal HTTP an chliaint Accept.

  Má tá do mhodh braite AJAX féin á scríobh agat, is féidir ``request.is_ajax () a atáirgeadh go díreach mar ``request.headers.get ('x-requested-with') == 'XMLHttpRequest'.

• Ag dul None mar an chéad argóint chuig ``django.utils.deprecation.middlewaremixin. Tá __init__ () ``díluaite.

• Tá formáid ionchódú luachanna fianáin a úsáideann u:class: ~django.contrib.messages.storage.cookie.cookie.cookieStorage difriúil ón bhformáid a ghineann leaganacha níos sine de Django. Tá tacaíocht don sean-fhormáid fós go dtí Django 4.0.

• Tá formáid ionchódú na seisiúin difriúil ón bhformáid a ghineann leaganacha níos sine de Django. Tá tacaíocht don sean-fhormáid fós go dtí Django 4.0.

• Tá an argóint doiciméadach amháin providing_args le haghaidh: class: ~django.Dispatch.Signal a dhíchur. Má tá tú ag brath ar an argóint seo mar dhoiciméadú, is féidir leat an téacs a bhogadh chuig trácht cód nó docstring.

• Tá glaoch ar django.utils.crypto.get_random_string () ``gan argóint ``length, cuirtear díluasc.

• Tá an teachtaireacht liost do:class: ~django.forms.ModelMultipleChoiceField a dhíchur i bhfabhar invalid_list.

• Tá ainmneacha colún amh a chur chuig: meth: .queryset.ORDER_by atá díluaite. Is féidir an toradh céanna a bhaint amach trí ainmneacha a rith in a:class: ~Django.db.Models.Expressions.RawSql roimh ré.

• Tá an réimse samhail NullBooleanField a dhíchur i bhfabhar ``BooleanField (Null=True, Blank = True) ``.

• Tá ``django.conf.urls.url () ``alias o:func: `django.urls.re_path díscothaithe.

• <django.template.backends.django.DjangoTemplates><TEMPLATES-OPTIONS>Tá na clibeanna teimpléad {% ifequal%} agus {% ifnotequal%} `díluaite i bhfabhra:ttag:` {% if%} `<if>. Clúdaíonn {% if%}` gach cás úsáide, ach más gá duit leanúint ar aghaidh ag úsáid na clibeanna seo, is féidir iad a bhaint as Django go modúl agus a áireamh mar chlib ionsuite san :class: builtin' '`rogha in:socrú: `ROGHANNA.

• Tá socrú idirthréimhseach DEFAULT_HASHING_ALGORITHM díchuimsithe.