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

Cur i bhfeidhm crios ama réamhshocraithe zoneinfoLink to this heading#

Is é leabharlann caighdeánach Python's:mod: zoneinfo anois an cur i bhfeidhm crios ama réamhshocraithe i Django.

Is é seo an chéad chéim eile san imirce ó pytz a úsáid go húsáid:mod: zoneinfo. Ceadaigh Django 3.2 criosanna ama neamh-pytz a úsáid. Déanann Django 4.0 zoneinfo an cur i bhfeidhm réamhshocraithe. Tá tacaíocht do “pytz” díscríofa anois agus bainfear é i Django 5.0.

zoneinfo is part of the Python standard library from Python 3.9. The backports.zoneinfo package is automatically installed alongside Django if you are using Python 3.8.

Ba chóir go mbeadh an t-aistriú chuig zoneinfo` trédhearcach den chuid is mó. Ní dhéantar tionchar a dhéanamh ar roghnú an chrios ama reatha, cásanna dáta-ama a thiontú go dtí an crios ama reatha i bhfoirmeacha agus teimpléid, chomh maith le hoibríochtaí ar amanna dáta feasacha in UTC.

Mar sin féin, má tá tú ag obair le criosanna ama neamh-UTC, agus ag baint úsáide as na APIs `pytz normalú () ``agus ``localize () `, b'fhéidir leis an socrú: `TIME_ZONE, beidh ort iniúchadh a dhéanamh ar do chód, ós rud é nach bhfuil pytz` agus zoneinfo <DATABASE-TIME_ZONE>`comhionann go hiomlán.

Chun am a thabhairt d'iniúchadh den sórt sin, ceadaíonn an socrú idirthréimhseach USE_DEPRECATED_PYTZ úsáid leanúnach pytz le linn an timthriall scaoilte 4.x. Bainfear an suíomh seo i Django 5.0.

Ina theannta sin, is féidir pacáiste pytz_deprecation_shim, a chruthaigh an t-údar zoneinfo, a úsáid chun cabhrú leis an imirce ó pytz`. Soláthraíonn an pacáiste seo shims chun cabhrú leat pytz a bhaint go sábháilte, agus tá treoir imirce mionsonraithe aige a thaispeánann conas bogadh chuig na APIs nua zoneinfo.

Moltar úsáid a bhaint as pytz_deprecation_shim agus an socrú idirthréimhseach USE_DEPRECATED_PYTZ má theastaíonn cosán nuashonraithe de réir a chéile uait.

Srianta uathúla feidhmiúlaLink to this heading#

<django.db.models.UniqueConstraint>Cuireann an argóint seasaimh nua:attr: *expressions <django.db.models.UniqueConstraint.expressions>`de:class: `UniqueConstraint () ar chumas srianta feidhmiúla uathúla a chruthú ar nathanna agus ar fheidhmeanna bunachar sonraí. Mar shampla:

from django.db import models
from django.db.models import UniqueConstraint
from django.db.models.functions import Lower


class MyModel(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)

    class Meta:
        constraints = [
            UniqueConstraint(
                Lower("first_name"),
                Lower("last_name").desc(),
                name="first_last_name_unique",
            ),
        ]

<django.db.models.Options.constraints>Cuirtear srianta uathúla feidhmiúla le samhlacha ag baint úsáide as an rogha: attr: `Meta.Constraints `.

Hasher pasfhocal scryptLink to this heading#

Tá an nua:ref: `scrypt password hasher <scrypt-usage>`níos sábháilte agus moltar thar PBKDF2. Mar sin féin, ní hé an réamhshocrú é mar éilíonn OpenSSL 1.1+ agus níos mó cuimhne uaidh.

Cúltaca taisce RedisLink to this heading#

Soláthraíonn an cúltaca taisce nua ``Django.Core.Cache.Backends.Redis.RedisCache ``tacaíocht ionsuite do chaching le Redis. :pypi: `redis-py <redis>`3.0.0 nó níos airde teastaíonn. <redis>Le haghaidh tuilleadh sonraí, féach an:ref: `doiciméadú ar chaching le Redis i Django `.

Rindreáil foirm bunaithe ar theimLink to this heading#

Forms, Formsets, and ErrorList are now rendered using the template engine to enhance customization. See the new render(), get_context(), and template_name for Form and formset rendering for Formset.

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í.

• Glacann modhanna databaseOperations.year_lookup_bouns_for_date_field () ``agus ``year_lookup_bouns_for_datetime_field () an argóint roghnach iso_year d'fhonn tacú le teorainneacha do bhlianta uimhrithe seachtaine ISO-8601.

• An dara argóint de DatabaseSchemaEditor. Is é modhanna _unique_sql () ``agus ``_create_unique_sql () anois fields in ionad columns.

django.contrib.gisLink to this heading#

• Baintear tacaíocht do PostGIS 2.3.

• Baintear tacaíocht do GDAL 2.0 agus GEOS 3.5.

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

Críochnaíonn tacaíocht suas srutha do PostgreSQL 9.6 i mí na Samhna 2021. Tacaíonn Django 4.0 le PostgreSQL 10 agus níos airde.

Chomh maith leis sin, méadaítear an leagan íosta tacaithe de psycopg2 ó 2.5.4 go 2.8.4, mar is é psycopg2` 2.8.4 an chéad eisiúint chun tacú le Python 3.8.

