Python模块和包

多个关系密切的模块应该组织成一个包，以便于维护和使用。这项技术能有效避免名字空间冲突。创建一个名字为包名字的文件夹并在该文件夹下创建一个__init__.py 文件就定义了一个包。你可以根据需要在该文件夹下存放资源文件、已编译扩展及子包。举例来说，一个包可能有以下结构:

Graphics/ 

    __init__.py

    Primitive/ 

        __init__.py  

       lines.py

        fill.py 

        text.py ... 

    Graph2d/ 

        __init__.py

        plot2d.py ...

    Graph3d/ 

        __init__.py 

        plot3d.py ... 

    Formats/ 

        __init__.py 

        gif.py 

        png.py 

        tiff.py 

        jpeg.py

import语句使用以下几种方式导入包中的模块:

* import Graphics.Primitive.fill 导入模块Graphics.Primitive.fill,只能以全名访问模块属性,例如Graphics.Primitive.fill.floodfill(img,x,y,color).

* from Graphics.Primitive import fill 导入模块fill ,只能以 fill.属性名 这种方式访问模块属性,例如 fill.floodfill(img,x,y,color).

* from Graphics.Primitive.fill import floodfill 导入模块fill ,并将函数floodfill放入当前名称空间,直接访问被导入的属性，例如 floodfill(img,x,y,color).

无论一个包的哪个部分被导入, 在文件__init__.py中的代码都会运行.这个文件的内容允许为空,不过通常情况下它用来存放包的初始化代码。导入过程遇到的所有__init__.py文件都被运行.因此 import Graphics.Primitive.fill 语句会顺序运行 Graphics 和 Primitive 文件夹下的__init__.py文件.

下边这个语句具有歧义:

from Graphics.Primitive import *

这个语句的原意图是想将Graphics.Primitive包下的所有模块导入到当前的名称空间.然而,由于不同平台间文件名规则不同(比如大小写敏感问题), Python不能正确判定哪些模块要被导入.这个语句只会顺序运行 Graphics 和 Primitive 文件夹下的__init__.py文件. 要解决这个问题，应该在Primitive文件夹下面的__init__.py中定义一个名字all的列表，例如:

1 # Graphics/Primitive/__init__.py

2 __all__ = ["lines","text","fill",...]

这样,上边的语句就可以导入列表中所有模块.

下面这个语句只会执行Graphics目录下的__init__.py文件，而不会导入任何模块:

1 import Graphics

2 Graphics.Primitive.fill.floodfill(img,x,y,color) # 失败!

不过既然 import Graphics 语句会运行 Graphics 目录下的 init.py文件,我们就可以采取下面的手段来解决这个问题：

 1 # Graphics/__init__.py 

2 import Primitive, Graph2d, Graph3d 

34 # Graphics/Primitive/__init__.py

5 import lines, fill, text, ...

这样import Graphics语句就可以导入所有的子模块(只能用全名来访问这些模块的属性).

在一个包中，同一目录下的两个模块可以互相引用而不需要提供包的名字.例如 Graphics.Primitive.fill模块可以使用import lines导入Graphics.Primitive.lines . 不过如果两个模块位于同一个包的不同目录,就必须提供包名.例如,如果Graphics.Graph2d的plot2d模块需要使用Graphics.Primitive下的lines模块,就必须使用from Graphics.Primitive import lines这样的语句.如果需要,一个模块可以通过__name__ 属性得到自己的全名.例如：下面的代码在仅知道同级子包的名字情况下(不知道它们共同的顶级包名)导入该子包下的一个模块。

 1 # Graphics/Graph2d/plot2d.py

23 # 决定包的名称,以及自身的位置

4 import string 

5 base_package = string.join(string.split(__name__,'.')[:-2],'.')

67 # 导入 ../Primitive/fill.py 模块

8 exec "from %s.Primitive import fill" % (base_package,)

最后,当Python导入一个包时,它定义了一个包含目录列表的特殊变量__path__ ,它用于查找包的模块(__path__与sys.path变量的作用相似). 可以在__init__.py文件中访问__path__变量.这个列表的初始值只有一个元素.即包的目录.只要你觉得必要,一个包也可以到其他的目录中去(在__path__增加要搜索的目录)搜索模块。(换言之，一个模块可以属于一个包，却不位于这个包所在的目录或子目录下。