From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 20 Aug 2023 13:49:32 +0000 (-0700) Subject: [3.12] gh-107619: Extend functools LRU cache docs with generators and async functions... X-Git-Tag: v3.12.0rc2~117 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fbe1cff015f0ae792005b443fe9fb4a5137ccc77;p=thirdparty%2FPython%2Fcpython.git [3.12] gh-107619: Extend functools LRU cache docs with generators and async functions (GH-107934) (#108161) gh-107619: Extend functools LRU cache docs with generators and async functions (GH-107934) (cherry picked from commit 1a713eac47b26899044752f02cbfcb4d628dda2a) Co-authored-by: Hadházy Tamás <85063808+Hels15@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Kumar Aditya --- diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst index 40f43f8b3519..f736eb0aca1a 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -226,8 +226,9 @@ The :mod:`functools` module defines the following functions: In general, the LRU cache should only be used when you want to reuse previously computed values. Accordingly, it doesn't make sense to cache - functions with side-effects, functions that need to create distinct mutable - objects on each call, or impure functions such as time() or random(). + functions with side-effects, functions that need to create + distinct mutable objects on each call (such as generators and async functions), + or impure functions such as time() or random(). Example of an LRU cache for static web content::