Author martin.panter
Recipients Unit03, lukasz.langa, martin.panter
Date 2016-05-26.09:53:09
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1464256389.63.0.896750902606.issue27106@psf.upfronthosting.co.za>
In-reply-to
Content
My personal opinion is to include all public APIs. Names that are omitted from __all__ may not come up in pydoc, and it is surprising when I use “import * ” in the interactive interpreter to play with a module and there is something missing.

To mitigate the risk of breaking code, I have been maintaining a list of the modules affected at <https://docs.python.org/3.6/whatsnew/3.6.html#changes-in-the-python-api>, which warns that extra symbols will be imported in 3.6.

On the other hand, there are other cases where people wanted to exclude APIs from __all__; I pointed out two at <https://bugs.python.org/issue26632#msg266117>.
History
Date User Action Args
2016-05-26 09:53:09martin.pantersetrecipients: + martin.panter, lukasz.langa, Unit03
2016-05-26 09:53:09martin.pantersetmessageid: <1464256389.63.0.896750902606.issue27106@psf.upfronthosting.co.za>
2016-05-26 09:53:09martin.panterlinkissue27106 messages
2016-05-26 09:53:09martin.pantercreate