Nótaí scaoileadh Django 4.1Link to this heading#

Láimhseálaithe asincrónacha le haghaidh tuairimí rang-bhunaitheLink to this heading#

Féadfaidh féachaint ar fho-aicmí láimhseálaithe modh HTTP async a shainiú anois:

import asyncio
from django.http import HttpResponse
from django.views import View


class AsyncView(View):
    async def get(self, request, *args, **kwargs):
        # Perform view logic using await.
        await asyncio.sleep(1)
        return HttpResponse("Hello async world!")

Féach: ref: async-class-based-views le haghaidh tuilleadh sonraí.

Comhéadan ASINCRONACH ORMLink to this heading#

Soláthraíonn QuerySet ``comhéadan asincrónach anois do gach oibríocht rochtana sonraí. Ainmnítear iad seo de réir na n-oibríochtaí sioncrónacha atá ann cheana ach le réimír ``a, mar shampla acreate () ``, `aget (), agus mar sin de.

Ligeann an comhéadan nua duit cód asincrónach a scríobh gan gá d'oibríochtaí ORM a fhilleadh i sync_to_async () `:

async for author in Author.objects.filter(name__startswith="A"):
    book = await author.books.afirst()

Tabhair faoi deara, ag an gcéim seo, go bhfanann na hoibríochtaí bunúsacha bunachar sonraí sioncrónach, agus ranníocaíochtaí leanúnach ar aghaidh chun tacaíocht asincrónach a bhrú síos isteach sa thiomsaitheoir SQL, agus tiománaithe bunachar sonraí asincr Cuimsíonn an comhéadan nua ceisteanna asincrónach na hoibríochtaí riachtanacha ``sync_to_async () `duit faoi láthair, agus ligfidh sé do chód leas a bhaint as forbairtí i dtacaíocht asincrónach an ORM de réir mar a fhorbraíonn sé.

Féach: ref: async-queries le haghaidh sonraí agus teorainneacha.

Bailíochtú SriantaLink to this heading#

<django.db.models.Options.constraints><validating-objects>:class: Seiceáil `, :class: `uath <django.db.models.CheckConstraint>úil, agus:class: eisiamh <django.db.models.UniqueConstraint>`srianta atá sainmhínithe sa roghnaí: <django.contrib.postgres.constraints.ExclusionConstraint>attr: `Meta.Constraints déantar seiceáil anois trí:ref: `bailíochtú samhail `.

Inrochtaineacht rindreálaLink to this heading#

Chun cabhrú le húsáideoirí le léitheoirí scáileáin, agus le teicneolaíocht chúnta eile, tá teimpléid foirm nua bunaithe ar <div> ar fáil ón eisiúint seo. Soláthraíonn siad seo nascleanúint níos inrochtana ná na teimpléid níos sine, agus tá siad in ann rialuithe gaolmhara, mar raidió-liostaí, a ghrúpáil i gceart i dtaca le réimsí páirce.

Moltar na teimpléid nua, agus beidh siad ina stíl rindreála foirme réamhshocraithe agus foirm á aschur, cosúil le ``{{form}} `i dteimpléad, ó Django 5.0.

D'fhonn glacadh leis an stíl aschuir nua a éascú, tá na teimpléid réamhshocraithe foirme agus foirmeacha inchumraithe anois ag leibhéal an tionscadail tríd an socrú: setting: FORM_RENDER.

Féach: Tagairt: `an chuid Foirmeacha (thíos) <forms-4.1>`le haghaidh sonraí iomlána.

CSRF_COOKIE_MASKED socrúLink to this heading#

Ligeann an socrú idirthréimhseach nua CSRF_COOKIE_MASKED a shonrú an féidir an fianán CSRF a mhaolú.

CsrfViewMiddleware no longer masks the CSRF cookie like it does the CSRF token in the DOM. If you are upgrading multiple instances of the same project to Django 4.1, you should set CSRF_COOKIE_MASKED to True during the transition, in order to allow compatibility with the older versions of Django. Once the transition to 4.1 is complete you can stop overriding CSRF_COOKIE_MASKED.

Tá an socrú seo imithe amhail an eisiúint seo agus bainfear é i Django 5.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í.

• Athraítear BasedatabaseFeatures.has_case_insensitive_like ó True go False chun iompar an chuid is mó de bhunachar sonraí a léiriú.

• Baintear ``databaseintrospection.get_key_columns () ``. Úsáid ``DatabaseIntrospection.get_relations () ``ina ionad.

