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

Cuardach téacs iomlán do PostgreSQLLink to this heading#

Cuimsíonn django.contrib.postgres anois cnuasach feidhmeanna bunachar sonraí chun úsáid an innill chuardaigh téacs iomlán a cheadú. Is féidir leat cuardach a dhéanamh thar réimsí iolracha i do bhunachar sonraí coibhneasta, cuardaigh a chomhcheangal le cuardaigh eile, cumraíochtaí agus ualuithe éagsúla teanga a úsáid, agus na torthaí a rangú de réir ábharthacht.

Cuimsíonn sé tacaíocht trigram anois, ag baint úsáide as an lorgaí:lookup: trigram_similar, agus na:class: ~django.contrib.postgres.search.trigramsimilarity agus:class: ~django.contrib.postgres.search.trigramdistance.

Meán-earraí nua i stílLink to this heading#

</topics/http/middleware> < https://github.com/django/deps/blob/main/final/0005-improved-middleware.rst>:doc: “Cuirtear isteach stíl nua de mheán-earraí” chun an easpa docht iarrata/freagartha a réiteach ar sheanstíl mheánearraí a thuairiscítear in DEP 0005. Beidh ort: ref: sean-mheán-earraí saincheaptha a oiriúnú `agus aistriú ón socrú ``MIDDLEWARE <upgrading-middleware>_CLASSES` go dtí an socrú nua:setting: MIDDLEWARE chun leas a bhaint as na feabhsuithe.

Tacaíocht oifigiúil d'ainmneacha úsáideora UnicodeLink to this heading#

Ní ghlac an tsamhail:class: ~django.contrib.auth.models.user i django.contrib.auth ar dtús litreacha agus uimhreacha ASCII in ainmneacha úsáideora. Cé nach rogha d'aon ghnó a bhí ann, glacadh le carachtair Unicode i gcónaí agus Python 3 á úsáid agat.

Glacann an bailíochtóir ainm úsáideora go sainráite anois le carachtair Unicode de réir réamhshocraithe ar Python 3 amháin.

Féadfaidh samhlacha úsáideora saincheaptha an nua:class: ~django.contrib.auth.validators.asciiUserNameValidator nó: class: ~django.contrib.auth.validators.unicodeUserNameValidator a úsáid.

MionghnéitheLink to this heading#

API cúltaca bunachar sonraíLink to this heading#

• Úsáideann “Areafield” GIS cineál uimhriúil bunúsach neamhshonraithe a d'fhéadfadh a bheith i gcleachtas aon chineál uimhriúil Python. Déantar luachanna Decimal.Decimal a aisghabháiltear ón mbunachar sonraí a thiontú anois go float chun go mbeidh sé níos éasca iad a chomhcheangal le luachanna a úsáideann na leabharlanna GIS.

• D'fhonn gearradh ama a chumasú ní mór duit bratach gné bunachar sonraí supports_temporal_subtraction a shocrú go True agus an modh DatabaseOperations.subtract_temporals () a chur i bhfeidhm. Ba cheart don mhodh seo an SQL agus na paraiméadair a theastaíonn chun an difríocht i micreasoicind idir na hargóintí lhs` agus rhs` a ríomh sa chineál sonraí a úsáidtear chun stóráil:class: ~Django.db.Models.DurationField a ríomh.

