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

Comhréir ródaithe URL simplitheLink to this heading#

The new django.urls.path() function allows a simpler, more readable URL routing syntax. For example, this example from previous Django releases:

url(r"^articles/(?P<year>[0-9]{4})/$", views.year_archive),

d'fhéadfaí a scríobh mar:

path("articles/<int:year>/", views.year_archive),

Tacaíonn an comhréireacht nua le cineál éigeantach ar pharaiméadair URL. Sa sampla, gheobhaidh an dearcadh an argóint eochairfhocal ``blian` mar shláimhir seachas mar shreang. Chomh maith leis sin, tá na URLanna a mheaitseálfaidh sé beagán níos lú srianta sa sampla athscríofa. Mar shampla, meaitneoidh an bliain 10000 anois ós rud é nach bhfuil sláimhreacha na bliana srianta go díreach ceithre dhigit ar fad mar atá siad san abairt rialta.

Tá an fheidhm django.conf.urls.url () ``ó leaganacha roimhe seo ar fáil anois mar: func: `django.urls.re_path`. Tá an sean-áit fós le haghaidh comhoiriúnacht ar ais, gan díghabháil atá le teacht. Is féidir an sean-fheidhm ``django.conf.urls.include () `allmhairithe anois ó ``django.urls ``ionas gur féidir leat ``ó django.urls allmhairiú include, path, re_path a úsáid i do URLConfs.

Athscríobhtar an doiciméad:doc: /topics/http/urls chun an comhréiteach nua a thaispeáint agus tuilleadh sonraí a sholáthar.

contrib.admin` atá cairdiúil don soghluaisteLink to this heading#

Tá an riarthóir sofhreagrach anois agus tacaíonn sé le gach mórghléas soghluaiste. D’fhéadfadh leibhéil éagsúla díghrádaithe a bheith ag brabhsálaithe níos sine.

Nathanna fuinneoigeLink to this heading#

Ligeann an léiriú nua:class: ~django.db.Models.Expressions.Window clásal OVER a chur le fiosraitheanna. <aggregation-functions>Is féidir leat:ref: feidhmeanna fuinneog <window-functions>`agus:ref: `feidhmeanna comhiomlána a úsáid sa abairt.

MionghnéitheLink to this heading#

Tacaíocht bainte le haghaidh bytestrings in áiteanna áiritheLink to this heading#

Chun tacú le teaghráin dúchasacha Python 2, b'éigean do leaganacha níos sine Django glacadh le teaghráin bytestrings agus teaghráin Unicode araon. Anois go bhfuil tacaíocht Python 2 titim, níor cheart teacht le bytestrings ach timpeall teorainneacha ionchuir/aschuir (láimhseáil réimsí dénártha nó sruthanna HTTP, mar shampla). B'fhéidir go mbeidh ort do chód a nuashonrú chun úsáid bytestring a theorannú go dtí a laghad, mar ní ghlacann Django le bytestrings i gcosáin cód áirithe a thuilleadh. Python's:option: d'fhéadfadh rogha -b cabhrú leis an botún sin i do chód a bhrath.

Mar shampla, úsáideann reverse () ``anois ``str () in ionad ``force_text () chun na args` agus kwar`gs` a fhaigheann sé a chur faoi iallach sula gcuirtear iad a shocrú sa URL. Maidir le bytestrings, cruthaíonn sé seo sreang le réimír b neamh-inmhianaithe chomh maith le luachana breise (str (b'foo') ``is ````b'foo'"). Chun oiriúnú, glaoigh ar decode () ``ar an mbytestring sula ndéantar é a chur chuig ``reverse ()`.

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

• Ní fhilleann na modhanna DatabaseOperations.dateTime_Cast_Date_SQL () ``, `datetime_cast_time_sql (), datetime_trunc_sql () `, datetime_extract_sql ()`, agus ``date_interval_sql () ``ach an SQL a dhéanamh chun an oibríocht a dhéanamh in ionad SQL agus SQL liosta de na paraiméadair.

• Ba chóir go gcuirfeadh cúltaca bunachar sonraí tríú páirtí tréith DatabaseWrapper.display_name leis ainm an bhunachar sonraí a oibríonn do chúltaca leis. Féadfaidh Django é a úsáid i dteachtaireachtaí éagsúla, mar shampla i seiceálacha córais.

• An chéad argóint de SchemaEditor. Is é _alter_column_type_sql () ``anois ``samhail seachas ``tábla ``.

• An chéad argóint de SchemaEditor. Is é _create_index_name () ``anois ``table_name seachas model.

• Chun tacaíocht FOR UPDATE OF ``a chumasú, socraigh databaseFeatures.HAS_SELECT_FOR_UPDATE_OF = True``. Má éilíonn an bunachar sonraí go mbeidh na hargóintí le OF` ná colúin seachas táblaí, socraigh databaseFeatures.select_for_update_of_column = True.

• Chun tacaíocht do: class: ~Django.db.Models.Expressions.Window a chumasú, socraigh DatabaseFeatures.supports_over_clause go True. B'fhéidir go mbeidh ort na modhanna databaseOperations.window_start_rows_start_end () ``agus/nó ``window_start_range_start_end () a shaincheapadh.

• Ba chóir go gcuirfeadh cúltaca bunachar sonraí tríú tríú tríú tréith databaseOperations.cast_char_field_without_max_length ``leis an gcineál sonraí bunachar sonraí a úsáidfear san fheidhm :class: `~django.db.models.functions.cast` le haghaidh ``charfield mura gcuirtear an argóint max_length`.

• An chéad argóint de DatabaseCreation. Is é _clone_test_db () ``agus ``get_test_db_clone_settings () anois suffix seachas uimhre (i gcás gur mhaith leat na sínithe i do chúlcheann a athainmniú le haghaidh comhsheasmhachta). Téann django.test anois ar na luachanna sin mar shreangáin seachas mar shláimhreacha.

• Ba chóir go gcuirfeadh cúltaca bunachar sonraí tríú páirtí modh DatabaseIntrospection.get_sequences () a chur leis bunaithe ar an stub i ``BaseDatabaseIntrospection`.

Tacaíocht titim do Oracle 11.2Link to this heading#

Is é deireadh na tacaíochta suas srutha do Oracle 11.2 ná Nollaig 2020. Tacófar le Django 1.11 go dtí Aibreán 2020 a shroicheann beagnach an dáta seo. Tacaíonn Django 2.0 go hoifigiúil le Oracle 12.1+.

Léitear leibhéal aonrúcháin réamhshocraithe MySQLLink to this heading#

D'fhéadfadh leibhéal aonrú réamhshocraithe MySQL, inléite athsheolta, a bheith ina chúis le caillteanas sonraí i ngnáthúsáid Chun é sin a chosc agus chun comhsheasmhacht le bunachair sonraí eile, léitear an leibhéal aonraithe réamhshocraithe tiomanta <mysql-isolation-level>Is féidir leat an socrú: setting: DATABASES a úsáid chó:ref: `úsáid leibhéal aonraithe difriúil `, más gá.

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

Tá imirce le haghaidh: attr: django.contrib.auth.models.user.last_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 d'ainmneacha deireanacha a chaomhnú, bain úsáid as foirm saincheaptha:

from django.contrib.auth.forms import UserChangeForm


class MyUserChangeForm(UserChangeForm):
    last_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)

