[issue42781] functools.cached_property docs should explain that it is non-overriding

Raymond Hettinger added the comment: New changeset 8333d421c0d7b90de3ff92002af9fd2c5d5f373c by Miss Islington (bot) in branch '3.9': bpo-42781: Document the mechanics of cached_property from a user viewpoint (GH-24031) (#24035)

[issue42781] functools.cached_property docs should explain that it is non-overriding

Change by Raymond Hettinger : -- assignee: docs@python -> rhettinger resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___

[issue42781] functools.cached_property docs should explain that it is non-overriding

Change by miss-islington : -- nosy: +miss-islington nosy_count: 3.0 -> 4.0 pull_requests: +22876 pull_request: https://github.com/python/cpython/pull/24035 ___ Python tracker

[issue42781] functools.cached_property docs should explain that it is non-overriding

Raymond Hettinger added the comment: New changeset c8a7b8fa1b5f9a6d3052db792018dc27c5a3a794 by Raymond Hettinger in branch 'master': bpo-42781: Document the mechanics of cached_property from a user viewpoint (GH-24031)

[issue42781] functools.cached_property docs should explain that it is non-overriding

Change by Raymond Hettinger : -- keywords: +patch nosy: +rhettinger nosy_count: 2.0 -> 3.0 pull_requests: +22872 stage: -> patch review pull_request: https://github.com/python/cpython/pull/24031 ___ Python tracker

[issue42781] functools.cached_property docs should explain that it is non-overriding

Change by Raymond Hettinger : -- nosy: -rhettinger ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue42781] functools.cached_property docs should explain that it is non-overriding

Luciano Ramalho added the comment: > FYI, the usual term is "data descriptor" instead of "overriding descriptor". Yes, the Python docs are consistent in always using "data descriptor", but I've adopted "overriding descriptor" from Martelli's Python in a Nutshell--in Fluent Python I also put

[issue42781] functools.cached_property docs should explain that it is non-overriding

Raymond Hettinger added the comment: FYI, the usual term is "data descriptor" instead of "overriding descriptor". Normally the docs for things like property() and cached_property() don't mention the term descriptor at all. From the user point of view, that is an implementation detail.

[issue42781] functools.cached_property docs should explain that it is non-overriding

New submission from Luciano Ramalho : functools.cached_property is a great addition to the standard library, thanks! However, the docs do not say that @cached_property produces a non-overriding descriptor, in contrast with @property. If a user replaces a @property with a @cached_property,