Cuireann ``select_related () `cosc ar réimsí neamhghaolmhara do chaidreamh neadaitheLink to this heading#

Chuir Django 1.8 bailíochtú le haghaidh réimsí neamhghaolmhara i ``select_related () ``:

>>> Book.objects.select_related("title")
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'title'

Ach níor chuir sé cosc ar réimsí neamhghaolmhara neadaithe mar a dhéanann sé anois:

>>> Book.objects.select_related("author__name")
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'name'

Tugann ``_meta.get_fields () ``réimsí comhsheasmhacha droim ar ais do mhúnlaí seachfhreastalaíLink to this heading#

Roimh Django 1.10, chuir an modh: meth: ~django.db.models.options.options.get_fields réimsí droim éagsúla ar ais nuair a ghlaoigh sé ar mhúnla seachfhreastalaí i gcomparáid lena aicme coincréite seachfhála. Socraíodh an neamhréireacht seo tríd an tsraith iomlán réimsí a thabhairt ar ais ag díriú ar aicme coincréite nó ar cheann dá sheirbhísí sa dá chás.

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

Tá imirce le haghaidh: attr: django.contrib.auth.models.user.userName 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.

We considered an increase to 254 characters to more easily allow the use of email addresses (which are limited to 254 characters) as usernames but rejected it due to a MySQL limitation. When using the utf8mb4 encoding (recommended for proper Unicode support), MySQL can only create unique indexes with 191 characters by default. Therefore, if you need a longer length, please use a custom user model.

Más mian leat an teorainn 30 carachtar d'ainmneacha úsáideora a chaomhnú, bain úsáid as foirm saincheaptha agus úsáideoir á chruthú agat nó agus ainmneacha úsáideora á athrú agat:

from django.contrib.auth.forms import UserCreationForm


class MyUserCreationForm(UserCreationForm):
    username = forms.CharField(
        max_length=30,
        help_text="Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only.",
    )

Más mian leat an srian seo a choinneáil sa riarachán, socraigh ``UserAdmin.Add_Form ``chun an fhoirm seo a úsáid:

from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from django.contrib.auth.models import User


class UserAdmin(BaseUserAdmin):
    add_form = MyUserCreationForm


admin.site.unregister(User)
admin.site.register(User, UserAdmin)

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

Críochnaíonn tacaíocht suas srutha do PostgreSQL 9.1 i Meán Fómhair 2016. Mar thoradh air sin, leagann Django 1.10 PostgreSQL 9.2 mar an leagan íosta a thacaíonn sé go hoifigiúil.

Téann aschur ``runserver ``trí logáilLink to this heading#

Seoltar láimhseáil iarratais agus freagartha an ordaithe runserver chuig an logger:ref: django-server-logger in ionad chuig sys.stderr`. Má dhíchumraíonn tú cumraíocht logála Django nó má dhíchumraíonn tú é le do chuid féin, beidh ort an chumraíocht logála cuí a chur leis más mian leat an t-aschur sin a fheiceáil:

LOGGING = {
    # ...
    "formatters": {
        "django.server": {
            "()": "django.utils.log.ServerFormatter",
            "format": "[%(server_time)s] %(message)s",
        }
    },
    "handlers": {
        "django.server": {
            "level": "INFO",
            "class": "logging.StreamHandler",
            "formatter": "django.server",
        },
    },
    "loggers": {
        "django.server": {
            "handlers": ["django.server"],
            "level": "INFO",
            "propagate": False,
        }
    },
}

Baineadh samhlacha tástála Auth.CustomUser` agus Auth.ExtensionUserLink to this heading#

Ó tugadh isteach imirce do na feidhmchláir contrib i Django 1.8, níor cruthaíodh táblaí na samhlacha tástála úsáideora saincheaptha seo a thuilleadh rud a fhágann go bhfuil siad neamhúsáidte i gcomhthéacs tástála.

Ní dhéantar clárlann apps go huathoibríoch a thuilleadh nuair a dhíphictear samhlacha lasmuighLink to this heading#

Níl clárlann na n-aipeanna daonra go huathoibríoch a thuilleadh agus samhlacha á Cuireadh é seo leis i Django 1.7.2 mar iarracht samhlacha neamhphicilte a cheadú lasmuigh de Django, mar shampla in oibrí RQ, gan glaoch ar ``django.setup () , ach cruthaíonn sé an fhéidearthacht go mbeadh caoileadh ann. Chun do chód a oiriúnú i gcás RQ, is féidir leat `scriptúr oibrí féin a sholáthar `_ a ghlaonn ``django.setup (< https://python-rq.org/docs/workers/>) `.

Seiceáil sannadh neall bainte le haghaidh príomhréimsí eachtracha neamh-Link to this heading#

