Do chuid aipeanna a iompar ó Django 0.96 go 1.0Link to this heading#

Athainmnigh maxlength ``go ``max_longLink to this heading#

Athainmnigh d'argóint maxlength ``go `max_length (athraíodh é seo chun a bheith comhsheasmhach le réimsí foirme):

Cuir __unicode__ in ionad __str__Link to this heading#

Cuir modh __unicode__ feidhm __str__ do mhúnla, agus déan cinnte go n-úsáideann tú Unicode`_ (u'foo') sa mhodh sin.

Bain prepopulated_fromLink to this heading#

Bain an argóint prepopulated_from ar réimsí samhail. Níl sé bailí a thuilleadh agus aistríodh é go dtí an rang ModelAdmin i admin.py`. Féach `an riarachán `_, thíos, le haghaidh tuilleadh sonraí faoi athruithe ar an riarachán.

Bain ``core ``Link to this heading#

Bain an argóint core ``ó do réimsí samhail. Níl sé riachtanach a thuilleadh, ós rud é go láimhseálann an comhéadan riaracháin an fheidhmiúlacht chomhionann (cuid de: ref: `eagarthóireacht inlíne <admin-inlines>`) go difriúil anois. Ní gá duit a bheith buartha faoi eagarthóireacht inlíne go dtí go sroicheann tú chuig an rannán `an riaracháin `_, thíos. Go dtí seo, bain na tagairtí go léir do `core.

Cuir “admin” in ionad class Admin: le admin.py`Link to this heading#

Bain do dhearbhuithe inmheánacha ``aicme Riaracháin ``ó do mhúnlaí. Ní bhriseoidh siad aon rud má fhágann tú iad, ach ní dhéanfaidh siad aon rud freisin. Chun aipeanna a chlárú leis an riarachán aistrfidh tú na dearbhuithe sin chuig comhad admin.py; féach `an riarachán `_ thíos le haghaidh tuilleadh sonraí.

SamplaLink to this heading#

Seo thíos sampla comhad models.py leis na hathruithe go léir a chaithfidh tú a dhéanamh:

Sean (0.96) models.py:

class Author(models.Model):
    first_name = models.CharField(maxlength=30)
    last_name = models.CharField(maxlength=30)
    slug = models.CharField(maxlength=60, prepopulate_from=("first_name", "last_name"))

    class Admin:
        list_display = ["first_name", "last_name"]

    def __str__(self):
        return "%s %s" % (self.first_name, self.last_name)

Nua (1.0) models.py:

class Author(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    slug = models.CharField(max_length=60)

    def __unicode__(self):
        return "%s %s" % (self.first_name, self.last_name)

Nua (1.0) admin.py:

from django.contrib import admin
from models import Author


class AuthorAdmin(admin.ModelAdmin):
    list_display = ["first_name", "last_name"]
    prepopulated_fields = {"slug": ("first_name", "last_name")}


admin.site.register(Author, AuthorAdmin)

Úsáid comhréir inlíne nuaLink to this heading#

Tá na roghanna nua edit_inline aistrithe go léir chuig admin.py`. Seo sampla:

Sean (0.96):

class Parent(models.Model): ...


class Child(models.Model):
    parent = models.ForeignKey(Parent, edit_inline=models.STACKED, num_in_admin=3)

Nua (1.0):

class ChildInline(admin.StackedInline):
    model = Child
    extra = 3


class ParentAdmin(admin.ModelAdmin):
    model = Parent
    inlines = [ChildInline]


admin.site.register(Parent, ParentAdmin)

Féach: ref: admin-inlines le haghaidh tuilleadh sonraí.

réimsí ``a shimpliú, nó bain úsáid as ``fieldsetsLink to this heading#

Bhí an sean-chomhpháirtíocht réimsí `mearbhall go leor, agus tá sé simplithe. Oibríonn an sean-chomhréir fós, ach beidh ort ``fieldsets a úsáid ina ionad.

Sean (0.96):

class ModelOne(models.Model):
    ...

    class Admin:
        fields = ((None, {"fields": ("foo", "bar")}),)


class ModelTwo(models.Model):
    ...

    class Admin:
        fields = (
            ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),
            ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),
        )

Nua (1.0):

