31.7. runpy — 定位并执行 Python 模块 — Python 文档
31.7. 流淌的 — 定位和执行 Python 模块
2.5 版中的新功能。
runpy 模块用于定位和运行 Python 模块，而无需先导入它们。 它的主要用途是实现 -m 命令行开关，允许使用 Python 模块命名空间而不是文件系统来定位脚本。
runpy 模块提供了两个功能：
- runpy.run_module(mod_name, init_globals=None, run_name=None, alter_sys=False)
执行指定模块的代码并返回结果模块全局字典。 模块的代码首先使用标准导入机制定位（有关详细信息，请参阅 PEP 302），然后在新的模块命名空间中执行。
如果提供的模块名称指的是一个包而不是普通模块，则该包被导入，然后执行该包中的
__main__子模块并返回生成的模块全局字典。可选的字典参数 init_globals 可用于在执行代码之前预填充模块的全局字典。 提供的字典不会被修改。 如果在提供的字典中定义了以下任何特殊全局变量，则这些定义将被 run_module() 覆盖。
特殊的全局变量
__name__、__file__、__loader__和__package__在模块代码执行之前在 globals 字典中设置（注意这是一个最小的变量集 - 其他变量可以隐式设置为解释器实现细节）。__name__设置为 run_name 如果此可选参数不是 None，如果命名模块是一个包和 设置为mod_name + '.__main__'否则 mod_name 参数。__file__设置为模块加载器提供的名称。 如果加载程序不提供文件名信息，则此变量设置为 None。__loader__设置为 PEP 302 模块加载器，用于检索模块的代码（此加载器可能是标准导入机制的包装器）。__package__设置为 mod_name 如果命名模块是一个包，否则设置为mod_name.rpartition('.')[0]。如果提供了参数 alter_sys 并且计算结果为 True，则
sys.argv[0]更新为__file__的值，sys.modules[__name__]为使用正在执行的模块的临时模块对象更新。 在函数返回之前，sys.argv[0]和sys.modules[__name__]都恢复到它们的原始值。请注意，对 sys 的这种操作不是线程安全的。 其他线程可能会看到部分初始化的模块，以及更改的参数列表。 从线程代码调用此函数时，建议将 sys 模块单独放置。
也可以看看
-m 选项从命令行提供等效功能。
2.7 版更改： 增加了通过查找
__main__子模块来执行包的能力
- runpy.run_path(file_path, init_globals=None, run_name=None)
在指定的文件系统位置执行代码并返回生成的模块全局字典。 与提供给 CPython 命令行的脚本名称一样，提供的路径可能指的是 Python 源文件、编译的字节码文件或包含
__main__模块的有效 sys.path 条目（例如 一个包含顶级__main__.py文件的 zip 文件）。对于一个简单的脚本，指定的代码只是在一个新的模块命名空间中执行。 对于有效的 sys.path 条目（通常是 zipfile 或目录），该条目首先添加到
sys.path的开头。 然后，该函数使用更新后的路径查找并执行 __main__ 模块。 请注意，如果在指定位置没有此类模块，则没有针对调用位于sys.path上其他位置的现有 __main__ 条目的特殊保护。可选的字典参数 init_globals 可用于在执行代码之前预填充模块的全局字典。 提供的字典不会被修改。 如果在提供的字典中定义了以下任何特殊全局变量，则这些定义将被 run_path() 覆盖。
特殊的全局变量
__name__、__file__、__loader__和__package__在模块代码执行之前在 globals 字典中设置（注意这是一个最小的变量集 - 其他变量可以隐式设置为解释器实现细节）。如果此可选参数不是 None，则
__name__设置为 run_name，否则设置为'<run_path>'。__file__设置为模块加载器提供的名称。 如果加载程序不提供文件名信息，则此变量设置为 None。 对于简单的脚本，这将设置为file_path。__loader__设置为 PEP 302 模块加载器，用于检索模块的代码（此加载器可能是标准导入机制的包装器）。 对于简单的脚本，这将设置为 None。__package__设置为__name__.rpartition('.')[0]。sys 模块也做了一些改动。 首先，可以如上所述改变
sys.path。sys.argv[0]更新为file_path的值，sys.modules[__name__]更新为正在执行的模块的临时模块对象。 在函数返回之前，对 sys 中项目的所有修改都将恢复。请注意，与 run_module() 不同，对 sys 所做的更改在此函数中不是可选的，因为这些调整对于允许执行 sys.path 条目至关重要。 由于线程安全限制仍然适用，在线程代码中使用此函数应该使用导入锁序列化或委托给单独的进程。
也可以看看
接口选项 用于命令行上的等效功能 (
python path/to/script)。2.7 版中的新功能。
