From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 18 Oct 2019 07:21:05 +0000 (-0700)
Subject: Doc: Add missing entry for functools.cached_property (GH-16803)
X-Git-Tag: v3.8.1rc1~153
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=380d443a6ac73cb4719d86fd5781544630bcec5e;p=thirdparty%2FPython%2Fcpython.git

Doc: Add missing entry for functools.cached_property (GH-16803)

(cherry picked from commit 93b81e1fcbeb61c1b49ac2fa52c5a0dff929940b)

Co-authored-by: Stéphane Wirtel <stephane@wirtel.be>
---

diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index e1388e2169f4..ef4209f9db49 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -685,6 +685,22 @@ than as a function returning a decorator.  So both of these are now supported::
 
 (Contributed by Raymond Hettinger in :issue:`36772`.)
 
+Added a new :func:`functools.cached_property` decorator, for computed properties
+cached for the life of the instance. ::
+
+   import functools
+   import statistics
+
+   class Dataset:
+      def __init__(self, sequence_of_numbers):
+         self.data = sequence_of_numbers
+
+      @functools.cached_property
+      def variance(self):
+         return statistics.variance(self.data)
+
+(Contributed by Carl Meyer in :issue:`21145`)
+
 
 gc
 --