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

Uathoibríoch: aicme: ~django.apps.appconfig fionnachtainLink to this heading#

Sainmhíníonn an chuid is mó de na feidhmchláir in-phlugáilte fo-aicme: ~django.apps.appconfig i bhfo-mhodúl apps.py. Sainmhíníonn go leor athróg default_app_config ag díriú ar an rang seo ina __init__.py.

Nuair a bhíonn an fo-mhodúl apps.py` ann agus go sainmhíníonn fo-aicme aonair: class: ~django.apps.appconfig, úsáideann Django anois an chumraíocht sin go huathoibríoch, ionas gur féidir leat default_app_config` a bhaint.

D'fhág default_app_config` ní féidir ach cosán an fheidhmchláir a dhearbhú in:setting: INSTALLED_APPS (m.sh. ``django.contrib.admin') seachas cosán cumraíochta an aip (m.sh. ``Django.contrib.admin.apps.adminconfig'). Tugadh isteach é le haghaidh comhoiriúnacht cúil leis an iar-stíl, agus é mar intinn an t-éiceachóras a aistriú go dtí an dara ceann, ach níor tharla an lasc.

Le fionnachtain uathoibríoch AppConfig, ní theastaíonn default_app_config a thuilleadh. Mar thoradh air sin, tá sé imithe.

Féach: ref: configuring-applications-ref le haghaidh sonraí iomlána.

Cineál eochracha bunscoile a chruthaíodh uathoibrLink to this heading#

<django.db.models.Field.primary_key>Nuair a shainmhínítear samhail, mura sainmhínítear aon réimse i msamhail le:attr: primary_key=true `cuirtear eochair bunscoile intuigthe leis. <django.apps.AppConfig.default_auto_field>Is féidir an cineál eochair bhunscoile intuigthe seo a rialú anois tríd an socrú: setting: `DEFAULT_AUTO_FIELD agus:attr: AppConfig.DEFault_AUTO_FIELD tréith. Níl gá níos mó eochracha bunscoile a shárú i ngach samhail.

Ag coinneáil an t-iompar stairiúil, is é an luach réamhshocraithe le haghaidh: socrú: DEFAULT_AUTO_FIELD: class: ~django.db.models.autofield. Ag tosú le 3.2 tionscadal nua a ghintear le:setting: DEFAULT_AUTO_FIELD atá socraithe to:class: ~DJANGO.DB.Models.BIGAUTOFIELD. <django.apps.AppConfig.default_auto_field>Chomh maith leis sin, gintear aipeanna nua le: attr: AppConfig.default_auto_field `socraithe to:class: `~django.db.models.bigautofield. Sa todhchaí a scaoileadh Django athrófar an luach réamhshocraithe de:setting: DEFAULT_AUTO_FIELD go dt:class: ~DJANGO.DB.Models.BIGAUTOFIELD.

Chun imirce nach dteastaíonn a sheachaint sa todhchaí, socraigh go sainráite:setting: DEFAULT_AUTO_FIELD to:class: ~django.db.models.autofield:

DEFAULT_AUTO_FIELD = "django.db.models.AutoField"

nó é a chumrú ar bhonn in aghaidh an aip:

from django.apps import AppConfig


class MyAppConfig(AppConfig):
    default_auto_field = "django.db.models.AutoField"
    name = "my_app"

nó ar bhonn in aghaidh an tsamhail:

from django.db import models


class MyModel(models.Model):
    id = models.AutoField(primary_key=True)

Le súil leis an réamhshocrú atá ag athrú, cuirfidh seiceáil chórais rabhadh ar fáil mura bhfuil socrú follasach agat le haghaidh: setting: DEFAULT_AUTO_FIELD.

Nuair a athraítear luach de:setting: DEFAULT_AUTO_FIELD, ní féidir imirce don phríomh-eochair an uathoibríoch atá cruthaithe ann cheana trí tháblaí a ghiniúint faoi láthair. Féach na:setting: DEFAULT_AUTO_FIELD docs le haghaidh sonraí maidir le táblaí den sórt sin a imirce.

Innéacsanna feidhmiúlaLink to this heading#

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

from django.db import models
from django.db.models import F, Index, Value
from django.db.models.functions import Lower, Upper


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

    class Meta:
        indexes = [
            Index(
                Lower("first_name"),
                Upper("last_name").desc(),
                name="first_last_name_idx",
            ),
            Index(
                F("height") / (F("weight") + Value(5)),
                name="calc_idx",
            ),
        ]

<django.db.models.Options.indexes>Cuirtear innéacsanna feidhmiúla le samhlacha ag baint úsáide as an rogha: attr: `Meta.Indexes `.

Tacaíocht pymemcacheLink to this heading#

Ligeann an cúltaca taisce nua django.core.cache.backends.memcached.pymemcacheCache leabharlanna:pypi: pymemcache a úsáid le haghaidh memcached. Teastaíonn pymemcache 3.4.0 nó níos airde. Le haghaidh tuilleadh sonraí, féach an:doc: doiciméadú maidir le caching in Django </topics/cache>.

Maisitheoirí nua don suíomh riaracháinLink to this heading#

Ceadaíonn an maisitheoir nua:func: ~django.contrib.admin.display roghanna a chur go héasca le feidhmeanna taispeána saincheaptha is féidir a úsáid le:attr: ~django.contrib.admin.modeladmin.list_display nó: attr: ~django.contrib.admin.modeladmin.readonly_fields.

Mar an gcéanna, ceadaíonn an maisitheoir nua:func: ~django.contrib.admin.action roghanna a chur go héasca le feidhmeanna gníomhaíochta is féidir a úsáid le:attr: ~django.contrib.admin.modeladmin.actions.

Tá an buntáiste ag baint úsáide as an maisitheoir @display gur féidir anois an maisitheoir @property a úsáid nuair is gá duit tréithe a shonrú ar an modh saincheaptha. Roimhe seo bhí sé riachtanach an fheidhm ``property () `a úsáid ina ionad sin tar éis na tréithe riachtanacha a shannadh don mhodh.

Tá an buntáiste ag baint le maisitheoirí a úsáid go bhfuil na roghanna seo níos infhaighte mar is féidir iad a mholadh trí fhóntais chríochnaithe in eagarthóirí cód. Níl siad ach áisiúlacht agus socraíonn siad na tréithe céanna fós ar na feidhmeanna faoin gcochall.

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

• Cuireann an maoin nua DatabaseFeatures.Introspected_Field_Types in ionad na gnéithe seo:

  • can_introspect_autofield

  • `Is féidir leis an réimse mór_iomlánaíneach

  • `is féidir _introspect_dénárach_réimhseach

  • ``Is féidir _introspect_deacimal_réimse ``

  • ``Is féidir _ionfheictitheoireach_tréimhseach_réimse `

  • Is féidir _introspect_ip_address _field

  • ``Is féidir _ionstraimhseach_dearfact_réimhseach_iomlán_réimse `

  • ``Is féidir _ionstraimhseach_beag_lán_réimse `

  • ``Is féidir _réimseach_aim_ionstraiméireacht `

  • cineál_infheicteoireach_mór_auto_field_

  • `cineál_réimsí beag_auto_field_introspected

  • `cineál_réimsí ionchosraithead_boolean

• Chun tacaíocht a chumasú chun innéacsanna a chlúdach (:attr: .index.include) agus srianta uathúla a chlúdach (:attr: .UniqueConstraint.include), socraigh databaseFeatures.supports_covering_indexes go True`.

• Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht do cholúin bunachar sonraí colún a chur i bhfeidhm ar Charfield agus TextFields nó DatabaseFeatures.supports_collation_on_charfield` agus databaseFeatures.supports_collation_on_textfield a shocrú go False`. Mura dtacaítear le comparáidí neamhchinnteacha, socraigh supports_non_deterministic_collations go False`.

• Baintear DatabaseOperations.Random_Function_SQL () i bhfabhar an fheidhm bunachar sonraí nua:class: ~Django.db.Models.Functions.Random.

• DatabaseOperations.date_trunc_sql () ``agus DatabaseOperations.time_trunc_sql () glacann anois an argóint roghnach ``tzname d'fhonn a ghearradh i gcrios ama ar leith.

• Faigheann DatabaseClient.runshell () `argóintí anois agus foclóir roghnach le hathróga comhshaoil chuig an gcliant líne ordaithe bunúsach ó ``DatabaseClient.settings_to_cmd_args_env () `modh. Caithfidh cúltaca bunachar sonraí tríú páirtí ``DatabaseClient.settings_to_cmd_args_env () `a chur i bhfeidhm nó ``DatabaseClient.runshell () a shárú.

• Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht d'innéacsanna feidhmiúla a chur i bhfeidhm (:attr: .index.Expressions) nó DatabaseFeatures.supports_Expression_indexes` a shocrú go False. Mura bhfuil COLLATE` mar chuid den ráiteas CREATE INDEX, socraigh databaseFeatures.collate_as_index_expression go True`.

django.contrib.adminLink to this heading#

• Tá naisc leathanaigh sa riarachán anois 1-innéacsaithe in ionad 0-innéacsaithe, ie is é an teaghrán fiosrúcháin don chéad leathanach ? p=1 in ionad ? p=0.

• Briseoidh an radharc nua riaracháin catch-all patrúin URL a atreoraítear tar éis na URLanna riaracháin agus an réimír URL riaracháin a mheaitseáil. <django.contrib.admin.AdminSite.final_catch_all_view>Is féidir leat d'ordú URL a choigeartú nó, más gá, socraí:attr: adminsite.final_catch_all_view `go `False`, ag díchumasú an radharc catch-all. Féach:ref: whats-new-3.2 le haghaidh tuilleadh sonraí.

• Ní chuirtear comhaid JavaScript mionraithe san áireamh leis an riarachán a thuilleadh. Má theastaíonn uait go ndéanfaí na comhaid seo a mionrú, smaoinigh ar aip tríú páirtí nó uirlis tógála seachtrach a úsáid. <contrib-admin-jquery>Tá na comhaid JavaScript mionraithe a phacáistithe leis an riarachán (e.g.:ref: `jquery.min.js `) san áireamh fós.

• ModelAdmin.prepopulated_fields no longer strips English stop words, such as 'a' or 'an'.

django.contrib.gisLink to this heading#

• Baintear tacaíocht do PostGIS 2.2.

• Clónaíonn cúltaca Oracle anois polagóin (agus bailiúcháin geoiméadais ina bhfuil polagóin) sula ndéanann siad iad a athdhíriú agus iad a shábháil ar an mbunachar sonraí. Níl siad sáraithe i bhfeidhm a thuilleadh. B'fhéidir go dtabharfá é seo a thabhairt faoi deara má úsáideann tú na polagóin tar éis samhail a shábháil.

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

Críochnaíonn tacaíocht suas srutha do PostgreSQL 9.5 i mí Feabhra 2021. Tacaíonn Django 3.2 le PostgreSQL 9.6 agus níos airde.

Tacaíocht titim do MySQL 5.6Link to this heading#

Is é Aibreán 2021 deireadh na tacaíochta suas srutha do MySQL 5.6. Tacaíonn Django 3.2 le MySQL 5.7 agus níos airde.

IlghnéitheachLink to this heading#

• Tacaíonn Django anois le criosanna ama neamh-pytz, mar shampla Python 3.9+'s:mod: zoneinfo modúl agus a backport.

• Athainmnítear an modh neamhdhoiciméadaithe SpatialiteOperations.proj4_version () ``go `proj_version ().

• slugify() now removes leading and trailing dashes and underscores.

• Ní bhraitheann scagairí teimpléad:tfilter: intcomma agus:tfilter: intword a thuilleadh ar an socrú USE_L10N.

• Baintear tacaíocht do ``argon2-cffi ``<19.1.0.

• Ní chuimsíonn na heochracha taisce an teanga a thuilleadh nuair a dhéantar idirnáisiúnú a dhíchumasú (USE_I18N = False) agus cuirtear logánú cumasaithe (USE_L10N = True). Tar éis uasghrádú a dhéanamh go Django 3.2 i gcumraíochtaí den sórt sin, is é an chéad iarratas ar aon luach a chosáiltear roimhe seo ná caill taisce.

• ``ForeignKey.validate () ``úsáideann anois:attr: ~Django.db.Models.Model. _base_manager seachas: attr: ~django.db.Models.Model. _default_manager chun a sheiceáil go bhfuil cásanna gaolmhara ann.

• Nuair a shainmhíníonn feidhmchlár fo-aicme: ~django.apps.appconfig i bhfo-mhodúl apps.py, úsáideann Django an chumraíocht seo go huathoibríoch anois, fiú mura bhfuil sé cumasaithe le default_app_config`. Socraigh default = False sa fho-aicme: ~django.apps.appconfig más gá duit an t-iompar seo a chosc. Féach:ref: whats-new-3.2 le haghaidh tuilleadh sonraí.

• Ardaíonn múnla teibí anois TypeError a thionscnamh.

• Tá argóintí eochairfhocal to:func: ~django.test.utils.setup_databases eochairfhocal amháin anois.

• Baintear an fheidhm ``django.utils.http.limited_parse_qsl () ``neamhdhoiciméadaithe. Úsáid le do thoil: func: urllib.parse.parse_qsl ina ionad.

• django.test.utils.TestContextDecorator now uses addCleanup() so that cleanups registered in the setUp() method are called before TestContextDecorator.disable().

• Ardaíonn SessionMiddleWare eisceacht anois a:exc: ~Django.Contrib.sessions.Exceptions.SessionInterrupted in ionad:exc: ~Django.Core.Exceptions.SuspiciousOperation nuair a scriostar seisiún in iarratas comhuaineach.

• Déanann an t-oibreoir comhionannais: Class: Django.DB.Models.Field idirdhealú i gceart anois cásanna allamuigh oidhreachta ar fud samhlacha. Ina theannta sin, sainmhínítear ordú réimsí den sórt sin anois.

• Filleann an fheidhm django.core.files.locks.lock () ``neamhdhoiciméadaithe ``False anois mura féidir an comhad a ghlasáil, in ionad ardú:exc: blockingioError.

• Déanann an mheicníocht athshocraithe pasfhocail neamhbhailí anois ar chomharthaí nuair a athraítear ríomhphost an úsáideora.

• makemessages command no longer processes invalid locales specified using makemessages --locale option, when they contain hyphens ('-').

• Is é an réimse foirme django.contrib.auth.forms.ReadOnlyPasswordHashfield anois:attr: ~django.forms.field.disabled de réir réamhshocraithe. Dá bhrí sin ní gá ``UserChangeForm.clean_password () ``an luach tosaigh a thabhairt ar ais a thuilleadh.

• Láimhseálann na hoibríochtaí taisce cache.get_many () ``, `get_or_set (), has_key () `, incr ()`, decr () `, incr_version ()`, agus decr_version () ``i gceart anois ``None` atá stóráilte sa taisce, ar an mbealach céanna le haon luach eile, in ionad iompar amhail is nach raibh an eochair ann.

  Mar gheall ar theorannú python-memcached, coimeádtar an t-iompar roimhe seo don chúltaca `MemcachedCache ``atá díluaite.

• Méadaítear an leagan íosta tacaithe de SQLite ó 3.8.3 go 3.9.0.

• CookieStorage now stores messages in the RFC 6265 compliant format. Support for cookies that use the old format remains until Django 4.1.

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

IlghnéitheachLink to this heading#

• Assigning objects which don't support creating deep copies with copy.deepcopy() to class attributes in TestCase.setUpTestData() is deprecated.

• Tá luach boolean a úsáid in:attr: .baseCommand.requires_System_Checks díluachtaithe. Úsáid '__all__' in ionad True, agus [] (liosta folamh) in ionad False.

• Tá an argóint whitelist agus an tréith domain_whitelist` de:class: ~django.core.validators.emailValidator a dhíchur. Úsáid allowlist in ionad whitelist, agus domain_allowlist in ionad domain_whitelist. B'fhéidir go mbeidh ort whitelist a athainmniú sna himirce atá ann cheana.

• Tá an t-athróg cumraíochta feidhmchláir default_app_config díscothaithe, mar gheall ar an bhfionnachtain AppConfig uathoibríoch anois. Féach:ref: whats-new-3.2 le haghaidh tuilleadh sonraí.

• Tá glaoch go huathoibríoch ar repr () ``ar shraith fiosrúcháin i ``TransactionTestCase.AssertQuerySetEqual ()`, i gcomparáid le luachanna teaghrán, a dhíchur. Má theastaíonn an t-iompar roimhe seo uait, socraigh go sainráite transform go repr.

• Tá an cúltaca django.core.cache.backends.memcached.memcachedcache díluaite mar tá roinnt fadhbanna ag python-memcached agus is cosúil nach bhfuil sé cothabháilte. Úsáid django.core.cache.backends.memcached.pymemcacheCache nó django.core.cache.backends.memcached.pylibmccache ina ionad.

• Tá formáid na dteachtaireachtaí a úsáideann 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.1.