Tá cosc ar QuerySet.reverse () ``agus ``last () tar éis slisnúLink to this heading#

Mar thoradh ar QuerySet.reverse () ``nó ``last () a ghlaoch ar shraith cheisteanna slisnaithe bíonn torthaí gan choinne mar gheall ar an slisnacht á chur i bhfeidhm tar éis athordú. Tá cosc air seo anois, m.sh.:

>>> Model.objects.all()[:2].reverse()
Traceback (most recent call last):
...
TypeError: Cannot reverse a query once a slice has been taken.

Ní ghlacann réimsí foirme le hargóintí roghnacha a thuilleadh marLink to this heading#

Chun cabhrú le hearráidí reatha a chosc mar gheall ar ordú mícheart argóintí réimse foirme, ní ghlactar le hargóintí roghnacha réimsí foirme ionsuite mar argóintí seasaim Mar shampla:

forms.IntegerField(25, 10)

ardaíonn eisceacht agus ba chóir na nithe seo a leanas a chur in ionad:

forms.IntegerField(max_value=25, min_value=10)

Bailíonn ``call_command () ``na roghanna a fhaigheann séLink to this heading#

Bailíonn call_command () ``anois go sainmhíníonn parser argóint an ordaithe atá á glaoch ar na roghanna go léir a chuirtear chuig ``call_command ().

Maidir le horduithe bainistíochta saincheaptha a úsáideann roghanna nach cruthaíodh ag baint úsáide as parser.add_argument () `, cuir tréith ``stealth_options` ar an ordú:

class MyCommand(BaseCommand):
    stealth_options = ("option_name", ...)

Ní ghlacann innéacsanna le hargóintí seasaimh a thuilLink to this heading#

Mar shampla:

models.Index(["headline", "-pub_date"], "index_name")

ardaíonn eisceacht agus ba chóir na nithe seo a leanas a chur in ionad:

models.Index(fields=["headline", "-pub_date"], name="index_name")

Tá príomhshrianta eachtracha cumasaithe anois ar SQLiteLink to this heading#

