第六章 模塊
如果退出Python解釋程序然后再進入，原有的定義（函數(shù)和變量）就丟失了。所以，如果需要寫長一點的程序，最好用一個文本編輯程序為解釋程序準(zhǔn)備輸入，然后以程序文件作為輸入來運行Python解釋程序，這稱為準(zhǔn)備腳本（script）。當(dāng)你的程序變長時，最好把它拆分成幾個文件以利于維護。你還可能想在幾個程序中都使用某個很方便的函數(shù)，但又不想把函數(shù)定義賦值到每一個程序中。

為了支持這些，Python有一種辦法可以把定義放在一個文件中然后就可以在一個腳本中或交互運行中調(diào)用。這樣的文件叫做一個模塊；模塊中的定義可以導(dǎo)入其它模塊或主模塊（主模塊指在解釋程序頂級執(zhí)行的腳本或交互執(zhí)行的程序所能訪問的變量集合）。

模塊是包含了Python定義和語句的文件。文件名由模塊名加上后綴“.py”構(gòu)成。在模塊內(nèi)，模塊的名字（作為一個字符串）可以由全局變量__name__的值獲知。例如，在Python的搜索路徑中用你習(xí)慣使用的文本編輯器（Python 1.5.2包含了一個用Tkinter編寫的IDLE集成開發(fā)環(huán)境，MS Windows下有一個PythonWin界面也可以進行Python程序編輯）生成一個名為“fibo.py ”的文件，包含如下內(nèi)容：

# Fibonacci numbers module
　
def fib(n):    # 輸出小于n的Fibonacci序列
    a, b = 0, 1
    while b < n:
        print b,
        a, b = b, a+b
　
def fib2(n): # 返回小于n的Fibonacci序列
    result = []
    a, b = 0, 1
    while b < n:
        result.append(b)
        a, b = b, a+b
    return result


然后進入Python解釋程序（在IDLE或PythonWin中可以直接進入解釋程序窗口），用如下命令可以導(dǎo)入模塊：

>>> import fibo

這不會把模塊fibo中的函數(shù)的名字直接引入當(dāng)前的符號表，這只是把模塊名fibo引入?？梢杂媚K名來訪問其中的函數(shù)：