Tacaíocht titim do Oracle 12.2 agus 18cLink to this heading#

Críochnaíonn tacaíocht suas srutha do Oracle 12.2 i mí an Mhárta 2022 agus do Oracle 18c críochnaíonn sé i mí an Mheithimh 2021 Tacófar le Django 3.2 go dtí Aibreán 2024. Tacaíonn Django 4.0 go hoifigiúil le Oracle 19c.

Athruithe CSRF_TRUSTED_ORIGINSLink to this heading#

Ní shocraíonn SecurityMiddleware ceannteideal ``X-XSS-Protection` a thuilleadhLink to this heading#

Ní shocraíonn an:class: ~django.middleware.security.securityMiddleware an ceannteideal X-XSS-Protection a thuilleadh má tá an socrú SECURE_BROWSER_XSS_FILTER True. Baintear an suíomh.

Ní thugann mórchuid na mbrabhsálaithe nua-aimseartha an ceannteideal HTTP ``X-XSS-Protection`. Is féidir leat Containt-Security Policy a úsáid gan scripteanna ``'unsafe-inline'` a cheadú ina ionad.

Más mian leat tacú le brabhsálaithe oidhreachta agus an ceannteideal a shocrú, bain úsáid as an líne seo i lár saincheaptha:

response.headers.setdefault("X-XSS-Protection", "1; mode=block")

Athruithe uathraitheoir imirceLink to this heading#

Úsáideann an t-uathbhreithnitheoir imirce stáit samhail anois in ionad ranganna samhail. Chomh maith leis sin, ní shonraíonn oibríochtaí imirce do réimsí ForeignKey agus ``ManyTomanyField` tréithe a thuilleadh nár cuireadh chuig na réimsí le linn an tionscnaimh.

Mar fho-éifeacht, d'fhéadfadh go mbeadh oibríochtaí “Alterfield” gan aon ghiniúint ag rith makemigrations` do réimsí ``ManyTomanyField` agus ``ForeignKey i gcásanna áirithe.

Athruithe DeleteViewLink to this heading#

DeleteView now uses FormMixin to handle POST requests. As a consequence, any custom deletion logic in delete() handlers should be moved to form_valid(), or a shared helper method, if required.

Athraíonn scéim ainmnithe tábla agus colún ar OracleLink to this heading#

D'athraigh Django 4.0 an scéim ainmniúcháin tábla agus colún ar Oracle go neamhthuiscint. Cuireann sé seo earráidí le haghaidh samhlacha agus réimsí le hainmneacha níos faide ná 30 carachtar. Ar an drochuair, tá gá le roinnt táblaí agus colún Oracle a athainmniú Úsáid an script uasghrádaithe in:ticket: 33789 chun ráitis RENAME <33789 #comment:15> a ghiniúint chun an scéim ainmniúcháin a athrú.

IlghnéitheachLink to this heading#

• Baintear tacaíocht do ``CX_Oracle ``<7.0.

