runpy ——查找并執(zhí)行 Python 模塊?

源代碼： Lib/runpy.py

runpy 模塊用于找到并運行 Python 的模塊，而無需首先導入。主要用于實現(xiàn) -m 命令行開關，以允許用 Python 模塊命名空間而不是文件系統(tǒng)來定位腳本。

請注意，這 并非 一個沙盒模塊——所有代碼都在當前進程中運行，所有副作用（如其他模塊對導入操作進行了緩存）在函數(shù)返回后都會留存。

此外，在 runpy 函數(shù)返回后，任何由已執(zhí)行代碼定義的函數(shù)和類都不能保證正確工作。如果某使用場景不能接收此限制，那么選用 importlib 可能更合適些。

runpy 模塊提供兩個函數(shù)：

runpy.run_module(mod_name, init_globals=None, run_name=None, alter_sys=False)?

執(zhí)行給定模塊的代碼，并返回結果模塊的 globals 字典。 該模塊的代碼首先會用標準的導入機制去查找定位 (詳情請參閱 PEP 302)，然后在全新的模塊命名空間中運行。

參數(shù) mod_name 應該是一個絕對模塊名。如果模塊名指向一個包，而不是普通的模塊，那么該包會被導入，然后執(zhí)行包中的 __main__ 子模塊，并返回結果模塊的 globals 字典。

可選的字典參數(shù) init_globals 可用來在代碼執(zhí)行前預填充模塊的 globals 字典。給出的字典參數(shù)不會被修改。如果字典中定義了以下任意一個特殊全局變量，這些定義都會被 run_module() 覆蓋。

The special global variables __name__, __spec__, __file__, __cached__, __loader__ and __package__ are set in the globals dictionary before the module code is executed (Note that this is a minimal set of variables - other variables may be set implicitly as an interpreter implementation detail).

若可選參數(shù) __name__ 不為 None 則設為 run_name，若此名稱的模塊是一個包則設為 mod_name + '.__main__'，否則設為 mod_name 參數(shù)。

__spec__ 將設為合適的 實際 導入模塊（也就是說，__spec__.name 一定是 mod_name 或 mod_name + '.__main__，而不是 run_name）。

__file__ 、__cached__、 __loader__ 和 __package__ 根據(jù)模塊規(guī)格進行 常規(guī)設置

如果給出了參數(shù) alter_sys 并且值為 True，那么 sys.argv[0] 將被更新為 __file__ 的值，sys.modules[__name__] 將被更新為臨時模塊對象。在函數(shù)返回前， sys.argv[0] 和 sys.modules[__name__] 將會復原。

注意，這種對 sys 的操作不是線程安全的。其他線程可能會看到初始化不完整的模塊，以及變動后的參數(shù)列表。如果從線程中的代碼調用此函數(shù)，建議單實例運行 sys 模塊。

參見

-m 選項由命令行提供相同功能。

在 3.1 版更改: 加入了 查找 __main__ 子模塊并執(zhí)行軟件包的能力。

在 3.2 版更改: 加入了 __cached__ 全局變量（參見 PEP 3147 ）。

在 3.4 版更改: 充分利用 PEP 451 加入的模塊規(guī)格功能。使得以這種方式運行的模塊能夠正確設置 __cached__，并確保真正的模塊名稱總是可以通過 __spec__.name 的形式訪問。

runpy.run_path(path_name, init_globals=None, run_name=None)?

執(zhí)行指定位置的代碼，并返回結果模塊的 globals 字典。與提供給 CPython 命令行的腳本名稱一樣，給出的路徑可以指向 Python 源文件、編譯過的字節(jié)碼文件或包含``__main__`` 模塊的有效 sys.path 項（例如一個包含頂級``__main__.py`` 文件的 zip 文件）。

對于直接的腳本而言，指定代碼將直接在一個新的模塊命名空間中運行。對于一個有效的 sys.path 項（通常是一個 zip 文件或目錄），其首先會被添加到 sys.path 的開頭。然后，本函數(shù)用更新后的路徑查找并執(zhí)行 __main__ 模塊。請注意，即便在指定位置不存在主模塊，也沒有特別的保護措施來防止調用存在于 sys.path 其他地方的 __main__。

利用可選的字典參數(shù) init_globals ，可在代碼執(zhí)行前預填模塊的 globals 字典。給出的字典參數(shù)不會被修改。如果給出的字典中定義了下列特殊全局變量，這些定義均會被 run_module() 覆蓋。

The special global variables __name__, __spec__, __file__, __cached__, __loader__ and __package__ are set in the globals dictionary before the module code is executed (Note that this is a minimal set of variables - other variables may be set implicitly as an interpreter implementation detail).

如果該可選參數(shù)不為 None，則 __name__ 被設為 run_name，否則為 '<run_path>'。

如果提供的路徑直接引用了一個腳本文件（無論是源碼文件還是預編譯的字節(jié)碼），那么 __file__ 將設為給出的路徑，而 __spec__、__cached__、__loader__ 和 __package__ 都將設為 None。

如果給出的路徑是對有效 sys.path 項的引用，那么 __spec__ 將為導入的 __main__ 模塊進行正確設置 (也就是說，__spec__.name 將一定是 __main__)。 __file__, __cached__, __loader__ 和 __package__ 將依據(jù)模塊規(guī)格 進行常規(guī)設置。

A number of alterations are also made to the sys module. Firstly, sys.path may be altered as described above. sys.argv[0] is updated with the value of path_name and sys.modules[__name__] is updated with a temporary module object for the module being executed. All modifications to items in sys are reverted before the function returns.

注意，與 run_module() 不同的是，本函數(shù)對 sys 的修改不是可有可無的，因為這些調整對于 sys.path 項能夠順利執(zhí)行至關重要。由于依然存在線程安全的限制，在線程代碼中使用本函數(shù)時應采用導入鎖進行序列運行，或者委托給一個單獨的進程。

參見

接口選項 用于在命令行上實現(xiàn)同等功能（python path/to/script）。

3.2 新版功能.

在 3.4 版更改: 已作更新，以便充分利用 PEP 451 加入的模塊規(guī)格功能。使得從有效 sys.path 項導入``__main__`` 而不是直接執(zhí)行的情況下，能夠正確設置 __cached__。