THGP- Python 中的模块和库
本文介绍了 《Python 高手之路中》与 Python 的模块和库相关的知识
模块
- sys.path 告诉 Python 从哪里导入标准库
- 导入机制是可以自定义的,参见 PEP 302
库
- 标准库都有哪些内容需要完整地阅读一遍
- 如果项目依赖外部库,确保外部库与项目的耦合度低,最好写一个包装层,使得项目的其它地方看不到外部库,只能看到包装层, 这样外部库变化时,只需要修改包装层。
- 选择外部库的原则:
- Python 3 兼容
- 开发活跃
- 维护活跃
- 是否与流行的 linux 发行版一起打包
- API 兼容保证
API变化
修改 API 后,要在文档中记录: * 新的接口 * 废除的旧接口 * 如何升级到新接口
管理 API 变化的一些有用工具:
* Sphinx 的 deprecated
标记
* 使用 warnings.warn 在旧接口中发出警告,并使用 -W all
在执行时给出警告 或者 -W error
将警告变为错误