• Cuirtear DatabaseOperations.on_conflict_suffix_sql () `in ionad modh databaseOperations.on_conflict_suffix_sql () a ghlacann leis na hargóintí ``fields, on_conflict`, update_fields`, agus unique_fields.

• Cuirtear on_conflict` in ionad an argóint ignore_conflicts den mhodh databaseOperations.insert_statement () ``a ghlacann le ``Django.db.Models.Constants.onConflict`.

• Oibríochtaí bunachar sonraí. Cuirtear ``DatabaseOperations in ionad _convert_field_to_tz (). _convert_sql_to_tz () a ghlacann leis na hargóintí ``sql, params`, agus tzname.

• Tógann roinnt modhanna dáta agus ama ar DatabaseOperations anois argóintí sql` agus params` in ionad field_name agus filleann 2-tuple ina bhfuil roinnt SQL agus na paraiméadair atá le hidirphóladh isteach sa SQL sin. Tá na sínithe nua seo ag na modhanna athraithe:

  • ``DatabaseOperations.date_extract_sql (lookup_type, sql, params) `

  • ``DatabaseOperations.DateTime_Extract_SQL (lookup_type, sql, params, ainm) ``

  • ``DatabaseOperations.Time_Extract_SQL (cuardach_cineál, sql, params) ``

  • ``DatabaseOperations.date_trunc_sql (lookup_type, sql, params, tZnA=None) ``

  • ``DatabaseOperations.DateTime_Trunc_sql (féin, lookup_type, sql, params, tzname) ``

  • ``DatabaseOperations.time_trunc_sql (lookup_type, sql, params, tzname=None) ``

  • ``DatabaseOperations.DateTime_Cast_Date_SQL (sql, paramaí, ainm) ``

  • ``DatabaseOperations.DateTime_Cast_Time_SQL (sql, paramaí, ainm) ``

django.contrib.gisLink to this heading#

• Baintear tacaíocht do GDAL 2.1.

• Baintear tacaíocht do PostGIS 2.4.

Tacaíocht titim do PostgreSQL 10Link to this heading#

Críochnaíonn tacaíocht suas srutha do PostgreSQL 10 i mí na Samhna 2022. Tacaíonn Django 4.1 le PostgreSQL 11 agus níos airde.

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

Críochnaíonn tacaíocht suas srutha do MariaDB 10.2 i mí na Bealtaine 2022. Tacaíonn Django 4.1 le MariaDB 10.3 agus níos airde.

Cuardaigh an liosta athraithe riaracháin a chuimsíonn athruithe caidrimh ilLink to this heading#

Cuirtear cuardach ar liosta athraithe riaracháin ag úsáid téarmaí cuardaigh iolracha i bhfeidhm anois i nglao amháin ar ``filter () ``, seachas i nglaonna ``filter () `seicheamhacha.

Maidir le caidrimh illuachmhar, ciallaíonn sé seo go gcaithfidh sraitheanna ón tsamhail gaolmhar na téarmaí go léir a mheaitseáil Mar shampla, má shocraítear search_fields go ['child__name', 'child__age'] agus má chuardaíonn úsáideoir ``Jamal 17', ní thabharfar sraitheanna tuismitheora ar ais ach amháin má bhíonn caidreamh le leanbh 17 bliain d'aois ainm Jamal, seachas tuismitheoirí a thabhairt ar ais nach bhfuil ach leanbh níos sine ar ainm Jamal.

Féach an t-ábhar: ref: spanning-il-luach-caidrim' le haghaidh tuilleadh plé a dhéanamh ar an difríocht seo. I Django 4.0 agus níos luaithe, lean:: meth: `~django.contrib.admin.modeladmin.get_search_results an dara ceist sampla, ach mar thoradh ar an iompar neamhdhoiciméadaithe seo bhí ceisteanna le comhpháirteanna iomarcacha.

Athruithe eochra eachtracha a aisiompú do chásanna samhailLink to this heading#

<django.db.models.fields.related.RelatedManager>D'fhonn an t-iompar a aontú le caidreamh go leor le go leor le haghaidh cásanna samhail neamhshábháilte, ardaíonn eochair eachtrach droim “ValueError” anois agus iad ag glaoch ar: class: `bainisteoirí gaolmhara `le haghaidh rudaí neamhshábháilte.

IlghnéitheachLink to this heading#

• Tá bainisteoirí gaolmhara le haghaidh: class: ~django.db.models.foreignKey, :class: ~django.db.models.manyToManyField, agus:class: ~django.contrib.contentTypes.Fields.GenericRelation ar an sampla: Class: ~Django.db.Models.Model lena mbaineann siad anois. * Cuireadh an t-athrú seo ar ais i Django 4.1.2. *

