From f33444f2476b4362171d93074db611934b396448 Mon Sep 17 00:00:00 2001 From: Jelle Zijlstra Date: Wed, 25 Sep 2024 15:20:39 -0700 Subject: [PATCH] gh-123242: Note that type.__annotations__ may not exist Closes #123242. The real criterion is that the attribute does not exist on heap types, but I don't think we should discuss heap vs. static types in the language reference. --- Doc/reference/datamodel.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index 7a93a9f770b474..a6348eda3891cc 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -1045,7 +1045,8 @@ Special attributes Accessing the :attr:`!__annotations__` attribute of a class object directly may yield incorrect results in the presence of - metaclasses. Use :func:`annotationlib.get_annotations` to + metaclasses. In addition, the attribute may not exist for + some classes. Use :func:`annotationlib.get_annotations` to retrieve class annotations safely. .. versionchanged:: 3.14