From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 20 Aug 2023 10:39:43 +0000 (-0700) Subject: [3.11] gh-107619: Extend functools LRU cache docs with generators and async functions... X-Git-Tag: v3.11.5~41 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4c042a36ce26d6920abdc7e5a54f80d288b9cc80;p=thirdparty%2FPython%2Fcpython.git [3.11] gh-107619: Extend functools LRU cache docs with generators and async functions (GH-107934) (#108162) 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 62fcddec0904..9dadbb69fc2f 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -211,8 +211,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::