Tidslinje för avveckling av Django¶

Det här dokumentet beskriver när olika delar av Django kommer att tas bort eller ändras på ett bakåtkompatibelt sätt, efter deras avskrivning, enligt :ref:deprecation policy <internal-release-deprecation-policy>. Mer information om varje objekt kan ofta hittas i utgivningsanteckningarna för två versioner tidigare.

6.1¶

Se Django 5.2 release notes för mer information om dessa ändringar.

Nyckelordsargumentet all i django.contrib.staticfiles.finders.find() kommer att tas bort.
Fallbacks to request.user and request.auser() when user is None in django.contrib.auth.login() and django.contrib.auth.alogin(), respectively, will be removed.
Nyckelordsargumentet ordering för de PostgreSQL-specifika aggregeringsfunktionerna django.contrib.postgres.aggregates.ArrayAgg, django.contrib.postgres.aggregates.JSONBAgg och django.contrib.postgres.aggregates.StringAgg kommer att tas bort.
Stöd för subklasser av RemoteUserMiddleware som åsidosätter process_request() utan att åsidosätta aprocess_request() kommer att tas bort.

6.0¶

Se Django 5.0 release notes för mer information om dessa ändringar.

De tillfälliga formgivarna DjangoDivFormRenderer och Jinja2DivFormRenderer kommer att tas bort.
Stöd för att skicka positionella argument till BaseConstraint kommer att tas bort.
request kommer att krävas i signaturen för ModelAdmin.lookup_allowed() subklasser.
django.db.models.sql.datastructures.Join kommer inte längre att fallbacka till get_joining_columns().
Metoden get_joining_columns() i ForeignObject och ForeignObjectRel kommer att tas bort.
Metoden ForeignObject.get_reverse_joining_columns() kommer att tas bort.
Standardschemat för forms.URLField ändras från "http" till "https".
Stöd för att anropa format_html() utan att skicka args eller kwargs kommer att tas bort.
Stöd för cx_Oracle kommer att tas bort.
BaseDatabaseOperations.field_cast_sql() kommer att tas bort.
Aliaset ChoicesMeta till django.db.models.enums.ChoicesType kommer att tas bort.
Metoden Prefetch.get_current_queryset() kommer att tas bort.
Metoden get_prefetch_queryset() för relaterade hanterare och deskriptorer kommer att tas bort.
get_prefetcher() och prefetch_related_objects() kommer inte längre att fallbacka till get_prefetch_queryset().
Övergångsinställningen FORMS_URLFIELD_ASSUME_HTTPS kommer att tas bort.

Se Django 5.1 release notes för mer information om dessa ändringar.

Metoderna ModelAdmin.log_deletion() och LogEntryManager.log_action() kommer att tas bort.
Den odokumenterade funktionen django.utils.itercompat.is_iterable() och modulen django.utils.itercompat kommer att tas bort.
Metoden django.contrib.gis.geoip2.GeoIP2.coords() kommer att tas bort.
Metoden django.contrib.gis.geoip2.GeoIP2.open() kommer att tas bort.
Stöd för att skicka positionella argument till Model.save() och Model.asave() kommer att tas bort.
Settern för django.contrib.gis.gdal.OGRGeometry.coord_dim kommer att tas bort.
django.urls.register_converter() kommer inte längre att tillåta åsidosättande av befintliga omvandlare.
Nyckelordsargumentet check i CheckConstraint kommer att tas bort.
Attributet OS_OPEN_FLAGS för FileSystemStorage kommer att tas bort.
Metoden get_cache_name() i FieldCacheMixin kommer att tas bort.

5.1¶

Se Django 4.2 release notes för mer information om dessa ändringar.

Metoden BaseUserManager.make_random_password() kommer att tas bort.
Modellens alternativ Meta.index_together kommer att tas bort.
Mallfiltret length_is kommer att tas bort.
django.contrib.auth.hashers.SHA1PasswordHasher, django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher och django.contrib.auth.hashers.UnsaltedMD5PasswordHasher kommer att tas bort.
Modellerna django.contrib.postgres.fields.CICharField, django.contrib.postgres.fields.CIEmailField och django.contrib.postgres.fields.CITextField kommer att tas bort. Stub-fält kommer att finnas kvar för kompatibilitet med historiska migreringar.
Mixinen django.contrib.postgres.fields.CIText kommer att tas bort.
Attributen map_width och map_height för BaseGeometryWidget kommer att tas bort.
Metoden SimpleTestCase.assertFormsetError() kommer att tas bort.
Metoden TransactionTestCase.assertQuerysetEqual() kommer att tas bort.
Stöd för att skicka kodade JSON-stränglitteraler till JSONField och tillhörande uppslagningar och uttryck kommer att tas bort.
Stöd för att skicka positionella argument till Signer och TimestampSigner kommer att tas bort.
Inställningarna DEFAULT_FILE_STORAGE och STATICFILES_STORAGE kommer att tas bort.
Funktionen django.core.files.storage.get_storage_class() kommer att tas bort.

5.0¶

Se Django 4.0 release notes för mer information om dessa ändringar.