• Chun a cheadú freastal ar shuíomh Django ar fho-chosán gan luach: setting: STATIC_URL a athrú, baintear an tosaigh den socrú sin (anois static/') sa teimpléad réamhshocraithe: djadmin: startproject.

• Níl an modh: Class: ~django.contrib.admin.admin.adminSite don amharc riaracháin index maisithe le never_cache a thuilleadh nuair a bhíonn rochtain air go díreach, seachas tríd an modh Adminsite.urls` molta, nó `Adminsite.get_URLs () `.

• Ardaíonn oibríochtaí gan tacaíocht ar shraith fiosrúcháin slisnaithe TypeError anois in ionad AssertionError.

• Athainmnítear an fheidhm ``django.test.runner.reorder_suite () neamhdhoiciméadaithe go ``reorder_tests () `. Glacann sé anois le tástálacha in-athraithe seachas sraith tástála, agus filleann sé athraitheoir tástálacha ar ais.

• Ag glaoch ar FilesystemStorage.delete () le ainm ``folamh, ardaíonn ``ValueError` in ionad AssertionError.

• Ag glaoch ar EmailMultiAlternatives.Attach_Alternative () ``nó ``EmailMessage.Attach () le hargóintí content nó mimetype` neamhbhailí ardaíonn ValueError in ionad AssertionError.

• assertHTMLEqual() no longer considers a non-boolean attribute without a value equal to an attribute with the same name and value.

• Meaitseálann tástálacha nach dteipfidh orthu a luchtú, mar shampla mar gheall ar earráidí comhréireachta, anois i gcónaí agus iad á n-úsáid:option: test --tag.

• Athainmnítear an fheidhm django.contrib.admin.utils.lookup_needs_different () ``gan doiciméadú go ``lookup_spawns_duplicates ().

• Baintear an modh ``HttpRequest.get_raw_uri () ``neamhdhoiciméadaithe. D'fhéadfadh an modh: Meth: `.httpRequest.build_Absolute_URI a bheith ina rogha eile oiriúnach.

• Athainmnítear an argóint object de mhodhanna ModelAdmin.log_Addition () ``, `log_change (), agus log_delete () ``neamhdhoiciméadaithe go ``obj.

• RssFeed, Atom1Feed, and their subclasses now emit elements with no content as self-closing tags.

• Ní chaitheann NodeList.render () ``aschur modh ``render () do nóid aonair chuig teaghrán a thuilleadh. Ba chóir go gcuirfeadh ``Node.render () ``teaghrán a thabhairt ar ais i gcónaí mar a dhoiciméadaithe.

• Baintear maoin where_class` django.db.models.sql.query.query agus an argóint where_class` leis an modh príobháideach get_extra_restriction` () ``de `ForeignObject agus`` ForeignoBject``. Más gá, cuir tús le Django.db.Models.sql.where.whereNode ina ionad.

• Cuirtear dhá argóint seasaimh filter_lhs` agus filter_rhs` in ionad argóint filter_clause` den mhodh ``Query.add_filter () ``neamhdhoiciméadaithe.

• CsrfViewMiddleware now uses request.META['CSRF_COOKIE_NEEDS_UPDATE'] in place of request.META['CSRF_COOKIE_USED'], request.csrf_cookie_needs_reset, and response.csrf_cookie_set to track whether the CSRF cookie should be sent. This is an undocumented, private API.

• Bogtar an tairiseach TRANSLATOR_COMMENT_MARK gan doiciméadú ó django.template.base go django.utils.translation.template.

• An argóint real_apps den `django.db.migrations.state.projectState gan doiciméadú. Caithfidh an modh __init__ () `a bheith ina tacar anois má sholáthraítear é.

• <div>:class: ~Django.Forms.RadioSelect agus:class: ~django.forms.CheckBoxSelectMultiple a rinneadh anois i gclibeanna ```` ionas go bhfógraíonn léitheoirí scáileáin iad níos gonta. Má theastaíonn an t-iompar roimhe seo uait, :ref: `athsháraigh an teimpléad giuirléid <overriding-built-in-widget-templates>`leis an teimpléad cuí ó Django 3.2.

• Ní bhraitheann an scagaire teimpléad: TFilter: floatformat a thuilleadh ar an socrú USE_L10N agus filleann sé aschur logánaithe i gcónaí. Úsáid an iarmhír u chun logánú a dhíchumasú.

• Athraítear luach réamhshocraithe an socrú USE_L10N go True. Féach an ranna:ref: `Logánú <use_l10n_deprecation>`thuas le haghaidh tuilleadh sonraí.

• Mar chuid den: ref: bogadh go zoneinfo <whats-new-4.0>, athraítear django.utils.timezone.utc go alias:attr: datetime.timezone.utc.

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

Úsáid criosanna ama pytzLink to this heading#

Mar chuid den: ref: bogadh go zoneinfo <whats-new-4.0>, tá úsáid criosanna ama pytz a dhíchur.

Dá réir sin, déantar na hargóintí is_dst` leis na nithe seo a leanas a dhíchur freisin:

• django.db.models.query.QuerySet.datetimes()

• django.db.models.functions.Trunc()

• django.db.models.functions.TruncSecond()

• django.db.models.functions.TruncMinute()

• django.db.models.functions.TruncHour()

• django.db.models.functions.TruncDay()

• django.db.models.functions.TruncWeek()

• django.db.models.functions.TruncMonth()

• django.db.models.functions.TruncQuarter()

• django.db.models.functions.TruncYear()

• django.utils.timezone.make_aware()

Bainfear tacaíocht le húsáid pytz i Django 5.0.

Tacaíocht crios amaLink to this heading#

D'fhonn dea-chleachtas a leanúint, athróidh luach réamhshocraithe an socruithe:: USE_TZ ó False go True`, agus cumasófar tacaíocht crios ama de réir réamhshocraithe, i Django 5.0.

<startproject><USE_TZ>Tabhair faoi deara go gcuimsíonn an comhad réamhshocraithe: file: settings.py a chruthaigh: djadmin: django-admin startproject `: socrú: `USE_TZ = Fíor ó Django 1.4.

Is féidir leat USE_TZ a shocrú go False i do shocruithe tionscadail roimhe sin chun diúltú.

LogánúLink to this heading#

D'fhonn dea-chleachtas a leanúint, athraítear luach réamhshocraithe an socrú USE_L10N ó False` go True`.

Ina theannta sin tá USE_L10N a dhíchur amhail an eisiúint seo. Ag tosú le Django 5.0, de réir réamhshocraithe, déanfar aon dáta nó uimhir a thaispeánann Django logánach.

Beidh Django onóir fós ar an gclibe:ttag: {% localize%}<localize> agus na scagairí:tfilter: localize/:tfilter: unlocalize fós.

IlghnéitheachLink to this heading#

• <test-case-serialized-rollback>Tá socrú tástála SERIALIZE a dhíchur mar is féidir é a thabhairt amach ón: attr: ~django.test.testcase.databases leis an rogha: ref: `serialized_rollback `cumasaithe.

• Tá an modúl django.utils.baseconv neamhdhoiciméadaithe míchuige.

• Tá an modúl django.utils.datetime_safe neamhdhoiciméadaithe míchuige.

• Athróidh an prótacal réamhshocraithe léarscáileanna láithreáin a tógadh lasmuigh de chomhthéacs iarratais ó `http' go https' i Django 5.0.

• Tá an argóint extra_tests le haghaidh: meth: .discoverRunner.build_suite agus:meth: .discoverRunner.run_tests a dhíchur.

• Fillfidh comhiomlánaithe `None nuair nach bhfuil aon sraitheanna ann in ionad Class: `~django.contrib.postgres.aggregates.jsonbagg`, ag:class: `~django.contrib.postgres.aggregates.stringagg` [], [], agus ````faoi seach i Django 5.0. Má theastaíonn an t-iompar roimhe seo uait, socraigh go sainráite ``réamhshocraithe go Luach ([]) ``, `Luach ('[]'), nó ``Luach (“) ``.

• Tá na ranganna Django.contrib.gis.admin.geomodelAdmin agus OsmGeoAdmin a dhíchur. Úsáid: aicme: ~django.contrib.admin.modelAdmin agus:class: ~django.contrib.gis.admin.gismodelAdmin ina ionad.

• Ós rud é go n-úsáideann rindreáil foirme an t-inneall teimpléad anois, tá an ``BaseForm neamhchá _html_output () ``tá modh cúntóra as lasmuigh.

• Tá an cumas chun str a thabhairt ar ais ó ErrorList agus ErrorDict a chur ar ais as ErrorDict. Táthar ag súil go bhfillfidh na modhanna seo Safestring.