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

Scagairí facet sa riarachánLink to this heading#

Taispeántar comhaireamh gnéithe anois le haghaidh scagairí feidhme sa liosta athraithe riaracháin nuair a dhéantar iad a thosú tríd an gComhéadan Is féidir an t-iompar seo a athrú tríd an tréith nua:attr: .modeladmin.show_facets. Le haghaidh tuilleadh faisnéise féach:ref: facet-filters.

Teimpléid shimplithe le haghaidh rindreáil réimseLink to this heading#

Tugann Django 5.0 coincheap grúpa allamuigh isteach, agus teimpléid grúpa allamuigh. Déanann sé seo rindreáil na n-eilimintí gaolmhara de réimse foirme Django mar a lipéad, giuirléid, téacs cabhrach agus earráidí a shimpliú.

Mar shampla, an teimpléad thíos:

<form>
...
<div>
  {{ form.name.label_tag }}
  {% if form.name.help_text %}
    <div class="helptext" id="{{ form.name.auto_id }}_helptext">
      {{ form.name.help_text|safe }}
    </div>
  {% endif %}
  {{ form.name.errors }}
  {{ form.name }}
  <div class="row">
    <div class="col">
      {{ form.email.label_tag }}
      {% if form.email.help_text %}
        <div class="helptext" id="{{ form.email.auto_id }}_helptext">
          {{ form.email.help_text|safe }}
        </div>
      {% endif %}
      {{ form.email.errors }}
      {{ form.email }}
    </div>
    <div class="col">
      {{ form.password.label_tag }}
      {% if form.password.help_text %}
        <div class="helptext" id="{{ form.password.auto_id }}_helptext">
          {{ form.password.help_text|safe }}
        </div>
      {% endif %}
      {{ form.password.errors }}
      {{ form.password }}
    </div>
  </div>
</div>
...
</form>

Is féidir é a shimpliú anois go:

<form>
...
<div>
  {{ form.name.as_field_group }}
  <div class="row">
    <div class="col">{{ form.email.as_field_group }}</div>
    <div class="col">{{ form.password.as_field_group }}</div>
  </div>
</div>
...
</form>

as_field_group() renders fields with the "django/forms/field.html" template by default and can be customized on a per-project, per-field, or per-request basis. See Teimpléid grúpa allamuigh.

Luachanna réamhshocraithe ríofa bunachar sonraíLink to this heading#

<django.db.models.Field.db_default>Socraíonn an paraiméadar nua:attr: `Field.db_default `luach réamhshocraithe ríofa bunachar sonraí. Mar shampla:

from django.db import models
from django.db.models.functions import Now, Pi


class MyModel(models.Model):
    age = models.IntegerField(db_default=18)
    created = models.DateTimeField(db_default=Now())
    circumference = models.FloatField(db_default=2 * Pi())

Réimse samhail a ghintear bunacharLink to this heading#

Ceadaíonn an nua:class: ~django.db.Models.GeneratedField colúin a ghintear bunachar sonraí a chruthú. Is féidir an réimse seo a úsáid ar gach cúltaca bunachar sonraí tacaithe chun réimse a chruthú a ríomhtar i gcónaí ó réimsí eile. Mar shampla:

from django.db import models
from django.db.models import F


class Square(models.Model):
    side = models.IntegerField()
    area = models.GeneratedField(
        expression=F("side") * F("side"),
        output_field=models.BigIntegerField(),
        db_persist=True,
    )

Tuilleadh roghanna chun roghanna allamuighLink to this heading#

Field.choices (for model fields) and ChoiceField.choices (for form fields) allow for more flexibility when declaring their values. In previous versions of Django, choices should either be a list of 2-tuples, or an Cineálacha áireamh subclass, but the latter required accessing the .choices attribute to provide the values in the expected form:

from django.db import models

Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE")

SPORT_CHOICES = [
    ("Martial Arts", [("judo", "Judo"), ("karate", "Karate")]),
    ("Racket", [("badminton", "Badminton"), ("tennis", "Tennis")]),
    ("unknown", "Unknown"),
]


class Winner(models.Model):
    name = models.CharField(...)
    medal = models.CharField(..., choices=Medal.choices)
    sport = models.CharField(..., choices=SPORT_CHOICES)

