Python闭包是否是`__all__`的一个很好的替代品？

Question

使用闭包而不是__all__限制Python模块公开的名称是一个好主意吗？这将阻止程序员意外地使用错误的名称(import urllib; urllib.os.getlogin())模块()以及避免" from x import *"命名空间污染__all__.

def _init_module():
   global foo
   import bar
   def foo():
       return bar.baz.operation()
   class Quux(bar.baz.Splort): pass
_init_module(); del _init_module

使用相同的模块__all__:

__all__ = ['foo']
import bar
def foo():
    return bar.baz.operation()
class Quux(bar.baz.Splort): pass

函数可以采用这种方式来避免污染模块名称空间:

def foo():
    import bar
    bar.baz.operation()

这对于希望帮助用户在交互式内省期间将其API与包和其他模块的API的使用区分开来的大型包可能会有所帮助.另一方面,也许IPython应该__all__在标签完成期间简单地区分名称,并且更多用户应该使用允许它们在文件之间跳转以查看每个名称的定义的IDE.

Answer 1

我是编写代码的粉丝,它完全像脑子一样简单.

__all__是Python的一个特性,明确添加以解决限制模块可见的名称的问题.当您使用它时,人们立即了解您正在使用它做什么.

你的关闭技巧是非标准的,如果我遇到它,我不会立即理解它.你需要做一个很长的评论来解释它,然后你需要加入另一个长评论来解释为什么你这样做而不是使用__all__.

编辑:既然我对这个问题了解得更好,这里有一个替代答案.

在Python中,将私有名称作为模块中的下划线加前缀是一种很好的做法.如果这样做,from the_module_name import *您将获得所有不以下划线开头的名称.因此,我更愿意看到正确使用初始下划线成语,而不是封闭技巧.

请注意,如果使用初始下划线名称,则甚至不需要使用__all__.