• DiscoverRunner now returns a non-zero error code for unexpected successes from tests marked with unittest.expectedFailure().

• CsrfViewMiddleware no longer masks the CSRF cookie like it does the CSRF token in the DOM.

• CsrfViewMiddleware now uses request.META['CSRF_COOKIE'] for storing the unmasked CSRF secret rather than a masked version. This is an undocumented, private API.

• Tugann an: Attr: .ModelAdmin.Actions agus:attr: ~django.contrib.admin.modelAdmin.inlines réamhshocraithe anois le tuple folamh seachas liosta folamh chun sóchán neamhbheartaithe a dhíspreagadh.

• </topics/forms/media> <link>Níl an tréith type="text/css" san áireamh a thuilleadh i gclibeanna ```` le haghaidh CSS:doc: form media.

• Is imeachtaí JavaScript íon iad imeachtaí JavaScript formset:added agus formset: removed anois agus níl siad ag brath ar jQuery. Féach:ref: admin-javascript-inline-form-events le haghaidh tuilleadh sonraí faoin athrú.

• Cuirtear exception in ionad argóint exc_info den fheidhm ``django.utils.log.log_response () `neamhdhoiciméadaithe.

• Baintear argóint size den fheidhm ``django.views.static.was_modified_since () ``neamhdhoiciméadaithe.

• Úsáideann an UI logáil amach riaracháin iarratais ``POST ``anois.

• Cuirtear an modh non_form_errors () `in ionad na maoine neamhdhoiciméadaithe ``inlineAdminFormSet.NON_FORM_ERRORS. Tá sé seo comhsheasmhach le BaseFormSet.

• Mar gheall ar: ref: thuas <templates-4.1>, tá an lódóir teimpléad taisceáilte cumasaithe anois i bhforbairt. Féadfaidh tú ``OPTIONS ['loader'] ``a shonrú chun é seo a shárú, más gá.

• Cuirtear RedirecturlMixin` in ionad an mixin django.contrib.auth.views.successURLAllowedHostsMixin neamhdhoiciméadaithe.

• BaseConstraint subclasses must implement validate() method to allow those constraints to be used for validation.

• An URLResolver gan doiciméadú. _is_callback () ``, `UrlResolver. Bogtar _callback_strs, agus URLPattern.lookup_str () ``chuig ``django.contrib.admindocs.utils.

• Athraíonn an modh: Meth: .model.FULL_CLEAN luach eisiúint anois go set`. Is fearr freisin luach ``eisithe a chur ar aghaidh mar set chuig na modhanna: meth: .model.clean_fields, :meth: .model.full_clean, :meth: .model.validate_unique, agus:meth: .model.validate_restricints.

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

• Ní úsáideann abairtí comhcheangailte an t-iompar earráidí a bhaineann le tuairim a thuilleadh output_field` nuair a mheaitseálann cineálacha argóintí. Mar thoradh air sin, féadfaidh réiteach output_field le haghaidh feidhmeanna bunachar sonraí agus nathanna comhcheangailte titim anois le cineálacha measctha. Beidh ort an output_field` a shocrú go sainráite i gcásanna den sórt sin.

• Ní athraíonn an t-ordú:djaDmin: makemessages comhaid `.po ``a thuilleadh nuair a bhíonn siad cothrom le dáta. I leaganacha níos sine, rinneadh “Pot-Creation-Date” a nuashonrú i gcónaí.

Logáil amach trí GETLink to this heading#

<django.contrib.auth.views.LogoutView>Tá logáil amach trí iarratais GET chuig an:py:class: `amharc logála amach ionsuite `díluachtaithe. Úsáid iarratais ``POST ``ina ionad.

Más mian leat taithí úsáideora nasc HTML a choinneáil, is féidir leat foirm atá stíleáilte a úsáid le feiceáil mar nasc:

<form id="logout-form" method="post" action="{% url 'admin:logout' %}">
  {% csrf_token %}
  <button type="submit">{% translate "Log out" %}</button>
</form>

#logout-form {
  display: inline;
}
#logout-form button {
  background: none;
  border: none;
  cursor: pointer;
  padding: 0;
  text-decoration: underline;
}

IlghnéitheachLink to this heading#