I leaganacha níos sine, a shannadh None do ForeignKey` neamh-neamh-neamhrialaithe nó OneTooneField ardaithe ``ValueError ('Ní féidir Aon a shannadh: ní cheadaíonn “model.field” luachanna null. ') ``. Le haghaidh comhsheasmhachta le réimsí samhlacha eile nach bhfuil seiceáil den chineál céanna acu, baintear an seiceáil seo.

Bainte hashers pasfhocal lag ón socrú réamhshocraithe PASSWORD_HASHERSLink to this heading#

Stóráilte pasfhocail Django 0.90 mar MD5 neamh-shailte. Chuir Django 0.91 tacaíocht le haghaidh SHA1 saillte le pasfhocail a uasghrádú uathoibríoch nuair a logálann úsáideoir isteach. Chuir Django 1.4 PBKDF2 leis mar an hasher pasfhocal réamhshocraithe.

If you have an old Django project with MD5 or SHA1 (even salted) encoded passwords, be aware that these can be cracked fairly easily with today's hardware. To make Django users acknowledge continued use of weak hashers, the following hashers are removed from the default PASSWORD_HASHERS setting:

• "django.contrib.auth.hashers.SHA1PasswordHasher"

• "django.contrib.auth.hashers.MD5PasswordHasher"

• "django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher"

• "django.contrib.auth.hashers.UnsaltedMD5PasswordHasher"

• "django.contrib.auth.hashers.CryptPasswordHasher"

Smaoinigh ar a:ref: phasfhocal fillte hasher <wrapping-password-hashers>`a úsáid chun na hashes i do bhunachar sonraí a neartú. Mura bhfuil sé sin indéanta, cuir an socrú:setting: `PASSWORD_HASHERS le do thionscadal agus cuir aon hashers a theastaíonn uait ar ais.

Is féidir leat a sheiceáil an bhfuil aon cheann de na hashers bainte mar seo ag do bhunachar sonraí:

from django.contrib.auth import get_user_model

User = get_user_model()

# Unsalted MD5/SHA1:
User.objects.filter(password__startswith="md5$$")
User.objects.filter(password__startswith="sha1$$")
# Salted MD5/SHA1:
User.objects.filter(password__startswith="md5$").exclude(password__startswith="md5$$")
User.objects.filter(password__startswith="sha1$").exclude(password__startswith="sha1$$")
# Crypt hasher:
User.objects.filter(password__startswith="crypt$$")

from django.db.models import CharField
from django.db.models.functions import Length

CharField.register_lookup(Length)
# Unsalted MD5 passwords might not have an 'md5$$' prefix:
User.objects.filter(password__length=32)

Baintear modhanna Field.get_prep_lookup () ``agus ``Field.get_db_prep_lookup ()Link to this heading#

Má tá réimse saincheaptha agat a chuireann ceachtar de na modhanna seo i bhfeidhm, cláraigh cuardach saincheaptha dó. Mar shampla:

from django.db.models import Field
from django.db.models.lookups import Exact


class MyField(Field): ...


class MyFieldExact(Exact):
    def get_prep_lookup(self):
        # do_custom_stuff_for_myfield
        ...


MyField.register_lookup(MyFieldExact)

django.contrib.gisLink to this heading#

• Titear tacaíocht do SpatiaLite <3.0 agus GEOS <3.3.

• Baintear an ailias comhoiriúnachta add_postgis_srs () ``ar chúl do `django.contrib.gis.utils.add_srs_entry ().

• Ar Oracle/GIS, filleann an fheidhm chomhiomlán:: class: ~django.contrib.gis.db.Models.Functions.Area float anois in ionad Decimal.Decimal. (Tá sé fós fillte i dtomhas méadar cearnach.)

• Déantar an ionadaíocht réamhshocraithe: class: ~django.contrib.gis.geos.geosgeometry (aschur WKT) a ghearradh de réir réamhshocraithe. Is é sin, in ionad POINT (23.0000000000000000 5.5000000000000000) ``, gheobhaidh tú ``POINT (23 5.5).

Tá uasmhéid comhlachta iarratais agus líon na bparaiméadair GET/POST teorantaLink to this heading#

Cuidíonn dhá shocrú nua le hionsaithe diúltaithe seirbhíse a mhaolú trí iarratais mhóra:

• DATA_UPLOAD_MAX_MEMORY_SIZE limits the size that a request body may be. File uploads don't count toward this limit.

• DATA_UPLOAD_MAX_NUMBER_FIELDS limits the number of GET/POST parameters that are parsed.

Seans go mbeidh ar iarratais a fhaigheann postanna foirmeacha neamhghnácha móra na socruithe seo a choigeartú.

IlghnéitheachLink to this heading#

• <QuerySet >Tá an repr () ``de `QuerySet` fillte i`` ``chun é a dhíbhriú ó liosta simplí agus é á dífhabhtú.