Beidh sé seo le feiceáil mar athrú neamh-chomhoiriúnach ar chúl (``IntegrityError: theip ar srian EOCHAIR FOREIGN ``) má dhéanann iarracht samhail shampla atá ann cheana a shábháil atá ag sárú srian eochair eachtrach.

Cruthaítear eochracha eachtracha anois le DEFERRABLE INICIALLY ATFERRED in ionad IDIRLEABLE IMMEDIATE. Dá bhrí sin, b'fhéidir go gcaithfear táblaí a atógáil chun eochracha eachtracha a athchruthú leis an sainmhíniú nua, go háirithe má tá patrún mar seo á úsáid agat:

from django.db import transaction

with transaction.atomic():
    Book.objects.create(author_id=1)
    Author.objects.create(id=1)

Mura ndéanann tú an eochair eachtrach a athchruthú mar ``DEFERRED`, theip ar an gcéad ``create () ``anois go ndéantar srianta eochairí eachtracha i bhfeidhm.

Cúltaca do bhunachar sonraí ar dtús Tar éis duit uasghrádú a dhéanamh go Django 2.0, is féidir leat táblaí a atógáil ag baint úsáide as script cosúil leis seo:

from django.apps import apps
from django.db import connection

for app in apps.get_app_configs():
    for model in app.get_models(include_auto_created=True):
        if model._meta.managed and not (model._meta.proxy or model._meta.swapped):
            for base in model.__bases__:
                if hasattr(base, "_meta"):
                    base._meta.local_many_to_many = []
            model._meta.local_many_to_many = []
            with connection.schema_editor() as editor:
                editor._remake_table(model)

Níor fuair an script seo tástáil fhairsing agus teastaíonn oiriúnú de dhíth le cásanna éagsúla mar iolracha bunachair Ná bíodh leisce ort feabhsuithe a chur leis.

Ina theannta sin, mar gheall ar theorannú athraithe tábla ar SQLite, tá sé toirmiscthe oibríochtaí: Class: ~Django.db.Migrations.Operations.RenameModel agus:class: ~django.db.migrations.operations.RenameField a dhéanamh ar mhúnlaí nó réimsí dá dtagraíonn samhlacha eile in idirbheart. D'fhonn ligean imirce ina bhfuil na hoibríochtaí seo a chur i bhfeidhm, ní mór duit an tréith ``Migration.Atomic` a shocrú go False.

IlghnéitheachLink to this heading#

• Baintear an rang SessionAuthenticationMiddleware as. Níor chuir sé feidhmiúlacht ar bith ar fáil ós rud é go bhfuil fíordheimhniú seisiún cumasaithe gan choinníoll in Django 1.10.

• Tá na láimhseálaithe réamhshocraithe earráide HTTP (`` láimhseálaí404``, etc.) inghlaoite anois in ionad teaghráin chonair Python poncaithe. Is fearr le Django tagairtí inghlaoite toisc go soláthraíonn siad feidhmíocht níos fearr agus taithí dífhabhtaithe.

• RedirectView no longer silences NoReverseMatch if the pattern_name doesn't exist.

• Nuair a bhíonn USE_L10N` as, :class: ~django.forms.floatfield agus:class: ~django.forms.decimalfield anois:setting: DECIMAL_SEPARATOR agus:setting: THOUSAND_SEPARATOR agus: setting: THOUSAND_SEPARATOR le linn bailíochtaithe. Mar shampla, leis na socruithe:

  Code

  USE_L10N = False
  USE_THOUSAND_SEPARATOR = True
  DECIMAL_SEPARATOR = ","
  THOUSAND_SEPARATOR = "."
  

  déantar ionchur de "1.345"` a thiontú anois go ``1345 in ionad ``1.345 ``.

• Níl fo-aicmí de AbstractBaseUser ag teastáil a thuilleadh chun get_short_name() agus get_full_name() a chur i bhfeidhm. (Baintear na bunfheidhmithe a ardaíonn NotImplementedError.) Úsáideann django.contrib.admin na modhanna seo má chuirtear i bhfeidhm iad ach níl siad de dhíth. B’fhéidir gur mhaith le haipeanna tríú páirtí a úsáideann na modhanna seo cur chuige comhchosúil a ghlacadh.

• Coinnítear na socruithe formáide FIRST_DAY_OF_WEEK agus NUMBER_GROUPING anois mar shláimhreacha in aschuir amharc JavaScript agus JSON i18n.

• assertNumQueries() now ignores connection configuration queries. Previously, if a test opened a new database connection, those queries could be included as part of the assertNumQueries() count.

• Méadaítear méid réamhshocraithe spáis tábla tástála Oracle ó 20M go 50M agus méadaítear an méid réamhshocraithe uathoibríoch ó 10M go 25M.

