21、包
包的使用
-
导入包与init.py
-
绝对导入与相对导入
-
from包import*
一、包的介绍
随着模块数目的增多,把所有模块不加区分地放到一起也是极不合理的,于是python为我们提供了一种把模块组织到一起的方法,即创建一个包。包就是一个含有init.py文件的文件夹,文件夹内可以组织子模块或子包,例如
pool/
|——__init__.py
|——futures
| |——__init__.py
| |——process.py
| |——thread.py
└── versions.py
# 1. 在python3中,即使包下没有__init__.py文件,import 包仍然不会报错,而在python2中,包下一定要有该文件,否则import 包报错
# 2. 创建包的目的不是为了运行,而是被导入使用,记住,包只是模块的一种形式而已,包的本质就是一种模块
接下来我们就以包pool为例来介绍包的使用,包内各文件内容如下
# process.py
class ProcessPoolExecutor:
def __init__(self, max_workers):
self.max_workers = max_workers
def submt(self):
print('ProcessPool submit')
# thread.py
class ThreadPoolExcutor:
def __init__(self, max_workers):
self.max_workers = max_workers
# versions.py
def check():
print('check versions')
# __init__.py文件内容均为空
二、包的使用
1.导入包与init.py
包属于模块的一种,因而包以及包内的模块均是用来被导入使用的,而绝非被直接执行,首次导入包(如import pool)同样会做三件事:
1.执行包下的init.py文件
2.产生一个新的名称空间用于存放init.py执行过程中产生的名字
3.在当前执行文件所在的名称空间中得到一个名字pool,该名子指向init.py的名称空间,例如pool.xxx和poo.yyy中的xxx和yyy都是来自于pool下的init.py,也就是说导入包时并不会导入包下所有的子模块与子包
import pool
pool.versions.check() # 抛出异常AttributeError
pool.futures.process.ProcessExecutor(3) # 抛出异常AttributeError
pool.versions.check()要求pool下有名字versions,进而pool.versions下有名字check。pool.versions下已经有名字check了,所以问题出现在pool下没有名字versions,这就需要在pool下的init.py中导入模块versions
强调
1.关于包相关的导入语句也分为import和from...import...两种,但是无论哪种,无论在什么位置,在导入时都必须遵循一个原则:凡是在导入时带点的,点的左边都必须是一个包,否则非法。可以带有一连串的点,如import 顶级包.子包.子模块,但都必须遵循这个原则。但对于导入后,在使用时就没有这种限制了,点的左边可以是包,模块,函数,类
2.绝对导入与相对导入
针对包内的模块之间互相导入,导入的方式有两种
1.绝对导入:以顶级包为起始
# pool下的__init__.py
from pool import versions
2.相对导入:代表当前文件所在的目录,..代表当前目录的上一级目录,依次类推
# pool 下的__init__.py
from . import versions
同理,针对pool.futures.process.ProcessPoolExecutor(3),则需要
#操作pool下的__init__.py,保证pool.futures
from . import futures #或from pool import futures
#操作futrues下的__init__.py,保证pool.futures.process
from . import process #或from pool.futures import process
相对导入只能用from module import symbol的形式,import ..versions语法是不对的,且symbol只能是一个明确的名字
from pool import futures.process # 语法错误
from pool.futures import process # 语法正确
针对包内部模块之间的相互导入推荐使用相对导入,需要特别强调:
1、相对导入只能在包内部使用,用相对导入不同目录下的模块是非法的
2、无论是import还是from-import,但凡是在导入时带点的,点的左边必须是包,否则语法错误
3.总结包的使用
总结包的使用需要牢记三点 1、导包就是在导包下init.py文件 2、包内部的导入应该使用相对导入,相对导入也只能在包内部使用,而且...取上一级不能出包 3、 使用语句中的点代表的是访问属性 m.n.x ----> 向m要n,向n要x 而导入语句中的点代表的是路径分隔符 import a.b.c --> a/b/c,文件夹下a下有子文件夹b,文件夹b下有子文件或文件夹c 所以导入语句中点的左边必须是一个包
4.from包和import *
在使用包时同样支持from pool.futures import * ,毫无疑问代表的是futures下init.py中所有的名字,通用是用变量all来控制代表的意思
#futures下的__init__.py
__all__ = ['process', 'thread']
最后说明一点,包内部的目录结构通常是包的开发者为了方便自己管理和维护代码而创建的,这种目录结构对包的使用者往往是无用的,此时通过操作init.py可以“隐藏”包内部的目录结构,降低使用难度,比如想要让使用者直接使用
pool下的init.py中导入子模块或子包
from .versions import check
from .futures.process import ProcessPoolExecutor
from .futures.thread import ThreadPoolExecutor
程序运行
import pool
pool.check()
pool.ProcessPoolExecutor(3)
pool.ThreadPoolExecutor(3)