• Tá an comhthéacs do theimpléid innéacs léarscáileáin léarscáileáin de liosta comhréidh URLanna míchuige. Ba chóir teimpléid innéacs léarscáileáin saincheaptha a nuashonrú do na hathróga coigeartaithe: ref: comhthéacs <sitemap-index-context-variables>, ag súil le liosta rudaí le suíomh ``agus tréithe roghnacha ``lastmod.

• Tá an socrú idirthréimhseach CSRF_COOKIE_MASKED a dhíchur.

• Tá an argóint ``ainm ``de:func: django.utils.functional.cached_property a dhíchur mar nach bhfuil sé gan ghá mar Python 3.6.

• <django.contrib.postgres.indexes.OpClass>Tá an argóint opclasses` de Django.contrib.postgres.Constraints.ExclusionConstraint` a dhíchur i bhfabhar úsáid:class: opClass () `in:attr: `.ExclusionConstraint.Expressions. Chun é a úsáid, ní mór duit 'django.contrib.postgres' a chur i d':setting: INSTALLED_APPS.

  Tar éis an t-athrú seo a dhéanamh, ginfidh :djadmin: makemigrations imirce nua le dhá oibríocht: removeConstraint` agus AddConstraint. Ós rud é nach bhfuil aon éifeacht ag an athrú seo ar an scéim bunachar sonraí, is féidir an oibríocht:: class: ~django.db.migrations.Operations.SeparateDatabaseAndState a úsáid chun an stát imirce a nuashonrú gan aon SQL a reáchtáil. Bog na hoibríochtaí a ghintear isteach san argóint state_operations de:class: ~django.db.migrations.Operations.SeparateDatabaseandState. Mar shampla:

  Code

  class Migration(migrations.Migration):
      ...
  
      operations = [
          migrations.SeparateDatabaseAndState(
              database_operations=[],
              state_operations=[
                  migrations.RemoveConstraint(...),
                  migrations.AddConstraint(...),
              ],
          ),
      ]
  

• <django.test.SimpleTestCase.assertFormSetError>Tá an cumas neamhdhoiciméadaithe chun Errors=None a rith chuig:meth: .simpletestCase.assertFormerror agus:meth: `assertFormSetError () `míchuige. Úsáid ``errors= [] ``ina ionad.

• Tá Django.Contrib.Sessions.Serializers.Pickleserializer a dhíchur mar gheall ar an mbaol go ndéanfar cód iargúlta a fhorghníomhú.

• Tá úsáid QuerySet.iterator () ``ar thacar cheisteanna a fhaigheann rudaí gaolmhara réamh-mheasta gan an argóint ``chunk_size a sholáthar. I leaganacha níos sine, níor rinneadh aon réamh-aimsiú. Tugann luach a sholáthar do chunk_size` le fios go bhfuil an ceist bhreise in aghaidh an phíosa a theastaíonn chun réamh-fháil ag teastáil.

• Tá cásanna samhail neamh-shábháilte a chur chuig scagairí gaolmhara. I Django 5.0, ardófar an eisceacht.

• Cuirtear created=True leis an síniú de:meth: .remoteUserBackend.configure_user. Tá tacaíocht do fho-aicmí RemoteUserBackend` nach nglacann leis an argóint seo a dhíchur.

• Tá an ailias django.utils.timezone.utc to:attr: datetime.timezone.utc díscothaithe. Úsáid: attr: datetime.timezone.utc go díreach.

• Tá réad freagartha agus ainm foirme/foirmeacha a chur chuig SimpletestCase.assertFormError () ``agus ``AssertFormSetError () a dhíchur. Úsáid:

  Code

  assertFormError(response.context["form_name"], ...)
  assertFormsetError(response.context["formset_name"], ...)
  

  nó pas an réad foirme/formset go díreach ina ionad sin.

• Tá an Django.contrib.gis.admin.openLayersWidget` neamhdhoiciméadaithe míchuige.

• Tá Django.Contrib.Auth.Hashers.CryptPasswordHasher díluachtaithe.

• An cumas chun modhanna Nulls_first=False nó Nulls_last=False a rith go Expression.asc () ``agus ``Expression.desc () modhanna, agus tá an abairt OrderBy díscothaithe. Úsáid ``None ``ina ionad.

• Tá na teimpléid ” django/forms/default.html “ agus ” django/forms/formsets/default.html “ atá ina seachfhreastalaí do na teimpléid tábla-bhunaithe a dhíchur. Úsáid an teimpléad sonrach ina ionad.

• Athainmnítear an modh ``logoutView.get_next_page () neamhdhoiciméadaithe go ``get_success_url () `.