- 本教程为python3文档解读
- 本教程面向完全型小白,只要你会在电脑上打字,那你就可以看懂。
- 参考视频观看,味道更加:https://space.bilibili.com/186584185/#!/video
- 建议优先阅读本系列的《编程的本质》这一章节。
- 推荐阅读:《跟我读python3文档:016_带你手撕程序,展现一个函数如何从思路到实现》
作者:咖喱py
贯穿始终的理念:别废话,就是干!
往期回顾:
- 匿名函数lambda
- 列表的方法
- del关键字
- 列表推导式
- 数据结构
文档解读
python3文档第六小节链接地址:6. Modules
本章主要讲解6. Modules(模块)这个小节
模块入门知识点相对较少,只要理解了基本概念,很快就能上手。
如果长篇大论看不下去的,可以直接翻到最后看总结。从而快速了解模块章节的知识点。
1. 首先要理解模块是什么。
我们到目前为止,都是在交互模式里输入代码,通过python解释器执行代码。
不知道大家有没有感觉到,这是一个非常笨拙的写代码的方法。
当我们要输入的代码比较多时,就会遇到一个问题:修改麻烦!
或者说,是不能修改。
我们一旦输入错误,那么之前的代码就废掉了,只能重新输入。
目前我们一次输入的代码量还比较少,最多也就十来行。重新输入一次到还可以接受。但是以后,我们的代码量越来越庞大,比如一次要输入上百行,那么,如果你中间有写错的部分,再把这些从头来过可能就很麻烦了。(ps:上古程序员被这件事折磨了很久。。)而且,你不能保证,下一次就不会犯错了。
为了解决这样的问题,我们一般是提前把代码写在一个文本文件里,然后用python解释器去解释执行。如果有错误的地方,只要修改下文本内容就可以了。
而这个提前写好的文本文件,就是我们说的模块!
不过,一般我们会把官方自带的模块成为内置模块。
自己写的文件一般就叫做脚本文件。。
但其实他俩在本质上是一样的。
所以,你可以理解为:模块即脚本,脚本即模块。
关键得看是谁写的。。。
2. 模块的特征
模块都是以.py结尾的文本文件。
比如 gali.py,知道galipy名字的由来了吧~
比如 sys.py、math.py、rhinoscriptsyntax.py
这些模块,有的是官方自带的,有的是别人写的,也有的是自己写的。不一而足。
3. 编写脚本
随便打开一个文本编辑器,开始写代码就行了。但是要记住,名字要以.py结尾。
下面,我们以atom编辑器,展示脚本编写。
在命令行直接用atom创建fibo.py文件。
atom fibo.py
参考截图如下:
注:如果电脑里没有atom编辑器,可以通过homebrew安装。
执行如下代码安装
brew cask install atom
如果不知道homebrew是是什么,请阅读如下章节
跟我读python3文档:004_mac与python3配置
执行完atom fibo.py之后,会打开一个新页面,我们在里面输入如下代码:
# Fibonacci numbers module
def fib(n): # write Fibonacci series up to n
a, b = 0, 1
while b < n:
print(b, end=' ')
a, b = b, a+b
print()
def fib2(n): # return Fibonacci series up to n
result = []
a, b = 0, 1
while b < n:
result.append(b)
a, b = b, a+b
return result
保存,关闭。
这样我们的第一个脚本就编写完了。
该脚本用来生成指定范围的斐波那契数列。
4. 调用模块(1)
使用import关键字就可以调用模块了。
打开pyhon交互模式,
然后试试调用自己编写的模块,也就是我们上面的那个fibo.py脚本文件
>>> import fibo #.py被省略。
>>> fibo.fib(100) #fibo是脚本名,fib是脚本内的函数名。
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
fibo.fib(100)这句的意思是,调用fibo脚本内部的fib函数,参数是100 。
脚本名与函数名用点连接。
问:为什么调用模块内的函数要这么麻烦呢?
答:因为我们以后写程序会导入很多模块,经常会碰到函数重名的问题。
为了解决这个问题,只好在函数名前指明是哪个模块的函数。
以后,你可能还会遇到模块也重名的情况。。。到时还会通过相似方法,指明这个模块是放在哪个文件夹的。
而这种以文件夹分类的方法就叫做包(Packages)
一个包里可以有多个模块。
相当于:一个文件夹里有多个以.py结尾的文本文件。
理解了吗?
而为了区分哪些文件夹是包,哪些不是,于是规定,文件夹里有名为:__init__.py的文件就是包。该文件可以是空文件,内部什么都可以不写。
5. 调用模块(2)
虽然我们借用其他模块的函数一般都是以如下形式
模块名.函数( )的形式,但是,有时模块名过长,并且该模块下的特定函数调用频繁。每次写起来都很麻烦。
为了解决这样的问题,在保证函数没有重名的情况下,可以用如下方法,只导入特定模块的特定函数。
以我们自己写的模块举例,从fibo模块导入fib( )和fib2( )两个函数,并调用。
>>> from fibo import fib, fib2
>>> fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377
>>> fib2(50)
[1, 1, 2, 3, 5, 8, 13, 21, 34]
6. 运行脚本
有时我们会需要在终端(shell)中直接运行我们的脚本。
我们需要怎么做呢?
我们先来了解两个知识点
知识点1
每个模块,都有一个名为:__name__的内置变量,它存储了模块的名字。
>>> import fibo
>>> fibo.__name__
'fibo'
我们自己写的模块也会有这个变量。
但是,当我们直接在终端(shell)中运行而不是在python交互环境中。这个变量存储的值就会变为:"__main__"
知识点2
sys模块的argv变量
详情参见//www.greatytc.com/p/4269882480aa
如果你掌握了上面两个知识点,那么继续跟我往下看。
当我们在终端运行我们的脚本时,python解释器会执行我们写好的脚本,但我们什么信息也得不到。为什么呢?因为我们没有明确的函数调用。也就是说,我们只告诉了计算机,你都可以做什么。但是我们没有让他做。
这就好比你启动了计算器,虽然计算器可以运行加、减、乘、除,但它什么也不会做。因为我们没有明确告诉计算器做什么。
所以,我们要额外添加明确的指令。
if __name__ == "__main__":
import sys
fib(int(sys.argv[1]))
结合上面的两个知识点,你看明白这段代码吗?
如果__name__变量的值为 "__main__",则执行之后的操作。
导入sys模块,取得终端输入的参数,转化为int型,并将其作为参数,被fib( )函数调用。
那么,什么时候__name__变量的值为 "__main__"呢?
就是我们在知识点1中讲到的,当我们在终端直接调用脚本时。
所以,把上面的代码添加进我们自己写的脚本结尾,保存。
然后试着在终端调用它吧。
$ python3 fibo.py 50
1 1 2 3 5 8 13 21 34
可以参考下面的截图:
解释下调用代码的意思。
- $是终端的输入提示符。
- python3是python解释器
- fibo.py是我们写好的脚本
- 50是函数用来调用的参数
7. 搜索路径
有的同学,虽然按照我说的做了,但可能会发现自己的脚本并不能被成功运行。
一个常见的原因就是:你的脚本放错了文件夹。
还记得我们之前讲解的环境变量吗?
你的python解释器会去指定路径的文件夹寻找文件,但如果你放在了其他文件夹,你的pyton解释器就会找不到你的脚本了。
所以,我们一般会把脚本文件放在你的主目录下。
在终端中,主目录一般会以波浪号~表示。
我们可以通过在终端输入:
pwd
来查看我们当前的工作目录。
我现在的工作目录就是我的主目录,它的实际位置是:
/Users/Galipy
所以,我的脚本文件都会存储在这个名为Galipy的文件夹里。
那么,python解释器都会搜索哪几个文件夹呢?
我们可以通过sys模块的path来查看
>>> import sys
>>> sys.path
我们会得到一个列表,列表里的元素值就是python解释器会搜索的路径了。
思考:既然我们的到的搜索路径是一个列表,那么如何让这个列表里添加其他路径值呢?
提示:append方法
以上就是你目前需要了解的关于模块的知识点了。
我们总结一下,你可以着重记忆一下:
import 模块
例如:import sysfrom 模块 import 函数或变量
例如:from fibo import fib2__name__ == "__main__"
例如:
if __name__ == "__main__":
import sys
fib(int(sys.argv[1]))
好好背诵这三个知识点吧~