<field-choices-enum-types>Cuireann Django 5.0 tacaíocht le glacadh le mapáil nó le glaoch in ionad athraitheach, agus ní éilíonn freisin go n-úsáidfear .choices` go ndéanfaí úsáid go díreach chun leathnaithe:ref: `cineálacha áireamh `:

from django.db import models

Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE")

SPORT_CHOICES = {  # Using a mapping instead of a list of 2-tuples.
    "Martial Arts": {"judo": "Judo", "karate": "Karate"},
    "Racket": {"badminton": "Badminton", "tennis": "Tennis"},
    "unknown": "Unknown",
}


def get_scores():
    return [(i, str(i)) for i in range(10)]


class Winner(models.Model):
    name = models.CharField(...)
    medal = models.CharField(..., choices=Medal)  # Using `.choices` not required.
    sport = models.CharField(..., choices=SPORT_CHOICES)
    score = models.IntegerField(choices=get_scores)  # A callable is allowed.

Faoin gcochall déantar na “roghanna” a sholáthraítear a normalú i liosta de dhá thúpla mar an fhoirm chanónach aon uair a nuashonraítear an luach ``roghnaí`. <field-choices>Le haghaidh tuilleadh faisnéise, seiceáil le do thoil an:ref: `tagairt réimse samhail ar roghanna `.

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

• Ba chóir DatabaseFeatures.supports_expression_defaults a shocrú go False mura dtacaíonn an bunachar sonraí le feidhmeanna bunachar sonraí a úsáid mar réamhshocraithe.

• Ba chóir databaseFeatures.supports_default_keyword_in_insert a shocrú go False mura dtacaíonn an bunachar sonraí leis an eochairfhocal DEFAULT i gceisteanna INSERT.

• Ba chóir databaseFeatures.supports_default_keyword_in_bulk_insert a shocrú go False mura dtacaíonn an bunachar sonraí leis an eochairfhocal DEFAULT i mórcheisteanna INSERT.

django.contrib.gisLink to this heading#

• Baintear tacaíocht do GDAL 2.2 agus 2.3.

• Baintear tacaíocht do GEOS 3.6 agus 3.7.

django.contrib.sitemapsLink to this heading#

• Baintear an fheidhm django.contrib.sitemaps.ping_google () ``agus an t-ordú bainistíochta `ping_google de réir mar a dhéantar críochphointe ping Google Sitemaps as dul in iúl agus bainfear é i mí Eanáir 2024.

• Baintear an rang eisceachta Django.Contrib.SiteMaps.SiteMapNotFound.

Tacaíocht titim do MySQL < 8.0.11Link to this heading#

Baintear tacaíocht do réamh-eisiúintí de shraith MySQL 8.0.x. Tacaíonn Django 5.0 le MySQL 8.0.11 agus níos airde.

D'fhéadfadh go mbeadh gá anois ag baint úsáide as create_defaults__exact le ``QuerySet.Update_or_create () ``Link to this heading#

QuerySet.update_or_create() now supports the parameter create_defaults. As a consequence, any models that have a field named create_defaults that are used with an update_or_create() should specify the field in the lookup with create_defaults__exact.

Ag aistriú UUIDField atá ann cheana ar MariaDB 10.7+Link to this heading#

Ar MariaDB 10.7+, cruthaítear UUIDField anois mar cholún UUID seachas colún CHAR (32) ``. Mar thoradh air sin, ba cheart fo-aicme ``UUidField a thacaíonn CHAR (32) ``a chur in ionad aon ``UUIDField a cruthaíodh i Django < 5.0:

class Char32UUIDField(models.UUIDField):
    def db_type(self, connection):
        return "char(32)"

    def get_db_prep_value(self, value, connection, prepared=False):
        value = super().get_db_prep_value(value, connection, prepared)
        if value is not None:
            value = value.hex
        return value

Mar shampla:

class MyModel(models.Model):
    uuid = models.UUIDField(primary_key=True, default=uuid.uuid4)

Ba chóir go mbeadh:

class Char32UUIDField(models.UUIDField): ...


class MyModel(models.Model):
    uuid = Char32UUIDField(primary_key=True, default=uuid.uuid4)

Ag rith an t-ordú:djadmin: makemigrations ginfidh imirce ina bhfuil oibríocht ``Alterfield` gan op.

IlghnéitheachLink to this heading#

• Athainmnítear argóint instance an modh BaseModelFormSet.save_Existing () ``neamhdhoiciméadaithe go ``obj.

• Baintear an django.contrib.admin.helpers.checkbox neamhdhoiciméadaithe.

• Déantar réimsí sláimhir a bhailíochtú anois mar shláimhreacha 64-giotán ar SQLite chun iompar sqlite3` a mheaitseáil.

• Athraítear an tréith Query.annotation_Select_Mask neamhdhoiciméadaithe ó shraith teaghráin go liosta ordaithe teaghráin.

• Ní ghlaofar imagefield.update_dimension_fields () ``ar an gcomhartha ``post_init a thuilleadh mura socraítear width_field agus height_field.

• Now database function now uses LOCALTIMESTAMP instead of CURRENT_TIMESTAMP on Oracle.

• <div><h1>:attr: .adminsite.site_header a rindreáiltear anois i gclib ```` in ionad ````. Tá úsáideoirí léitheoirí scáileáin ag brath ar eilimintí ceannteidil le haghaidh nasclean Bhí dhá ghné <h1>```a bheith mearbhall agus ní raibh ceanntásc an láithreáin cabhrach mar go ndéantar é a athdhéanamh ar gach leathanach.