• ``utils.version.get_version () filleadh: pep: leaganacha iarrthóirí scaoilte comhlíontacha `440 (m.sh. '1.10rc1' in ionad '1.10c1').

• Ceanglaítear anois gur teaghráin de 64 alfa-uimhriúla iad luachanna dearbháin CSRF; cuirtear teaghráin de 64 carachtar in ionad luachanna 32 alfa-uimhriúla, mar atá socraithe ag leaganacha níos sine de Django de réir réamhshocraithe. Meastar luachanna eile a bheith neamhbhailí. Níor cheart go ndéanfadh sé seo difear ach d’fhorbróirí nó d’úsáideoirí a athsholáthróidh na comharthaí seo.

• Baintear an socrú LOGOUT_URL` toisc nár bhain Django úsáid as ó roimh 1.0. Má úsáideann tú é i do thionscadal, is féidir leat é a chur le socruithe do thionscadail. Ba é an luach réamhshocraithe ná ``'/cuntais/logáil/'.

• Tá rudaí le modh close () ``mar chomhaid agus gineadóirí a chuirtear chuig: class: `~django.http.httpResponse` dúnta anois láithreach in ionad nuair a ghlaonn an freastalaí WSGI ``close () ar an bhfreagra.

• Baintear glao iomarcach transaction.atomic () ``i `QuerySet.Update_or_create (). D'fhéadfadh sé seo dul i bhfeidhm ar chomhaireamh ceisteanna a ndearnadh tástáil ag ``TransactionTestCase.assertNumQueries () ``.

• Baintear tacaíocht do skip_validation` i BaseCommand.execute (**roghanna) ``. Úsáid ``skip_checks (cuireadh i Django 1.7) ina ionad.

• : djadmin: Ardaíonn loaddata CommandError anois in ionad rabhadh a thaispeáint nuair nach bhfaightear an comhad daingneáin sonraithe.

• In ionad rochtain a fháil go díreach ar an tréith Logentry.change_message, is fearr anois glaoch ar an modh ``Logentry.get_change_message () ``a sholáthróidh an teachtaireacht sa teanga reatha.

• Ardaíonn na tuairimí earráide réamhshocraithe TemplateDoesNotExist anois má shonraítear template_name nach bhfuil ann.

• Baintear an argóint eochairfhocal roghnaí` neamhúsáidte den mhodh ``Relect agus SelectMultiple render () ``giuirléidí ``Render ()`. Baintear an argóint roghna den mhodh render_options () ``freisin, rud a fhágann go bhfuil `roghnaí_roghnaithe an chéad argóint.

• Déanfaidh tástálacha a sháraíonn srianta bunachar sonraí in-iarchurtha earráid anois nuair a reáchtáiltear iad ar bhunachar sonraí a thacaíonn le srianta in-iarchurtha.

• Úsáideann orduithe bainistíochta ionsuite anois innéacsú eochracha i “roghanna”, m.sh. options ['verbosity'] ``, in ionad ``options.get () agus ní dhéanann siad aon chineál comhéigeantach a thuilleadh. D'fhéadfadh sé seo a bheith ina fhadhb má tá tú ag glaoch orduithe ag baint úsáide as Command.execute () ``(a sheachnaíonn an parser argóint a leagann luach réamhshocraithe) in ionad:func: `~django.core.management.call_command`. In ionad glaoch ar ``Command.execute () ``, pas an réad ordaithe mar an chéad argóint chuig ``call_command ().

• Diúltaíonn: ~django.contrib.auth.backends.modelBackend agus:class: ~django.contrib.auth.backends.remoteUserBackend úsáideoirí neamhghníomhacha anois. Ciallaíonn sé seo nach féidir le húsáideoirí neamhghníomhacha logáil isteach agus logálfar amach iad má aistrítear iad ó is_active=true go False. Má theastaíonn an t-iompar roimhe seo uait, bain úsáid as an nua:class: ~django.contrib.auth.backends.allowAllUsersModelBackend nó:class: ~django.contrib.auth.backends.allowAllUsersRemoteUserBackend in:setting: AUTHENTICATION_BACKENDS ina ionad.

• In light of the previous change, the test client's login() method no longer always rejects inactive users but instead delegates this decision to the authentication backend. force_login() also delegates the decision to the authentication backend, so if you're using the default backends, you need to use an active user.

• django.views.i18n.set_language() may now return a 204 status code for AJAX requests.

• The base_field attribute of RangeField is now a type of field, not an instance of a field. If you have created a custom subclass of RangeField, you should change the base_field attribute.

• Cuirtear ranganna Middleware a thionscnamh anois nuair a thosaíonn an freastalaí seachas le linn na chéad iarratais.

• <user-is-auth-anon-deprecation>Má sháraitheann tú is_autentifikated () ``nó ``is_anonymné () i samhail úsáideora saincheaptha, ní mór duit iad a thiontú go tréithe nó airíonna mar a thuairiscítear in:ref: `an nóta dímheasa `.

• Nuair a úsáidtear: attr: ModelAdmin.save_ <django.contrib.admin.ModelAdmin.save_as>as = True `, atreoraíonn an cnaipe “Sábháil mar nua” anois chuig an radharc athraithe don réad nua in ionad chuig liosta athraithe an tsamhail. <django.contrib.admin.ModelAdmin.save_as_continue>Má theastaíonn an t-iompar roimhe seo uait, socraigh an tréith nua:attr: `ModelAdmin.save_as_continue `do `False`.

