[1.7.x] Documented how to rename get_query_set if you are a library author

Backport of ca139bbfdf from master
This commit is contained in:
Luke Plant 2014-10-02 11:19:18 +01:00
parent b21ec1ab6e
commit adae224572
1 changed files with 20 additions and 0 deletions

View File

@ -1099,6 +1099,26 @@ a regular deprecation path.
Methods that return a ``QuerySet`` such as ``Manager.get_query_set`` or
``ModelAdmin.queryset`` have been renamed to ``get_queryset``.
If you are writing a library that implements, for example, a
``Manager.get_query_set`` method, and you need to support old Django versions,
you should rename the method and conditionally add an alias with the old name::
class CustomManager(models.Manager):
def get_queryset(self):
pass # ...
if django.VERSION < (1, 6):
get_query_set = get_queryset
# For Django >= 1.6, models.Manager provides a get_query_set fallback
# that emits a warning when used.
If you are writing a library that needs to call the ``get_queryset`` method and
must support old Django versions, you should write::
method = getattr(some_manager, 'get_queryset', some_manager.get_query_set)
method(params)
``shortcut`` view and URLconf
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~