[Python-Dev] Re: What is a public API?

2019-07-13 Thread Raymond Hettinger
> On Jul 13, 2019, at 1:56 PM, Serhiy Storchaka wrote: > > Could we strictly define what is considered a public module interface in > Python? The RealDefinition™ is that whatever we include in the docs is public, otherwise not. Beyond that, there is a question of how users can deduce what

[Python-Dev] Re: What is a public API?

2019-07-13 Thread Ivan Pozdeev via Python-Dev
On 13.07.2019 23:56, Serhiy Storchaka wrote: I thought that the name in a module is in the public interface if: * It doesn't start with an underscore and the module does not have __all__. * It is included in the module's __all__ list. * It is explicitly documented as a part of the public

[Python-Dev] What is a public API?

2019-07-13 Thread Serhiy Storchaka
I thought that the name in a module is in the public interface if: * It doesn't start with an underscore and the module does not have __all__. * It is included in the module's __all__ list. * It is explicitly documented as a part of the public interface. help() uses more complex rules, but it