python入门第五课

模块

在前面的几节课中我们基本上是用 python 解释器来编程，如果你从 Python 解释器退出再进入，那么你定义的所有的方法和变量就都消失了。

为此 Python 提供了一个办法，把这些定义存放在文件中，为一些脚本或者交互式的解释器实例使用，这个文件被称为模块。

模块是一个包含所有你定义的函数和变量的文件，其后缀名是.py。模块可以被别的程序引入，以使用该模块中的函数等功能。这也是使用 python 标准库的方法。

实例

# 引入 python 标准库中的 sys.py 模块
import sys

print('命令行参数如下:')、
# sys.argv是一个包含命令行参数的列表。
for i in sys.argv:
   print(i)
# sys.path 包含了一个 Python 解释器自动查找所需模块的路径的列表。
print('\n\nPython 路径为：', sys.path, '\n')

import 语句

想使用 Python 源文件，只需在另一个源文件里执行 import 语句

语法

#import module1[, module2[,... moduleN]

一个模块只会被导入一次，不管你执行了多少次 import。这样可以防止导入模块被一遍又一遍地执行。

当我们使用 import 语句的时候，Python 解释器是怎样找到对应的文件的呢？

• 这就涉及到 Python 的搜索路径，搜索路径是由一系列目录名组成的，Python 解释器就依次从这些目录中去寻找所引入的模块。

• 这看起来很像环境变量，事实上，也可以通过定义环境变量的方式来确定搜索路径。

• 搜索路径是在 Python 编译或安装的时候确定的，安装新的库应该也会修改。

from … import 语句

Python 的 from 语句让你从模块中导入一个指定的部分到当前命名空间中

语法

#from modname import name1[, name2[, ... nameN]]

这个声明不会把整个modname 模块导入到当前的命名空间中，它只会将modname 里的name1函数引入进来。

from … import * 语句

把一个模块的所有内容全都导入到当前的命名空间也是可行的

这提供了一个简单的方法来导入一个模块中的所有项目。然而这种声明不该被过多地使用。

深入模块

• 块除了方法定义，还可以包括可执行的代码。这些代码一般用来初始化这个模块。这些代码只有在第一次被导入时才会被执行。

• 每个模块有各自独立的符号表，在模块内部为所有的函数当作全局符号表来使用。

• 所以，模块的作者可以放心大胆的在模块内部使用这些全局变量，而不用担心把其他用户的全局变量搞混。

• 从另一个方面，当你确实知道你在做什么的话，你也可以通过 modname.itemname 这样的表示法来访问模块内的函数。

• 模块是可以导入其他模块的。在一个模块（或者脚本，或者其他地方）的最前面使用 import 来导入一个模块，当然这只是一个惯例，而不是强制的。被导入的模块的名称将被放入当前操作的模块的符号表中。

• 还有一种导入的方法，可以使用 import 直接把模块内（函数，变量的）名称导入到当前操作模块。

__name__属性

一个模块被另一个程序第一次引入时，其主程序将运行。如果我们想在模块被引入时，模块中的某一程序块不执行，我们可以用__name__属性来使该程序块仅在该模块自身运行时执行。

dir() 函数

内置的函数 dir() 可以找到模块内定义的所有名称

标准模块

• Python 本身带着一些标准的模块库，在 Python 库参考文档中将会介绍到（就是后面的"库参考文档"）。

• 有些模块直接被构建在解析器里，这些虽然不是一些语言内置的功能，但是他却能很高效的使用，甚至是系统级调用也没问题。

• 这些组件会根据不同的操作系统进行不同形式的配置，比如 winreg 这个模块就只会提供给 Windows 系统。

• 应该注意到这有一个特别的模块 sys ，它内置在每一个 Python 解析器中

包

• 包是一种管理 Python 模块命名空间的形式，采用"点模块名称"。

• 比如一个模块的名称是 A.B， 那么他表示一个包 A中的子模块 B 。

• 就好像使用模块的时候，你不用担心不同模块之间的全局变量相互影响一样，采用点模块名称这种形式也不用担心不同库之间的模块重名的情况。

• 这样不同的作者都可以提供 NumPy 模块，或者是 Python 图形库。

• 不妨假设你想设计一套统一处理声音文件和数据的模块（或者称之为一个"包"）。

• 现存很多种不同的音频文件格式（基本上都是通过后缀名区分的，例如： .wav，:file:.aiff，:file:.au，），所以你需要有一组不断增加的模块，用来在不同的格式之间转换。

• 并且针对这些音频数据，还有很多不同的操作（比如混音，添加回声，增加均衡器功能，创建人造立体声效果），所以你还需要一组怎么也写不完的模块来处理这些操作。

可能的包结构

sound/                          顶层包
      __init__.py               初始化 sound 包
      formats/                  文件格式转换子包
              __init__.py
              wavread.py
              wavwrite.py
              aiffread.py
              aiffwrite.py
              auread.py
              auwrite.py
              ...
      effects/                  声音效果子包
              __init__.py
              echo.py
              surround.py
              reverse.py
              ...
      filters/                  filters 子包
              __init__.py
              equalizer.py
              vocoder.py
              karaoke.py
              ...

在导入一个包的时候，Python 会根据 sys.path 中的目录来寻找这个包中包含的子目录。

目录只有包含一个叫做 init.py 的文件才会被认作是一个包，主要是为了避免一些滥俗的名字（比如叫做 string）不小心的影响搜索路径中的有效模块。

最简单的情况，放一个空的 :file:init.py就可以了。当然这个文件中也可以包含一些初始化代码或者为（将在后面介绍的） __all__变量赋值。

• 用户可以每次只导入一个包里面的特定模块，比如:

import sound.effects.echo

• 这将会导入子模块:sound.effects.echo。 他必须使用全名去访问:

sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)

• 还有一种导入子模块的方法是:

from sound.effects import echo

• 这同样会导入子模块: echo，并且他不需要那些冗长的前缀，所以他可以这样使用:

echo.echofilter(input, output, delay=0.7, atten=4)

• 还有一种变化就是直接导入一个函数或者变量:

from sound.effects.echo import echofilter

• 同样的，这种方法会导入子模块: echo，并且可以直接使用他的 echofilter() 函数:

echofilter(input, output, delay=0.7, atten=4)

注意当使用 from package import item 这种形式的时候，对应的 item 既可以是包里面的子模块（子包），或者包里面定义的其他名称，比如函数，类或者变量。

import 语法会首先把 item 当作一个包定义的名称，如果没找到，再试图按照一个模块去导入。如果还没找到，抛出一个 :exc:ImportError 异常。

反之，如果使用形如 import item.subitem.subsubitem 这种导入形式，除了最后一项，都必须是包，而最后一项则可以是模块或者是包，但是不可以是类，函数或者变量的名字。

从一个包中导入*

• 如果我们使用 from sound.effects import * 会发生什么呢？

• Python 会进入文件系统，找到这个包里面所有的子模块，然后一个一个的把它们都导入进来。

• 但这个方法在 Windows 平台上工作的就不是非常好，因为 Windows 是一个不区分大小写的系统。

• 在 Windows 平台上，我们无法确定一个叫做 ECHO.py 的文件导入为模块是 echo 还是 Echo，或者是 ECHO。

• 为了解决这个问题，我们只需要提供一个精确包的索引。

• 导入语句遵循如下规则：如果包定义文件 init.py 存在一个叫做 all 的列表变量，那么在使用 from package import * 的时候就把这个列表中的所有名字作为包内容导入。

• 作为包的作者，可别忘了在更新包之后保证 all 也更新了啊。