>>> fibo.fib(1000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987
>>> fibo.fib2(100)
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
>>> fibo.__name__
'fibo'


如果經(jīng)常使用某個函數(shù)可以給它賦一個局部名字：

>>> fib = fibo.fib
>>> fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377


6.1 模塊的進一步介紹
模塊除了可以包含函數(shù)定義之外也可以包含可執(zhí)行語句。這些可執(zhí)行語句用來初始化模塊，它們只在模塊第一次被導(dǎo)入時執(zhí)行。

每個模塊有自己私有的符號表，這個私有符號表對于模塊中的所有函數(shù)而言卻是它們的全局符號表。因此，模塊作者可以在模塊中使用全局變量而不需擔(dān)心與模塊用戶的全局變量沖突。另一方面，如果你有把握的話也可以用訪問模塊中函數(shù)的格式，即modname.itemname的方法來修改模塊中的全局變量。

模塊可以導(dǎo)入其它模塊。我們通常把所有的導(dǎo)入語句放在模塊（或腳本）的開始位置，這不是規(guī)定要求的。導(dǎo)入的模塊名放入模塊的全局符號表中。

導(dǎo)入還有另一種用法，可以把模塊中的名字直接導(dǎo)入使用者的符號表。例如： 

>>> from fibo import fib, fib2
>>> fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377


這不會把模塊名導(dǎo)入使用者的符號表中（例如，上面例子中fibo就沒有定義）。 

還有一種辦法可以導(dǎo)入一個模塊中定義的所有名字： 

>>> from fibo import *
>>> fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377


這可以把模塊中除了以下劃線結(jié)尾的所有名字導(dǎo)入。 

6.1.1 模塊搜索路徑
在導(dǎo)入名為spam的模塊時，解釋程序先在當(dāng)前目錄中尋找名為“spam.py”的文件，然后從環(huán)境變量PYTHONPATH所定義的目錄列表中尋找。PYTHONPATH的用法和可執(zhí)行文件的搜索路徑PATH用法相同，都是一個目錄列表。當(dāng)PYTHONPATH未設(shè)置的時候，或者文件仍找不到，則搜索繼續(xù)在安裝時設(shè)定的缺省路徑搜索，在Unix中，這通常是“.:/usr/local/lib/python” 。

實際上，模塊是按變量sys.path指定的路徑搜索的，此變量在解釋程序啟動時初始化為包含輸入腳本的目錄（或當(dāng)前路徑），PYTHONPATH和安裝缺省路徑。這樣，用戶可以通過修改sys.path 來修改和替換模塊搜索路徑。參見后面關(guān)于標(biāo)準(zhǔn)模塊的一節(jié)。

6.1.2 “編譯”的Python文件
為了提高調(diào)用許多標(biāo)準(zhǔn)模塊的小程序的啟動時間，一個重要的措施是，如果在找到“spam.py ”的目錄中存在一個名為“spam.pyc”的文件，就認為此文件包含了模塊spam的一個所謂“ 字節(jié)編譯”版本。用于生成“spam.pyc”的“spam.py”的修改時間被記入了“spam.pyc”中，如果記錄的修改時間與現(xiàn)在文件的時間不相符的話就忽略編譯文件。

一般不需要自己生成“spam.pyc”這樣的編譯文件。每當(dāng)“spam.py”成功編譯后解釋程序就嘗試寫編譯版本“spam.pyc”，如果不可寫也不會出錯；如果因為某種原因此文件沒有寫完則生成的“spam.pyc”被識別為不完整的而被忽略。編譯文件“spam.pyc”的格式是不依賴于平臺的，所以不同結(jié)構(gòu)的機器可以共享Python模塊目錄。

下面是對專家的一些竅門： 

如果Python解釋程序是以-O標(biāo)志啟動的，將生成優(yōu)化的編譯代碼，保存在“.pyo”文件中。目前優(yōu)化不是很多，現(xiàn)在只是去掉assert語句和SET_LINENO指令。使用了-O標(biāo)志時，所有字節(jié)碼都是優(yōu)化的，“.pyc”文件被忽略，“.py”文件被編譯為優(yōu)化的字節(jié)碼。

給Python解釋程序兩個優(yōu)化標(biāo)志（-OO）產(chǎn)生的優(yōu)化代碼有時會導(dǎo)致程序運行不正常。目前雙重優(yōu)化只從字節(jié)碼中刪除了__doc__字符串，使得“.pyo”文件較小。有些程序可能是依賴于文檔字符串的，所以只有在確知不會有問題時才可以使用這樣的優(yōu)化。

從“.pyc”或“.pyo”讀入的程序并不能比從“.py”讀入的運行更快，它們只是調(diào)入速度更快一些。

如果一個程序是用在命令行指定腳本文件名的方式運行的，腳本的字節(jié)碼不會寫入“.pyc ”或“.pyo”文件。所以如果把程序的主要代碼都移入一個模塊，腳本中只剩下導(dǎo)入該模塊的引導(dǎo)程序則可以略微縮短腳本的啟動時間。

可以有叫做“spam.pyc”（當(dāng)用了-O標(biāo)志時為“spam.pyo”）的文件而沒有對應(yīng)的源文件“spam.py”。這可以用來分發(fā)一個比較難反編譯的Python代碼庫。

模塊compileall可以把一個目錄中所有模塊編譯為“.pyc”文件（指定了-O選項時編譯為“.pyo”文件）。

6.2 標(biāo)準(zhǔn)模塊
Python帶有一個標(biāo)準(zhǔn)模塊庫，在另一個文檔《Python庫參考》中進行了描述。一些模塊直接編入了解釋程序中，這些模塊不是語言的核心，為了運行效率或者為了提供對于系統(tǒng)調(diào)用這樣的系統(tǒng)底層功能而編入了解釋程序中。提供那些模塊是編譯時的選擇，例如，amoeba模塊只在提供amoeba底層指令的系統(tǒng)中才能提供。

有一個模塊值得特別重視：sys模塊，每一個Python解釋程序中都編譯入了這個模塊。變量sys.ps1和sys.ps2定義了交互運行時的初始提示和續(xù)行提示。

>>> import sys
>>> sys.ps1
'>>> '
>>> sys.ps2
'... '
>>> sys.ps1 = 'C> '
C> print 'Yuck!'
Yuck!
C>


這兩個變量只在解釋程序以交互方式運行時才有定義。 

變量sys.path是一個字符串列表，由它確定解釋程序的模塊搜索路徑。它被初始化為環(huán)境變量PYTHONPATH所指定的缺省路徑，環(huán)境變量沒有定義時初始化為安裝時的缺省路徑?？梢杂脴?biāo)準(zhǔn)的列表操作修改這個搜索路徑，例如：

>>> import sys
>>> sys.path.append('/ufs/guido/lib/python')


