This document outlines when various pieces of Django will be removed or altered in a backward incompatible way, following their deprecation, as per the deprecation policy. More details about each item can often be found in the release notes of two versions prior.
See the Django 5.2 release notes for more details on these changes.
The all
keyword argument of django.contrib.staticfiles.finders.find()
will be removed.
The fallback to request.user
when user
is None
in
django.contrib.auth.login()
and django.contrib.auth.alogin()
will be
removed.
The ordering
keyword argument of the PostgreSQL specific aggregation
functions django.contrib.postgres.aggregates.ArrayAgg
,
django.contrib.postgres.aggregates.JSONBAgg
, and
django.contrib.postgres.aggregates.StringAgg
will be removed.
See the Django 5.0 release notes for more details on these changes.
The DjangoDivFormRenderer
and Jinja2DivFormRenderer
transitional form
renderers will be removed.
Support for passing positional arguments to BaseConstraint
will be
removed.
request
will be required in the signature of
ModelAdmin.lookup_allowed()
subclasses.
The django.db.models.sql.datastructures.Join
will no longer fallback to
get_joining_columns()
.
The get_joining_columns()
method of ForeignObject
and
ForeignObjectRel
will be removed.
The ForeignObject.get_reverse_joining_columns()
method will be removed.
The default scheme for forms.URLField
will change from "http"
to
"https"
.
Support for calling format_html()
without passing args or kwargs will be
removed.
Support for cx_Oracle
will be removed.
BaseDatabaseOperations.field_cast_sql()
will be removed.
The ChoicesMeta
alias to django.db.models.enums.ChoicesType
will be
removed.
The Prefetch.get_current_queryset()
method will be removed.
The get_prefetch_queryset()
method of related managers and descriptors
will be removed.
get_prefetcher()
and prefetch_related_objects()
will no longer
fallback to get_prefetch_queryset()
.
The FORMS_URLFIELD_ASSUME_HTTPS
transitional setting will be removed.
See the Django 5.1 release notes for more details on these changes.
The ModelAdmin.log_deletion()
and LogEntryManager.log_action()
methods will be removed.
The undocumented django.utils.itercompat.is_iterable()
function and the
django.utils.itercompat
module will be removed.
The django.contrib.gis.geoip2.GeoIP2.coords()
method will be removed.
The django.contrib.gis.geoip2.GeoIP2.open()
method will be removed.
Support for passing positional arguments to Model.save()
and
Model.asave()
will be removed.
The setter for django.contrib.gis.gdal.OGRGeometry.coord_dim
will be
removed.
django.urls.register_converter()
will no longer allow overriding existing
converters.
The check
keyword argument of CheckConstraint
will be removed.
The OS_OPEN_FLAGS
attribute of
FileSystemStorage
will be removed.
The get_cache_name()
method of FieldCacheMixin
will be removed.
See the Django 4.2 release notes for more details on these changes.
The BaseUserManager.make_random_password()
method will be removed.
The model’s Meta.index_together
option will be removed.
The length_is
template filter will be removed.
The django.contrib.auth.hashers.SHA1PasswordHasher
,
django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher
, and
django.contrib.auth.hashers.UnsaltedMD5PasswordHasher
will be removed.
The model django.contrib.postgres.fields.CICharField
,
django.contrib.postgres.fields.CIEmailField
, and
django.contrib.postgres.fields.CITextField
will be removed. Stub fields
will remain for compatibility with historical migrations.
The django.contrib.postgres.fields.CIText
mixin will be removed.
The map_width
and map_height
attributes of BaseGeometryWidget
will be removed.
The SimpleTestCase.assertFormsetError()
method will be removed.
The TransactionTestCase.assertQuerysetEqual()
method will be removed.
Support for passing encoded JSON string literals to JSONField
and
associated lookups and expressions will be removed.
Support for passing positional arguments to Signer
and
TimestampSigner
will be removed.
The DEFAULT_FILE_STORAGE
and STATICFILES_STORAGE
settings will be
removed.
The django.core.files.storage.get_storage_class()
function will be
removed.
이러한 변경사항에 대한 자세한 내용은 :ref::`Django 4.0 release notes <deprecedated-features-4.0>’을 참조하십시오.
“SERIALIZE” 테스트 설정이 제거됩니다.
문서화되지 않은 “django.utils.baseconv” 모듈이 제거됩니다.
문서화되지 않은 “django.utils.datetime_safe” 모듈이 제거됩니다.
“USE_TZ” 설정의 기본값은 “False”에서 “True”로 변경됩니다.
요청 컨텍스트 외부에 구축된 사이트 맵의 기본 사이트 맵 프로토콜이 “‘http”에서 “https”로 변경됩니다.
DiscoverRunner.build_suite()
및 ``DiscoverRunner.run_tests()``에 대한 ``extra_tests``인수가 제거됩니다.
The django.contrib.postgres.aggregates.ArrayAgg
, JSONBAgg
, and
StringAgg
aggregates will return None
when there are no rows instead
of []
, []
, and ''
respectively.
USE_L10N
설정이 제거됩니다.
USE_DEPRECATED_PYTZ
전환 설정이 제거됩니다.
pytz
시간대 지원이 제거됩니다.
is_dst
인수는 다음에서 제거됩니다:
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()
django.contrib.gis.admin.GeoModelAdmin
및 OSMGeoAdmin
클래스가 제거됩니다.
문서화되지 않은 BaseForm._html_output()
메서드는 제거됩니다.
ErrorDict
및 ``ErrorList``를 렌더링할 때 ``SafeString``이 아닌 ``str``을 반환하는 기능이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 4.1 릴리스 노트 <deprecated-features-4.1>`를 참조하세요.
SitemapIndexItem.__str__()
메서드가 제거됩니다.
CSRF_COOKIE_MASKED
전환 설정이 제거됩니다.
django.utils.functional.cached_property()``의 ``name
인수가 제거됩니다.
django.contrib.postgres.constraints.ExclusionConstraint``의 ``opclasses
인수가 제거됩니다.
errors=None``을 ``SimpleTestCase.assertFormError()
및 ``assertFormsetError()``에 전달하는 문서화되지 않은 기능이 제거됩니다.
``django.contrib.sessions.serializers.PickleSerializer``가 제거됩니다.
chunk_size
인수를 제공하지 않고 관련 객체를 미리 가져오는 쿼리셋에서 QuerySet.iterator()
사용이 더 이상 허용되지 않습니다.
저장되지 않은 모델 인스턴스를 관련 필터에 전달하는 것은 더 이상 허용되지 않습니다.
created=True``는 ``RemoteUserBackend.configure_user()
하위 클래스의 서명에 필요합니다.
django.contrib.auth.views.LogoutView
및``django.contrib.auth.views.logout_then_login()``에서 GET
요청을 총한 로그아웃 지원이 제거됩니다.
django.utils.timezone.utc
별칭에서 ``datetime.timezone.utc``가 제거됩니다.
SimpleTestCase.assertFormError()
및 ``assertFormsetError()``에 응답 객체 및 폼/폼셋 이름을 전달하는 것이 더 이상 허용되지 않습니다.
``django.contrib.gis.admin.OpenLayersWidget``이 제거됩니다.
``django.contrib.auth.hashers.CryptPasswordHasher``가 제거됩니다.
"django/forms/default.html"
및 "django/forms/formsets/default.html"
템플릿이 제거됩니다.
nulls_first=False
또는 nulls_last=False``를 ``Expression.asc()
및 Expression.desc()
메서드에 전달하는 기능과 OrderBy
표현식은 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 3.2 릴리스 노트 <deprecated-features-3.2>`를 참조하세요.
``TestCase.setUpTestData()``의 클래스 속성에 ``copy.deepcopy()``를 사용하여 깊은 복사 생성을 지원하지 않는 개체 할당에 대한 지원이 제거됩니다.
``BaseCommand.requires_system_checks``는 부울 값을 지원하지 않습니다.
``django.core.validators.EmailValidator``의 ``whitelist``인수 및 ``domain_whitelist``속성이 제거됩니다.
default_app_config
모듈 변수가 제거됩니다.
``TransactionTestCase.assertQuerysetEqual()``은 문자열 값과 비교할 때 더 이상 쿼리 세트에서 ``repr()``을 자동으로 호출하지 않습니다.
``django.core.cache.backends.memcached.MemcachedCache``가 제거됩니다.
``django.conrib.messages.storage.cookie.CookieStorage``에서 사용하는 Django 3.2 이전 형식의 메시지에 대한 지원이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 3.0 릴리스 노트 <deprecated-features-3.0>`을 참조하세요
django.utils.http.urlquote()
, urlquote_plus()
, urlunquote()
및 ``urlunquote_plus()``가 제거됩니다.
django.utils.encoding.force_text()
및 ``smart_text()``가 제거됩니다.
django.utils.translation.ugettext()
, ugettext_lazy()
, ugettext_noop()
, ungettext()
및 ``ungettext_lazy()``가 제거됩니다.
django.views.i18n.set_language()``는 더 이상 ``request.session``(키 ``django.utils.translation.LANGUAGE_SESSION_KEY
)에서 사용자 언어를 설정하지 않습니다.
alias=None``은 ``django.db.models.Expression.get_group_by_cols()
하위 클래스의 서명에 필요합니다.
``django.utils.text.unescape_entities()``가 제거됩니다.
``django.utils.http.is_safe_url()``가 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 3.1 릴리스 노트 <deprecated-features-3.1>`를 참조하십시오.
PASSWORD_RESET_TIMEOUT_DAYS
설정이 제거됩니다.
부울이 아닌 값을 우변으로 사용하는 isnull
조회의 문서화되지 않은 사용은 더 이상 허용되지 않습니다.
django.db.models.query_utils.InvalidQuery
예외 클래스가 제거됩니다.
django-admin.py
진입점이 제거됩니다.
HttpRequest.is_ajax()
메서드가 제거됩니다.
``django.contrib.messages.storage.cookie.CookieStorage``에서 사용하는 쿠키 값의 Django 3.1 이전 인코딩 형식에 대한 지원이 제거됩니다.
관리 사이트(SHA-1 해싱 알고리즘 사용)에서 Django 3.1 이전 암호 재설정 토큰에 대한 지원이 제거됩니다.
세션의 Django 3.1 이전 인코딩 형식에 대한 지원이 제거됩니다.
Django 3.1 이전 django.core.signing.Signer
서명(SHA-1 알고리즘으로 인코딩됨)에 대한 지원이 제거됩니다.
django.core.signing.loads()``에서 Django 3.1 이전 ``django.core.signing.dumps()
서명(SHA-1 알고리즘으로 인코딩됨)에 대한 지원이 제거됩니다.
Django 3.1 이전 사용자 세션(SHA-1 알고리즘 사용)에 대한 지원이 제거됩니다.
django.utils.deprecation.MiddlewareMixin.__init__()``에 대한 ``get_response
인수가 필요하며 ``None``을 허용하지 않습니다.
django.dispatch.Signal``에 대한 ``providing_args
인수가 제거됩니다.
django.utils.crypto.get_random_string()``에 대한 ``length
인수가 필요합니다.
ModelMultipleChoiceField``에 대한 ``list
메시지가 제거됩니다.
원시 열 별칭을 ``QuerySet.order_by()``에 전달하는 지원이 제거됩니다.
NullBooleanField
모델이 제거됩니다. 이전 마이그레이션과의 호환성을 위해 스텁 필드가 유지됩니다.
``django.conf.urls.url()``이 제거됩니다.
django.contrib.postgres.fields.JSONField
모델이 제거됩니다. 이전 마이그레이션과의 호환성을 위해 스텁 필드가 유지됩니다.
django.contrib.postgres.forms.JSONField
, django.contrib.postgres.fields.jsonb.KeyTransform
및 ``django.contrib.postgres.fields.jsonb.KeyTextTransform``이 제거됩니다.
{% ifequal %}
및 {% ifnotequal %}
템플릿 태그가 제거됩니다.
DEFAULT_HASHING_ALGORITHM
전환 설정이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 2.2 릴리스 노트 <deprecated-features-2.2>`를 참조하세요.
``django.utils.timezone.FixedOffset``이 제거됩니다.
``django.core.paginator.QuerySetPaginator``가 제거됩니다.
모델의 Meta.ordering``은 더 이상 ``GROUP BY
쿼리에 영향을 미치지 않습니다.
django.contrib.postgres.fields.FloatRangeField
및 ``django.contrib.postgres.forms.FloatRangeField``가 제거됩니다.
FILE_CHARSET
설정이 제거됩니다.
``django.contrib.staticfiles.storage.CachedStaticFilesStorage``가 제거됩니다.
``RemoteUserBackend.configure_user()``는 첫 번째 인수로 ``request``를 요구합니다.
SimpleTestCase.allow_database_queries
및 TransactionTestCase.multi_db
지원이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 2.0 릴리스 노트<deprecated-features-2.0>`를 참조하십시오.
django.db.backends.postgresql_psycopg2
모듈이 제거됩니다.
``django.shortcuts.render_to_response()``가 제거됩니다.
DEFAULT_CONTENT_TYPE
설정이 제거됩니다.
``HttpRequest.xreadlines()``가 제거됩니다.
Field.from_db_value()
및 Expression.convert_value()``의 ``context
인수에 대한 지원이 제거됩니다.
QuerySet.earliest()
및 latest()``의 ``field_name
키워드 인수가 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 2.1 릴리스 노트 <deprecated-features-2.1>`를 참조하십시오.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 1.11 릴리스 노트<deprecated-features-1.11>`를 참조하십시오.
contrib.auth.views.login()
, logout()
, password_change()
, password_change_done()
, password_reset()
, password_reset_done( )
, password_reset_confirm()
및 ``password_reset_complete()``가 제거됩니다.
contrib.auth.views.logout_then_login()``의 ``extra_context
매개변수가 제거됩니다.
``django.test.runner.setup_databases()``가 제거됩니다.
``django.utils.translation.string_concat()``이 제거됩니다.
django.core.cache.backends.memcached.PyLibMCCache``는 더 이상 ``pylibmc
동작 설정을 ``OPTIONS``의 최상위 속성으로 전달하는 것을 지원하지 않습니다.
django.utils.http.is_safe_url()``의 ``host
매개변수가 제거됩니다.
{% include %}
템플렛 태그를 렌더링하는 동안 발생한 예외 무시가 제거됩니다.
``DatabaseIntrospection.get_indexes()``가 제거됩니다.
인증 백엔드의 authenticate()
메서드는 첫 번째 인수로 ``request``를 요구합니다.
django.db.models.permalink()
데코레이터가 제거됩니다.
USE_ETAGS
설정이 제거됩니다. CommonMiddleware
및 ``django.utils.cache.patch_response_headers()``는 더 이상 ETag를 설정하지 않습니다.
Model._meta.has_auto_field
속성이 제거됩니다.
정규표현식 그룹((?i)
, (?L)
, (?m)
, (?s)
, and (?u)
) 의 인라인 플래그에 대한 ``url()``의 지원이 제거됩니다.
renderer
인수가 없는 Widget.render()
메서드에 대한 지원이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 1.9 릴리스 노트<deprecated-features-1.9>`를 참조하세요.
django.dispatch.signals.Signal.disconnect()``에 대한 ``weak
인수가 제거됩니다.
``django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()``가 제거됩니다.
django.forms.extras
패키지가 제거됩니다.
assignment_tag
도우미가 제거됩니다.
assertsRedirects``에 대한 ``host
인수가 제거됩니다. 경로가 동일한 경우 절대 URL을 상대 URL과 동일하게 간주할 수 있는 호환성 계층도 제거됩니다.
``Field.rel``이 제거됩니다.
Field.remote_field.to
속성이 제거됩니다.
ForeignKey
및 OneToOneField``에 대한 ``on_delete
인수가 필요합니다.
``django.db.models.fields.add_lazy_relation()``이 제거됩니다.
시간대 지원이 활성화되면 시간대를 지원하지 않는 데이터베이스 백엔드는 이러한 값이 ORM 외부에서 실행되는 SQL 쿼리(``cursor.execute()``를 사용하는)에 매개변수로 전달될 때 더 이상 인식 날짜 시간을 UTC의 순진한 값으로 변환하지 않습니다.
django.contrib.auth.tests.utils.skipIfCustomUser()
데코레이터가 제거됩니다.
GeoManager
및 GeoQuerySet
클래스가 제거됩니다.
django.contrib.gis.geoip
모듈이 제거됩니다.
템플릿 로더에 대한 supports_recursion
검사가 다음에서 제거됩니다.
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()
load_template()
및 load_template_sources()
템플릿 로더 메서드는 제거됩니다.
템플릿 로더에 대한 template_dirs
인수가 제거됩니다:
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()
django.template.loaders.base.Loader.__call__()
메서드가 제거됩니다.
단일 위치 매개변수가 있는 사용자 지정 오류 보기에 대한 지원이 중단됩니다.
django.utils.feedgenerator.Atom1Feed
및 django.utils.feedgenerator.RssFeed``의 ``mime_type
속성은 ``content_type``을 위해 제거됩니다.
django.conf.urls.include()``에 대한 ``app_name
인수가 제거됩니다.
``include()``에 대한 첫 번째 인수로 3-튜플을 전달하는 지원이 제거됩니다.
애플리케이션 네임스페이스 없이 URL 인스턴스 네임스페이스를 설정하는 지원이 제거됩니다.
``Field._get_val_from_obj()``는 ``Field.value_from_object()``를 위해 제거됩니다.
``django.template.loaders.eggs.Loader``가 제거됩니다.
contrib.auth
보기에 대한 current_app
매개변수가 제거됩니다.
SimpleTestCase.assertRaisesMessage()``에 대한 ``callable_obj
키워드 인수가 제거됩니다.
ModelAdmin
메서드의 allow_tags
속성에 대한 지원이 제거됩니다.
SyndicationFeed.add_item()``에 대한 ``enclosure
키워드 인수가 제거됩니다.
django.template.base.Origin``의 ``django.template.loader.LoaderOrigin
및 django.template.base.StringOrigin
별칭이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 1.10 릴리스 노트 <deprecated-features-1.10>`를 참조하세요.
makemigrations --exit
옵션이 제거됩니다.
역방향 외래 키 또는 다대다 관계에 대한 직접 할당 지원이 제거됩니다.
django.contrib.gis.geos.GEOSGeometry``의 ``get_srid()
및 set_srid()
메소드가 제거됩니다.
django.contrib.gis.geos.Point``의 ``get_x()
, set_x()
, get_y()
, set_y()
, get_z()
및 set_z()
메서드가 제거됩니다.
django.contrib.gis.geos.Point``의 ``get_coords()
및 set_coords()
메서드가 제거됩니다.
django.contrib.gis.geos.MultiPolygon``의 ``cascaded_union
속성이 제거됩니다.
``django.utils.functional.allow_lazy()``가 제거됩니다.
shell --plain
옵션이 제거됩니다.
django.core.urlresolvers
모듈이 제거됩니다.
CommaSeparatedIntegerField
모델이 제거됩니다. 이전 마이그레이션과의 호환성을 위해 스텁 필드가 유지됩니다.
템플릿 Context.has_key()
메서드에 대한 지원이 제거됩니다.
django.core.files.storage.Storage.accessed_time()
, created_time()
및 modified_time()
메서드에 대한 지원이 제거됩니다.
``Meta.default_related_name``이 설정된 경우 모델 이름을 사용한 쿼리 조회 지원이 제거됩니다.
__search
쿼리 조회 및 DatabaseOperations.fulltext_search_sql()
메서드가 제거됩니다.
_apply_rel_filters()
메서드 없이 사용자 지정 관련 관리자 클래스를 지원하기 위한 shim이 제거됩니다.
User.is_authenticated()
및 ``User.is_anonymous()``를 메소드로 사용하는 것은 더 이상 지원되지 않습니다.
Field.contribute_to_class()``의 ``virtual_only
및 Model._meta.add_field()``의 ``virtual
비공개 키워드 인수가 제거됩니다.
javascript_catalog()
및 json_catalog()
보기가 제거됩니다.
django.contrib.gis.utils.precision_wkt()
함수가 제거됩니다.
다중 테이블 상속에서 ``OneToOneField``에서 ``parent_link``로의 암시적 확장이 제거됩니다.
``Widget._format_value()``에 대한 지원이 제거됩니다.
FileField
메서드 get_directory_name()
및 ``get_filename()``이 제거됩니다.
mark_for_escaping()
함수와 EscapeData
, EscapeBytes
, EscapeText
, EscapeString
및 EscapeUnicode
클래스가 제거됩니다.
escape
필터는 ``django.utils.html.conditional_escape()``를 사용하도록 변경됩니다.
``Manager.use_for_related_fields``가 제거됩니다.
모델 Manager
상속은 MRO 상속 규칙을 따르며 이 동작을 선택하는 ``Meta.manager_inheritance_from_future``는 제거됩니다.
``settings.MIDDLEWARE_CLASSES``를 사용하는 구식 미들웨어에 대한 지원이 제거됩니다.
이러한 변경 사항에 대한 자세한 내용은 :ref:`Django 1.8 릴리스 노트<deprecated-features-1.8>`를 참조하십시오.
quote_name_unless_alias
메서드를 호출하기 위한 별칭으로 ``SQLCompiler``를 직접 호출하는 지원이 제거됩니다.
cycle
및 firstof
템플릿 태그는 future
템플릿 태그 라이브러리에서 제거됩니다(1.6/1.7 지원 중단 기간 동안 사용됨).
``django.conf.urls.patterns()``가 제거됩니다.
django.conf.urls.i18n.i18n_patterns()``에 대한 ``prefix
인수 지원이 제거됩니다.
``SimpleTestCase.urls``가 제거됩니다.
for
템플릿 태그에서 압축 해제된 값의 잘못된 개수를 사용하면 조용히 실패하지 않고 예외가 발생합니다.
점으로 구분된 Python 경로를 사용하여 URL을 뒤집는 기능이 제거됩니다.
LOGIN_URL
및 LOGIN_REDIRECT_URL
설정에 점으로 구분된 Python 경로를 사용하는 기능이 제거됩니다.
사용자 지정 관리 명령에 대한 optparse
지원이 중단됩니다( :py:mod:`argparse`로 대체됩니다).
django.core.management.NoArgsCommand
클래스가 제거됩니다. 기본적으로 인수를 사용하지 않는 클래스:`~django.core.management.BaseCommand`를 대신 사용하십시오.
django.core.context_processors
모듈이 제거됩니다.
django.db.models.sql.aggregates
모듈이 제거됩니다.
django.contrib.gis.db.models.sql.aggregates
모듈이 제거됩니다.
``django.db.sql.query.Query``의 다음 메서드 및 속성이 제거됩니다.
속성: aggregates
및 aggregate_select
메소드: add_aggregate
, set_aggregate_mask
및 append_aggregate_mask
``django.template.resolve_variable``이 제거됩니다.
다음 비공개 API는 django.db.models.options.Options`(``Model._meta`
)에서 제거됩니다.
get_field_by_name()
get_all_field_names()
get_fields_with_model()
get_concrete_fields_with_model()
get_m2m_with_model()
get_all_related_objects()
get_all_related_objects_with_model()
get_all_related_many_to_many_objects()
get_all_related_m2m_objects_with_model()
django.forms.RegexField``의 ``error_message
인수가 제거됩니다.
The unordered_list
filter will no longer support old style lists.
url()``에 대한 문자열 ``view
인수에 대한 지원이 제거됩니다.
``django.forms.Form._has_changed()``를 ``has_changed()``로 이름을 바꾸는 이전 버전과 호환되는 심이 제거됩니다.
removetags
템플릿 필터가 제거됩니다.
django.utils.html``의 ``remove_tags()
및 strip_entities()
함수가 제거됩니다.
django.contrib.auth.views.password_reset()``에 대한 ``is_admin_site
인수가 제거됩니다.
django.db.models.field.subclassing.SubfieldBase
will be removed.
django.utils.checksums
will be removed; its functionality is included
in django-localflavor
1.1+.
The original_content_type_id
attribute on
django.contrib.admin.helpers.InlineAdminForm
will be removed.
The backwards compatibility shim to allow FormMixin.get_form()
to be
defined with no default value for its form_class
argument will be removed.
The following settings will be removed:
ALLOWED_INCLUDE_ROOTS
TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_DEBUG
TEMPLATE_DIRS
TEMPLATE_LOADERS
TEMPLATE_STRING_IF_INVALID
The backwards compatibility alias django.template.loader.BaseLoader
will
be removed.
Django template objects returned by
get_template()
and
select_template()
won’t accept a
Context
in their
render()
method anymore.
Template response APIs will enforce the use
of dict
and backend-dependent template objects instead of
Context
and Template
respectively.
The current_app
parameter for the following function and classes will be
removed:
django.shortcuts.render()
django.template.Context()
django.template.RequestContext()
django.template.response.TemplateResponse()
The dictionary
and context_instance
parameters for the following
functions will be removed:
django.shortcuts.render()
django.shortcuts.render_to_response()
django.template.loader.render_to_string()
The dirs
parameter for the following functions will be removed:
django.template.loader.get_template()
django.template.loader.select_template()
django.shortcuts.render()
django.shortcuts.render_to_response()
Session verification will be enabled regardless of whether or not
'django.contrib.auth.middleware.SessionAuthenticationMiddleware'
is in
MIDDLEWARE_CLASSES
.
Private attribute django.db.models.Field.related
will be removed.
The --list
option of the migrate
management command will be removed.
The ssi
template tag will be removed.
Support for the =
comparison operator in the if
template tag will be
removed.
The backwards compatibility shims to allow Storage.get_available_name()
and Storage.save()
to be defined without a max_length
argument will
be removed.
Support for the legacy %(<foo>)s
syntax in ModelFormMixin.success_url
will be removed.
GeoQuerySet
aggregate methods collect()
, extent()
, extent3d()
,
make_line()
, and unionagg()
will be removed.
Ability to specify ContentType.name
when creating a content type instance
will be removed.
Support for the old signature of allow_migrate
will be removed. It changed
from allow_migrate(self, db, model)
to
allow_migrate(self, db, app_label, model_name=None, **hints)
.
Support for the syntax of {% cycle %}
that uses comma-separated arguments
will be removed.
The warning that Signer
issues when given an
invalid separator will become an exception.
See the Django 1.7 release notes for more details on these changes.
django.utils.dictconfig
will be removed.
django.utils.importlib
will be removed.
django.utils.tzinfo
will be removed.
django.utils.unittest
will be removed.
The syncdb
command will be removed.
django.db.models.signals.pre_syncdb
and
django.db.models.signals.post_syncdb
will be removed.
allow_syncdb
on database routers will no longer automatically become
allow_migrate
.
Automatic syncing of apps without migrations will be removed. Migrations will
become compulsory for all apps unless you pass the --run-syncdb
option to
migrate
.
The SQL management commands for apps without migrations, sql
, sqlall
,
sqlclear
, sqldropindexes
, and sqlindexes
, will be removed.
Support for automatic loading of initial_data
fixtures and initial SQL
data will be removed.
All models will need to be defined inside an installed application or
declare an explicit app_label
.
Furthermore, it won’t be possible to import them before their application
is loaded. In particular, it won’t be possible to import models inside
the root package of their application.
The model and form IPAddressField
will be removed. A stub field will
remain for compatibility with historical migrations.
AppCommand.handle_app()
will no longer be supported.
RequestSite
and get_current_site()
will no longer be importable from
django.contrib.sites.models
.
FastCGI support via the runfcgi
management command will be
removed. Please deploy your project using WSGI.
django.utils.datastructures.SortedDict
will be removed. Use
collections.OrderedDict
from the Python standard library instead.
ModelAdmin.declared_fieldsets
will be removed.
Instances of util.py
in the Django codebase have been renamed to
utils.py
in an effort to unify all util and utils references.
The modules that provided backwards compatibility will be removed:
django.contrib.admin.util
django.contrib.gis.db.backends.util
django.db.backends.util
django.forms.util
ModelAdmin.get_formsets
will be removed.
The backward compatibility shim introduced to rename the
BaseMemcachedCache._get_memcache_timeout()
method to
get_backend_timeout()
will be removed.
The --natural
and -n
options for dumpdata
will be removed.
The use_natural_keys
argument for serializers.serialize()
will be
removed.
Private API django.forms.forms.get_declared_fields()
will be removed.
The ability to use a SplitDateTimeWidget
with DateTimeField
will be
removed.
The WSGIRequest.REQUEST
property will be removed.
The class django.utils.datastructures.MergeDict
will be removed.
The zh-cn
and zh-tw
language codes will be removed and have been
replaced by the zh-hans
and zh-hant
language code respectively.
The internal django.utils.functional.memoize
will be removed.
django.core.cache.get_cache
will be removed. Add suitable entries
to CACHES
and use django.core.cache.caches
instead.
django.db.models.loading
will be removed.
Passing callable arguments to querysets will no longer be possible.
BaseCommand.requires_model_validation
will be removed in favor of
requires_system_checks
. Admin validators will be replaced by admin
checks.
The ModelAdmin.validator_class
and default_validator_class
attributes
will be removed.
ModelAdmin.validate()
will be removed.
django.db.backends.DatabaseValidation.validate_field
will be removed in
favor of the check_field
method.
The validate
management command will be removed.
django.utils.module_loading.import_by_path
will be removed in favor of
django.utils.module_loading.import_string
.
ssi
and url
template tags will be removed from the future
template
tag library (used during the 1.3/1.4 deprecation period).
django.utils.text.javascript_quote
will be removed.
Database test settings as independent entries in the database settings,
prefixed by TEST_
, will no longer be supported.
The cache_choices
option to ModelChoiceField
and
ModelMultipleChoiceField
will be removed.
The default value of the
RedirectView.permanent
attribute will change from True
to False
.
django.contrib.sitemaps.FlatPageSitemap
will be removed in favor of
django.contrib.flatpages.sitemaps.FlatPageSitemap
.
Private API django.test.utils.TestTemplateLoader
will be removed.
The django.contrib.contenttypes.generic
module will be removed.
Private APIs django.db.models.sql.where.WhereNode.make_atom()
and
django.db.models.sql.where.Constraint
will be removed.
See the Django 1.6 release notes for more details on these changes.
django.contrib.comments
will be removed.
The following transaction management APIs will be removed:
TransactionMiddleware
,
the decorators and context managers autocommit
, commit_on_success
,
and commit_manually
, defined in django.db.transaction
,
the functions commit_unless_managed
and rollback_unless_managed
,
also defined in django.db.transaction
,
the TRANSACTIONS_MANAGED
setting.
The cycle
and firstof
template tags will auto-escape their
arguments. In 1.6 and 1.7, this behavior is provided by the version of these
tags in the future
template tag library.
The SEND_BROKEN_LINK_EMAILS
setting will be removed. Add the
django.middleware.common.BrokenLinkEmailsMiddleware
middleware to
your MIDDLEWARE_CLASSES
setting instead.
django.middleware.doc.XViewMiddleware
will be removed. Use
django.contrib.admindocs.middleware.XViewMiddleware
instead.
Model._meta.module_name
was renamed to model_name
.
Remove the backward compatible shims introduced to rename get_query_set
and similar queryset methods. This affects the following classes:
BaseModelAdmin
, ChangeList
, BaseCommentNode
,
GenericForeignKey
, Manager
, SingleRelatedObjectDescriptor
and
ReverseSingleRelatedObjectDescriptor
.
Remove the backward compatible shims introduced to rename the attributes
ChangeList.root_query_set
and ChangeList.query_set
.
django.views.defaults.shortcut
will be removed, as part of the
goal of removing all django.contrib
references from the core
Django codebase. Instead use
django.contrib.contenttypes.views.shortcut
. django.conf.urls.shortcut
will also be removed.
Support for the Python Imaging Library (PIL) module will be removed, as it no longer appears to be actively maintained & does not work on Python 3.
The following private APIs will be removed:
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
will be removed in favor of
django.forms.widgets.RadioChoiceInput
.
The module django.test.simple
and the class
django.test.simple.DjangoTestSuiteRunner
will be removed. Instead use
django.test.runner.DiscoverRunner
.
The module django.test._doctest
will be removed. Instead use the doctest
module from the Python standard library.
The CACHE_MIDDLEWARE_ANONYMOUS_ONLY
setting will be removed.
Usage of the hard-coded Hold down “Control”, or “Command” on a Mac, to select
more than one. string to override or append to user-provided help_text
in
forms for ManyToMany model fields will not be performed by Django anymore
either at the model or forms layer.
The Model._meta.get_(add|change|delete)_permission
methods will
be removed.
The session key django_language
will no longer be read for backwards
compatibility.
Geographic Sitemaps will be removed
(django.contrib.gis.sitemaps.views.index
and
django.contrib.gis.sitemaps.views.sitemap
).
django.utils.html.fix_ampersands
, the fix_ampersands
template filter and
django.utils.html.clean_html
will be removed following an accelerated deprecation.
See the Django 1.5 release notes for more details on these changes.
The module django.utils.simplejson
will be removed. The standard library
provides json
which should be used instead.
The function django.utils.itercompat.product
will be removed. The Python
builtin version should be used instead.
Auto-correction of INSTALLED_APPS and TEMPLATE_DIRS settings when they are specified as a plain string instead of a tuple will be removed and raise an exception.
The mimetype
argument to the __init__
methods of
HttpResponse
,
SimpleTemplateResponse
, and
TemplateResponse
, will be removed.
content_type
should be used instead. This also applies to the
render_to_response()
shortcut and the sitemap views,
index()
and
sitemap()
.
When HttpResponse
is instantiated with an iterator,
or when content
is set to an iterator,
that iterator will be immediately consumed.
The AUTH_PROFILE_MODULE
setting, and the get_profile()
method on
the User model, will be removed.
The cleanup
management command will be removed. It’s replaced by
clearsessions
.
The daily_cleanup.py
script will be removed.
The depth
keyword argument will be removed from
select_related()
.
The undocumented get_warnings_state()
/restore_warnings_state()
functions from django.test.utils
and the save_warnings_state()
/
restore_warnings_state()
django.test.*TestCase methods are
deprecated. Use the warnings.catch_warnings
context manager
available starting with Python 2.6 instead.
The undocumented check_for_test_cookie
method in
AuthenticationForm
will be removed
following an accelerated deprecation. Users subclassing this form should
remove calls to this method, and instead ensure that their auth related views
are CSRF protected, which ensures that cookies are enabled.
The version of django.contrib.auth.views.password_reset_confirm()
that
supports base36 encoded user IDs
(django.contrib.auth.views.password_reset_confirm_uidb36
) will be
removed. If your site has been running Django 1.6 for more than
PASSWORD_RESET_TIMEOUT_DAYS
, this change will have no effect. If not,
then any password reset links generated before you upgrade to Django 1.7
won’t work after the upgrade.
The django.utils.encoding.StrAndUnicode
mix-in will be removed.
See the Django 1.4 release notes for more details on these changes.
django.contrib.databrowse
will be removed.
django.contrib.localflavor
will be removed following an accelerated
deprecation.
django.contrib.markup
will be removed following an accelerated
deprecation.
The compatibility modules django.utils.copycompat
and
django.utils.hashcompat
as well as the functions
django.utils.itercompat.all
and django.utils.itercompat.any
will
be removed. The Python builtin versions should be used instead.
The csrf_response_exempt
and csrf_view_exempt
decorators will
be removed. Since 1.4 csrf_response_exempt
has been a no-op (it
returns the same function), and csrf_view_exempt
has been a
synonym for django.views.decorators.csrf.csrf_exempt
, which should
be used to replace it.
The django.core.cache.backends.memcached.CacheClass
backend
was split into two in Django 1.3 in order to introduce support for
PyLibMC. The historical CacheClass
will be removed in favor of
django.core.cache.backends.memcached.MemcachedCache
.
The UK-prefixed objects of django.contrib.localflavor.uk
will only
be accessible through their GB-prefixed names (GB is the correct
ISO 3166 code for United Kingdom).
The IGNORABLE_404_STARTS
and IGNORABLE_404_ENDS
settings have been
superseded by IGNORABLE_404_URLS
in the 1.4 release. They will be
removed.
The form wizard has been refactored to use class-based views with pluggable backends in 1.4. The previous implementation will be removed.
Legacy ways of calling
cache_page()
will be removed.
The backward-compatibility shim to automatically add a debug-false
filter to the 'mail_admins'
logging handler will be removed. The
LOGGING
setting should include this filter explicitly if
it is desired.
The builtin truncation functions django.utils.text.truncate_words()
and django.utils.text.truncate_html_words()
will be removed in
favor of the django.utils.text.Truncator
class.
The django.contrib.gis.geoip.GeoIP
class was moved to
django.contrib.gis.geoip
in 1.4 – the shortcut in
django.contrib.gis.utils
will be removed.
django.conf.urls.defaults
will be removed. The functions
include()
, patterns()
, and url()
, plus
handler404
and handler500
are now available through django.conf.urls
.
The functions setup_environ()
and execute_manager()
will be removed
from django.core.management
. This also means that the old (pre-1.4)
style of manage.py
file will no longer work.
Setting the is_safe
and needs_autoescape
flags as attributes of
template filter functions will no longer be supported.
The attribute HttpRequest.raw_post_data
was renamed to HttpRequest.body
in 1.4. The backward compatibility will be removed –
HttpRequest.raw_post_data
will no longer work.
The value for the post_url_continue
parameter in
ModelAdmin.response_add()
will have to be either None
(to redirect
to the newly created object’s edit page) or a pre-formatted url. String
formats, such as the previous default '../%s/'
, will not be accepted any
more.
See the Django 1.3 release notes for more details on these changes.
Starting Django without a SECRET_KEY
will result in an exception
rather than a DeprecationWarning
. (This is accelerated from the usual
deprecation path; see the Django 1.4 release notes.)
The mod_python
request handler will be removed. The mod_wsgi
handler should be used instead.
The template
attribute on django.test.client.Response
objects returned by the test client will be removed.
The templates
attribute should be
used instead.
The django.test.simple.DjangoTestRunner
will be removed.
Instead use a unittest
-native class. The features of the
django.test.simple.DjangoTestRunner
(including fail-fast and
Ctrl-C test termination) can be provided by unittest.TextTestRunner
.
The undocumented function
django.contrib.formtools.utils.security_hash
will be removed,
instead use django.contrib.formtools.utils.form_hmac
The function-based generic view modules will be removed in favor of their class-based equivalents, outlined here.
The django.core.servers.basehttp.AdminMediaHandler
will be
removed. In its place use
django.contrib.staticfiles.handlers.StaticFilesHandler
.
The template tags library adminmedia
and the template tag {%
admin_media_prefix %}
will be removed in favor of the generic static files
handling. (This is faster than the usual deprecation path; see the
Django 1.4 release notes.)
The url
and ssi
template tags will be modified so that the first
argument to each tag is a template variable, not an implied string. In 1.4,
this behavior is provided by a version of the tag in the future
template
tag library.
The reset
and sqlreset
management commands will be removed.
Authentication backends will need to support an inactive user
being passed to all methods dealing with permissions.
The supports_inactive_user
attribute will no longer be checked
and can be removed from custom backends.
transform()
will raise
a GEOSException
when called
on a geometry with no SRID value.
django.http.CompatCookie
will be removed in favor of
django.http.SimpleCookie
.
django.core.context_processors.PermWrapper
and
django.core.context_processors.PermLookupDict
will be removed in
favor of the corresponding
django.contrib.auth.context_processors.PermWrapper
and
django.contrib.auth.context_processors.PermLookupDict
, respectively.
The MEDIA_URL
or STATIC_URL
settings will be
required to end with a trailing slash to ensure there is a consistent
way to combine paths in templates.
django.db.models.fields.URLField.verify_exists
will be removed. The
feature was deprecated in 1.3.1 due to intractable security and
performance issues and will follow a slightly accelerated deprecation
timeframe.
Translations located under the so-called project path will be ignored during
the translation building process performed at runtime. The
LOCALE_PATHS
setting can be used for the same task by including the
filesystem path to a locale
directory containing non-app-specific
translations in its value.
The Markup contrib app will no longer support versions of Python-Markdown library earlier than 2.1. An accelerated timeline was used as this was a security related deprecation.
The CACHE_BACKEND
setting will be removed. The cache backend(s) should be
specified in the CACHES
setting.
See the Django 1.2 release notes for more details on these changes.
CsrfResponseMiddleware
and CsrfMiddleware
will be removed. Use
the {% csrf_token %}
template tag inside forms to enable CSRF
protection. CsrfViewMiddleware
remains and is enabled by default.
The old imports for CSRF functionality (django.contrib.csrf.*
),
which moved to core in 1.2, will be removed.
The django.contrib.gis.db.backend
module will be removed in favor
of the specific backends.
SMTPConnection
will be removed in favor of a generic email backend API.
The many to many SQL generation functions on the database backends will be removed.
The ability to use the DATABASE_*
family of top-level settings to
define database connections will be removed.
The ability to use shorthand notation to specify a database backend
(i.e., sqlite3
instead of django.db.backends.sqlite3
) will be
removed.
The get_db_prep_save
, get_db_prep_value
and
get_db_prep_lookup
methods will have to support multiple databases.
The Message
model (in django.contrib.auth
), its related
manager in the User
model (user.message_set
), and the
associated methods (user.message_set.create()
and
user.get_and_delete_messages()
), will be removed. The
messages framework should be used
instead. The related messages
variable returned by the
auth context processor will also be removed. Note that this
means that the admin application will depend on the messages
context processor.
Authentication backends will need to support the obj
parameter for
permission checking. The supports_object_permissions
attribute
will no longer be checked and can be removed from custom backends.
Authentication backends will need to support the AnonymousUser
class
being passed to all methods dealing with permissions. The
supports_anonymous_user
variable will no longer be checked and can be
removed from custom backends.
The ability to specify a callable template loader rather than a
Loader
class will be removed, as will the load_template_source
functions that are included with the built in template loaders for
backwards compatibility.
django.utils.translation.get_date_formats()
and
django.utils.translation.get_partial_date_formats()
. These functions
will be removed; use the locale-aware
django.utils.formats.get_format()
to get the appropriate formats.
In django.forms.fields
, the constants: DEFAULT_DATE_INPUT_FORMATS
,
DEFAULT_TIME_INPUT_FORMATS
and
DEFAULT_DATETIME_INPUT_FORMATS
will be removed. Use
django.utils.formats.get_format()
to get the appropriate
formats.
The ability to use a function-based test runner will be removed,
along with the django.test.simple.run_tests()
test runner.
The views.feed()
view and feeds.Feed
class in
django.contrib.syndication
will be removed. The class-based view
views.Feed
should be used instead.
django.core.context_processors.auth
. This release will
remove the old method in favor of the new method in
django.contrib.auth.context_processors.auth
.
The postgresql
database backend will be removed, use the
postgresql_psycopg2
backend instead.
The no
language code will be removed and has been replaced by the
nb
language code.
Authentication backends will need to define the boolean attribute
supports_inactive_user
until version 1.5 when it will be assumed that
all backends will handle inactive users.
django.db.models.fields.XMLField
will be removed. This was
deprecated as part of the 1.3 release. An accelerated deprecation
schedule has been used because the field hasn’t performed any role
beyond that of a simple TextField
since the removal of oldforms
.
All uses of XMLField
can be replaced with TextField
.
The undocumented mixin
parameter to the open()
method of
django.core.files.storage.Storage
(and subclasses) will be removed.
See the Django 1.1 release notes for more details on these changes.
AdminSite.root()
. This method of hooking up the admin URLs will be
removed in favor of including admin.site.urls
.
Authentication backends need to define the boolean attributes
supports_object_permissions
and supports_anonymous_user
until
version 1.4, at which point it will be assumed that all backends will
support these options.
4월 17, 2025