mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-03 00:23:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

[3.12] gh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs (#124480) (#124558)

Browse source
This commit is contained in:
Alex Waygood 2024-09-25 16:01:19 -07:00 • committed by GitHub
parent ea5c650704
commit d2068c65a6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
39 changed files with 228 additions and 184 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Doc/tutorial/classes.rst
View file

@ -276,8 +276,8 @@ definition looked like this::
then ``MyClass.i`` and ``MyClass.f`` are valid attribute references, returning
an integer and a function object, respectively. Class attributes can also be
assigned to, so you can change the value of ``MyClass.i`` by assignment.
:attr:`!__doc__` is also a valid attribute, returning the docstring belonging to
the class: ``"A simple example class"``.
:attr:`~type.__doc__` is also a valid attribute, returning the docstring
belonging to the class: ``"A simple example class"``.
Class *instantiation* uses function notation. Just pretend that the class
object is a parameterless function that returns a new instance of the class.
@ -932,6 +932,6 @@ Examples::
.. [#] Except for one thing. Module objects have a secret read-only attribute called
:attr:`~object.__dict__` which returns the dictionary used to implement the module's
namespace; the name :attr:`~object.__dict__` is an attribute but not a global name.
namespace; the name ``__dict__`` is an attribute but not a global name.
Obviously, using this violates the abstraction of namespace implementation, and
should be restricted to things like post-mortem debuggers.