Message 302404 - Python tracker

➜

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

In-reply-to
Author	codypiersall
Recipients	codypiersall
Date	2017年09月18日.02:20:35
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1505701236.05.0.735759478714.issue31503@psf.upfronthosting.co.za>

Content
If a some_module defines __all__, dir(some_module) should only return what is in __all__. This is already a mechanism that Python provides to specify module-level APIs. Currently, dir(some_module) returns some_module.__dict__.keys(). The concern with this enhancement is backwards compatibility. It is conceivable that some library's code would be broken with the different return value of dir(some_module). However, it seems unlikely that any code, other than tests, depends on the current behavior of dir(some_module). If __all__ is not defined in some_module, the old behavior is preserved.

Content

If a some_module defines __all__, dir(some_module) should only return what is in __all__. This is already a mechanism that Python provides to specify module-level APIs. Currently, dir(some_module) returns some_module.__dict__.keys().
The concern with this enhancement is backwards compatibility. It is conceivable that some library's code would be broken with the different return value of dir(some_module). However, it seems unlikely that any code, other than tests, depends on the current behavior of dir(some_module).
If __all__ is not defined in some_module, the old behavior is preserved.

History
Date	User	Action	Args
2017年09月18日 02:20:36	codypiersall	set	recipients: + codypiersall
2017年09月18日 02:20:36	codypiersall	set	messageid: <1505701236.05.0.735759478714.issue31503@psf.upfronthosting.co.za>
2017年09月18日 02:20:36	codypiersall	link	issue31503 messages
2017年09月18日 02:20:35	codypiersall	create

homepage