class ModelOneAdmin(admin.ModelAdmin):
    fields = ("foo", "bar")


class ModelTwoAdmin(admin.ModelAdmin):
    fieldsets = (
        ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),
        ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),
    )

Nuashonraigh do fhréamh urls.pyLink to this heading#

Má tá an suíomh riaracháin á úsáid agat, ní mór duit do fhréamh ``urls.py` a nuashonrú.

Sean (0.96) urls.py:

from django.conf.urls.defaults import *

urlpatterns = patterns(
    "",
    (r"^admin/", include("django.contrib.admin.urls")),
    # ... the rest of your URLs here ...
)

Nua (1.0) urls.py:

from django.conf.urls.defaults import *

# The next two lines enable the admin and load each admin.py file:
from django.contrib import admin

admin.autodiscover()

urlpatterns = patterns(
    "",
    (r"^admin/(.*)", admin.site.root),
    # ... the rest of your URLs here ...
)

Úsáid django.forms in ionad newformsLink to this heading#

Cuir django.newforms` in ionad django.forms` - Athainmníodh Django 1.0 an modúl newforms (tugadh isteach i 0.96) go sean-foirme` simplí. Baineadh an modúl oldforms freisin.

Má tá leabharlann ``newforms` á úsáid agat cheana féin, agus má d'úsáid tú ár gcomhréiteach ráiteas ``allmhairiúch` a mholtar, níl le déanamh agat ach do ráitis iompórtála a athrú.

Sean:

from django import newforms as forms

Nua:

from django import forms

