python3之工程中必须依赖的__init__.py 1.  __init__.py 2.  Python3.3+的__init__.py 3. Python3中的PYTHONPATH 4. 若要通过setup.py打包工程时,需要依赖__init__.py

1.1  什么是__init__.py

  在Python3工程里,当python3检测到一个目录下存在__init__.py文件时,Python3就会把它当成一个模块(module)。__init__.py可以是一个空文件,也可以有内容。

1.2  为什么需要__init__.py

  使用Python3模块常见的情况是,在使用A.py时,需要import B.py,需要先拷贝到当前目录,然后再import,这样的做法在程序量较小的情况下是可行的,如果程序交互复杂程度稍高,就会复杂费力。有一种解决方法可以将多个.py文件组织起来,方便在外部统一调用以及在内部互相调用。

Python3中的__init__.py在包调用中起到了重要的作用。首先要明确Python3在执行import包的时候,执行的操作,按照Python3的文档描述,操作如下:

  1. 创建一个新的module对象(它可能包含多个module);
  2. 把这个module对象插入sys.module中;
  3. 装载module的代码(首先需要找到module程序所在的位置,其原理为:如果需要导入的module的名字是m1,则解释器必须找到m1.py,它首先在当前目录查找,然后是在环境变量PYTHONPATH中查找)
  4. 执行新的module中对应的代码。

一个简单的package示例如图所示。

其中__init__.py为空,解释器对其视作一个package处理。

第一层:pack1, pack2, main.py

第二层:pack1: __init__.py,module_A.py

       pack2:__init__.py,module_B.py

python3之工程中必须依赖的__init__.py
1.  __init__.py
2.  Python3.3+的__init__.py
3. Python3中的PYTHONPATH
4. 若要通过setup.py打包工程时,需要依赖__init__.py

  当main.py调用脚本from pack1 import Module_A,由于from操作,会默认目录下存在pack1包,解释器会首先寻找__init__.py。也就是说,package内module的import是受__init__.py限制的。

2.  Python3.3+的__init__.py

  Python 3.3+版本以后,Python3具有隐式命名空间包,允许它创建不带__init__.py文件的包,允许隐式名称空间包意味着可以完全放弃提供__init__.py文件的要求,并使其不受到影响。所以这就是在Python3.3以后的版本中,有时候工程中忘记加入了__init__.py文件而工程仍然能够正常运行的原因。

3. Python3中的PYTHONPATH

  PYTHONPATH是Python3中一个重要的环境变量,用于在导入模块的时候搜索路径。因为PYTHONPATH是Python3的搜索路径,所以默认我们import的模块都会从PYTHONPATH里面进行寻找。如果我们使用PYTHONPATH中的modules,那么在运行python3前,就要把path加到os.environ['PYTHONPATH'],如果在运行python3后再加,那些模块不能直接被导入。

python3之工程中必须依赖的__init__.py
1.  __init__.py
2.  Python3.3+的__init__.py
3. Python3中的PYTHONPATH
4. 若要通过setup.py打包工程时,需要依赖__init__.py

 python3之工程中必须依赖的__init__.py
1.  __init__.py
2.  Python3.3+的__init__.py
3. Python3中的PYTHONPATH
4. 若要通过setup.py打包工程时,需要依赖__init__.py

  可以看到,路径列表的第一个元素为相对路径下的当前目录。由于在导入模块的时候,解释器会按照列表的顺序搜索,直到找到第一个模块,所以优先导入的模块为同一目录下的模块。导入模块时搜索路径的顺序也可以改变,分两种情况:

  1. 通过sys.path.append(),sys.path.insert()等方法来改变,这种方法当重新启动解释器的时候,原来的设置会失效。
  2. 改变PYTHONPATH,这种设置方法永久有效。在这种情况下,可以通过在sys.path列表显示的路径中添加.pth文件来实现。

4. 若要通过setup.py打包工程时,需要依赖__init__.py

  在Python3的PYTHONPATH中,包含Python3安装目录相关的一组路径(内置模块和标准库,以及其它第三方模块的共享路径),但是它不支持项目所在根目录这种形式,而是只支持文件所在目录的相对路径。以1.2小节中的示例,项目的根路径为D:pytest_init,其中包含pack1(Module_A)和pack2(Module_B)包。项目根路径D:pytest_init是需要放在PYTHONPATH中的,这样python解释器才可以通过包名互相访问。

  而setup.py所做的主要事情:将整个项目添加到PYTHONPATH中,setup.py中所记录的就是项目模块添加到PYTHONPATH的规则。setup.py中会定义此项目中有哪些模块需要被加入到PYTHONPATH,在这个过程中可以把测试项目过滤掉,而对项目中的模块进行打包时,setup.py会默认该模块包含并优先加载其中的__init__.py文件,因此在所要加入的每个模块中,都必须要有__init__.py文件的存在以保证所有需要导入的包都能够正确被找到并被导入。即,在使用setup.py打包的项目中,__init__.py必须包含在每个模块包的目录中,以便自动找到软件包,这样打包的软件包仅在包含__init__.py文件的情况下才能被识别。setup.py中还会定义需要的第三方依赖包,使用安装命令可以同时安装这些第三方依赖包等等。