6.3 dir()函數(shù)
內(nèi)置函數(shù)dir()用于列出一個模塊所定義的名字，它返回一個字符串列表： 

>>> import fibo, sys
>>> dir(fibo)
['__name__', 'fib', 'fib2']
>>> dir(sys)
['__name__', 'argv', 'builtin_module_names', 'copyright', 'exit',
'maxint', 'modules', 'path', 'ps1', 'ps2', 'setprofile', 'settrace',
'stderr', 'stdin', 'stdout', 'version']


沒有自變量時，dir()列出當(dāng)前定義的名字。

>>> a = [1, 2, 3, 4, 5]
>>> import fibo, sys
>>> fib = fibo.fib
>>> dir()
['__name__', 'a', 'fib', 'fibo', 'sys']


注意dir()列出了所有各類名字：變量名、模塊名、函數(shù)名，等等。dir()不會列出內(nèi)置函數(shù)、變量的名字。要想列出內(nèi)置名字的話需要使用標(biāo)準(zhǔn)模塊__builtin__：

>>> import __builtin__
>>> dir(__builtin__)
['AccessError', 'AttributeError', 'ConflictError', 'EOFError', 'IOError',
'ImportError', 'IndexError', 'KeyError', 'KeyboardInterrupt',
'MemoryError', 'NameError', 'None', 'OverflowError', 'RuntimeError',
'SyntaxError', 'SystemError', 'SystemExit', 'TypeError', 'ValueError',
'ZeroDivisionError', '__name__', 'abs', 'apply', 'chr', 'cmp', 'coerce',
'compile', 'dir', 'divmod', 'eval', 'execfile', 'filter', 'float',
'getattr', 'hasattr', 'hash', 'hex', 'id', 'input', 'int', 'len', 'long',
'map', 'max', 'min', 'oct', 'open', 'ord', 'pow', 'range', 'raw_input',
'reduce', 'reload', 'repr', 'round', 'setattr', 'str', 'type', 'xrange']


6.4 包
Python中可以用“包”來組織Python的模塊名字空間，名字引用時可以用“帶點的模塊名。例如，模塊名A.B代表包“A”內(nèi)名為“B”的子模塊。正如使用模塊可以使不同模塊的作者不用顧慮彼此的全局變量名會沖突，使用帶點的模塊名可以使多模塊包如NumPy和PIL的作者不需要擔(dān)心彼此的模塊名會沖突。

假設(shè)你有一系列處理聲音文件和聲音數(shù)據(jù)的模塊（稱為一個“包”）。有許多種不同的聲音文件格式（通常用擴展名來識別，如“wav”，“.aiff”，“.au”），所以你可能需要制作并維護一組不斷增加的模塊來處理不同文件格式的轉(zhuǎn)換。你還可能需要對聲音數(shù)據(jù)進行許多不同的操作（如混音、回響、均衡、產(chǎn)生模擬立體聲效果），所以你還需要不斷增加模塊來執(zhí)行這些操作。一下是你的程序包的可能的結(jié)構(gòu)（用一個分層文件系統(tǒng)表示）：

　
Sound/                          頂層包
      __init__.py               初始化音響包
      Formats/                  用于文件格式轉(zhuǎn)換的子程序包
              __init__.py
              wavread.py
              wavwrite.py
              aiffread.py
              aiffwrite.py
              auread.py
              auwrite.py
              ...
      Effects/                  用于音響效果的子程序包
              __init__.py
              echo.py
              surround.py
              reverse.py
              ...
      Filters/                  用于濾波的子程序包
              __init__.py
              equalizer.py
              vocoder.py
              karaoke.py
              ...
　


包目錄中的“__init__.py”文件是必須得，用來指示Python把這個目錄看成包，這可以防止有相同名字如“string”的子目錄掩蓋住在搜索路徑后面一些出現(xiàn)的模塊定義。在最簡單的情況下，“__init__.py”可以是一個空文件，它也可以包含初始化包所需的代碼，和設(shè)置“__all__”變量，這些后面會加以討論。

包的用戶可以從包中導(dǎo)入單獨的模塊，如： 

    import Sound.Effects.echo

這可以把子模塊Sound.Effects.echo導(dǎo)入。要引用它也必須用全名，例如：

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

導(dǎo)入子模塊的另一種辦法是：

from Sound.Effects import echo

這同樣也導(dǎo)入子模塊echo，但調(diào)用時不需寫包前綴，所以可以用如：

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

另外一種寫法是直接導(dǎo)入所需的函數(shù)或變量：