• Tá an tréith HTML “riachtanach” ag réimsí foirme riachtanacha anois. <django.forms.Form.use_required_attribute>Socraigh an tréith: attr: Form.USE_Required_Attribute `le `False` chun é a dhíchumasú. D'fhéadfá an tréith novalidate a chur le ```` mura dteastaíonn bailíochtú brabhsála <form>í uait. <django.forms.Widget.use_required_attribute>Chun an tréith riachtan a dhíchumasú ar ghuirléidí saincheaptha, athsháraigh an modh:meth: `Widget.USE_REQUIRED_ATTRIBUTE () `.

• Ní bhaineann an láimhseálaí WSGI ábhar na bhfreagraí a thuilleadh ó iarratais nó freagraí HEAD` le ``status_code de 100-199, 204, nó 304. Cuireann an chuid is mó de na freastalaithe gréasáin an t-iompar seo Leanann na “socruithe freagartha” seo i bhfeidhm ag freagraí a aisghabhadh ag úsáid cliant tástála Django.

• Samhail. Faigheann __init__ () ```Django.db.Models.Deferred anois mar luach na réimsí iarchurtha.

• An Samhail. Baintear tréith _athraingthe ``mar aicmí samhail dinimiciúla nuair a úsáidtear ``querySet.Defer () agus ``only () ``baintear.

• Storage.save() no longer replaces '\' with '/'. This behavior is moved to FileSystemStorage since this is a storage specific implementation detail. Any Windows user with a custom storage implementation that relies on this behavior will need to implement it in the custom storage's save() method.

• Príobháideach:Class: ~django.db.models.filefield ní thuilleadh ar mhodhanna get_directory_name () ``agus `get_filename () a thuilleadh (agus tá siad curtha anois) ar athrú neamh-chomhoiriúnach é d'úsáideoirí a sháraíonn na modhanna sin ar réimsí saincheaptha. <django.core.files.storage.Storage.generate_filename>Chun an cód den sórt sin a oiriúnú, déan filefield.generate_filename () ```nó: meth: `Storage.generate_filename () ina ionad. B'fhéidir go mbeadh sé indéanta a úsáid:attr: ~django.db.models.filefield.upload_to freisin.

• Ní ghearrtar ábhar an phoist a sheolann AdminEmailHandler ag 989 carachtar a thuilleadh. Má bhí tú ag brath ar fad teoranta, déan an t-ábhar a ghearradh ort féin.

• Baintear abairtí príobháideacha Django.db.Models.Expressions.Date agus DateTime`. Soláthraíonn na nathanna nua:class: ~django.db.models.functions.trunc an fheidhmiúlacht chéanna.

• Baintear na tréithe _base_manager agus _default_manager ó chásanna samhail. Tá siad inrochtana ar an rang samhail.

• Ag rochtain a fháil ar réimse scriosta ar shampla samhail, m.sh. tar éis del obj.field, luach an réimse a athluchtú in ionad AttributeError a ardú.

• Má dhéanann tú fo-aicme AbstractBaseUser agus má sháraíonn tú clean () ``, bí cinnte go nglacann sé ``super (). :meth: Glaítear .AbstractBaseUser.Normalize_UserName i modh nua:meth: .AbstractBaseUser.clean.

• Tugann API príobháideach django.forms.models.model_to_dict () ``tacar fiosrúcháin seachas liosta de na príomheochracha do ``ManyTomanyFields.

• Má tá django.contrib.staticfiles` suiteáilte, úsáideann an clib teimpléad:ttag: static an stóráil staticfiles chun an URL a thógáil seachas an luach a cheangal le STATIC_ROOT`. Ionchódaíonn an cur chuige nua an URL, a d'fhéadfadh a bheith comhoiriúnach ar chúl i gcásanna amhail blúire a áireamh i gcosán, m.sh. {% static 'img.svg #fragment'%} `, ós rud é go bhfuil an `# ionchódaithe mar %23`. Chun oiriúnú, bog an blúire lasmuigh den chlib teimpléad: {% static 'img.svg'%} #fragment.

