[Python-checkins] Add more tests. Fix code excerpt. (GH-25549) (GH-25550)
rhettinger
webhook-mailer at python.org
Thu Apr 22 23:27:12 EDT 2021
https://github.com/python/cpython/commit/8db72cd342917e68a42edcc41b25c58ac33ca928
commit: 8db72cd342917e68a42edcc41b25c58ac33ca928
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: rhettinger <rhettinger at users.noreply.github.com>
date: 2021-04-22T20:26:56-07:00
summary:
Add more tests. Fix code excerpt. (GH-25549) (GH-25550)
files:
M Doc/howto/descriptor.rst
diff --git a/Doc/howto/descriptor.rst b/Doc/howto/descriptor.rst
index eef6b2dfa00c2..9f0dd2f1f1550 100644
--- a/Doc/howto/descriptor.rst
+++ b/Doc/howto/descriptor.rst
@@ -953,6 +953,20 @@ The documentation shows a typical use to define a managed attribute ``x``:
def delx(self): del self.__x
x = property(getx, setx, delx, "I'm the 'x' property.")
+.. doctest::
+ :hide:
+
+ >>> C.x.__doc__
+ "I'm the 'x' property."
+ >>> c.x = 2.71828
+ >>> c.x
+ 2.71828
+ >>> del c.x
+ >>> c.x
+ Traceback (most recent call last):
+ ...
+ AttributeError: 'C' object has no attribute '_C__x'
+
To see how :func:`property` is implemented in terms of the descriptor protocol,
here is a pure Python equivalent:
@@ -1354,9 +1368,10 @@ Using the non-data descriptor protocol, a pure Python version of
"A doc for 'T'"
-The code path for ``hasattr(obj, '__get__')`` was added in Python 3.9 and
-makes it possible for :func:`classmethod` to support chained decorators.
-For example, a classmethod and property could be chained together:
+The code path for ``hasattr(type(self.f), '__get__')`` was added in
+Python 3.9 and makes it possible for :func:`classmethod` to support
+chained decorators. For example, a classmethod and property could be
+chained together:
.. testcode::
More information about the Python-checkins
mailing list