Testinställningen SERIALIZE kommer att tas bort.
Den odokumenterade modulen django.utils.baseconv kommer att tas bort.
Den odokumenterade modulen django.utils.datetime_safe kommer att tas bort.
Standardvärdet för inställningen USE_TZ kommer att ändras från False till True.
Standardprotokollet för webbplatskartor som byggs upp utanför en begäran ändras från 'http till 'https.
Argumentet extra_tests för DiscoverRunner.build_suite() och DiscoverRunner.run_tests() kommer att tas bort.
Aggregaten django.contrib.postgres.aggregates.ArrayAgg, JSONBAgg och StringAgg returnerar None när det inte finns några rader istället för [], [] respektive ''.
Inställningen USE_L10N kommer att tas bort.
Övergångsinställningen USE_DEPRECATED_PYTZ kommer att tas bort.
Stöd för tidszonerna pytz kommer att tas bort.
Argumentet is_dst kommer att tas bort från:
- QuerySet.datetimes()
- django.utils.timezone.make_aware()`
- django.db.models.functions.Trunc()`
- django.db.models.functions.TruncSecond()`
- django.db.models.functions.TruncMinute()
- django.db.models.functions.TruncHour()`
- django.db.models.functions.TruncDay()`
- django.db.models.functions.TruncWeek()
- django.db.models.functions.TruncMonth()
- django.db.models.functions.TruncQuarter()`
- django.db.models.functions.TruncYear()`
Klasserna django.contrib.gis.admin.GeoModelAdmin och OSMGeoAdmin kommer att tas bort.
Den odokumenterade metoden BaseForm._html_output() kommer att tas bort.
Möjligheten att returnera en str, snarare än en SafeString, vid rendering av en ErrorDict och ErrorList kommer att tas bort.

Se Django 4.1 release notes för mer information om dessa ändringar.

Metoden SitemapIndexItem.__str__() kommer att tas bort.
Övergångsinställningen CSRF_COOKIE_MASKED kommer att tas bort.
Argumentet name i django.utils.functional.cached_property() kommer att tas bort.
Argumentet opclasses i django.contrib.postgres.constraints.ExclusionConstraint kommer att tas bort.
Den odokumenterade möjligheten att skicka errors=None till SimpleTestCase.assertFormError() och assertFormsetError() kommer att tas bort.
django.contrib.sessions.serializers.PickleSerializer kommer att tas bort.
Det är inte längre tillåtet att använda QuerySet.iterator() på en queryset som hämtar relaterade objekt utan att ange argumentet chunk_size.
Det kommer inte längre att vara tillåtet att skicka osparade modellinstanser till relaterade filter.
created=True kommer att krävas i signaturen för RemoteUserBackend.configure_user() subklasser.
Stöd för utloggning via GET-förfrågningar i django.contrib.auth.views.LogoutView och django.contrib.auth.views.logout_then_login() kommer att tas bort.
Aliaset django.utils.timezone.utc till datetime.timezone.utc kommer att tas bort.
Det kommer inte längre att vara tillåtet att skicka ett svarsobjekt och ett formulär/formset-namn till SimpleTestCase.assertFormError() och assertFormsetError().
django.contrib.gis.admin.OpenLayersWidget kommer att tas bort.
django.contrib.auth.hashers.CryptPasswordHasher kommer att tas bort.
Mallarna "django/forms/default.html" och "django/forms/formsets/default.html" kommer att tas bort.
Möjligheten att skicka nulls_first=False eller nulls_last=False till metoderna Expression.asc() och Expression.desc() samt uttrycket OrderBy tas bort.

4.1¶

Se Django 3.2 release notes för mer information om dessa ändringar.

Stöd för att tilldela objekt som inte stöder skapande av djupa kopior med copy.deepcopy() till klassattribut i TestCase.setUpTestData() kommer att tas bort.
BaseCommand.requires_system_checks stöder inte booleska värden.
Argumentet whitelist och attributet domain_whitelist i django.core.validators.EmailValidator kommer att tas bort.
Modulvariabeln default_app_config kommer att tas bort.
TransactionTestCase.assertQuerysetEqual() kommer inte längre att automatiskt anropa repr() på en queryset när den jämförs med strängvärden.
django.core.cache.backends.memcached.MemcachedCache kommer att tas bort.
Stöd för formatet före Django 3.2 för meddelanden som används av django.contrib.messages.storage.cookie.CookieStorage kommer att tas bort.

4.0¶

Se Django 3.0 release notes för mer information om dessa ändringar.

django.utils.http.urlquote(), urlquote_plus(), urlunquote() och urlunquote_plus() kommer att tas bort.
django.utils.encoding.force_text() och smart_text() kommer att tas bort.
django.utils.translation.ugettext(), ugettext_lazy(), ugettext_noop(), ungettext() och ungettext_lazy() kommer att tas bort.
django.views.i18n.set_language() kommer inte längre att ställa in användarens språk i request.session (nyckel django.utils.translation.LANGUAGE_SESSION_KEY).
alias=None kommer att krävas i signaturen för django.db.models.Expression.get_group_by_cols() subklasser.
django.utils.text.unescape_entities() kommer att tas bort.
django.utils.http.is_safe_url() kommer att tas bort.

Se Django 3.1 release notes för mer information om dessa ändringar.

Inställningen PASSWORD_RESET_TIMEOUT_DAYS kommer att tas bort.
Den odokumenterade användningen av isnull lookup med icke-booleska värden som höger sida kommer inte längre att tillåtas.
Undantagsklassen django.db.models.query_utils.InvalidQuery kommer att tas bort.
Ingångspunkten django-admin.py kommer att tas bort.
Metoden HttpRequest.is_ajax() kommer att tas bort.
Stöd för kodningsformatet före Django 3.1 för cookie-värden som används av django.contrib.messages.storage.cookie.CookieStorage kommer att tas bort.
Stöd för lösenordsåterställningstoken från före Django 3.1 på administratörssidan (som använder SHA-1-hashalgoritmen) kommer att tas bort.
Stöd för kodningsformatet för sessioner före Django 3.1 kommer att tas bort.
Stöd för signaturer från före Django 3.1 django.core.signing.Signer (kodade med SHA-1-algoritmen) kommer att tas bort.
Stöd för signaturerna före Django 3.1 django.core.signing.dumps() (kodade med SHA-1-algoritmen) i django.core.signing.loads() kommer att tas bort.
Stöd för användarsessioner före Django 3.1 (som använder SHA-1-algoritmen) kommer att tas bort.
Argumentet get_response för django.utils.deprecation.MiddlewareMixin.__init__() kommer att krävas och accepterar inte None.
Argumentet providing_args för django.dispatch.Signal kommer att tas bort.
Argumentet length för django.utils.crypto.get_random_string() kommer att krävas.
Meddelandet list för ModelMultipleChoiceField kommer att tas bort.
Stöd för att skicka råa kolumnaliaser till QuerySet.order_by() kommer att tas bort.
Modellen NullBooleanField kommer att tas bort. Ett stub-fält kommer att finnas kvar för kompatibilitet med historiska migreringar.
django.conf.urls.url() kommer att tas bort.
Modellen django.contrib.postgres.fields.JSONField kommer att tas bort. Ett stubbfält kommer att finnas kvar för kompatibilitet med historiska migreringar.
django.contrib.postgres.forms.JSONField, django.contrib.postgres.fields.jsonb.KeyTransform och django.contrib.postgres.fields.jsonb.KeyTextTransform kommer att tas bort.
Malltaggarna {% ifequal %} och {% ifnotequal %} kommer att tas bort.
Övergångsinställningen DEFAULT_HASHING_ALGORITHM kommer att tas bort.

3.1¶

Se Django 2.2 release notes för mer information om dessa ändringar.

django.utils.timezone.FixedOffset kommer att tas bort.
django.core.paginator.QuerySetPaginator kommer att tas bort.
En modells Meta.ordering kommer inte längre att påverka GROUP BY-frågor.
django.contrib.postgres.fields.FloatRangeField och django.contrib.postgres.forms.FloatRangeField kommer att tas bort.
Inställningen FILE_CHARSET kommer att tas bort.
django.contrib.staticfiles.storage.CachedStaticFilesStorage kommer att tas bort.
RemoteUserBackend.configure_user() kommer att kräva request som det första positionella argumentet.
Stöd för SimpleTestCase.allow_database_queries och TransactionTestCase.multi_db kommer att tas bort.

3.0¶

Se Django 2.0 release notes för mer information om dessa ändringar.

Modulen django.db.backends.postgresql_psycopg2 kommer att tas bort.
django.shortcuts.render_to_response() kommer att tas bort.
Inställningen DEFAULT_CONTENT_TYPE kommer att tas bort.
HttpRequest.xreadlines() kommer att tas bort.
Stöd för argumentet context i Field.from_db_value() och Expression.convert_value() kommer att tas bort.
Nyckelordsargumentet field_name i QuerySet.earliest() och latest() kommer att tas bort.

Se Django 2.1 release notes för mer information om dessa ändringar.

django.contrib.gis.db.models.functions.ForceRHR kommer att tas bort.
django.utils.http.cookie_date() kommer att tas bort.
Malltaggbiblioteken staticfiles och admin_static kommer att tas bort.
django.contrib.staticfiles.templatetags.static() kommer att tas bort.
Den shim som tillåter att InlineModelAdmin.has_add_permission() definieras utan ett obj-argument kommer att tas bort.

2.1¶

Se Django 1.11 release notes för mer information om dessa ändringar.

contrib.auth.views.login(), logout(), password_change(), password_change_done(), password_reset(), password_reset_done(), password_reset_confirm() och password_reset_complete() kommer att tas bort.
Parametern extra_context i contrib.auth.views.logout_then_login() kommer att tas bort.
django.test.runner.setup_databases() kommer att tas bort.
django.utils.translation.string_concat() kommer att tas bort.
django.core.cache.backends.memcached.PyLibMCCache kommer inte längre att stödja överföring av pylibmc beteendeinställningar som toppnivåattribut för OPTIONS.
Parametern host i django.utils.http.is_safe_url() kommer att tas bort.
Avstängning av undantag som uppstår vid rendering av malltaggen {% include %} kommer att tas bort.
DatabaseIntrospection.get_indexes() kommer att tas bort.
Metoden authenticate() för autentiseringsbackends kräver request som det första positionella argumentet.
Dekoratorn django.db.models.permalink() kommer att tas bort.
Inställningen USE_ETAGS kommer att tas bort. CommonMiddleware och django.utils.cache.patch_response_headers() kommer inte längre att ställa in ETags.
Attributet Model._meta.has_auto_field kommer att tas bort.
url():s stöd för inline-flaggor i grupper av reguljära uttryck ((?i), (?L), (?m), (?s) och (?u)) kommer att tas bort.
Stöd för Widget.render()-metoder utan renderer-argumentet kommer att tas bort.

2.0¶

Se Django 1.9 release notes för mer information om dessa ändringar.

Argumentet weak till django.dispatch.signals.Signal.disconnect() kommer att tas bort.
django.db.backends.base.BaseDatabaseOperations.check_aggregate_support() kommer att tas bort.
Paketet django.forms.extras kommer att tas bort.
Hjälpen assignment_tag kommer att tas bort.
Argumentet host till assertsRedirects kommer att tas bort. Kompatibilitetslagret som gör att absoluta webbadresser kan betraktas som likvärdiga med relativa när sökvägen är identisk kommer också att tas bort.
Field.rel kommer att tas bort.
attributet Field.remote_field.to kommer att tas bort.
Argumentet on_delete för ForeignKey och OneToOneField kommer att krävas.
django.db.models.fields.add_lazy_relation() kommer att tas bort.
När stöd för tidszoner är aktiverat kommer databasbackends som inte stöder tidszoner inte längre att konvertera medvetna datatider till naiva värden i UTC när sådana värden skickas som parametrar till SQL-frågor som körs utanför ORM, t.ex. med cursor.execute().
Dekoratorn django.contrib.auth.tests.utils.skipIfCustomUser() kommer att tas bort.
Klasserna GeoManager och GeoQuerySet kommer att tas bort.
Modulen django.contrib.gis.geoip kommer att tas bort.
supports_recursion-kontrollen för mallladdare kommer att tas bort från:
- django.template.engine.Engine.find_template()`
- django.template.loader_tags.ExtendsNode.find_template()
- django.template.loaders.base.Loader.supports_recursion()
- django.template.loaders.cached.Loader.supports_recursion()
Mallladdningsmetoderna load_template() och load_template_sources() kommer att tas bort.
Argumentet template_dirs för mallladdare kommer att tas bort:
- django.template.loaders.base.Loader.get_template()
- django.template.loaders.cached.Loader.cache_key()`
- django.template.loaders.cached.Loader.get_template()
- django.template.loaders.cached.Loader.get_template_sources()
- django.template.loaders.filesystem.Loader.get_template_sources()`
Metoden django.template.loaders.base.Loader.__call__() kommer att tas bort.
Stöd för anpassade felvyer med en enda positionell parameter kommer att tas bort.
Attributet mime_type för django.utils.feedgenerator.Atom1Feed och django.utils.feedgenerator.RssFeed kommer att tas bort till förmån för content_type.
Argumentet app_name till django.conf.urls.include() kommer att tas bort.
Stöd för att skicka en 3-tupel som första argument till include() kommer att tas bort.
Stöd för att ange en URL-instansnamnrymd utan en applikationsnamnrymd kommer att tas bort.
Field._get_val_from_obj() kommer att tas bort till förmån för Field.value_from_object().
django.template.loaders.eggs.Loader kommer att tas bort.
Parametern current_app för vyerna contrib.auth kommer att tas bort.
Nyckelordsargumentet callable_obj till SimpleTestCase.assertRaisesMessage() kommer att tas bort.
Stöd för attributet allow_tags på ModelAdmin-metoder kommer att tas bort.
Nyckelordsargumentet enclosure till SyndicationFeed.add_item() kommer att tas bort.
Aliasen django.template.loader.LoaderOrigin och django.template.base.StringOrigin för django.template.base.Origin kommer att tas bort.