• Nuair a bhíonn USE_L10N True, cuirtear logánú i bhfeidhm anois ar na scagairí:tfilter: dáta agus:tfilter: time nuair nach sonraítear aon teaghrán formáide. Úsáidtear na sonraitheoirí DATE_FORMAT agus TIME_FORMAT ón áitear gníomhach in ionad na socruithe den ainm céanna.

Sannadh díreach le heochair eachtrach droim nó gaol go leorLink to this heading#

In ionad rudaí gaolmhara a shannadh ag úsáid sannadh díreach:

>>> new_list = [obj1, obj2, obj3]
>>> e.related_set = new_list

Úsáid an modh: meth: ~django.db.models.fields.related.relatedManager.set curtha leis i Django 1.9:

>>> e.related_set.set([obj1, obj2, obj3])

Cuireann sé seo cosc ar mhearbhall faoi shannadh mar thoradh ar shábháil intuigthe.

Neamh-Time-Area: Class: ~django.core.files.storage.storage APILink to this heading#

Tá na sean-mhodhanna, neamh-eolach ar chrios ama accsed_time () ``, `created_time (), agus modified_time () `, modhnaithe () ``a dhíchur i bhfabhar na modhanna nua ``get_*_time ()`.

Ba chóir go gcuirfeadh cúltaca stórála tríú páirtí na modhanna nua a chur i bhfeidhm agus na seancinn a mharcáil Go dtí sin, déanann na modhanna nua get_*_time () ``ar an mbon:class: `~django.core.files.storage` a thiontú ``datetimes ó na sean-mhodhanna de réir mar is gá agus scaoileann siad rabhadh dipraiticiúcháin de réir mar a dhéanann siad amhlaidh.

Féadfaidh cúltaca stórála tríú páirtí na sean-mhodhanna a choinneáil chomh fada agus is mian leo tacú le leaganacha níos luaithe de Django.

django.contrib.gisLink to this heading#

• Tá na modhanna get_srid () ``agus `set_srid () de:class: ~django.contrib.gis.geos.geosgeometry i bhfabhar na maoine: attr: ~django.contrib.gis.geos.geosgeometry.srid.

• Tá na modhanna get_x () ``, `set_x (), get_y () `, set_y ()`, get_z () `, agus set_z () modhanna de:class: ~django.contrib.gis.geos.point i bhfabhar an x' Airíonna ``, ``y, agus z.

• Tá na modhanna get_coords () ``agus `set_coords () de:class: ~django.contrib.gis.geos.point i bhfabhar na maoine tuple.

• Tá an maoin cascaded_union` de:class: ~django.contrib.gis.geos.multipolygon a dhíchur i bhfabhar na maoine: attr: ~django.contrib.gis.geos.geosgeometry.unary_union.

• Tá an fheidhm ``django.contrib.gis.utils.precision_wkt () díluaite i bhfabhr:class: `~django.contrib.gis.geos.wktWriter.

Réimse samhail CommaseParatedIntegerFieldLink to this heading#

Tá CommaseParatedIntegerField díscoite i bhfabhr:class: ~django.db.models.charfield leis an bailíochtaí:func: ~django.core.validators.validate_comma_separated_integer_list bailíochtaithe:

from django.core.validators import validate_comma_separated_integer_list
from django.db import models


class MyModel(models.Model):
    numbers = models.CharField(..., validators=[validate_comma_separated_integer_list])

Má tá Oracle á úsáid agat, úsáideann Charfield cineál réimse bunachar sonraí difriúil (NVARCHAR2) ná CommaseParatedIntegerField (VARCHAR2). Ag brath ar do shocruithe bunachar sonraí, d'fhéadfadh sé seo ionchódú difriúil a thabhairt le tuiscint, agus dá bhrí sin fad difriúil (i mbetaí) don ábhar céanna. Má tá do luachanna stóráilte níos faide ná an teorainn 4000 beit de NVARCHAR2, ba chóir duit Textfield (NCLOB`) a úsáid ina ionad. Sa chás seo, má tá aon cheisteanna agat a ghrúpaíonn de réir an réimse (m.sh. anótáil a dhéanamh ar an tsamhail le comhiomlánú nó ag baint úsáide as `difriúil () `) beidh ort iad a athrú (chun an réimse a chur siar).