• Chun feidhmíocht a fheabhsú agus tacair mhóra torthaí á sruthú ón mbunachar sonraí, faigheann: meth: .queryset.iterator 2000 sraitheanna ag an am anois in ionad 100. Is féidir an sean-iompar a athbhunú ag baint úsáide as an paraiméadar chunk_size. Mar shampla:

  Code

  Book.objects.iterator(chunk_size=100)
  

• Ardaíonn ainmneacha pacáiste anaithnid a sholáthar san argóint packages den :class: ~django.views.i18n.javascriptCatalog amharc valueError anois in ionad dul go ciúin.

• Tá príomh-eochair samhail le feiceáil anois sa réamhshocraithe Samhail. __str__ () ``modh, m.sh. ``Rud ceist (1).

• Aimsíonn makemigrations athruithe anois ar an réimse samhail limit_choices_to rogha. Cuir é seo le do imirce atá ann cheana nó glac le himirce a ghintear go huathoibríoch do réimsí a úsáideann é.

• Ardaíonn fiosrúcháin a dteastaíonn uathoibrí:ref: claochluithe spásúla uathoibríoch <automatic-spatial-transformations>`anois `NotImplementederror` ar MySQL in ionad geoiméadraí neamh-chlaochlaithe a úsáid go ciúin.

• Baintear Django.Core.Exceptions.djangoruntimeWarning. Ní úsáideadh é ach sa chúltaca taisce mar rang idirmheánach in oidhreacht `CachekeyWarning de RuntimeWarning`.

• Athainmníodh BaseExpression. _output_field go output_field. B'fhéidir go mbeidh ort nathanna saincheaptha a nuashonrú.

• I leaganacha níos sine, comhcheanglaíonn foirmeacha agus foirmeacha a gcuid Meáin ``le giuirléid ``Meáin tríd an dá cheann a chomhcheangal. <form-media-asset-order>Déanann an comhcheangal iarracht anois:ref: ord coibhneasta eilimintí i ngach liosta a chaomhnú `. Eisítear ``MediaOrderConflictwarning` mura féidir an t-ordú a chaomhnú.

• Baintear Django.contrib.gis.gdal.ogrexception. Is ailias é do GdalException ó Django 1.8.

• Titeann tacaíocht do GEOS 3.3.x.

• Athraítear an bealach a roghnaítear sonraí le haghaidh GeometryField` chun feidhmíocht a fheabhsú, agus i gceisteanna SQL amh, caithfear na réimsí sin a fhilleadh anois in `connection.ops.select. Féach na:ref: `Nóta ceisteanna amh <gis-raw-sql>`sa rang teagaisc GIS mar shampla.

Argóint context de Field.from_DB_Value () ``agus ``Expression.convert_Value ()`Link to this heading#

Ní úsáidtear an argóint context de Field.from_DB_Value () ``agus ``Expression.convert_VALUE ()` mar is foclóir folamh é i gcónaí. Is é síniú an dá mhodh anois:

(self, value, expression, connection)

in ionad:

(self, value, expression, connection, context)

Fanann tacaíocht don seanshíniú i réimsí saincheaptha agus nathanna go dtí Django 3.0.

IlghnéitheachLink to this heading#

• Tá an modúl django.db.backends.postgresql_psycopg2 a dhíchur i bhfabhar django.db.backends.postgresql. Tá sé ina ainm ó Django 1.9. Ní théann sé seo ach ar chód a allmhairíonn ón modúl go díreach. Is féidir leis an socrú DATABASES django.db.backends.postgresql_psycopg2'` a úsáid fós, cé gur féidir leat é sin a shimpliú tríd an ainm ``'django.db.backends.postgresql' a chuirtear i Django 1.9 a úsáid.

• Tá ``django.shortcuts.render_to_response () ``luasghabháilte i bhfabhr:func: django.shortcuts.render. Glacann ``render () ``na hargóintí céanna ach amháin go dteastaíonn ``iarraidh` uaidh freisin.

• Tá an socrú DEFAULT_CONTENT_TYPE imithe i léig. Ní idirghníomhaíonn sé go maith le haipeanna tríú páirtí agus tá sé imithe i léig toisc gur tháinig HTML5 in ionad XHTML den chuid is mó.

• Tá HttpRequest.xReadLines () a dhíchur i bhfabhar athraithe thar an iarratas.

• Tá an argóint eochairfhocal field_name` to:meth: .querySet.Earliest agus:meth: .queryset.latest a dhíchur i bhfabhar ainmneacha na réimse a rith mar argóintí. Scríobh .early ('pub_date') ``in ionad ``.early (field_name='pub_date').