[docs] [issue27505] Missing documentation for setting module __class__ attribute

Nick Coghlan report at bugs.python.org
Tue Jul 12 21:32:02 EDT 2016


New submission from Nick Coghlan:

Python 3.5 added the ability to set module __class__ attributes by way of http://bugs.python.org/issue22986

However, this isn't covered in the What's New guide or anywhere else in the documentation, and even in the NEWS file it appears under the cryptic title "Issue #22986: Allow changing an object’s __class__ between a dynamic type and static type in some cases." for 3.5.0a1

This should be documented somewhere (perhaps in the data model section of the language reference?) and an example given of using the feature to emit DeprecationWarning for access to a particular module level attribute.

It should also be mentioned in the Python 3.5 What's New documentation.

----------
assignee: docs at python
components: Documentation
messages: 270285
nosy: docs at python, ncoghlan, njs
priority: normal
severity: normal
stage: needs patch
status: open
title: Missing documentation for setting module __class__ attribute
type: enhancement
versions: Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27505>
_______________________________________


More information about the docs mailing list