[Python-checkins] Minor improvements to the functools docs (#103672)

rhettinger webhook-mailer at python.org
Fri Apr 21 21:53:57 EDT 2023


https://github.com/python/cpython/commit/7d20783d45a9c78379fe79229b57e4c31610a623
commit: 7d20783d45a9c78379fe79229b57e4c31610a623
branch: main
author: Raymond Hettinger <rhettinger at users.noreply.github.com>
committer: rhettinger <rhettinger at users.noreply.github.com>
date: 2023-04-21T20:53:50-05:00
summary:

Minor improvements to the functools docs (#103672)

* Use an f-string for improved readability

* Put version notes in chronological order

files:
M Doc/library/functools.rst

diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
index d467e50bc7a4..d1289ce83621 100644
--- a/Doc/library/functools.rst
+++ b/Doc/library/functools.rst
@@ -118,6 +118,7 @@ The :mod:`functools` module defines the following functions:
            def stdev(self):
                return statistics.stdev(self._data)
 
+   .. versionadded:: 3.8
 
    .. versionchanged:: 3.12
       Prior to Python 3.12, ``cached_property`` included an undocumented lock to
@@ -126,8 +127,6 @@ The :mod:`functools` module defines the following functions:
       per-instance, which could result in unacceptably high lock contention. In
       Python 3.12+ this locking is removed.
 
-   .. versionadded:: 3.8
-
 
 .. function:: cmp_to_key(func)
 
@@ -233,7 +232,7 @@ The :mod:`functools` module defines the following functions:
         @lru_cache(maxsize=32)
         def get_pep(num):
             'Retrieve text of a Python Enhancement Proposal'
-            resource = 'https://peps.python.org/pep-%04d/' % num
+            resource = f'https://peps.python.org/pep-{num:04d}'
             try:
                 with urllib.request.urlopen(resource) as s:
                     return s.read()



More information about the Python-checkins mailing list