from Sound.Effects.echo import echofilter

這一次同樣是調(diào)入了子模塊echo，但是使其函數(shù)echofilter直接可用：

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

注意使用“from 包 import 項”這樣的格式時，導(dǎo)入的項可以是包的一個子模塊（或子包），也可以是包內(nèi)定義的其它名字如函數(shù)、類、變量。導(dǎo)入語句首先查找包內(nèi)是否定義了所需的項，如果沒有則假設(shè)它是一個模塊然后調(diào)入。如果找不到，結(jié)果引起ImportError。

相反的，當(dāng)使用“import item.subitem.subsubitem”這樣的格式時，除最后一個外其它各項都應(yīng)該是包，最后一項可以是包也可以是模塊，不允許是前面一項內(nèi)部定義的類、函數(shù)或變量。

6.4.1 從包中導(dǎo)入*
現(xiàn)在，如果用戶寫“from Sound.Effects import *”會發(fā)生什么情況？理想情況下我們希望這應(yīng)該掃描文件系統(tǒng)，找到所有包內(nèi)的子模塊并把它們都導(dǎo)入進來。不幸的是這種操作在Mac和Windows平臺上不能準(zhǔn)確實現(xiàn)，這兩種操作系統(tǒng)對文件名的大小寫沒有準(zhǔn)確信息。在這些平臺上，不知道名為“ECHO.PY”的文件會作為模塊echo、Echo還是ECHO被導(dǎo)入。（例如，Windows 95在顯示文件名時總是討厭地把第一個字母大寫）。DOS的8＋3文件名限制更是對長模塊名造成了有趣的困難。

這個問題的唯一解決辦法是由模塊作者顯式地提供包的索引。引入*的import語句遵循如下規(guī)定：如果包的“__init__.py”文件定義了一個名為“__all__”的列表，這個列表就作為從包內(nèi)導(dǎo)入*時要導(dǎo)入的所有模塊的名字表。因此當(dāng)包的新版本發(fā)布時需要包的作者確保這個列表是最新的。包的作者如果認為不需要導(dǎo)入*的話也可以不支持這種用法。例如，文件Sounds/Effects/__init__.py 可以包含如下代碼：

　
__all__ = ["echo", "surround", "reverse"]


這意味著from Sound.Effects import *將從Sound包中導(dǎo)入指定的三個子包。　 
如果沒有定義__all__，則from Sound.Effects import *語句不會導(dǎo)入Sound.Effects包中的所有子模塊；此語句只能保證Sound.Effects被導(dǎo)入（可能是執(zhí)行其初始化代碼“__init__.py ”）并導(dǎo)入包中直接定義的名字。這包括由“__init__.py”定義的任何名字和顯式導(dǎo)入的子模塊名。這也包括模塊中已經(jīng)在前面用import顯式地導(dǎo)入的子模塊，例如：

　
import Sound.Effects.echo
import Sound.Effects.surround
from Sound.Effects import *
　


在這個例子中，echo和surround模塊被導(dǎo)入當(dāng)前名字空間，因為它們在執(zhí)行from...import 語句時已定義（在定義了__all__的情況下這一點也是成立的）。

注意用戶應(yīng)盡量避免使用從模塊或包中導(dǎo)入*的做法，因為這樣經(jīng)常導(dǎo)致可讀性差的代碼。盡管如此，在交互運行時可以用導(dǎo)入*的辦法節(jié)省敲鍵次數(shù)，而且有些模塊在設(shè)計時就考慮到了這個問題，它們只輸出遵循某種約定的名字。注意，from 包 import 特定子模塊的用法并沒有錯，實際上這還是我們推薦的用法，除非程序還需要用到來自其它包的同名的子模塊。

6.4.2 包內(nèi)部引用
子模塊常常需要彼此引用。例如，模塊surround可能要用到模塊echo。事實上，這樣的引用十分常見，所以import語句首先從子模塊的所在包中尋找要導(dǎo)入的子模塊才在標(biāo)準(zhǔn)模塊搜索路徑查找。所以，模塊surround只要寫import echo或from echo import echofilter。如果在包含本模塊的包中沒有找到要導(dǎo)入的模塊，import語句將去尋找指定名字的頂級模塊。

當(dāng)包組織成子包時（比如例中的Sound包），沒有一種簡單的辦法可以引用兄弟包中的子模塊――必須使用子模塊的全名。例如，如果模塊Sound.Filters.vocoder要引用Sound.Effects 包中的echo模塊，它可以用Sound.Effects import echo。

最新評論