Se Django 1.10 release notes för mer information om dessa ändringar.

Alternativet makemigrations --exit kommer att tas bort.
Stöd för direkt tilldelning till en omvänd främmande nyckel eller en relation mellan många och många kommer att tas bort.
Metoderna get_srid() och set_srid() i django.contrib.gis.geos.GEOSGeometry kommer att tas bort.
Metoderna get_x(), set_x(), get_y(), set_y(), get_z() och set_z() i django.contrib.gis.geos.Point kommer att tas bort.
Metoderna get_coords() och set_coords() i django.contrib.gis.geos.Point kommer att tas bort.
Egenskapen cascaded_union för django.contrib.gis.geos.MultiPolygon kommer att tas bort.
django.utils.functional.allow_lazy() kommer att tas bort.
Alternativet shell --plain kommer att tas bort.
Modulen django.core.urlresolvers kommer att tas bort.
Modellen CommaSeparatedIntegerField kommer att tas bort. Ett stub-fält kommer att finnas kvar för kompatibilitet med historiska migreringar.
Stöd för mallmetoden Context.has_key() kommer att tas bort.
Stöd för metoderna django.core.files.storage.Storage.accessed_time(), created_time() och modified_time() kommer att tas bort.
Stöd för frågeuppslagningar som använder modellnamnet när Meta.default_related_name är inställt kommer att tas bort.
Frågeuppslagningen __search och metoden DatabaseOperations.fulltext_search_sql() kommer att tas bort.
Shim för att stödja anpassade relaterade manager-klasser utan en _apply_rel_filters()-metod kommer att tas bort.
Att använda User.is_authenticated() och User.is_anonymous() som metoder kommer inte längre att stödjas.
Det privata attributet virtual_fields i Model._meta kommer att tas bort.
De privata nyckelordsargumenten virtual_only i Field.contribute_to_class() och virtual i Model._meta.add_field() kommer att tas bort.
Vyerna javascript_catalog() och json_catalog() kommer att tas bort.
Funktionen django.contrib.gis.utils.precision_wkt() kommer att tas bort.
I arv med flera tabeller kommer implicit marknadsföring av en OneToOneField till en parent_link att tas bort.
Stöd för Widget._format_value() kommer att tas bort.
FileField metoderna get_directory_name() och get_filename() kommer att tas bort.
Funktionen mark_for_escaping() och de klasser den använder: EscapeData, EscapeBytes, EscapeText, EscapeString och EscapeUnicode kommer att tas bort.
Filtret escape kommer att ändras till att använda django.utils.html.conditional_escape().
Manager.use_for_related_fields kommer att tas bort.
Modellens Manager-arv kommer att följa MRO-arvsreglerna och Meta.manager_inheritance_from_future för att välja detta beteende kommer att tas bort.
Stöd för gammaldags middleware med hjälp av settings.MIDDLEWARE_CLASSES kommer att tas bort.