Má tá an seanchóras foirmeacha á n-úsáid agat (ar a django.forms`` agus django.oldforms` roimhe seo), beidh ort d'fhoirmeacha a athscríobh. Áit mhaith le tosú ná: doc: `foirmeacha doiciméadúcháin `</topics/forms/index>

Láimhseáil comhaid uaslódáilte ag úsáid an APILink to this heading#

Cuir úsáid comhaid uaslódáilte - is é sin, iontrálacha i Request.Files -- mar fhoclóirí simplí leis an nua:class: ~django.core.files.uploadedfile.uploadedfile. Ní oibríonn comhréir an sean-fhoclóra a thuilleadh.

Dá bhrí sin, i radharc mar:

def my_view(request):
    f = request.FILES["file_field_name"]
    ...

... bheadh ort na hathruithe seo a leanas a dhéanamh:

Oibrigh le réimsí comhad ag baint úsáide as an API nuaLink to this heading#

Tá athrú tagtha ar chur i bhfeidhm inmheán:class: Django.db.Models.FileField. Toradh infheicthe air seo ná go bhfuil athrú tagtha ar an mbealach a rochtain agat ar thréithe speisialta (URL, ainm comhaid, méid íomhá, srl.) na réimsí samhail seo. Beidh ort na hathruithe seo a leanas a dhéanamh, ag glacadh leis ar do mhúnla 's:class: ~django.db.models.filefield tugtar myfile:

Tabhair faoi deara nach bhfuil ciall ar na tréithe leithead agus airde ach do réimsí: class: `~django.db.models.imagefield. Is féidir tuilleadh sonraí a fháil sna cáipéiséisíocht: doc: model API </ref/models/fields>.

Úsáid Paginator in ionad ObjectPaginatorLink to this heading#

Baineadh an ObjectPaginator` i 0.96 agus cuireadh leagan feabhsaithe ina ionad, :class: django.core.paginator.paginator.

Foghlaim grá a bhaint as autoescapingLink to this heading#

De réir réamhshocraithe, éalaíonn an córas teimpléid HTML-go huathoibríoch anois aschur gach athróg. Chun tuilleadh a fhoghlaim, féach:ref: automatic-html-escaping.

Chun éalú uathoibríoch a dhíchumasú le haghaidh athróg aonair, bain úsáid as an scagair:tfilter: safe:

This will be escaped: {{ data }}
This will not be escaped: {{ data|safe }}

Chun éalú uathoibríoch a dhíchumasú le haghaidh teimpléad iomlán, fillte an teimpléad (nó díreach cuid áirithe den teimpléad) sa chlibe:ttag: autoescape:

{% autoescape off %}
   ... unescaped template content here ...
{% endautoescape %}

spaceless tagLink to this heading#

Baineann an chlib teimpléad spacel anois spásanna uach* idir clibeanna HTML, in ionad spás amháin a chaomhnú.

Blas áitiúil na SALink to this heading#

Athainmníodh django.contrib.localflavor.usa ``go `django.contrib.localflavor.us. Rinneadh an t-athrú seo chun scéim ainmniúcháin blasanna áitiúla eile a mheaitseáil. Chun do chód a aistriú, níl le déanamh agat ach na hallmhairí a athrú.

Eochair seisiúin nua a fháilLink to this heading#

Athainmníodh SessionBase.get_new_session_key () ``go ``_get_new_session_key (). ``get_new_session_object () ``níl ann a thuilleadh.

Ní ghlaonn sé ar `save () ``a thuilleadh ag luchtú sraitheannaLink to this heading#

Roimhe seo, rith an tsraith a luchtú go huathoibríoch modh ``save () ``an tsamhail. Níl sé seo amhlaidh a thuilleadh, mar sin teastaíonn luachanna follasacha in aon daingneán anois ó aon réimsí (mar shampla: stampaí ama) a rinneadh go huathoibríoch ag `save () `.

Eisceachtaí níos fearrLink to this heading#

Tá an sean:exc: EnvironmentError roinnte ina an:exc: ImportError nuair a theipeann ar Django an modúl socruithe a aimsiú agus a:exc: RuntimeError nuair a dhéanann tú iarracht socruithe a athchumrú tar éis iad a úsáid cheana féin.

LOGIN_URL has movedLink to this heading#

Bhog an: setting: LOGIN_URL tairiseach ó django.contrib.auth isteach sa modúl socruithe ``. <LOGIN_URL>In ionad ``from django.contrib.auth allmhairiú LOGIN_URL a úsáid féach to:setting: `Settings.login_url `.

APPEND_SLASH behavior has been updatedLink to this heading#

I 0.96, mura raibh deireadh le URL i slash nó mura raibh tréimhse aige sa chomhpháirt dheiridh dá chonair, agus:setting: 'APPEND_SLASH` Fíor, atreoródh Django chuig an URL céanna, ach le slash curtha leis an deireadh. Anois, seiceálann Django chun a fheiceáil an mbeadh rud éigin i do phatrúin URL comhoiriúnach leis an bpatrún gan an slash rianaithe. Más ea, ní dhéantar aon athatreorú, toisc go nglactar leis go raibh tú ag iarraidh an patrún sin a ghabháil d'aon ghnó.

Maidir le formhór na ndaoine, ní bheidh aon athruithe ag teastáil ó seo. Mar sin féin, tá patrúin URL ag daoine áirithe a bhfuil cuma seo orthu:

r"/some_prefix/(.*)$"

Roimhe seo, bheadh na patrúin sin a atreorú chun slasc rianaithe a bheith acu. Más mian leat slash i gcónaí ar URLanna den sórt sin, athscríobh an patrún mar:

r"/some_prefix/(.*/)$"

Eisceacht difriúil ó ``get () ``Link to this heading#

Tugann bainisteoirí ar ais anois eisceacht a:exc: ~Django.Core.Exceptions.MultipleObjectsReturned in ionad:exc: AssertionError:

Sean (0.96):

try:
    Model.objects.get(...)
except AssertionError:
    handle_the_error()

Nua (1.0):

try:
    Model.objects.get(...)
except Model.MultipleObjectsReturned:
    handle_the_error()

Scaoileadh LazyDateLink to this heading#

Níl an rang cúntóra LazyDate ann a thuilleadh.

Is féidir luachanna réamhshocraithe réimse agus argóintí fiosrúcháin a bheith ina rudaí inghlaonta, mar sin is féidir tagairt do datetime.datetime.now` a chur in ionad cásanna LazyDate:

Sean (0.96):

class Article(models.Model):
    title = models.CharField(maxlength=100)
    published = models.DateField(default=LazyDate())

Nua (1.0):

import datetime


class Article(models.Model):
    title = models.CharField(max_length=100)
    published = models.DateField(default=datetime.datetime.now)

Tá Decimalfield nua, agus is snámhphointe ceart anois é FloatfieldLink to this heading#

Sean (0.96):

class MyModel(models.Model):
    field_name = models.FloatField(max_digits=10, decimal_places=3)
    ...

Nua (1.0):

class MyModel(models.Model):
    field_name = models.DecimalField(max_digits=10, decimal_places=3)
    ...

Má dhéanann tú dearmad an t-athrú seo a dhéanamh, feicfidh tú earráidí faoi Floatfield gan tréith max_digits a ghlacadh i __init__, toisc nach nglacann an Floatfield nua aon argóintí a bhaineann le cruinneas.

Má tá MySQL nó PostgreSQL á úsáid agat, níl aon athruithe breise ag teastáil. Tá na cineálacha colún bunachar sonraí le haghaidh Decimalfield mar an gcéanna leis an sean-Floatfield.

Má tá SQLite á úsáid agat, ní mór duit an bunachar sonraí a chur i bhfeidhm ar na colúin chuí mar chineálacha deachúil, seachas snámha. Chun seo a dhéanamh, beidh ort do chuid sonraí a athluchtú. Déan é seo tar éis duit an t-athrú a dhéanamh ar Decimalfield a úsáid i do chód agus an cód Django a nuashonrú.

Chun gach feidhmchlár a uasghrádú chun ``Decimalfield` a úsáid, is féidir leat an méid seo a leanas a dhéanamh, agus ainm gach aip in ionad ```sa chód th <app>íos:

$ ./manage.py dumpdata --format=xml <app> > data-dump.xml
$ ./manage.py reset <app>
$ ./manage.py loaddata data-dump.xml

Nótaí:

1. Tá sé tábhachtach go gcuimhneoidh tú formáid XML a úsáid sa chéad chéim den phróiseas seo. Táimid ag baint leas as gné de na dumpaí sonraí XML a fhágann gur féidir snámha a iompar go deachmhálacha le SQLite.

2. Sa dara céim iarrfar ort a dhearbhú go bhfuil tú ullmhaithe chun na sonraí a chailleadh don iarratas (í) atá i gceist. Abair tá; cuirfimid na sonraí seo ar ais sa tríú céim.

3. Ní úsáidtear Decimalfield in aon cheann de na feidhmchláir a sheoltar le Django sula ndéantar an t-athrú seo, mar sin ní gá duit a bheith buartha faoin nós imeachta seo a dhéanamh d'aon cheann de na samhlacha caighdeánacha Django.

Má théann rud éigin mícheart sa phróiseas thuas, níl le déanamh ach cóipeáil do bhunachar sonraí cúltaca thar an mbunchomhad agus tosú arís.

django.views.i18n.set_language() now requires a POST requestLink to this heading#

Roimhe seo, úsáideadh iarratas GET. Chiallaigh an sean-iompar go bhféadfaí stát (an áitiúil a úsáidtear chun an suíomh a thaispeáint) a athrú trí iarratas GET, atá i gcoinne moltaí na sonraíochta HTTP. Caithfidh an cód a ghlaonn an dearcadh seo a chinntiú go ndéantar iarratas POST anois, in ionad GET. Ciallaíonn sé seo nach féidir leat nasc a úsáid a thuilleadh chun rochtain a fháil ar an radharc, ach caithfidh tú aighneacht foirme de chineál éigin a úsáid (m.sh. cnaipe).

Níl `_ () ``i dtógáin a thuilleadhLink to this heading#

Ní dhéantar `_ () ``(an réad inghlaonta a bhfuil a ainm béim amháin aige) a thuilleadh isteach i dtógáin - is é sin, níl sé ar fáil go draíochta i ngach modúl a thuilleadh.

Má bhí tú ag brath roimhe seo ar _ () ``a bheith i láthair i gcónaí, ba cheart duit ``ugettext` nó ugettext_lazy a iompórtáil go sainráite anois, más cuí, agus é a ainmhairiú chuig _` duit féin:

from django.utils.translation import ugettext as _

Rochtain ar an bhfoclóir ar HttpRequest`Link to this heading#

Ní thacaíonn rudaí HttpRequest` le rochtain ar stíl fhoclóra a thuilleadh; roimhe seo, bhí sonraí GET agus POST ``ar fáil go díreach ar an réad `HttpRequest` (m.sh., d'fhéadfá píosa sonraí foirme a sheiceáil trí if 'some_form_key' a úsáid in iarrat` nó trí request ['some_form_key']. Ní thacaítear leis seo a thuilleadh; má theastaíonn rochtain uait ar na sonraí comhcheangailte ``GET` agus POST `, bain úsáid as Request.request ina ionad.

Moltar go láidir, áfach, go bhféachann tú go sainráite sa fhoclóir cuí i gcónaí don chineál iarratais a bhfuil súil agat a fháil (Request.Get nó Request.Post); ag brath ar an bhfoclóir comhcheangailte request.request is féidir bunús na sonraí atá ag teacht isteach a masc.

Rochtain a fháil ar cheanntásca HttpResponse`Link to this heading#

Athainmníodh Django.http.httpResponse.Headers go _headers agus:class: ~django.http.http.httpResponse tacaíonn anois le seiceáil srianta go díreach. Mar sin bain úsáid as if ceannteideal mar fhreagra: ``in ionad ``if ceannteideal i freagra.heads:`.

Tá caidreamh cineálach aistrithe as croílárLink to this heading#

Tá na ranganna caidrimh chineálach -- GenericForeignKey` agus GenericRelation -- tar éis bogadh isteach sa mhodúl:mod: django.contrib.contenttypes.

django.test.Client.login() has changedLink to this heading#

Sean (0.96):

from django.test import Client

c = Client()
c.login("/path/to/login", "myuser", "mypassword")

Nua (1.0):

# ... same as above, but then:
c.login(username="myuser", password="mypassword")

Orduithe bainistíochta a rith ó do chódLink to this heading#

django.core.management has been greatly refactored.

Caithfidh glaonna chuig seirbhísí bainistíochta i do chód ``call_command ``a úsáid anois. Mar shampla, má tá cód tástála éigin agat a ghlaonn flush agus load_data:

from django.core import management

management.flush(verbosity=0, interactive=False)
management.load_data(["test_data"], verbosity=0)

... beidh ort an cód seo a athrú chun léamh:

from django.core import management

management.call_command("flush", verbosity=0, interactive=False)
management.call_command("loaddata", "test_data", verbosity=0)

Caithfidh fo-orduithe a bheith roimh roghanna anoisLink to this heading#

Éilíonn django-admin.py agus manage.py` fo-orduithe anois chun roimh roghanna. Mar sin:

$ django-admin.py --settings=foo.bar runserver

... ní oibríonn sé a thuilleadh agus ba chóir é a athrú go:

$ django-admin.py runserver --settings=foo.bar

Beathú. __init__ tá athrú tagthaLink to this heading#

Glacann an modh __init__ () ``de rang ``Feed chreat shiondícithe réad HttpRequest anois mar a dara paraiméadar, in ionad URL an bheatha. Ligeann sé seo don chreat siondicíochta oibriú gan creat na suíomhanna a bheith ag teastáil. Ní théann sé seo ach ar an gcód a dhéanann fo-aicmí Feed ``agus a sháraíonn an modh ``__init__ (), agus an cód a ghlaonn ``Feed. __init__ () ``go díreach.

Tá Sorteddictfromlist imitheLink to this heading#

Baineadh django.newforms.forms.sorteddictfromlist. Is féidir Django.Utils.DataStructures.SortedDict a ionchasadh anois le seicheamh tuples.

Chun do chód a nuashonrú:

1. Úsáid Django.Utils.DataStructures.SortedDict cibé áit a raibh tú ag úsáid Django.NewForms.Forms.SortedDictFromList.

2. Toisc nach dtugann Django.utils.DataStructures.SortedDict.copy` doimhchóip ar ais mar a rinne SortedDictFromList.copy () `, beidh ort do chód a nuashonrú má bhí tú ag brath ar dhoimhchóip. Déan é seo trí `copy.deepcopy a úsáid go díreach.

Athainmníodh feidhmeanna cúltaca bunachar sonraíLink to this heading#

Athainmníodh agus/nó athlonnaíodh beagn* uil* de fheidhmeanna cúltaca an bhunachar sonraí. Níor doiciméadaíodh aon cheann díobh seo, ach beidh ort do chód a athrú má tá aon cheann de na feidhmeanna seo á úsáid agat, a bhfuil gach ceann acu in:mod: django.db: