diff options
author | Raymond Hettinger <rhettinger@users.noreply.github.com> | 2024-09-13 22:02:37 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-09-13 22:02:37 (GMT) |
commit | cd06f5e32369c7816c7360cbb20fbe9f38b4f3a7 (patch) | |
tree | 94a94ac2fa18dc20b52f2b060cfc83e8a00ee47b /Doc | |
parent | b1d6f8a2ee04215c64aa8752cc515b7e98a08d28 (diff) | |
download | cpython-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.rst | 10 |
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: |