1.10¶

Se Django 1.8 release notes för mer information om dessa ändringar.

Stöd för att anropa en SQLCompiler direkt som ett alias för att anropa dess quote_name_unless_alias -metod kommer att tas bort.
cycle och firstof malltaggar kommer att tas bort från future malltaggsbiblioteket (används under 1.6/1.7 utfasningsperioden).
django.conf.urls.patterns() kommer att tas bort.
Stöd för argumentet prefix till django.conf.urls.i18n.i18n_patterns() kommer att tas bort.
SimpleTestCase.urls kommer att tas bort.
Om man använder ett felaktigt antal uppackade värden i for-malltaggen kommer ett undantag att uppstå istället för ett tyst fel.
Möjligheten att vända webbadresser som använder en prickad Python-sökväg kommer att tas bort.
Möjligheten att använda en prickad Python-sökväg för inställningarna LOGIN_URL och LOGIN_REDIRECT_URL kommer att tas bort.
Stöd för optparse kommer att tas bort för anpassade hanteringskommandon (ersätts av argparse).
Klassen django.core.management.NoArgsCommand kommer att tas bort. Använd BaseCommand istället, som inte tar några argument som standard.
modulen django.core.context_processors kommer att tas bort.
modulen django.db.models.sql.aggregates kommer att tas bort.
modulen django.contrib.gis.db.models.sql.aggregates kommer att tas bort.
Följande metoder och egenskaper för django.db.sql.query.Query kommer att tas bort:
- Egenskaper: aggregat och aggregat_select
- Metoder: add_aggregate, set_aggregate_mask och append_aggregate_mask.
django.template.resolve_variable kommer att tas bort.
Följande privata API:er kommer att tas bort från django.db.models.options.Options (Model._meta):
- get_field_by_name()
- get_all_field_names()
- get_fields_with_model()
- get_konkreta_fält_med_modell()`
- get_m2m_med_modell()`
- get_all_related_objects()
- get_all_related_objects_with_model()
- get_all_related_many_to_many_objects()
- get_all_related_m2m_objects_with_model()
Argumentet error_message i django.forms.RegexField kommer att tas bort.
Filtret unordered_list stöder inte längre listor i gammal stil.
Stöd för sträng-”view”-argument till url() kommer att tas bort.
Den bakåtkompatibla shim för att byta namn på django.forms.Form._has_changed() till has_changed() kommer att tas bort.
Mallfiltret removetags kommer att tas bort.
Funktionerna remove_tags() och strip_entities() i django.utils.html kommer att tas bort.
Argumentet is_admin_site till django.contrib.auth.views.password_reset() kommer att tas bort.
django.db.models.field.subclassing.SubfieldBase kommer att tas bort.
django.utils.checksums kommer att tas bort; dess funktionalitet ingår i django-localflavor 1.1+.
Attributet original_content_type_id på django.contrib.admin.helpers.InlineAdminForm kommer att tas bort.
Den bakåtkompatibla shim som tillåter att FormMixin.get_form() definieras utan något standardvärde för dess form_class-argument kommer att tas bort.
Följande inställningar kommer att tas bort:
- TILLÅTET_INKLUDERA_RÖTTER
- TEMPLATE_KONTEXT_PROCESSORER
- TEMPLATE_DEBUG
- TEMPLATE_DIRS
- TEMPLATE_LADDARE
- TEMPLATE_STRING_IF_INVALID
Det bakåtkompatibla aliaset django.template.loader.BaseLoader kommer att tas bort.
Django-mallobjekt som returneras av get_template() och select_template() accepterar inte längre en Context i sin render()-metod.
Template response APIs kommer att genomdriva användningen av dict och backend-beroende mallobjekt istället för Context respektive Template.
Parametern current_app för följande funktioner och klasser kommer att tas bort:
- django.shortcuts.render()
- django.template.Context()
- django.template.RequestContext()`
- django.template.response.TemplateResponse() ``
Parametrarna dictionary och context_instance för följande funktioner kommer att tas bort:
- django.shortcuts.render()
- django.shortcuts.render_to_response()
- django.template.loader.render_to_string()
Parametern dirs för följande funktioner kommer att tas bort:
- django.template.loader.get_template()
- django.template.loader.select_template()
- django.shortcuts.render()
- django.shortcuts.render_to_response()
Sessionsverifiering kommer att aktiveras oavsett om 'django.contrib.auth.middleware.SessionAuthenticationMiddleware'` finns i MIDDLEWARE_CLASSES eller inte.
Det privata attributet django.db.models.Field.related kommer att tas bort.
Alternativet --list i hanteringskommandot migrate kommer att tas bort.
Malltaggen ssi kommer att tas bort.
Stöd för jämförelseoperatorn = i malltaggen if kommer att tas bort.
De shims för bakåtkompatibilitet som tillåter att Storage.get_available_name() och Storage.save() definieras utan ett max_length-argument kommer att tas bort.
Stöd för den äldre syntaxen %(<foo>)s i ModelFormMixin.success_url kommer att tas bort.
aggregatmetoderna GeoQuerySet collect(), extent(), extent3d(), make_line() och unionagg() kommer att tas bort.
Möjligheten att ange ContentType.name när man skapar en innehållstypsinstans kommer att tas bort.
Stöd för den gamla signaturen för allow_migrate kommer att tas bort. Det ändrades från allow_migrate(self, db, model) till allow_migrate(self, db, app_label, model_name=None, **hints).
Stöd för syntaxen {% cycle %} som använder kommaseparerade argument kommer att tas bort.
Varningen som Signer utfärdar när den får en ogiltig separator kommer att bli ett undantag.