Ag baint úsáide as ainm samhail mar chuardach ceisteanna nuair a shocraítear default_related_nameLink to this heading#

Glac leis na samhlacha seo a leanas:

from django.db import models


class Foo(models.Model):
    pass


class Bar(models.Model):
    foo = models.ForeignKey(Foo)

    class Meta:
        default_related_name = "bars"

I leaganacha níos sine, ní fhéadfaí :attr: ~django.db.models.options.default_related_name a úsáid mar chuardach ceisteanna. Tá sé seo socraithe agus déantar tacaíocht don sean-ainm cuardaigh a dhíchur. Mar shampla, ós rud é go bhfuil default_related_name` socraithe sa tsamhail Bar,, in ionad ainm an tsamhail bar a úsáid mar an chuardach:

>>> bar = Bar.objects.get(pk=1)
>>> Foo.objects.get(bar=bar)

bain úsáid as an réamhshocraithe_related_name barra:

>>> Foo.objects.get(bars=bar)

Cuardach ceisteanna __searchLink to this heading#

Tá an cuardach chuardach, a thacaíonn le MySQL amháin agus atá thar a bheith teoranta i ngnéithe, míshuanta. Cuardach saincheaptha in ionad é:

from django.db import models


class Search(models.Lookup):
    lookup_name = "search"

    def as_mysql(self, compiler, connection):
        lhs, lhs_params = self.process_lhs(compiler, connection)
        rhs, rhs_params = self.process_rhs(compiler, connection)
        params = lhs_params + rhs_params
        return "MATCH (%s) AGAINST (%s IN BOOLEAN MODE)" % (lhs, rhs), params


models.CharField.register_lookup(Search)
models.TextField.register_lookup(Search)

Ag baint úsáide as User.is_Authenticated () ``agus ``User.is_Anonymous () mar mhodhannaLink to this heading#

Is airíonna anois iad na modhanna is_autenticated () ``agus ``is_anonymus () de:class: ~django.contrib.auth.models.abstractBaseUser agus:class: ~django.contrib.auth.models.anonymousUser aicmí anois. Oibreoidh siad fós mar mhodhanna go dtí Django 2.0, ach úsáideann gach úsáid i Django rochtain tréithe anois.

Mar shampla, má úsáideann tú: class: ~django.contrib.auth.middleware.AuthenticationMiddleware agus má theastaíonn uait a fháil amach an bhfuil an t-úsáideoir logáilte isteach faoi láthair bheadh úsáid as:

if request.user.is_authenticated:
    ...  # Do something for logged-in users.
else:
    ...  # Do something for anonymous users.

in ionad ``request.user.is_autenticated () ``.

Seachnaíonn an t-athrú seo sceitheadh faisnéise de thaisme má dhéanann tú dearmad glaoch ar an modh, m.sh.:

if request.user.is_authenticated:
    return sensitive_information

Má sháraíonn tú na modhanna seo i samhail úsáideora saincheaptha, ní mór duit iad a athrú go hairíonna nó tréithe.

Úsáideann Django réad CallableBool chun ligean do na tréithe seo oibriú mar mhaoin agus mar mhodh araon. Dá bhrí sin, go dtí go gcríochnaíonn an tréimhse díghabhála, ní féidir leat na hairíonna seo a chur i gcomparáid ag baint úsáide as an oibreoir Is é sin, ní oibreoidh an méid seo a leanas:

if request.user.is_authenticated is True:
    ...

Caithfidh ranganna bainisteora saincheaptha atá ar fáil trí prefetch_related modh ``_apply_rel_filters () `a shainiúLink to this heading#

Má shainigh tú rang bainisteora saincheaptha atá ar fáil trí:meth: ~django.db.models.query.queryset.prefetch_related ní mór duit a chinntiú go sainmhíníonn sé modh ``_apply_rel_filters () `.

Caithfidh an modh seo glacadh le sampla a:class: ~django.db.models.query.querySet mar a argóint aonair agus leagan scagtha den tacar ceisteanna a thabhairt ar ais don samhail samhail atá an bainisteoir faoi cheangal.

An leath “éalaithe” de django.utils.safestring`Link to this heading#

