包的研究

本文主要从为什么要使用包、包的使用、绝对导入与相对导入等角度来对包进行研究。

'''
整体说明：
01 包是一种通过使用'.模块名'来组织python模块名称空间的方式。
02 包就是一个包含有__init__.py文件的文件夹，所以其实我们创建的目的就是为了用文件夹将文件/模块组织起来
    （1）在python3中，即使包下没有__init__.py文件，import包仍然不会报错，而在python2中，包下一定要要有该文件，否则import会报错。
    （2）创建包的目的不是为了运行，而是为了被导入使用，包只是模块的一种形式而已，包的本质就是一个模块。
03 import包发生的3件事情
    （1）在内存中以包名开辟一个空间。
    （2）自动将包下面的__init__文件中的代码加载到内存。
    （3）通过‘包名.’获取模块中的对象。
04 总结
    （1）执行文件的当前目录是在sys.path的第一个参数，所以当前目录的文件可以直接import,也就是说同一目录的包，可以项相互导入。
    （2）无论是采用import或者是from...import导入，一定是从当前目录执行开始。

05 包的总结
    （1）如果要是 from 包.包.包（执行文件同一个目录，sys.path） import ... 那么 __init__ 可以不用任何操作
    （2）‘.’的左边一定是包
    （3）如果你是 import 包  __init__ 必须要各种写。
    
06 为什么要使用包
    （1）包的本质就是一个文件夹，那么文件夹唯一的功能就是将文件组织起来
    （2）随着功能越写越多，我们无法将所以功能都放到一个文件中，于是我们使用模块去组织功能，而随着模块越来越多，我们就需要用文件夹
        将模块文件组织起来，以此来提高程序的结构性和可维护性
07 包的注意事项
    （1）关于包相关的导入语句也分为import和from ... import ...两种，但是无论哪种，无论在什么位置，在导入时都必须遵循一个原则：
        凡是在导入时带点的，点的左边都必须是一个包，否则非法。可以带有一连串的点，如item.subitem.subsubitem,但都必须遵循这个原则。
        但对于导入后，在使用时就没有这种限制了，点的左边可以是包,模块，函数，类(它们都可以用点的方式调用自己的属性)。
    （2）import导入文件时，产生名称空间中的名字来源于文件，import 包，产生的名称空间的名字同样来源于文件，即包下的__init__.py，
        导入包本质就是在导入该文件
    （3）包A和包B下有同名模块也不会冲突，如A.a与B.a来自俩个命名空间
08 包的使用
    （1）需要注意的是from后import导入的模块，必须是明确的一个不能带点，否则会有语法错误，如：from a import b.c是错误语法。
    （2）‘.'都在from后面才能有，并且'.'的左边只能是包名
    
09 包的应用：
    （1）可以用来模块的分发

10 包的使用： 包的使用之from ... import ...
    （1）需要注意的是from后import导入的模块，必须是明确的一个不能带点，否则会有语法错误，如：from a import b.c是错误语法
  
11 包的使用：from glance.api import *
    （1）在讲模块时，我们已经讨论过了从一个模块内导入所有*，此处我们研究从一个包导入所有*。

    （2）此处是想从包api中导入所有，实际上该语句只会导入包api下__init__.py文件中定义的名字，我们可以在这个文件中定义__all___:

12 绝对导入与相对导入

    （1）绝对导入: 以执行文件的sys.path为起始点开始导入,称之为绝对导入
           优点: 执行文件与被导入的模块中都可以使用
           缺点: 所有导入都是以sys.path为起始点,导入麻烦
    
    （2）相对导入: 参照当前所在文件的文件夹为起始开始查找,称之为相对导入
           符号: .代表当前所在文件的文件加,..代表上一级文件夹,...代表上一级的上一级文件夹
           优点: 导入更加简单
           缺点: 只能在导入包中的模块时才能使用
    　　　　  #注意:
    　　　　　　　　1. 相对导入只能用于包内部模块之间的相互导入,导入者与被导入者都必须存在于一个包内
    　　　　　　　　2. attempted relative import beyond top-level package # 试图在顶级包之外使用相对导入是错误的,言外之意,必须在顶级包内使用相对导入,每增加一个.代表跳到上一级文件夹,而上一级不应该超出顶级包
'''

# 01 删除sys.path中的第二个元素。
import sys
print(sys.path)
sys.path.pop(1)
print(sys.path)

# 02 模块的分发:

import NB as nb
nb.f1()
nb.f2()

nb.f3()
nb.f4()
nb.f5()
nb.f6()
'''
需求描述，将以下模块在不改变调用方式的前提下，修改为3个模块进行保存
# import NB as nb
# nb.f1()
# nb.f2()
# nb.f3()
# nb.f4()
# nb.f5()
# nb.f6()

模块1：
def f1():
    print('f1')


def f2():
    print('f2')
    
模块2：
def f3():
    print('f3')


def f4():
    print('f4')

模块3：
def f5():
    print('f5')


def f6():
    print('f6')
'''

# 新建包，包名为NB。
# 创建模块m1
def f1():
    print('f1')


def f2():
    print('f2')
    
# 创建模块m2
def f3():
    print('f3')

def f4():
    print('f4')
    
# 创建模块m3
def f5():
    print('f5')


def f6():
    print('f6')
    
# 在__init__中添加如下内容：

from NB.m1 import f1,f2  # '.'的左面必须是包，右面可能是包，可能是模块，导入的可能是任意对象，函数、可执行程序、变量等
from NB.m2 import f3,f4
from NB.m3 import f5,f6

'''
通过以上步骤即完成了模块的分发。主要作用如下：
（1）模块不断的完善中会出现较多函数，放在一个py文件下不便于管理，所以需要功能拆分成不同的文件。
（2）不改变原有的调用方式和习惯，保证了使用者者开发习惯。
（3）即使模块的名字变更，直接通过起别名的方式，通过简单的一句代码即可完成模块名字的修改，无需改动代码其他内容。
'''