1.9¶

Se Django 1.7 release notes för mer information om dessa ändringar.

django.utils.dictconfig kommer att tas bort.
django.utils.importlib kommer att tas bort.
django.utils.tzinfo kommer att tas bort.
django.utils.unittest kommer att tas bort.
Kommandot syncdb kommer att tas bort.
django.db.models.signals.pre_syncdb och django.db.models.signals.post_syncdb kommer att tas bort.
allow_syncdb på databasroutrar kommer inte längre automatiskt att bli allow_migrate.
Automatisk synkronisering av appar utan migreringar kommer att tas bort. Migreringar kommer att bli obligatoriska för alla appar om du inte anger alternativet --run-syncdb till migrate.
SQL-hanteringskommandona för appar utan migreringar, sql, sqlall, sqlclear, sqldropindexes och sqlindexes, kommer att tas bort.
Stöd för automatisk laddning av initial_data fixturer och initiala SQL-data kommer att tas bort.
Alla modeller måste definieras i en installerad applikation eller deklarera en explicit app_label. Dessutom kommer det inte att vara möjligt att importera dem innan deras applikation har laddats. I synnerhet kommer det inte att vara möjligt att importera modeller inuti rotpaketet för deras applikation.
Modellen och formuläret IPAddressField kommer att tas bort. Ett stub-fält kommer att finnas kvar för kompatibilitet med historiska migreringar.
AppCommand.handle_app() kommer inte längre att stödjas.
RequestSite och get_current_site() kommer inte längre att vara importerbara från django.contrib.sites.models.
FastCGI-stöd via hanteringskommandot runfcgi kommer att tas bort. Distribuera ditt projekt med hjälp av WSGI.
django.utils.datastructures.SortedDict kommer att tas bort. Använd collections.OrderedDict från Pythons standardbibliotek istället.
ModelAdmin.declared_fieldsets kommer att tas bort.
Förekomster av util.py i Djangos kodbas har bytt namn till utils.py i ett försök att förena alla util- och utils-referenser. De moduler som gav bakåtkompatibilitet kommer att tas bort:
- django.contrib.admin.util
- django.contrib.gis.db.backends.util
- django.db.backends.util
- django.forms.util
ModelAdmin.get_formsets kommer att tas bort.
Den shim för bakåtkompatibilitet som infördes för att byta namn på metoden BaseMemcachedCache._get_memcache_timeout() till get_backend_timeout() kommer att tas bort.
Alternativen --natural och -n för dumpdata kommer att tas bort.
Argumentet use_natural_keys för serializers.serialize() kommer att tas bort.
Privata API django.forms.forms.get_declared_fields() kommer att tas bort.
Möjligheten att använda en SplitDateTimeWidget med DateTimeField kommer att tas bort.
Egenskapen WSGIRequest.REQUEST kommer att tas bort.
Klassen django.utils.datastructures.MergeDict kommer att tas bort.
Språkkoderna zh-cn och zh-tw kommer att tas bort och har ersatts av språkkoderna zh-hans respektive zh-hant.
Den interna django.utils.functional.memoize kommer att tas bort.
django.core.cache.get_cache kommer att tas bort. Lägg till lämpliga poster i CACHES och använd django.core.cache.caches istället.
django.db.models.loading kommer att tas bort.
Det kommer inte längre att vara möjligt att skicka anropsbara argument till querysets.
BaseCommand.requires_model_validation kommer att tas bort till förmån för requires_system_checks. Admin-validatorer kommer att ersättas av admin-kontroller.
Attributen ModelAdmin.validator_class och default_validator_class kommer att tas bort.
ModelAdmin.validate() kommer att tas bort.
django.db.backends.DatabaseValidation.validate_field kommer att tas bort till förmån för metoden check_field.
Ledningskommandot validate kommer att tas bort.
django.utils.module_loading.import_by_path kommer att tas bort till förmån för django.utils.module_loading.import_string.
`ssi och url malltaggar kommer att tas bort från future malltaggbiblioteket (används under 1.3/1.4 utfasningsperioden).
django.utils.text.javascript_quote kommer att tas bort.
Databasens testinställningar som självständiga poster i databasinställningarna, med prefixet TEST_, kommer inte längre att stödjas.
Alternativet cache_choices till ModelChoiceField och ModelMultipleChoiceField kommer att tas bort.
Standardvärdet för attributet RedirectView.permanent ändras från True till False.
django.contrib.sitemaps.FlatPageSitemap kommer att tas bort till förmån för django.contrib.flatpages.sitemaps.FlatPageSitemap.
Privata API django.test.utils.TestTemplateLoader kommer att tas bort.
Modulen django.contrib.contenttypes.generic kommer att tas bort.
Privata API:er django.db.models.sql.where.WhereNode.make_atom() och django.db.models.sql.where.Constraint kommer att tas bort.

1.8¶

Se Django 1.6 release notes för mer information om dessa ändringar.

django.contrib.comments kommer att tas bort.
Följande API:er för transaktionshantering kommer att tas bort:
- TransactionMiddleware,
- dekoratörerna och kontexthanterarna autocommit, commit_on_success och commit_manually, definierade i django.db.transaction,
- funktionerna commit_unless_managed och rollback_unless_managed, som också definieras i django.db.transaction,
- inställningen TRANSACTIONS_MANAGED.
Malltaggarna cycle och firstof kommer automatiskt att utläsa sina argument. I 1.6 och 1.7 tillhandahålls detta beteende av versionen av dessa taggar i malltaggbiblioteket future.
Inställningen SEND_BROKEN_LINK_EMAILS kommer att tas bort. Lägg till django.middleware.common.BrokenLinkEmailsMiddleware middleware till din MIDDLEWARE_CLASSES inställning istället.
django.middleware.doc.XViewMiddleware kommer att tas bort. Använd django.contrib.admindocs.middleware.XViewMiddleware istället.
Model._meta.module_name döptes om till model_name.
Ta bort de bakåtkompatibla shims som infördes för att byta namn på get_query_set och liknande queryset-metoder. Detta påverkar följande klasser: BaseModelAdmin, ChangeList, BaseCommentNode, GenericForeignKey, Manager, SingleRelatedObjectDescriptor och ReverseSingleRelatedObjectDescriptor.
Ta bort de bakåtkompatibla shims som infördes för att byta namn på attributen ChangeList.root_query_set och ChangeList.query_set.
django.views.defaults.shortcut kommer att tas bort, som en del av målet att ta bort alla django.contrib-referenser från kärnan i Django-kodbasen. Använd istället django.contrib.contenttypes.views.shortcut. django.conf.urls.shortcut kommer också att tas bort.
Stöd för modulen Python Imaging Library (PIL) kommer att tas bort, eftersom den inte längre verkar underhållas aktivt och inte fungerar på Python 3.
Följande privata API:er kommer att tas bort:
- django.db.backend
- django.db.close_connection()
- django.db.backends.creation.BaseDatabaseCreation.set_autocommit()`
- django.db.transaction.is_managed() ``
- django.db.transaction.managed()
django.forms.widgets.RadioInput kommer att tas bort till förmån för django.forms.widgets.RadioChoiceInput.
Modulen django.test.simple och klassen django.test.simple.DjangoTestSuiteRunner kommer att tas bort. Använd istället django.test.runner.DiscoverRunner.
Modulen django.test._doctest kommer att tas bort. Använd istället doctest-modulen från Pythons standardbibliotek.
Inställningen CACHE_MIDDLEWARE_ANONYMOUS_ONLY kommer att tas bort.
Användning av den hårdkodade Håll ner ”Control”, eller ”Command” på en Mac, för att välja mer än en. sträng för att åsidosätta eller lägga till användartillhandahållen help_text i formulär för ManyToMany-modellfält kommer inte att utföras av Django längre, varken i modell- eller formulärskiktet.
Metoderna Model._meta.get_(add|change|delete)_permission kommer att tas bort.
Sessionsnyckeln django_language kommer inte längre att läsas för bakåtkompatibilitet.
Geografiska webbplatskartor kommer att tas bort (django.contrib.gis.sitemaps.views.index och django.contrib.gis.sitemaps.views.sitemap).
django.utils.html.fix_ampersands, mallfiltret fix_ampersands och django.utils.html.clean_html kommer att tas bort efter en påskyndad utfasning.

1.7¶

Se Django 1.5 release notes för mer information om dessa ändringar.

Modulen django.utils.simplejson kommer att tas bort. Standardbiblioteket tillhandahåller json som bör användas istället.
Funktionen django.utils.itercompat.product kommer att tas bort. Den inbyggda Python-versionen bör användas istället.
Automatisk korrigering av INSTALLED_APPS- och TEMPLATE_DIRS-inställningar när de anges som en vanlig sträng istället för en tupel kommer att tas bort och ge upphov till ett undantag.
Argumentet mimetype till metoderna __init__ i HttpResponse, SimpleTemplateResponse, och TemplateResponse, kommer att tas bort. content_type bör användas istället. Detta gäller även för genvägen render_to_response() och sitemap-vyerna, index() och sitemap().
När HttpResponse instansieras med en iterator, eller när content sätts till en iterator, kommer den iteratorn att konsumeras omedelbart.
Inställningen AUTH_PROFILE_MODULE och metoden get_profile() i User-modellen kommer att tas bort.
Ledningskommandot cleanup kommer att tas bort. Det ersätts av clearsessions.
Skriptet daily_cleanup.py kommer att tas bort.
Nyckelordsargumentet depth kommer att tas bort från select_related().
De odokumenterade funktionerna get_warnings_state()/restore_warnings_state() från django.test.utils och metoderna save_warnings_state()/ restore_warnings_state() django.test.*TestCase är föråldrade. Använd istället warnings.catch_warnings kontexthanterare som finns tillgänglig från och med Python 2.6.
Den odokumenterade metoden check_for_test_cookie i AuthenticationForm kommer att tas bort efter en accelererad depreciering. Användare som underklassar detta formulär bör ta bort anrop till denna metod och istället se till att deras auth-relaterade vyer är CSRF-skyddade, vilket säkerställer att cookies är aktiverade.
Den version av django.contrib.auth.views.password_reset_confirm() som stöder base36-kodade användar-ID (django.contrib.auth.views.password_reset_confirm_uidb36) kommer att tas bort. Om din webbplats har kört Django 1.6 i mer än PASSWORD_RESET_TIMEOUT_DAYS, kommer denna ändring inte att ha någon effekt. Om inte, kommer alla länkar för återställning av lösenord som genereras innan du uppgraderar till Django 1.7 inte att fungera efter uppgraderingen.
Mix-in django.utils.encoding.StrAndUnicode kommer att tas bort.

