【Python】import

2019-10-20

模块（Module）和包（Package）

为了编写可维护的代码，我们把很多函数分组，分别放到不同的文件里，这样，每个文件包含的代码就相对较少，很多编程语言都采用这种组织代码的方式。在Python中，一个.py文件就称之为一个模块（Module）。

使用模块还可以避免函数名和变量名冲突。相同名字的函数和变量完全可以分别存在不同的模块中，因此，我们自己在编写模块时，不必考虑名字会与其他模块冲突。

如果不同的人编写的模块名相同怎么办？为了避免模块名冲突，Python又引入了按目录来组织模块的方法，称为包（Package）。

举个例子，一个abc.py的文件就是一个名字叫abc的模块，一个xyz.py的文件就是一个名字叫xyz的模块。

现在，假设我们的abc和xyz这两个模块名字与其他模块冲突了，于是我们可以通过包来组织模块，避免冲突。方法是选择一个顶层包名，比如mycompany，按照如下目录存放：

mycompany
├─ __init__.py
├─ abc.py
└─ xyz.py

引入了包以后，只要顶层的包名不与别人冲突，那所有模块都不会与别人冲突。现在，abc.py模块的名字就变成了mycompany.abc，类似的，xyz.py的模块名变成了mycompany.xyz。

请注意，每一个包目录下面都会有一个__init__.py的文件，这个文件是必须存在的，否则，Python就把这个目录当成普通目录，而不是一个包。__init__.py可以是空文件，也可以有Python代码，因为__init__.py本身就是一个模块，而它的模块名就是mycompany。

类似的，可以有多级目录，组成多级层次的包结构。比如如下的目录结构：

mycompany
 ├─ web
 │  ├─ __init__.py
 │  ├─ utils.py
 │  └─ www.py
 ├─ __init__.py
 ├─ abc.py
 └─ utils.py

文件www.py的模块名就是mycompany.web.www，两个文件utils.py的模块名分别是mycompany.utils和mycompany.web.utils。

自己创建模块时要注意命名，不能和Python自带的模块名称冲突。例如，系统自带了sys模块，自己的模块就不可命名为sys.py，否则将无法导入系统自带的sys模块。

Absolute Import

1	from src.packone import test1

绝对引用通过package的绝对路径引入module，且路径要从最上一层的package写起。

from xxx import *

# constants.py
MAX_ENTITY_NUMBER_LIMIT_FOR_DB_QUERY = 500
DEFAULT_ENTITY_NUMBER_FOR_DB_QUERY = 50

def a():
	pass

如果通过from core.constants import *，则core.constants（对应constants.py文件）中定义的所有变量和函数，都可以在 views.py 中直接使用（无需通过 constants.MAX_ENTITY_NUMBER_LIMIT_FOR_DB_QUERY 来调用，就好像把constants.py文件全文复制到了views.py 中）

#views.py
from core.constants import *

def get_limit(l):
		a()
    if l is None:
        l = DEFAULT_ENTITY_NUMBER_FOR_DB_QUERY
    else:
        if l > MAX_ENTITY_NUMBER_LIMIT_FOR_DB_QUERY:
            l = DEFAULT_ENTITY_NUMBER_FOR_DB_QUERY
    return l

import xxx

Note：datetime模块中有一个 datetime 方法。

>>> import datetime
>>> datetime(2017,10,30)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'module' object is not callable
>>> datetime.datetime(2017,10,30)
datetime.datetime(2017, 10, 30, 0, 0)

结论：通过 import 语句引用一个模块后，要通过[模块名].[方法名]()来调用。

from [模块名] import xxx

1
2
3

>>> from datetime import datetime
>>> datetime(2017,10,30)
datetime.datetime(2017, 10, 30, 0, 0)

结论：通过 from xxx import xxx 语句引用一个模块后，直接可以调用这个模块的方法，即通过 [方法名]()，而方法名前不再需要声明该方法所属的模块。

Relative Import

from . import yyy
from .xx import yyy
from ..xx import yyy
from ...xx import yyy

相对引入方式使用一个点号来标识引入类库的精确位置。与linux的相对路径表示相似，一个点表示当前目录，每多一个点号则代表向上一层目录。

文件在文件夹中

$ tree
.
├── core
│   └── models.py
└── manage.py

1 directory, 2 files

1
2
3

>>> from .core import models
>>> models.Channel.objects.all()
<QuerySet [<Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>, <Channel: Channel object>]>

类似的，这里也是通过 from xxx import xxx 语句引用一个模块，所以可以直接调用 models 模块的方法，即通过 [方法名]()，而方法名前不再需要声明该方法所属的模块。

Reference

https://www.jianshu.com/p/04bac02ae3f0