如何学习使用第三方模块

得益于python强大的开源社区,我们在使用python开发项目时,可以几乎可以做到全程拿来主义。需要什么,就百度好了,总会有人已经实现了你需要的功能模块,你所需要做的仅仅是使用pip命令安装他们。

虽然你不必重复造轮子,但理解掌握别人已经早好的轮子有时候也并非易事。本文介绍3种学习第三方库的方法

  1. 搜索第三方库文档
  2. 阅读源码例子, 测试脚本
  3. 编译第三方模块说明文档

1. 搜索第三方库文档

这是最快速,最有效的学习第三方库的方法,别无其他,假设你想学习requests这个http库,那么最好的办法是用百度搜索这个库的文档,关键词: python reqeusts。百度会给你提供大量的教程连接
百度搜索requests
运气好,可以直接找到第三方库的官方网址,或者找到国内已经翻译好的教程。选择一份你喜欢的,讲解详细,示例多的教程,慢慢学习吧!

2. 阅读源码例子, 测试脚本

有些第三方库的作者并没有提供官方的文档,或者还没有人将英文的文档翻译成中文,或者文档讲解不细致,总之,使用搜索引擎找不到合适的文档,那么这个时候,你就要考虑从源码里寻找可用的资源,例如源码中的代码示例或者测试脚本。

事实上存在这样的情况,作者认为自己所开发的库或者模块比较简单,无需提供详细的使用文档,但他会在源码里写一些示例代码,还有些作者自己会写测试脚本以验证自己的代码是健壮的,通过示例代码和测试脚本,你仍然可以快速学习第三方库的使用方法。

很多作者都会把开源项目放在github上,因此想要找源码,github最合适不过,以web框架bottle为例,在git仓库里有一个test文件夹,这里就保留了大量作者用以测试框架的代码,你完全可以通过阅读这些测试代码来学习该框架

以excel操作库xlrd为例,源码里不仅有tests文件夹,还有一个examples文件夹,提供了示例代码。

3.编译项目使用说明文档

有些作者会在源码里提供项目使用说明文档,以xlwt为例,项目文档存放在docs中,将源码下载到本地,并进入到docs目录中,你会看到很多以.rst结尾的文件,rst于Python类似Javadoc与Java,我们可以将其转为html后用浏览器打开。

在转换之前,你需要先安装sphinx

pip3 install sphinx

编译说明文档有两种方式
方式1, 进入到源码,执行命令

sudo sphinx-build -b html docs build

docs就是保存rst文件的文件夹,上面的命令会生成一个build文件,在这个文件夹里有一个index.html文件,用浏览器打开这个文件,就可以看到帮助说明文档
编译python第三方库说明文档

方式2, 进入docs文件夹,执行命令

make html

该命令会在docs文件夹下生成一个_build目录,和方法1里生成的build一样,保存了一些html文件,使用浏览器打开index.html,就可以查看说明文档了。

扫描关注, 与我技术互动

QQ交流群: 211426309

加入知识星球, 每天收获更多精彩内容

分享日常研究的python技术和遇到的问题及解决方案