1.6¶

Se Django 1.4 release notes för mer information om dessa ändringar.

django.contrib.databrowse kommer att tas bort.
django.contrib.localflavor kommer att tas bort efter en snabbare utfasning.
django.contrib.markup kommer att tas bort efter en påskyndad avskrivning.
Kompatibilitetsmodulerna django.utils.copycompat och django.utils.hashcompat samt funktionerna django.utils.itercompat.all och django.utils.itercompat.any kommer att tas bort. De inbyggda Python-versionerna bör användas istället.
Dekoratorerna csrf_response_exempt och csrf_view_exempt kommer att tas bort. Sedan 1.4 har csrf_response_exempt varit en no-op (den returnerar samma funktion), och csrf_view_exempt har varit en synonym för django.views.decorators.csrf.csrf_exempt, som bör användas för att ersätta den.
Backend django.core.cache.backends.memcached.CacheClass delades upp i två i Django 1.3 för att införa stöd för PyLibMC. Den historiska CacheClass kommer att tas bort till förmån för django.core.cache.backends.memcached.MemcachedCache.
De UK-prefixerade objekten i django.contrib.localflavor.uk kommer endast att vara tillgängliga genom sina GB-prefixerade namn (GB är den korrekta ISO 3166-koden för Storbritannien).
Inställningarna IGNORABLE_404_STARTS och IGNORABLE_404_ENDS har ersatts av IGNORABLE_404_URLS i utgåvan 1.4. De kommer att tas bort.
Formulärguiden har omarbetats för att använda klassbaserade vyer med pluggbara backends i 1.4. Den tidigare implementationen kommer att tas bort.
Äldre sätt att anropa cache_page() kommer att tas bort.
Den bakåtkompatibla shim som automatiskt lägger till ett debug-false-filter i logghanteraren 'mail_admins kommer att tas bort. Inställningen LOGGING bör inkludera detta filter explicit om det önskas.
De inbyggda trunkeringsfunktionerna django.utils.text.truncate_words() och django.utils.text.truncate_html_words() kommer att tas bort till förmån för klassen django.utils.text.Truncator.
Klassen django.contrib.gis.geoip.GeoIP flyttades till django.contrib.gis.geoip i 1.4 – genvägen i django.contrib.gis.utils kommer att tas bort.
django.conf.urls.defaults kommer att tas bort. Funktionerna include(), patterns(), och url(), plus handler404 och handler500 är nu tillgängliga via django.conf.urls.
Funktionerna setup_environ() och execute_manager() kommer att tas bort från django.core.management. Detta innebär också att den gamla (pre-1.4) stilen för manage.py-filen inte längre kommer att fungera.
Att ställa in flaggorna is_safe och needs_autoescape som attribut för mallfilterfunktioner kommer inte längre att stödjas.
Attributet HttpRequest.raw_post_data döptes om till HttpRequest.body i 1.4. Bakåtkompatibiliteten kommer att tas bort – HttpRequest.raw_post_data kommer inte längre att fungera.
Värdet för parametern post_url_continue i ModelAdmin.response_add() måste vara antingen None (för att omdirigera till det nyskapade objektets redigeringssida) eller en förformaterad webbadress. Strängformat, som det tidigare standardvärdet '../%s/', kommer inte att accepteras längre.

1.5¶

Se Django 1.3 release notes för mer information om dessa ändringar.

