innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Fixed #30864 -- Doc'd classproperty decorator.

This commit is contained in:
Deep Sukhwani 2020-03-28 18:52:54 +05:30 committed by Mariusz Felisiak
parent 93ed71e058
commit 4b146e0c83
4 changed files with 15 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
AUTHORS
View File

@ -246,6 +246,7 @@ answer newbie questions, and generally made Django that much better:
David Tulig <david.tulig@gmail.com> David Tulig <david.tulig@gmail.com>
David Wobrock <david.wobrock@gmail.com> David Wobrock <david.wobrock@gmail.com>
Davide Ceretti <dav.ceretti@gmail.com> Davide Ceretti <dav.ceretti@gmail.com>
Deep L. Sukhwani <deepsukhwani@gmail.com>
Deepak Thukral <deep.thukral@gmail.com> Deepak Thukral <deep.thukral@gmail.com>
Denis Kuzmichyov <kuzmichyov@gmail.com> Denis Kuzmichyov <kuzmichyov@gmail.com>
Dennis Schwertel <dennisschwertel@gmail.com> Dennis Schwertel <dennisschwertel@gmail.com>

4
django/utils/functional.py
View File

@ -50,6 +50,10 @@ class cached_property:
class classproperty: class classproperty:
"""
Decorator that converts a method with a single cls argument into a property
that can be accessed directly from the class.
"""
def __init__(self, method=None): def __init__(self, method=None):
self.fget = method self.fget = method

8
docs/ref/utils.txt
View File

@ -556,6 +556,14 @@ https://web.archive.org/web/20110718035220/http://diveintomark.org/archives/2004
z = person.friends # does not call z = person.friends # does not call
x is z # is True x is z # is True
.. class:: classproperty(method=None)
.. versionadded:: 3.1
Similar to :py:func:`@classmethod <classmethod>`, the ``@classproperty``
decorator converts the result of a method with a single ``cls`` argument
into a property that can be accessed directly from the class.
.. function:: keep_lazy(func, *resultclasses) .. function:: keep_lazy(func, *resultclasses)
Django offers many utility functions (particularly in ``django.utils``) Django offers many utility functions (particularly in ``django.utils``)

4
docs/releases/3.1.txt
View File

@ -557,8 +557,8 @@ Miscellaneous
``ETag`` header to responses with an empty ``ETag`` header to responses with an empty
:attr:`~django.http.HttpResponse.content`. :attr:`~django.http.HttpResponse.content`.
* ``django.utils.decorators.classproperty()`` decorator is moved to * ``django.utils.decorators.classproperty()`` decorator is made public and
``django.utils.functional.classproperty()``. moved to :class:`django.utils.functional.classproperty()`.
* :tfilter:`floatformat` template filter now outputs (positive) ``0`` for * :tfilter:`floatformat` template filter now outputs (positive) ``0`` for
negative numbers which round to zero. negative numbers which round to zero.