【Python学习之九】模块

环境
　　虚拟机：VMware 10
　　Linux版本：CentOS-6.5-x86_64
　　客户端：Xshell4
　　FTP：Xftp4
　　python3.6

一、模块的使用和安装
模块和C语言中的头文件以及Java中的jar包很类似，使用关键字import引入模块。

1、import module1,mudule2...
当解释器遇到import语句，如果模块在当前的搜索路径就会被导入。

2、在调用math模块中的函数时，必须这样引用：模块名.函数名

import math
#print(sqrt(2))#语法报错
print(math.sqrt(2))

3、from…import

如果只需要用到模块中的某个函数，只需要引入该函数即可，此时可以用下面方法实现：
from modname import name1[, name2[, ... nameN]]
from语句让你从模块中导入一个指定的部分到当前命名空间中

示例：要导入模块fib的fibonacci函数：
from fib import fibonacci

4、from modname import *
把一个模块的所有内容全都导入到当前的命名空间。
注意：这提供了一个简单的方法来导入一个模块中的所有项目。然而这种声明不该被过多地使用。

5、定位模块
当你导入一个模块，Python解析器对模块位置的搜索顺序是：
(1)当前目录
(2)如果不在当前目录，Python则搜索在shell变量PYTHONPATH下的每个目录。
(3)如果都找不到，Python会察看默认路径。UNIX下，默认路径一般为/usr/local/lib/python/
(4)模块搜索路径存储在system模块的sys.path变量中。变量里包含当前目录，PYTHONPATH和由安装过程决定的默认目录。

6、安装模块

#安装
conda install 模块
pip install 模块
#更新
conda update 模块
#卸载
conda remove 模块
#查找
conda search 模块
#列出清单
conda list

二、模块制作

1、定义自己的模块
在Python中，每个Python文件都可以作为一个模块，模块的名字就是文件的名字。
示例：

test.py
def add(a,b):
return a+b 

2、调用自己定义的模块

在其他文件中可以先import test，然后通过test.add(a,b)来调用，当然也可以通过from test import add来引入
示例：

main.py
import test
result=test.add(11,22)
print(result)

3、测试模块

在实际开中，当一个开发人员编写完一个模块后，为了让模块能够在项目中达到想要的效果，这个开发人员会自行在py文件中添加一些测试信息，
示例：

test.py
def add(a,b):
return a+b
# 用来进行测试
ret=add(12,22)
print('int test.py file,,,,12+22=%d'%ret) 

如果此时，在其他py文件中引入了此文件的话，想想看，测试的那段代码是否也会执行呢！

main.py
import test
result=test.add(11,22)
print(result)

至此，可发现test.py中的测试代码，应该是单独执行test.py文件时才应该执行的，不应该是其他的文件中引用而执行

为了解决这个问题，python在执行一个文件时有个变量__name__,

__name__标识模块名字的一个系统变量。前后加了双下划线这是系统定义的名字。普通变量不要使用此方式命名变量。

def test():
  print '__name__ = ',__name__
if __name__ == '__main__':
  test()

分两种情况：

(1)假如当前模块是主模块（也就是调用其他模块的模块），那么此模块名字就是__main__，通过if判断这样就可以执行“__mian__:”后面的主函数内容；
(2)假如此模块是被import的，则此模块名字为文件名字（不加后面的.py），通过if判断这样就会跳过“__mian__:”后面的内容。

4、模块中的__all__

__all__用于模块公开接口的一种约定，__all__提供了暴露接口用的”白名单“。一些不以下划线开头的变量（比如从其他地方 import 到当前模块的成员）可以同样被排除出去。

import os
import sys

__all__ = ["process_xxx"] # 排除了 `os` 和 `sys`

def process_xxx():
    pass # omit

(1)__all__ 应该是 list 类型的；

(2)不应该动态生成 __all__，比如使用列表解析式。__all__ 的作用就是定义公开接口，如果不以字面量的形式显式写出来，就失去意义了；
(3)即使有了__all__ 也不应该在非临时代码中使用 from xxx import * 语法，或者用元编程手段模拟 Ruby 的自动 import。Python 不像 Ruby，没有 Module 这种成员，模块就是命名空间隔离的执行者。如果打破了这一层，而且引入诸多动态因素，生产环境跑的代码就充满了不确定性，调试也会非常困难；
(4)按照 PEP8 建议的风格，__all__ 应该写在所有 import 语句下面，和函数、常量等模块成员定义的上面。

三、Python中的模块

1、python中的包
包将有联系的模块组织在一起，即放到同一个文件夹下，并且在这个文件夹创建一个名字为__init__.py 文件，那么这个文件夹就称之为包;
有效避免模块名称冲突问题，让应用组织结构更加清晰

(1)包就是一个目录;
(2)把多个py文件放到同一个文件夹下;
(3)使用import 文件夹.模块 的方式导入,python3可以导入包,python2不行。
(4)使用from 文件夹 import 模块 的方式导入,python3可以导入包,python2不行。
(5)在包的文件夹下创建__init__.py文件。
在python2中：有一个目录，并且目录下有一个__init__.py的文件,才叫包。
有__init__.py文件在python3中没有有错，为了兼容python2，以后我们都在包的目录下新建一个__init__.py文件。
(6)在__init__.py文件中写入

from . import 模块1
from . import 模块2

那么可以使用import 文件夹 导入

2、 __init__.py文件有什么用:__init__.py 控制着包的导入行为。
(1)__init__.py为空：仅仅是把这个包导入，不会导入包中的模块;
(2)可以在__init__.py文件中编写内容,可以在这个文件中编写语句，当导入时，这些语句就会被执行;

四、模块的发布、安装、引用
mymodule目录结构体如下：

.
├── setup.py
├── suba
│ ├── aa.py
│ ├── bb.py
│ └── __init__.py
└── subb
├── cc.py
├── dd.py
└── __init__.py

1、编辑setup.py文件

from distutils.core import setup
setup(name="压缩包的名字", version="1.0", description="描述", author="作者", py_modules=['suba.aa', 'suba.bb', 'subb.cc', 'subb.dd'])

注意：py_modules需指明所需包含的py文件

2、构建模块

python setup.py build

3、生成发布压缩包

python setup.py sdist

4、安装

(1)找到模块的压缩包（拷贝到其他地方）
(2)解压
(3)进入文件夹
(4)执行命令

python setup.py install

注意：如果在install的时候，执行目录安装，可以使用

python setup.py install --prefix=安装路径 

5、模块的引入

在程序中，使用from import 即可完成对安装的模块使用
from 模块名 import 模块名或者*

参考：
Python学习笔记