python学习笔记之九：模块和包

542505989

　　Python的标准安装包括一组模块，称为标准库。这里介绍模块的工作方式，学习如何使用它们。
　　一. 模块
　　1.1 用import从外部模块获取函数并为自己的程序所用：



>>> from math import sqrt
>>> import math
　　1.2 编写自己的模块
　　任何python程序都可以作为模块导入。程序保存的位置很重要。假设我们所写的程序叫hello.py被保存在c:/python目录下，可以执行以下的代码，告诉解释器在哪里寻找hello.py模块：



#hello.py
print "hello,world!"
>>> import sys
>>> sys.path.append('c:/python')
>>> import hello
hello,world!
　　如上所见，在导入模块时，其中的代码被执行了。不过如果再次导入该模块，就什么都不会发生了。因为导入模块并不意味着在导入时执行某些操作，它们主要用于定义，只需要定义一次，导入模块一次和多次的效果是一样的。
　　1.3 模块用于定义
　　导入模块真正的用处在于保持自己的作用域，这意味着定义的所有类和函数以及赋值后的变量都成了模块的特性。
　　（1）我们可以在模块底下定义函数，然后像标准库那样导入它们。
　　（2）我们还可以在模块中增加测试代码来检查模块本身是否正常工作：
　　有2种办法加入测试代码：
　　第一种办法是“告知”模块本身是作为程序运行还是导入到其他程序：



#hello.py
def hello():
print 'hello:__name__'
#A test:
    hello()
>>> __name__
'__main__'
>>> hello.__name__
'hello:__name__'
　　第二种办法是使用条件测试代码：



#hello.py
def hello():
print 'hello'
#A test:
def test():
hello()
if __name__ == '__main__':test()
　　这样如果将它作为程序运行，hello（）函数会被执行，而作为模块导入时，它的行为就会像普通模块一样。
　　
　　1.4 让模块可用
　　（1）把模块放在正确的位置：只需找出python解释器从哪里开始查找模块，然后将你自己的文件放置在那里即可。



>>> import sys
>>> print sys.path
['D:\\python', 'C:\\Python27\\Lib\\idlelib', 'C:\\Python27\\python27.zip', 'C:\\Python27\\DLLs', 'C:\\Python27\\lib', 'C:\\Python27\\lib\\plat-win', 'C:\\Python27\\lib\\lib-tk', 'C:\\Python27', 'C:\\Python27\\lib\\site-packages']
　　以上目录都可以用来存放我们定义的文件，但是site-packages目录是最佳选择，因为它就是用来做这些事情的。
　　（2）告诉编译器哪里去找：编辑sys.path或者是在PYTHONPATH环境变量中包含模块所在目录
　　
　　二. 包package
　　为了组织好模块，你可以把它们分组为包。当模块存储在文件.py中时，包就是模块所在的目录。
　　为了让python将其作为包对待，它必须包含一个名为__init__.py的文件。
　　如果要建立一个叫dd的包，其中包含aa和cc的模块，那么你就需要创建如下文件和目录：



1. D:/pythons
2. D:/pythons/dd
3. D:/python/sdd/__init__.py
4. D:/python/sdd/aa.py
5. D:/pythonsdd/cc.py
　　(以上假设D:/pythons已经被放置到PYTHONPATH中。)



import dd             # __init__中的内容可用，aa和cc模块不可用
import dd.aa         #aa模块可用了，但只能使用全名dd.aa来使用
from dd import cc   #cc模块可用了，可用通过短名cc来使用
　　
　　三. 探究模块
　　学会如何探究模块是极有价值的技能。探究模块最直接的方式是在python解释器中研究它们。
　　3.1 模块中有什么 -- 比如copy标准模块
　　（1）使用dir函数
　　使用dir函数可以将对象的特性都列出，如下，我们可以使用列表推导式过滤掉一部分：



>>> import copy
>>> [n for n in dir(copy) if not n.startswith('_')]
['Error', 'PyStringMap', 'copy', 'deepcopy', 'dispatch_table', 'error', 'name', 't', 'weakref']
>>> [n for n in dir(copy) if n.startswith('__')]
['__all__', '__builtins__', '__doc__', '__file__', '__name__', '__package__']
　　（2）继续查看它的__all__



>>> copy.__all__
['Error', 'copy', 'deepcopy']
　　可见它定义了模块的公有借口，更准确地说，它告诉解释器：从模块导入所有名字代表什么含义。
　　如：from cpy import *意味着你只能使用__all__变量中的几个函数，如果要导入PyStringMap的话，就要这样做：
　　导入copy然后使用copy.PyStringMap；或者是使用from copy import PyStringMap
　　我们在编写模块的时候，像设置__all__这样的技术是相当有用的，因为一个模块中可能会有一大堆其他程序不需要或者不想要的变量，函数和类，__all__会把它们过滤出去。如果没有设定__all__，用import*会默认输出模块中所有不以下划线开头的全局名称。
　　
　　3.2 用help函数获取帮助
　　help函数能够为你提供日常所需的信息：



>>> help(copy)
Help on module copy:
NAME
copy - Generic (shallow and deep) copying operations.
FILE
c:\python27\lib\copy.py
DESCRIPTION
Interface summary:   
import copy
x = copy.copy(y)        # make a shallow copy of y
x = copy.deepcopy(y)    # make a deep copy of y
.......
　　
　　3.3 文档--模块信息的自然来源
　　比如寻找range的文档描述：



>>> print range.__doc__
range(stop) -> list of integers
range(start, stop[, step]) -> list of integers
Return a list containing an arithmetic progression of integers.
range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.
When step is given, it specifies the increment (or decrement).
For example, range(4) returns [0, 1, 2, 3].  The end point is omitted!
These are exactly the valid indices for a list of 4 elements.
　　这样就获得了关于range函数的精确描述。但是要记住，并不是所有的模块和函数都有不错的文档字符串的，有时候要透彻理解模块和函数是如何工作的，最好参考Pyhton库：http:python.org/doc/lib
　　
　　3.4 使用源代码
　　使用如下语句就可以查找到想要模块的源代码位置：



>>> print copy.__file__
C:\Python27\lib\copy.pyc
　　如果文件名以.pyc结尾，只要查看相应的以.py结尾的文件即可。