• <div>D'fhonn inrochtaineacht a fheabhsú, déantar príomhlimistéar ábhair an riaracháin agus limistéar ábhar ceanntásc a léiriú anois i gclib <main>```` agus ```` <header>``in ionad`` `.

• Ar bhunachair sonraí gan tacaíocht dhúchasach don oibreoir SQL XOR, filleann ^ mar oibreoir eisiach nó (XOR) sraitheanna anois atá comhoiriúnaithe le líon aisteach oibrithe seachas oibrand amháin go díreach. Tá sé seo ag teacht le hiompar MySQL, MariaDB, agus Python.

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

• Méadaítear an leagan íosta tacaithe de selenium` ó 3.8.0 go 4.8.0.

• Aistrítear na heisceachtaí AlreadyRegistered agus Notregistered` ó django.contrib.admin.sites go django.contrib.admin.exceptions`.

• Méadaítear an leagan íosta tacaithe de SQLite ó 3.21.0 go 3.27.0.

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

• Ardaíonn sé anois ceisteanna SQL a fhorghníomhú sula ndéantar clárlann na n-aipeanna daonra go hiomlán anois:exc: RuntimeWarning.

• : exc: Ardaítear ~django.core.exceptions.badRequest le haghaidh iarratais ionchódaithe neamh-UTF-8 leis an gcineál ábhair: mimetype: application/x-www-form-urlencoded. Féach: RFC: 1866 le haghaidh tuilleadh sonraí.

• Méadaítear an leagan íosta tacaithe de “colorama” go 0.4.6.

• Méadaítear an leagan íosta tacaithe de docutils go 0.19.

• Tugann scagadh ceisteanna i gcoinne luachanna sláimhriúla atá ró-shlán anois tacar ceisteanna folamh i gcónaí. <using-f-with-annotations>Mar thoradh air sin, b'fhéidir go mbeidh ort ``ExpressionWrapper () ``a úsáid to:ref: `uimhríocht a fhilleadh go sainráite `i gcoinne réimsí sláireach i gcásanna den sórt sin.

IlghnéitheachLink to this heading#

• Tá na léiritheoirí foirme idirthréimhseacha DjangoDivFormRenderer agus Jinja2DivFormRenderer a dhíchur.

• Tá argóintí seasaimh name agus violation_error_message a chur chuig:class: ~django.db.models.baseConstraint i bhfabhar argóintí eochairfhocal amháin.

• Cuirtear request leis an síniú de:meth: .modeladmin.lookup_allowed. Tá tacaíocht do fho-aicmí ModelAdmin nach nglacann leis an argóint seo caite.

• Tá an modh get_joining_columns () ``de `ForeignObject agus ForeignObjectRel a dhíchur. Ag tosú le Django 6.0, ní thiocfaidh Django.db.Models.sql.DataStructures.join ar ais chuig ``get_joining_columns () ``a thuilleadh. Ba chóir go gcuirfeadh fo-ranganna ``get_joining_fields () ``a chur i bhfeidhm ina ionad.

• Tá an modh ``ForeignObject.get_Reverse_Joining_Columns () ``a dhíchur.

• The default scheme for forms.URLField will change from "http" to "https" in Django 6.0. Set FORMS_URLFIELD_ASSUME_HTTPS transitional setting to True to opt into assuming "https" during the Django 5.x release cycle.

• FORMS_URLFIELD_ASSUME_HTTPS tá an socrú idirthréimhseach a dhíchur.

• Tá an tacaíocht chun glaoch ar ``format_html () ``gan args nó kwargs a rith a chur as.

• Tá tacaíocht do CX_Oracle` a dhíchur i bhfabhar tiománaí Python oracledb 1.3.2+.

• Táthar ag moladh DatabaseOperations.field_cast_sql() i bhfabhar DatabaseOperations.lookup_cast(). Ag tosú le Django 6.0, ní thabharfar field_cast_sql() ar BuiltinLookup.process_lhs() a thuilleadh. Ba cheart go gcuirfí lookup_cast() i bhfeidhm ina ionad sin d'innill bhunachar sonraí tríú páirtí.

• Athainmnítear an metaclass Django.db.Models.Enums.ChoiceSmeta go ChoiceStype.

• Tá an modh ``Prefetch.get_current_querySet () ``díluachtaithe.

• Tá an modh get_prefetch_queryset () ``bainisteoirí agus tuairiscí gaolmhara a dhíchur. Ag tosú le Django 6.0, ní thiocfaidh ``get_prefetcher () ``agus ``prefetch_related_objects () ar ais chuig ``get_prefetch_queryset () ``a thuilleadh. Ba chóir go gcuirfeadh fo-ranganna ``get_prefetch_querysets () ``a chur i bhfeidhm ina ionad.