Calendrier d’obsolescence de Django¶
Ce document présente les échéances où divers aspects de Django seront supprimés ou modifiés de manière non rétrocompatible, après une période d’obsolescence, en accord avec la politique d’obsolescence. Plus de détails sur ces différents éléments sont souvent disponibles dans les notes de publication les précédant de deux versions.
4.0¶
Consultez les notes de publication de Django 3.0 pour plus de détails sur ces changements.
django.utils.http.urlquote()
,urlquote_plus()
,urlunquote()
eturlunquote_plus()
seront supprimées.django.utils.encoding.force_text()
etsmart_text()
seront supprimées.django.utils.translation.ugettext()
,ugettext_lazy()
,ugettext_noop()
,ungettext()
etungettext_lazy()
seront supprimées.django.views.i18n.set_language()
ne définira plus la langue de l’utilisateur dansrequest.session
(clédjango.utils.translation.LANGUAGE_SESSION_KEY
).alias=None
sera obligatoire dans la signature des sous-classes dedjango.db.models.Expression.get_group_by_cols()
.django.utils.text.unescape_entities()
sera supprimée.django.utils.http.is_safe_url()
sera supprimée.
Consultez les notes de publication de Django 3.1 pour plus de détails sur ces changements.
- Le réglage
PASSWORD_RESET_TIMEOUT_DAYS
sera supprimé. - L’utilisation non documentée de l’expression de requête
isnull
avec des valeurs non booléennes dans la partie droite ne sera plus autorisée. - La classe d’exception
django.db.models.query_utils.InvalidQuery
sera supprimée. - Le point d’entrée
django-admin.py
sera supprimé. - La méthode
HttpRequest.is_ajax()
sera supprimée. - La prise en charge du format de codage des cookies d’avant Django 3.1 utilisé par
django.contrib.messages.storage.cookie.CookieStorage
sera supprimée. - La prise en charge des jetons de réinitialisation des mots de passe d’avant Django 3.1 dans le site d’administration (qui utilise l’algorithme de hachage SHA-1) sera supprimée.
- La prise en charge du format de codage des sessions d’avant Django 3.1 sera supprimée.
- La prise en charge des signatures
django.core.signing.Signer
d’avant Django 3.1 (utilisant l’algorithme de hachage SHA-1) sera supprimée. - La prise en charge des signatures
django.core.signing.dumps()
d’avant Django 3.1 (utilisant l’algorithme de hachage SHA-1) sera supprimée dansdjango.core.signing.loads()
. - La prise en charge des sessions d’utilisateurs d’avant Django 3.1 (utilisant l’algorithme de hachage SHA-1) sera supprimée.
- The
get_request
argument fordjango.utils.deprecation.MiddlewareMixin.__init__()
will be required and won’t acceptNone
. - The
providing_args
argument fordjango.dispatch.Signal
will be removed. - Le paramètre
length
dedjango.utils.crypto.get_random_string()
sera obligatoire. - Le message
list
deModelMultipleChoiceField
sera supprimé. - Support for passing raw column aliases to
QuerySet.order_by()
will be removed. - The model
NullBooleanField
will be removed. A stub field will remain for compatibility with historical migrations. django.conf.urls.url()
sera supprimée.- The model
django.contrib.postgres.fields.JSONField
will be removed. A stub field will remain for compatibility with historical migrations. django.contrib.postgres.forms.JSONField
,django.contrib.postgres.fields.jsonb.KeyTransform
, anddjango.contrib.postgres.fields.jsonb.KeyTextTransform
will be removed.- The
{% ifequal %}
and{% ifnotequal %}
template tags will be removed. - The
DEFAULT_HASHING_ALGORITHM
transitional setting will be removed.
3.1¶
Consultez les notes de publication de Django 2.2 pour plus de détails sur ces changements.
django.utils.timezone.FixedOffset
sera supprimée.django.core.paginator.QuerySetPaginator
sera supprimée.- L’attribut
Meta.ordering
des modèles n’affectera plus les requêtesGROUP BY
. django.contrib.postgres.fields.FloatRangeField
etdjango.contrib.postgres.forms.FloatRangeField
seront supprimés.- Le réglage
FILE_CHARSET
sera supprimé. django.contrib.staticfiles.storage.CachedStaticFilesStorage
sera supprimée.RemoteUserBackend.configure_user()
exigerarequest
comme premier paramètre positionnel.- La prise en charge de
SimpleTestCase.allow_database_queries
et deTransactionTestCase.multi_db
sera supprimée.
3.0¶
Consultez les notes de publication de Django 2.0 pour plus de détails sur ces changements.
- Le module
django.db.backends.postgresql_psycopg2
sera supprimé. django.shortcuts.render_to_response()
sera supprimée.- Le réglage
DEFAULT_CONTENT_TYPE
sera supprimé. HttpRequest.xreadlines()
sera supprimée.- La prise en charge du paramètre
context
deField.from_db_value()
et deExpression.convert_value()
sera supprimée. - Le paramètre nommé
field_name
deQuerySet.earliest()
et delatest()
sera supprimé.
Consultez les notes de publication de Django 2.1 pour plus de détails sur ces changements.
django.contrib.gis.db.models.functions.ForceRHR
sera supprimée.django.utils.http.cookie_date()
sera supprimée.- Les bibliothèques de balises de gabarits
staticfiles
etadmin_static
seront supprimées. django.contrib.staticfiles.templatetags.static()
sera supprimée.- La couche de compatibilité pour permettre à
InlineModelAdmin.has_add_permission()
d’être définie sans paramètreobj
sera supprimée.
2.1¶
Consultez les notes de publication de Django 1.11 pour plus de détails sur ces changements.
contrib.auth.views.login()
,logout()
,password_change()
,password_change_done()
,password_reset()
,password_reset_done()
,password_reset_confirm()
etpassword_reset_complete()
seront supprimées.- Le paramètre
extra_context
decontrib.auth.views.logout_then_login()
sera supprimé. django.test.runner.setup_databases()
sera supprimée.django.utils.translation.string_concat()
sera supprimée.django.core.cache.backends.memcached.PyLibMCCache
ne prendra plus en charge la transmission des réglages de comportementpylibmc
comme attributs de premier niveau desOPTIONS
.- Le paramètre
host
dedjango.utils.http.is_safe_url()
sera supprimé. - Le masquage des exceptions produites lors du rendu de la balise de gabarit
{% include %}
sera supprimé. DatabaseIntrospection.get_indexes()
sera supprimée.- La méthode
authenticate()
des moteurs d’authentification exigerarequest
comme premier paramètre positionnel. - Le décorateur
django.db.models.permalink()
sera supprimé. - Le réglage
USE_ETAGS
sera supprimé.CommonMiddleware
etdjango.utils.cache.patch_response_headers()
ne créeront plus d’ETags. - L’attribut
Model._meta.has_auto_field
sera supprimé. - La prise en charge de
url()
des drapeaux en ligne dans les groupes d’expressions régulières ((?i)
,(?L)
,(?m)
,(?s)
, and(?u)
) sera supprimée. - La prise en charge des méthodes
Widget.render()
sans le paramètrerenderer
sera supprimée.
2.0¶
Consultez les notes de publication de Django 1.9 pour plus de détails sur ces changements.
- Le paramètre
weak
dedjango.dispatch.signals.Signal.disconnect()
sera supprimé. django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()
sera supprimée.- Le paquet
django.forms.extras
sera supprimé. - L’utilitaire
assignment_tag
sera supprimé. - Le paramètre
host
deassertsRedirects
sera supprimé. La couche de compatibilité qui permet de considérer les URL absolues égales aux URL relatives lorsque le chemin est identique sera également supprimée. Field.rel
sera supprimé.- L’attribut
Field.remote_field.to
sera supprimé. - Le paramètre
on_delete
deForeignKey
etOneToOneField
deviendra obligatoire. django.db.models.fields.add_lazy_relation()
sera supprimée.- Lorsque la prise en charge des fuseaux horaires est active, les moteurs de base de données qui ne prennent pas en charge les fuseaux horaires ne vont plus convertir les dates/heures avec fuseau en valeurs UTC naïves lorsque de telles valeurs sont transmises en paramètre à des requêtes SQL exécutées en dehors de l’ORM, par exemple avec
cursor.execute()
. - Le décorateur
django.contrib.auth.tests.utils.skipIfCustomUser()
sera supprimé. - Les classes
GeoManager
etGeoQuerySet
seront supprimées. - Le module
django.contrib.gis.geoip
sera supprimé. - Le contrôle
supports_recursion
pour les chargeurs de gabarit sera supprimé de :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()
- Les méthodes de chargeur de gabarit
load_template()
etload_template_sources()
seront supprimées. - Le paramètre
template_dirs
des chargeurs de gabarit sera supprimé de :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()
- La méthode
django.template.loaders.base.Loader.__call__()
sera supprimée. - La prise en charge des vues d’erreur personnalisées avec un seul paramètre positionnel sera supprimée.
- L’attribut
mime_type
dedjango.utils.feedgenerator.Atom1Feed
et dedjango.utils.feedgenerator.RssFeed
sera supprimé en faveur decontent_type
. - Le paramètre
app_name
dedjango.conf.urls.include()
sera supprimé. - Support for passing a 3-tuple as the first argument to
include()
will be removed. - Support for setting a URL instance namespace without an application namespace will be removed.
Field._get_val_from_obj()
will be removed in favor ofField.value_from_object()
.django.template.loaders.eggs.Loader
sera supprimée.- Le paramètre
current_app
decontrib.auth
sera supprimé. - The
callable_obj
keyword argument toSimpleTestCase.assertRaisesMessage()
will be removed. - La prise en charge de l’attribut
allow_tags
des méthodesModelAdmin
sera supprimée. - Le paramètre nommé
enclosure
deSyndicationFeed.add_item()
sera supprimé. - The
django.template.loader.LoaderOrigin
anddjango.template.base.StringOrigin
aliases fordjango.template.base.Origin
will be removed.
Consultez les notes de publication de Django 1.10 pour plus de détails sur ces changements.
- L’option
makemigrations --exit
sera supprimée. - Support for direct assignment to a reverse foreign key or many-to-many relation will be removed.
- The
get_srid()
andset_srid()
methods ofdjango.contrib.gis.geos.GEOSGeometry
will be removed. - Les méthodes
get_x()
,set_x()
,get_y()
,set_y()
,get_z()
etset_z()
dedjango.contrib.gis.geos.Point
seront supprimées. - Les méthodes
get_coords()
etset_coords()
dedjango.contrib.gis.geos.Point
seront supprimées. - La propriété
cascaded_union
dedjango.contrib.gis.geos.MultiPolygon
sera supprimée. django.utils.functional.allow_lazy()
sera supprimée.- L’option
shell --plain
sera supprimée. - Le module
django.core.urlresolvers
sera supprimé. - The model
CommaSeparatedIntegerField
will be removed. A stub field will remain for compatibility with historical migrations. - Support for the template
Context.has_key()
method will be removed. - Support for the
django.core.files.storage.Storage.accessed_time()
,created_time()
, andmodified_time()
methods will be removed. - Support for query lookups using the model name when
Meta.default_related_name
is set will be removed. - The
__search
query lookup and theDatabaseOperations.fulltext_search_sql()
method will be removed. - The shim for supporting custom related manager classes without a
_apply_rel_filters()
method will be removed. - Using
User.is_authenticated()
andUser.is_anonymous()
as methods will no longer be supported. - The private attribute
virtual_fields
ofModel._meta
will be removed. - The private keyword arguments
virtual_only
inField.contribute_to_class()
andvirtual
inModel._meta.add_field()
will be removed. - The
javascript_catalog()
andjson_catalog()
views will be removed. - The
django.contrib.gis.utils.precision_wkt()
function will be removed. - In multi-table inheritance, implicit promotion of a
OneToOneField
to aparent_link
will be removed. - Support for
Widget._format_value()
will be removed. FileField
methodsget_directory_name()
andget_filename()
will be removed.- La fonction
mark_for_escaping()
et les classes qu’elle utilise :EscapeData
,EscapeBytes
,EscapeText
,EscapeString
etEscapeUnicode
seront supprimées. - Le filtre
escape
sera modifié pour utiliserdjango.utils.html.conditional_escape()
. Manager.use_for_related_fields
sera supprimé.- Model
Manager
inheritance will follow MRO inheritance rules and theMeta.manager_inheritance_from_future
to opt-in to this behavior will be removed. - La prise en charge de l’ancien style d’intergiciel utilisant
settings.MIDDLEWARE_CLASSES
sera supprimée.
1.10¶
Consultez les notes de publication de Django 1.8 pour plus de détails sur ces changements.
- Support for calling a
SQLCompiler
directly as an alias for calling itsquote_name_unless_alias
method will be removed. cycle
andfirstof
template tags will be removed from thefuture
template tag library (used during the 1.6/1.7 deprecation period).django.conf.urls.patterns()
sera supprimée.- Support for the
prefix
argument todjango.conf.urls.i18n.i18n_patterns()
will be removed. SimpleTestCase.urls
sera supprimé.- Using an incorrect count of unpacked values in the
for
template tag will raise an exception rather than fail silently. - The ability to reverse URLs using a dotted Python path will be removed.
- The ability to use a dotted Python path for the
LOGIN_URL
andLOGIN_REDIRECT_URL
settings will be removed. - Support for
optparse
will be dropped for custom management commands (replaced byargparse
). - The class
django.core.management.NoArgsCommand
will be removed. UseBaseCommand
instead, which takes no arguments by default. - Le module
django.core.context_processors
sera supprimé. - Le module
djangodb.models.sql.aggregates
sera supprimé. - Le module
django.contrib.gis.db.models.sql.aggregates
sera supprimé. - Les méthodes et propriétés suivantes de
django.db.sql.query.Query
seront supprimées :- Propriétés :
aggregates
etaggregate_select
- Méthodes :
add_aggregate
,set_aggregate_mask
etappend_aggregate_mask
.
- Propriétés :
django.template.resolve_variable
sera supprimée.- Les API privées suivantes seront supprimées de
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()
- Le paramètre
error_message
dedjango.forms.RegexField
sera supprimé. - Le filtre
unordered_list
ne prendra plus en charge les listes de l’ancien style. - La prise en charge des paramètres de
view
sous forme de texte dansurl()
sera supprimée. - La couche de rétrocompatibilité pour renommer
django.forms.Form._has_changed()
enhas_changed()
sera supprimée. - Le filtre de gabarit
removetags
sera supprimé. - Les fonctions
remove_tags()
etstrip_entities()
dedjango.utils.html
seront supprimées. - Le paramètre
is_admin_site
dedjango.contrib.auth.views.password_reset()
sera supprimé. django.db.models.field.subclassing.SubfieldBase
sera supprimée.django.utils.checksums
sera supprimée ; cette fonctionnalité est incluse dansdjango-localflavor
1.1+.- L’attribut
original_content_type_id
dedjango.contrib.admin.helpers.InlineAdminForm
sera supprimé. - La couche de compatibilité pour permettre à
FormMixin.get_form()
d’être définie sans valeur par défaut pour son paramètreform_class
sera supprimée. - Les réglages suivants seront supprimés :
ALLOWED_INCLUDE_ROOTS
TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_DEBUG
TEMPLATE_DIRS
TEMPLATE_LOADERS
TEMPLATE_STRING_IF_INVALID
- L’alias de rétrocompatibilité
django.template.loader.BaseLoader
sera supprimé. - Les objets de gabarit Django renvoyés par
get_template()
etselect_template()
n’accepteront plus deContext
dans leur méthoderender()
. - Les API de réponse de gabarit forceront l’usage de
dict
et d’objets de gabarit dépendants du moteur au lieu de respectivementContext
et deTemplate
. - Le paramètre
current_app
sera supprimé des fonction et classes suivantes :django.shortcuts.render()
django.template.Context()
django.template.RequestContext()
django.template.response.TemplateResponse()
- Les paramètres
dictionary
etcontext_instance
seront supprimés des fonctions suivantes :django.shortcuts.render()
django.shortcuts.render_to_response()
django.template.loader.render_to_string()
- Le paramètre
dirs
sera supprimé des fonctions suivantes :django.template.loader.get_template()
django.template.loader.select_template()
django.shortcuts.render()
django.shortcuts.render_to_response()
- La vérification des sessions sera active sans tenir compte de la présence de
'django.contrib.auth.middleware.SessionAuthenticationMiddleware'
dansMIDDLEWARE_CLASSES
. - L’attribut privé
django.db.models.Field.related
sera supprimé. - L’option
--list
de la commande d’administrationmigrate
sera supprimée. - La balise de gabarit
ssi
sera supprimée. - La prise en charge de l’opérateur de comparaison
=
sera supprimée dans la balise de gabaritif
. - The backwards compatibility shims to allow
Storage.get_available_name()
andStorage.save()
to be defined without amax_length
argument will be removed. - Support for the legacy
%(<foo>)s
syntax inModelFormMixin.success_url
will be removed. - Les méthodes d’agrégation
GeoQuerySet
collect()
,extent()
,extent3d()
,make_line()
etunionagg()
seront supprimées. - 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 fromallow_migrate(self, db, model)
toallow_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.
1.9¶
Consultez les notes de publication de Django 1.7 pour plus de détails sur ces changements.
django.utils.dictconfig
sera supprimé.django.utils.importlib
sera supprimé.django.utils.tzinfo
sera supprimé.django.utils.unittest
sera supprimé.- La commande
syncdb
sera supprimée. django.db.models.signals.pre_syncdb
etdjango.db.models.signals.post_syncdb
seront supprimés.allow_syncdb
on database routers will no longer automatically becomeallow_migrate
.- Automatic syncing of apps without migrations will be removed. Migrations will
become compulsory for all apps unless you pass the
--run-syncdb
option tomigrate
. - The SQL management commands for apps without migrations,
sql
,sqlall
,sqlclear
,sqldropindexes
, andsqlindexes
, will be removed. - La prise en charge du chargement automatique des instantanés
initial_data
et des données SQL initiales sera supprimée. - Tous les modèles devront être définis dans une application installée ou déclarer une option
app_label
explicite. De plus, il ne sera plus possible de les importer avant que leur application soit chargée. En particulier, il ne sera plus possible d’importer des modèles dans le paquet racine de leur application. - Les champ de modèle et de formulaire
IPAddressField
seront supprimés. Un champ de substitution restera pour des raisons de compatibilité avec l’historique des migrations. AppCommand.handle_app()
ne sera plus prise en charge.RequestSite
etget_current_site()
ne pourront plus être importés à partir dedjango.contrib.sites.models
.- La prise en charge de FastCGI par la commande d’administration
runfcgi
sera supprimée. Veuillez déployer votre projet avec WSGI. django.utils.datastructures.SortedDict
sera supprimé. Utilisez à la placecollections.OrderedDict
de la bibliothèque Python standard.ModelAdmin.declared_fieldsets
sera supprimé.- Instances of
util.py
in the Django codebase have been renamed toutils.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
sera supprimé.- The backward compatibility shim introduced to rename the
BaseMemcachedCache._get_memcache_timeout()
method toget_backend_timeout()
will be removed. - Les options
--natural
et-n
dedumpdata
seront supprimées. - Le paramètre
use_natural_keys
deserializers.serialize()
sera supprimé. - L’API privée
django.forms.forms.get_declared_fields()
sera supprimée. - La possibilité d’utiliser un composant
SplitDateTimeWidget
avecDateTimeField
sera supprimée. - La propriété
WSGIRequest.REQUEST
sera supprimée. - La classe
django.utils.datastructures.MergeDict
sera supprimée. - The
zh-cn
andzh-tw
language codes will be removed and have been replaced by thezh-hans
andzh-hant
language code respectively. - La fonction interne
django.utils.functional.memoize
sera supprimée. django.core.cache.get_cache
sera supprimée. Ajoutez plutôt les lignes adéquates dansCACHES
et utilisezdjango.core.cache.caches
.django.db.models.loading
sera supprimée.- La transmission de paramètres exécutables aux jeux de requête ne sera plus possible.
BaseCommand.requires_model_validation
sera supprimé en faveur derequires_system_checks
.- Les attributs
ModelAdmin.validator_class
etdefault_validator_class
seront supprimés. ModelAdmin.validate()
sera supprimée.django.db.backends.DatabaseValidation.validate_field
will be removed in favor of thecheck_field
method.- La commande d’administration
validate
sera supprimée. django.utils.module_loading.import_by_path
sera supprimé en faveur dedjango.utils.module_loading.import_string
.ssi
andurl
template tags will be removed from thefuture
template tag library (used during the 1.3/1.4 deprecation period).django.utils.text.javascript_quote
sera supprimé.- Database test settings as independent entries in the database settings,
prefixed by
TEST_
, will no longer be supported. - The
cache_choices
option toModelChoiceField
andModelMultipleChoiceField
will be removed. - The default value of the
RedirectView.permanent
attribute will change fromTrue
toFalse
. django.contrib.sitemaps.FlatPageSitemap
will be removed in favor ofdjango.contrib.flatpages.sitemaps.FlatPageSitemap
.- L’API privée
django.test.utils.TestTemplateLoader
sera supprimée. - Le module
django.contrib.contenttypes.generic
sera supprimé. - Les API privées
django.db.models.sql.where.WhereNode.make_atom()
etdjango.db.models.sql.where.Constraint
seront supprimées.
1.8¶
Consultez les notes de publication de Django 1.6 pour plus de détails sur ces changements.
django.contrib.comments
sera supprimé.- Les API de gestion des transactions suivantes seront supprimées :
TransactionMiddleware
,- les décorateurs et gestionnaires de contexte
autocommit
,commit_on_success
etcommit_manually
, définis dansdjango.db.transaction
, - les fonctions
commit_unless_managed
etrollback_unless_managed
, aussi définies dansdjango.db.transaction
, - le réglage
TRANSACTIONS_MANAGED
.
- The
cycle
andfirstof
template tags will auto-escape their arguments. In 1.6 and 1.7, this behavior is provided by the version of these tags in thefuture
template tag library. - The
SEND_BROKEN_LINK_EMAILS
setting will be removed. Add thedjango.middleware.common.BrokenLinkEmailsMiddleware
middleware to yourMIDDLEWARE_CLASSES
setting instead. django.middleware.doc.XViewMiddleware
sera supprimé. Utilisezdjango.contrib.admindocs.middleware.XViewMiddleware
à la place.Model._meta.module_name
a été renommé enmodel_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
andReverseSingleRelatedObjectDescriptor
. - Remove the backward compatible shims introduced to rename the attributes
ChangeList.root_query_set
andChangeList.query_set
. django.views.defaults.shortcut
will be removed, as part of the goal of removing alldjango.contrib
references from the core Django codebase. Instead usedjango.contrib.contenttypes.views.shortcut
.django.conf.urls.shortcut
will also be removed.- Le module Python Imaging Library (PIL) ne sera plus pris en charge, car il ne semble plus activement maintenu et qu’il ne fonctionne pas avec Python 3.
- Les API privées suivantes seront supprimées :
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
sera supprimé en faveur dedjango.forms.widgets.RadioChoiceInput
.- Le module
django.test.simple
et la classedjango.test.simple.DjangoTestSuiteRunner
seront supprimés. Utilisezdjango.test.runner.DiscoverRunner
à la place. - Le module
django.test._doctest
sera supprimé. Utilisez à la place le module doctest de la bibliothèque Python standard. - Le réglage
CACHE_MIDDLEWARE_ANONYMOUS_ONLY
sera supprimé. - 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
anddjango.contrib.gis.sitemaps.views.sitemap
). django.utils.html.fix_ampersands
, thefix_ampersands
template filter anddjango.utils.html.clean_html
will be removed following an accelerated deprecation.
1.7¶
See the Django 1.5 release notes for more details on these changes.
- The module
django.utils.simplejson
will be removed. The standard library providesjson
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 ofHttpResponse
,SimpleTemplateResponse
, andTemplateResponse
, will be removed.content_type
should be used instead. This also applies to therender_to_response()
shortcut and the sitemap views,index()
andsitemap()
. - When
HttpResponse
is instantiated with an iterator, or whencontent
is set to an iterator, that iterator will be immediately consumed. - Le réglage
AUTH_PROFILE_MODULE
ainsi que la méthodeget_profile()
du modèleUser
seront supprimés. - La commande d’administration
cleanup
sera supprimée. Elle est remplacée parclearsessions
. - Le script
daily_cleanup.py
sera supprimé. - Le paramètre nommé
depth
sera supprimé deselect_related()
. - The undocumented
get_warnings_state()
/restore_warnings_state()
functions fromdjango.test.utils
and thesave_warnings_state()
/restore_warnings_state()
django.test.*TestCase methods are deprecated. Use thewarnings.catch_warnings
context manager available starting with Python 2.6 instead. - The undocumented
check_for_test_cookie
method inAuthenticationForm
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 thanPASSWORD_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.
1.6¶
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
anddjango.utils.hashcompat
as well as the functionsdjango.utils.itercompat.all
anddjango.utils.itercompat.any
will be removed. The Python builtin versions should be used instead. - The
csrf_response_exempt
andcsrf_view_exempt
decorators will be removed. Since 1.4csrf_response_exempt
has been a no-op (it returns the same function), andcsrf_view_exempt
has been a synonym fordjango.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 historicalCacheClass
will be removed in favor ofdjango.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
andIGNORABLE_404_ENDS
settings have been superseded byIGNORABLE_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.
- Les anciennes manières d’appeler
cache_page()
seront supprimées. - The backward-compatibility shim to automatically add a debug-false
filter to the
'mail_admins'
logging handler will be removed. TheLOGGING
setting should include this filter explicitly if it is desired. - The builtin truncation functions
django.utils.text.truncate_words()
anddjango.utils.text.truncate_html_words()
will be removed in favor of thedjango.utils.text.Truncator
class. - The
django.contrib.gis.geoip.GeoIP
class was moved todjango.contrib.gis.geoip
in 1.4 – the shortcut indjango.contrib.gis.utils
will be removed. django.conf.urls.defaults
will be removed. The functionsinclude()
,patterns()
, andurl()
, plushandler404
andhandler500
are now available throughdjango.conf.urls
.- The functions
setup_environ()
andexecute_manager()
will be removed fromdjango.core.management
. This also means that the old (pre-1.4) style ofmanage.py
file will no longer work. - Setting the
is_safe
andneeds_autoescape
flags as attributes of template filter functions will no longer be supported. - The attribute
HttpRequest.raw_post_data
was renamed toHttpRequest.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 inModelAdmin.response_add()
will have to be eitherNone
(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.
1.5¶
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 aDeprecationWarning
. (This is accelerated from the usual deprecation path; see the Django 1.4 release notes.) - The
mod_python
request handler will be removed. Themod_wsgi
handler should be used instead. - The
template
attribute ondjango.test.client.Response
objects returned by the test client will be removed. Thetemplates
attribute should be used instead. - The
django.test.simple.DjangoTestRunner
will be removed. Instead use aunittest
-native class. The features of thedjango.test.simple.DjangoTestRunner
(including fail-fast and Ctrl-C test termination) can be provided byunittest.TextTestRunner
. - The undocumented function
django.contrib.formtools.utils.security_hash
will be removed, instead usedjango.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 usedjango.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
andssi
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 thefuture
template tag library. - Les commandes d’administration
reset
etsqlreset
seront supprimées. - 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 aGEOSException
when called on a geometry with no SRID value.django.http.CompatCookie
will be removed in favor ofdjango.http.SimpleCookie
.django.core.context_processors.PermWrapper
anddjango.core.context_processors.PermLookupDict
will be removed in favor of the correspondingdjango.contrib.auth.context_processors.PermWrapper
anddjango.contrib.auth.context_processors.PermLookupDict
, respectively.- The
MEDIA_URL
orSTATIC_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 alocale
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 theCACHES
setting.
1.4¶
Consultez les notes de publication de Django 1.2 pour plus de détails sur ces changements.
CsrfResponseMiddleware
andCsrfMiddleware
will be removed. Use the{% csrf_token %}
template tag inside forms to enable CSRF protection.CsrfViewMiddleware
remains and is enabled by default.- Les anciennes importations de fonctionnalité CSRF (
django.contrib.csrf.*
), qui sont passées dans le cœur Django dans la version 1.2 seront supprimées. - Le module
django.contrib.gis.db.backend
sera supprimé en faveur des moteurs spécifiques. SMTPConnection
sera supprimée en faveur d’une API générique de moteur de courriels.- Les fonctions de génération SQL plusieurs-à-plusieurs des moteurs de base de données seront supprimées.
- La possibilité d’utiliser la famille de réglages de premier niveau
DATABASE_*
pour définir les connexions de base de données sera supprimée. - The ability to use shorthand notation to specify a database backend
(i.e.,
sqlite3
instead ofdjango.db.backends.sqlite3
) will be removed. - The
get_db_prep_save
,get_db_prep_value
andget_db_prep_lookup
methods will have to support multiple databases. - The
Message
model (indjango.contrib.auth
), its related manager in theUser
model (user.message_set
), and the associated methods (user.message_set.create()
anduser.get_and_delete_messages()
), will be removed. The messages framework should be used instead. The relatedmessages
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. Thesupports_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. Thesupports_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 theload_template_source
functions that are included with the built in template loaders for backwards compatibility. django.utils.translation.get_date_formats()
anddjango.utils.translation.get_partial_date_formats()
. These functions will be removed; use the locale-awaredjango.utils.formats.get_format()
to get the appropriate formats.- In
django.forms.fields
, the constants:DEFAULT_DATE_INPUT_FORMATS
,DEFAULT_TIME_INPUT_FORMATS
andDEFAULT_DATETIME_INPUT_FORMATS
will be removed. Usedjango.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 andfeeds.Feed
class indjango.contrib.syndication
will be removed. The class-based viewviews.Feed
should be used instead. django.core.context_processors.auth
. This release will remove the old method in favor of the new method indjango.contrib.auth.context_processors.auth
.- Le moteur de base de données
postgresql
sera supprimé, utilisez à la place le moteurpostgresql_psycopg2
. - Le code de langue
no
sera supprimé car il a été remplacé par le code de languenb
. - 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 simpleTextField
since the removal ofoldforms
. All uses ofXMLField
can be replaced withTextField
.- The undocumented
mixin
parameter to theopen()
method ofdjango.core.files.storage.Storage
(and subclasses) will be removed.
1.3¶
Consultez les notes de publication de Django 1.1 pour plus de détails sur ces changements.
AdminSite.root()
. Cette méthode de branchement des URL d’administration sera supprimée en faveur de l’inclusion deadmin.site.urls
.- Les moteurs d’authentification doivent définir les attributs booléens
supports_object_permissions
etsupports_anonymous_user
jusqu’à la version 1.4, après quoi Django supposera que tous les moteurs savent gérer ces options.