gh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs #124480
Conversation
…es" section of the data model docs
AlexWaygood
added
needs backport to 3.12
AlexWaygood
requested review from
willingc,
ethanfurman,
JelleZijlstra,
rhettinger,
a team and
vsajip
as code owners
There was a problem hiding this comment.
Looks good @AlexWaygood. Thanks for doing this table.
As an FYI, it's much faster to review when the nitpick fixes are a separate PR. Makes it a little easier to grok what the new addition contains. No worries for this PR.
Thanks -- I'll separate it out into two PRs next time! |
|
Thanks @AlexWaygood for the PR 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13. |
|
Sorry, @AlexWaygood, I could not cleanly backport this to |
|
Sorry, @AlexWaygood, I could not cleanly backport this to |
…m classes" section of the data model docs (python#124480)
|
GH-124556 is a backport of this pull request to the 3.13 branch. |
…m classes" section of the data model docs (python#124480)
|
GH-124558 is a backport of this pull request to the 3.12 branch. |
* main: (69 commits) Add "annotate" SET_FUNCTION_ATTRIBUTE bit to dis. (python#124566) pythongh-124412: Add helpers for converting annotations to source format (python#124551) pythongh-119180: Disallow instantiation of ConstEvaluator objects (python#124561) For-else deserves its own section in the tutorial (python#123946) Add 3.13 as a version option to the crash issue template (python#124560) pythongh-123242: Note that type.__annotations__ may not exist (python#124557) pythongh-119180: Make FORWARDREF format look at __annotations__ first (python#124479) pythonGH-58058: Add quick reference for `ArgumentParser` to argparse docs (pythongh-124227) pythongh-41431: Add `datetime.time.strptime()` and `datetime.date.strptime()` (python#120752) pythongh-102450: Add ISO-8601 alternative for midnight to `fromisoformat()` calls. (python#105856) pythongh-124370: Add "howto" for free-threaded Python (python#124371) pythongh-121277: Allow `.. versionadded:: next` in docs (pythonGH-121278) pythongh-119400: make_ssl_certs: update reference test data automatically, pass in expiration dates as parameters python#119400 (pythonGH-119401) pythongh-119180: Avoid going through AST and eval() when possible in annotationlib (python#124337) pythongh-124448: Update Windows builds to use Tcl/Tk 8.6.15 (pythonGH-124449) pythongh-123884 Tee of tee was not producing n independent iterators (pythongh-124490) pythongh-124378: Update test_ttk for Tcl/Tk 8.6.15 (pythonGH-124542) pythongh-124513: Check args in framelocalsproxy_new() (python#124515) pythongh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs (python#124480) Doc: Use ``major.minor`` for documentation distribution archive filenames (python#124489) ...
| .. doctest:: | ||
|
|
||
| >>> int.__subclasses__() | ||
| [<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, <class 're._constants._NamedIntConstant'>, <class 're._ZeroSentinel'>] |
There was a problem hiding this comment.
This failed spuriously on https://github.com/python/cpython/actions/runs/11043320393/job/30677452220?pr=124569. I suspect it depends on whether GC has run and collected the MyIntEnum class. Example:
>>> print(int.__subclasses__())
[<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, <class 're._constants._NamedIntConstant'>, <class 're._ZeroSentinel'>]
>>> import enum
>>> def f():
... class MyIntEnum(int, enum.Enum): pass
...
>>> f()
>>> print(int.__subclasses__())
[<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, <class 're._constants._NamedIntConstant'>, <class 're._ZeroSentinel'>, <enum 'MyIntEnum'>]
>>> import gc
>>> gc.collect()
31
>>> print(int.__subclasses__())
[<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, <class 're._constants._NamedIntConstant'>, <class 're._ZeroSentinel'>]
>>>
I'll send a PR to change this.
There was a problem hiding this comment.
Oh, interesting! Thanks!
type.__*__rather thanclass.__*__; this reflects the reality at runtime__qualname__), and move some references fromlibrary/stdtypes.rstto the datamodel docs so that references for all class attributes can be found in a single location📚 Documentation preview 📚: https://cpython-previews--124480.org.readthedocs.build/