summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorRaymond Hettinger <rhettinger@users.noreply.github.com>2024-09-13 22:02:37 (GMT)
committerGitHub <noreply@github.com>2024-09-13 22:02:37 (GMT)
commitcd06f5e32369c7816c7360cbb20fbe9f38b4f3a7 (patch)
tree94a94ac2fa18dc20b52f2b060cfc83e8a00ee47b /Doc
parentb1d6f8a2ee04215c64aa8752cc515b7e98a08d28 (diff)
downloadcpython-cd06f5e32369c7816c7360cbb20fbe9f38b4f3a7.zip
cpython-cd06f5e32369c7816c7360cbb20fbe9f38b4f3a7.tar.gz
cpython-cd06f5e32369c7816c7360cbb20fbe9f38b4f3a7.tar.bz2
Minor edits to the descriptor guide (GH-123928)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/howto/descriptor.rst10
1 files changed, 6 insertions, 4 deletions
diff --git a/Doc/howto/descriptor.rst b/Doc/howto/descriptor.rst
index 5dd1836..d110164 100644
--- a/Doc/howto/descriptor.rst
+++ b/Doc/howto/descriptor.rst
@@ -389,7 +389,9 @@ Here are three practical data validation utilities:
def validate(self, value):
if value not in self.options:
- raise ValueError(f'Expected {value!r} to be one of {self.options!r}')
+ raise ValueError(
+ f'Expected {value!r} to be one of {self.options!r}'
+ )
class Number(Validator):
@@ -469,6 +471,7 @@ The descriptors prevent invalid instances from being created:
Traceback (most recent call last):
...
ValueError: Expected -5 to be at least 0
+
>>> Component('WIDGET', 'metal', 'V') # Blocked: 'V' isn't a number
Traceback (most recent call last):
...
@@ -1004,7 +1007,6 @@ here is a pure Python equivalent that implements most of the core functionality:
if doc is None and fget is not None:
doc = fget.__doc__
self.__doc__ = doc
- self.__name__ = ''
def __set_name__(self, owner, name):
self.__name__ = name
@@ -1303,8 +1305,8 @@ mean, median, and other descriptive statistics that depend on the data. However,
there may be useful functions which are conceptually related but do not depend
on the data. For instance, ``erf(x)`` is handy conversion routine that comes up
in statistical work but does not directly depend on a particular dataset.
-It can be called either from an object or the class: ``s.erf(1.5) --> .9332`` or
-``Sample.erf(1.5) --> .9332``.
+It can be called either from an object or the class: ``s.erf(1.5) --> 0.9332``
+or ``Sample.erf(1.5) --> 0.9332``.
Since static methods return the underlying function with no changes, the
example calls are unexciting: