2018-08-13

模块和包的定义

模块：python中每个文件都是一个独立的模块
       独立的，较少的，功能近似的 多个函数 变量 类型的集合
  模块中的测试代码可以包含在 if __name__ == “__main__”: 
     语句块中，这样不会再其他模块引入时执行这些测试代码
一个标准模块的定义方式【模块名称：见名知意】

包：包含多个python模块文件夹，包含一个__init__.py声明文件
     包含多个模块  具备强大功能的程序
  区别
       包  包含一个__init__.py声明文件[空文件 代码]
文件夹：普通文件夹
 区别： 包可以有效管理模块 文件夹只能作为默认包进行基本管理【包含文件】
   包和文件夹中引入对应的模块代码的操作方式有区别

import 和 from import
包和模块的引入
import
引入一个模块
import 模块名称
#使用模块中的数据
模块名称.变量名称
模块名称.函数名称
模块名称.类型名称

引入一个包

    import 包名称
    # 使用包中的数据
    包名称.模块名称.变量名称/函数名称/类型名称

    # 引入包中的某个模块
    import 包名称.模块名称
    # 使用包中的数据
    包名称.模块名称.变量名称/函数名称/类型名称

    import引入的包和模块会自动从当前文件夹中、
             系统环境变量PYTHONPATH中、
            以及系统的sys.path路径中查询是否存在该名称的包/模块

 from import语法
   # (相对)引入包
   from . import 包名称  [必须在__init__.py中，主动通过from . import引入需要的模块]
   # 使用数据
   包名称.模块名称.变量名称/函数名称/类型名称

   # (相对)引入包中的模块
   from .包名称 import 模块名称
   # 使用数据
   模块名称.变量名称/函数名称/类型名称

   # (相对) 引入包中的模块中的数据
   from .包名称.模块名称 import  变量/函数/类型
   # 使用数据：当成当前文件中的数据进行数据
   变量名称/函数名称/类型名称

    #相对引入 & 绝对引入

相对引入：相对当前文件路径，参照父级文件路径
|-- demo/
    |-- utils.py
    |-- main.py  [from . import utils]

运行：添加参照路径：python -m demo.main
        运行过程中，在main.py中找到相对路径的utils.py

绝对引入：针对包/项目/模块，直接引入的方式
|-- demo/
    |-- users/
        |-- __init__.py
        |-- tools.py
    |-- utils.py
    |- main.py
            [import utils]
            [from users import tools]
            [绝对引入：查询路径]
                [当前文件夹|PYTHONPATH|sys.path]


__all__属性就是用于模糊导入的特殊魔法属性，值是一个包含模块名称的列表，
 主要声明在__init__.py文件中，用于定义可以使用通配符的方式引入的模块

自定义包的发布

 在我们已经开发好的一个包文件夹下，创建一个python模块：setup.py
   模块中定义如下内容：
# 引入构建包信息的模块
from distutils.core import setup
# 定义发布的包文件的信息
setup(
name=“damu”,  # 发布的包文件名称
version=”1.0”,   # 发布的包的版本序号
description=”我的测试包”, # 发布包的描述信息
author=”大牧莫邪”,   # 发布包的作者信息
author_email=”[email protected]”, # 作者联系邮箱信息
py_modules=[‘__init__.py’,’..’,..]# 发布的包中的模块文件列表
)

执行当前程序包文件的构建操作命令:按照标准格式组织包中的所有数据文件

 python setup.py build
  REMARK:构建完毕的文件
   可以通过python setup.py install命令直接当成第三方模块进行安装

 执行命令进行包的打包发布
      python setup.py sdist

执行打包命令
  python setup.py sdist

  首先安装第三方模块:twine，用于上传我们打包的项目文件
  pip install twine
  上传项目
    twine upload dist/*

此时，如果我们还需要我们自己开发的某个模块的话，
    直接通过pip命令安装即可
        pip install 文件名