Tá an fheidhm mark_for_escaping () ``agus na haicmí a úsáideann sé: ``EscapeData, EscapeBytes`, EscapeText`, EscapeString`, agus EscapeUnicode dímheasta.

Mar thoradh air sin, tá iompar “leisciúil” an scagaire ``éalaithe ``(áit a chuirfí i bhfeidhm é i gcónaí mar an scagaire deireanach is cuma cá raibh sé le feiceáil sa slabhra scagaire) a dhíchur. Athróidh an scagaire chun cur i bhfeidhm láithreach:func: ~django.utils.html.conditional_escape i Django 2.0.

Manager.Use_for_Related_Fields agus athruithe oidhreachtaLink to this heading#

<django.db.models.Options.base_manager_name>Tá Manager.Use_for_Related_Fields a dhíchur i bhfabhar socruithe: attr: `Meta.Base_Manager_name `ar an mhúnla.

Leanfaidh oidhreacht Mhúnla Bainisteoir ``rialacha oidhreachta MRO i Django 2.0, ag athrú an t-iompar reatha nuair nach n-oidhreacht ag ranganna leanaí bainisteoirí atá sainmhínithe ar ranganna bonn neamh-teibí. Ardaítear rabhadh laghdaitheach le treoracha maidir le conas do chód a oiriúnú má tá aon bhainisteoirí difear agat. Déanfaidh tú bainisteoir a athdhearbhú ó mhúnla teibí ar rang an linbh chun an bainisteoir a shárú ón tsamhail choincréite, nó socraíonn tú rogha ``meta.manager_heritance_from_future=true` an tsamhail chun roghnú isteach san iompar oidhreachta nua.

Le linn na tréimhse díghabhála, déanfar onóir ar use_for_related_fields agus ardófar rabhadh, fiú má shocraítear base_manager_name. Ligeann sé seo cód tríú páirtí iompar oidhreachta a chaomhnú agus é ag aistriú chuig an API nua. Is féidir an rabhadh a thostú trí Silence_USE_for_related_fields_deprecation=true a shocrú ar an mbainisteoir.

IlghnéitheachLink to this heading#

• Tá an rogha makemigrations --exit a dhíchur i bhfabhar an rogha: makemigrations --check.

• Tá ``django.utils.functional.allow_lazy () ``díluaite i bhfabhar an fheidhm nua:func: ~django.utils.functional.keep_lazy is féidir a úsáid le comhréir maisiúcháin níos nádúrtha.

• Tá an rogha shell --plain ``a dhíchur i bhfabhar ``-i python nó --interface python.

• Tá allmhairiú ón modúl django.core.urlresolvers a dhíchur i bhfabhar a shuíomh nua, :mod: django.urls.

• Tá an modh teimpléad Context.has_key () ``a dhíchur i bhfabhar ``in.

• An tréith phríobháideach virtual_fields de Samhail. Tá _meta` a dhíchur i bhfabhar príobháideach_fields.

• Na hargóintí eochairfhocal príobháideacha virtual_only i field.contribute_to_class () ``agus ``virtual` i Samhail. Tá _meta.add_field () ``a dhíchur i bhfabhar ``príobháideach_only` agus ``príobháideach`, faoi seach.

• Tá na tuairimí javascript_catalog () ``agus ``json_catalog ()` a dhíchur i bhfabhar radhairc ranga-bhunaithe: class: ~django.views.i18n.javascriptCatalog agus:class: ~django.views.i18n.jsonCatalog.

• In oidhreacht il-tábla, cuirtear cur chun cinn intuigthe OneToonefield go parent_link` a chur chun cinn intuigthe. Cuir parent_link=True le réimsí den sórt sin.

• An API príobháideach ``Giuirléid. Déantar _format_value () ``a phoiblí agus athainmnítear u:meth: ~django.forms.widget.format_value. Oibreoidh an sean-ainm trí thréimhse díghabhála.

• Private FileField methods get_directory_name() and get_filename() are deprecated in favor of performing this work in Storage.generate_filename().

• Tá meán-earraí sean-stíl a úsáideann Settings.middleware_classes a dhíchur. :ref: Cuir sean-mheánearraí saincheaptha in oiriúint `agus ba <upgrading-middleware>in úsáid as an socrú nua:setting: `MIDDLEWARE.