Att starta Django utan en SECRET_KEY kommer att resultera i ett undantag snarare än en DeprecationWarning. (Detta är accelererat från den vanliga föråldringsvägen; se Django 1.4 release notes.)
Förfrågningshanteraren mod_python kommer att tas bort. Hanteringen mod_wsgi bör användas istället.
Attributet template på django.test.client.Response-objekt som returneras av test client kommer att tas bort. Attributet templates bör användas istället.
django.test.simple.DjangoTestRunner kommer att tas bort. Använd istället en unittest-nativ klass. Funktionerna i django.test.simple.DjangoTestRunner (inklusive fail-fast och Ctrl-C testavslut) kan tillhandahållas av unittest.TextTestRunner.
Den odokumenterade funktionen django.contrib.formtools.utils.security_hash kommer att tas bort, använd istället django.contrib.formtools.utils.form_hmac
De funktionsbaserade generiska vymodulerna kommer att tas bort till förmån för deras klassbaserade motsvarigheter, som beskrivs här.
django.core.servers.basehttp.AdminMediaHandler kommer att tas bort. I stället används django.contrib.staticfiles.handlers.StaticFilesHandler.
Malltaggbiblioteket adminmedia och malltaggen {% admin_media_prefix %} kommer att tas bort till förmån för den generiska hanteringen av statiska filer. (Detta är snabbare än den vanliga utfasningsvägen; se Django 1.4 release notes.)
Malltaggarna url och `ssi kommer att ändras så att det första argumentet i varje tagg är en mallvariabel, inte en implicit sträng. I 1.4 tillhandahålls detta beteende av en version av taggen i malltaggsbiblioteket future.
Hanteringskommandona reset och sqlreset kommer att tas bort.
Autentiseringsbackends måste ha stöd för att en inaktiv användare skickas till alla metoder som hanterar behörigheter. Attributet supports_inactive_user kommer inte längre att kontrolleras och kan tas bort från anpassade backends.
transform() kommer att ge upphov till en GEOSException när den anropas på en geometri utan SRID-värde.
django.http.CompatCookie kommer att tas bort till förmån för django.http.SimpleCookie.
django.core.context_processors.PermWrapper och django.core.context_processors.PermLookupDict kommer att tas bort till förmån för motsvarande django.contrib.auth.context_processors.PermWrapper respektive django.contrib.auth.context_processors.PermLookupDict.
Inställningarna MEDIA_URL eller STATIC_URL måste sluta med ett efterföljande snedstreck för att säkerställa att det finns ett konsekvent sätt att kombinera sökvägar i mallar.
django.db.models.fields.URLField.verify_exists kommer att tas bort. Funktionen utrangerades i 1.3.1 på grund av svårlösta säkerhets- och prestandaproblem och kommer att följa en något snabbare tidsram för utrangeringen.
Översättningar som ligger under den så kallade projektsökvägen kommer att ignoreras under översättningsbyggnadsprocessen som utförs vid körning. Inställningen LOCALE_PATHS kan användas för samma uppgift genom att inkludera filsystemets sökväg till en locale-katalog som innehåller icke-appspecifika översättningar i dess värde.
Appen Markup contrib kommer inte längre att stödja versioner av Python-Markdown-biblioteket som är äldre än 2.1. En påskyndad tidslinje användes eftersom detta var en säkerhetsrelaterad utfasning.
Inställningen CACHE_BACKEND kommer att tas bort. Cache-backend(s) bör anges i inställningen CACHES.

1.4¶

Se Django 1.2 release notes för mer information om dessa ändringar.

CsrfResponseMiddleware och CsrfMiddleware kommer att tas bort. Använd malltaggen {% csrf_token %} i formulär för att aktivera CSRF-skydd. CsrfViewMiddleware kvarstår och är aktiverat som standard.
Den gamla importen för CSRF-funktionalitet (django.contrib.csrf.*), som flyttades till kärnan i 1.2, kommer att tas bort.
Modulen django.contrib.gis.db.backend kommer att tas bort till förmån för de specifika backends.
SMTPConnection kommer att tas bort till förmån för ett generiskt API för e-postbackend.
De många SQL-genereringsfunktionerna på databasens backend kommer att tas bort.
Möjligheten att använda DATABASE_*-familjen av toppnivåinställningar för att definiera databasanslutningar kommer att tas bort.
Möjligheten att använda kortfattad notation för att ange en databasbackend (t.ex. sqlite3 istället för django.db.backends.sqlite3) kommer att tas bort.
Metoderna get_db_prep_save, get_db_prep_value och get_db_prep_lookup måste ha stöd för flera databaser.
Modellen Message (i django.contrib.auth), dess relaterade manager i modellen User (user.message_set), och de associerade metoderna (user.message_set.create() och user.get_and_delete_messages()), kommer att tas bort. Ramverket messages bör användas istället. Den relaterade variabeln messages som returneras av auth-kontextprocessorn kommer också att tas bort. Observera att detta innebär att admin-programmet kommer att vara beroende av kontextprocessorn för meddelanden.
Autentiseringsbackends måste ha stöd för parametern obj för behörighetskontroll. Attributet upports_object_permissions kommer inte längre att kontrolleras och kan tas bort från anpassade backends.
Autentiseringsbackends måste stödja klassen AnonymousUser som skickas till alla metoder som hanterar behörigheter. Variabeln upports_anonymous_user kommer inte längre att kontrolleras och kan tas bort från anpassade backends.
Möjligheten att ange en anropsbar malladdare i stället för en Loader-klass kommer att tas bort, liksom load_template_source-funktionerna som ingår i de inbyggda malladdarna för bakåtkompatibilitet.
django.utils.translation.get_date_formats() och django.utils.translation.get_partial_date_formats(). Dessa funktioner kommer att tas bort; använd den lokalmedvetna django.utils.formats.get_format() för att få lämpliga format.
I django.forms.fields kommer konstanterna: DEFAULT_DATE_INPUT_FORMATS, DEFAULT_TIME_INPUT_FORMATS och DEFAULT_DATETIME_INPUT_FORMATS att tas bort. Använd django.utils.formats.get_format() för att få lämpliga format.
Möjligheten att använda en funktionsbaserad testlöpare kommer att tas bort, tillsammans med testlöparen django.test.simple.run_tests().
Vyn views.feed() och klassen feeds.Feed i django.contrib.syndication kommer att tas bort. Den klassbaserade vyn views.Feed bör användas istället.
django.core.context_processors.auth. Denna utgåva kommer att ta bort den gamla metoden till förmån för den nya metoden i django.contrib.auth.context_processors.auth.
Databasbackend postgresql kommer att tas bort, använd istället backend postgresql_psycopg2.
Språkkoden no kommer att tas bort och har ersatts av språkkoden nb.
Autentiseringsbackends måste definiera det booleska attributet supports_inactive_user fram till version 1.5 då det kommer att antas att alla backends hanterar inaktiva användare.
django.db.models.fields.XMLField kommer att tas bort. Detta avförklarades som en del av 1.3-versionen. Ett accelererat avvecklingsschema har använts eftersom fältet inte har utfört någon roll utöver den som en enkel TextField sedan borttagandet av oldforms. Alla användningar av XMLField kan ersättas med TextField.
Den odokumenterade parametern mixin till metoden open() i django.core.files.storage.Storage (och underklasser) kommer att tas bort.

1.3¶

Se Django 1.1 release notes för mer information om dessa ändringar.

AdminSite.root(). Denna metod för att koppla upp admin-URL:erna kommer att tas bort till förmån för att inkludera admin.site.urls.
Autentiseringsbackends måste definiera de booleska attributen supports_object_permissions och upports_anonymous_user fram till version 1.4, då det kommer att antas att alla backends stöder dessa alternativ.