Python - __all__ 变量

import *

• 当我们向文件导入某个模块时，导入的是该模块中那些名称不以下划线(单下划线 _ 或者双下划线 __ )开头的变量、函数和类
• 因此，如果不想模块文件中的某个对象被引入到其它文件中使用，可以在其名称前添加下划线
• 下面就来讲下 import * 的栗子

demo.py

def say():
    print("人生苦短，我学Python！")

def disPython():
    print("小菠萝教程：https://www.cnblogs.com/poloyy/")

test.py

from demo import *

say()
disPython()

执行结果

人生苦短，我学Python！
小菠萝教程：https://www.cnblogs.com/poloyy/

如果对象不想被引入呢

如果 demo.py 模块中的 disPython() 函数不想让其它文件引入，则只需将其名称改为 _disPython() 或者 __disPython() 

再次执行 test.py，输出结果

人生苦短，我学Python！
Traceback (most recent call last):
  File "C:/Users/polo/Desktop/2.py", line 4, in <module>
    disPython()
NameError: name 'disPython' is not defined

test.py 文件中无法使用未引入的 disPython() 函数

Python 模块 __all__ 变量

• 模块提供的 __all__ 变量，该变量的值是一个列表，存储的是当前模块中一些对象成员(变量、函数或者类)的名称(字符串格式)
• 通过在模块文件中设置 __all__ 变量，当其它文件以 from 模块名 import * 的形式导入该模块时，该文件中只能使用 __all__ 列表中指定的对象成员，未指定的成员是无法导入的

demo.py

def say():
    print("人生苦短，我学Python！")

def disPython():
    print("小菠萝教程：https://www.cnblogs.com/poloyy/") 

__all__ = ["say"]

__all__ 变量只包含 say()的函数名，不包含 disPython() 函数的名称

test.py

from demo import *

say()
disPython()

运行 test.py

人生苦短，我学Python！
Traceback (most recent call last):
  File "C:/Users/mengma/Desktop/2.py", line 4, in <module>
    disPython()
NameError: name 'disPython' is not defined

• 对于 test.py 来说，demo.py 模块中的 disPython() 函数是未引入，这样调用是非法的
• 重点：__all__ 变量仅限于在其它文件中以 from 模块名 import * 的方式引入

使用以下 2 种方式引入模块，__all__ 变量是无效的

方式一

 import 模块名 的形式导入模块，通过该方式导入模块后，总可以通过模块名前缀(如果为模块指定了别名，则可以使用模快的别名作为前缀)来调用模块内的所有成员(除了以下划线开头命名的成员)

demo.py 

def say():
    print("人生苦短，我学Python！")

def disPython():
    print("小菠萝教程：https://www.cnblogs.com/poloyy/") 

__all__ = ["say"]

test.py

import demo

demo.say()
demo.disPython()

运行 test.py

人生苦短，我学Python！
小菠萝教程：https://www.cnblogs.com/poloyy/

虽然 demo.py 模块中设置有  __all__ 变量，但是当以 import demo 的方式引入后，__all__ 变量将不起作用

方式二

 from 模块名 import 对象成员 的形式直接导入指定成员，使用此方式导入的模块，__all__ 变量即便设置，也不起作用

demo.py 

仍然是上面的 demo 代码

test.py

from demo import say
from demo import disPython

say()
disPython()

运行 test.py

人生苦短，我学Python！
小菠萝教程：https://www.cnblogs.com/poloyy/