python小练习--模块与包

练习1：模块设置的初体验

1. __doc __打印出模块或其函数的功能描述

设计出的模块：命名为mymodule01

"""
本模块用于计算公司员工的薪资
"""

company = "Clichong"

def yearsalary(monthsalary):
    """根据传入的月薪，计算出年薪"""
    return monthsalary*12

def daysalary(monthsalary):
    """根据出入的月薪，计算出日薪"""
    return monthsalary/12

测试代码：

import mymodule01
import math

#测试自定义的模块
print(mymodule01.__doc__)
print(mymodule01.yearsalary.__doc__)
print(mymodule01.daysalary.__doc__)

#测试第三方库模块
print(math.cos.__doc__)
print(math.acos.__doc__)

结果：

2. __name __可以获取模块的名称

"""
本模块用于计算公司员工的薪资
"""

company = "Clichong"

def yearsalary(monthsalary):
    """根据传入的月薪，计算出年薪"""
    return monthsalary*12

def daysalary(monthsalary):
    """根据出入的月薪，计算出日薪"""
    return monthsalary/12

print(yearsalary.__name__)
print(__name__)

#可以自定义测试函数
if __name__ == "__main__":
    print(yearsalary(10000))
    print(daysalary(10000))

另外调用模块：

import mymodule01
import math

print(math.__name__)
print(mymodule01.__name__)
print(mymodule01.daysalary.__name__)

再调用模块的时候，会全部执行代码，包括两条打印语句。而__name __在测试文件里面的名称就不是 __ main__了，而是变成了模块的名称mymodule01

3. import导入问题与importlib模块

import 语句的基本语法格式如下：
import 模块名 #导入一个模块
import 模块 1，模块 2… #导入多个模块
import 模块名 as 模块别名 #导入模块并使用新名字
from 模块名 import 成员 1，成员 2，…

#自定义导入模块名
from mymodule01 import daysalary as dd
from math import cos

#动态导入测试
import importlib

print(cos.__name__)
print(my.__name__)
print(dd.__name__)

s = "math"
Clichong = importlib.import_module(s)
print(Clichong.pi)

一般来说，模块只能被导入一次不能多次导入，而有时候我们确实需要重新加载一个模块，这时候可以使用：importlib.reload()

练习2：包package的使用

1.包的导入

1. import a.aa.module_AA
   在使用时，必须加完整名称来引用，比如：a.aa.module_AA.fun_AA()
2. from a.aa import module_AA
   在使用时，直接可以使用模块名。 比如：module_AA.fun_AA()
3. from a.aa.module_AA import fun_AA 直接导入函数
   在使用时，直接可以使用函数名。 比如：fun_AA()

ps：
1） from package import item 这种语法中，item 可以是包、模块，也可以是函数、
类、变量。
2）import item1.item2 这种语法中，item 必须是包或模块，不能是其他。

导入包的本质其实是“导入了包的__init__.py”文件。也就是说，”import pack1”意味着执行了包 pack1 下面的__init__.py 文件。 这样，可以在__init __.py 中批量导入我们需要的模块，而不再需要一个个导入。
__init __.py 的三个核心作用：

1. 作为包的标识，不能删除。
2. 用来实现模糊导入
3. 导入包实质是执行__init__.py 文件，可以在__init__.py 文件中做这个包的初始化、以及
   需要统一执行代码、批量导入。

2.包内引用

from … import module_A #…表示上级目录 .表示同级目录
from . import module_A2 #.表示同级目录

练习3：sys模块搜索路径

当我们导入某个模块文件时， Python 解释器去哪里找这个文件呢？只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件（按照顺序寻找，找到即停不继续往下寻找）：

1. 内置模块
2. 当前目录
3. 程序的主目录
4. pythonpath 目录（如果已经设置了 pythonpath 环境变量） #永久有效
5. 标准链接库目录
6. 第三方库目录（site-packages 目录）
7. .pth 文件的内容（如果存在的话） #永久有效
8. sys.path.append()临时添加的目录 #只对当前程序有效

查看当前搜索路径：

import sys
#sys.path.append( "d:/")	#动态添加环境变量
print(sys.path)

结果如下：

['E:\\PyCharm\\workspace\\myImport', 'E:\\PyCharm\\workspace\\myImport', 'E:\\PyCharm\\PyCharm 2019.3.3\\plugins\\python\\helpers\\pycharm_display', 'E:\\PyCharm\\workspace\\myImport\\venv\\Scripts\\python37.zip', 'E:\\python\\python3.7\\DLLs', 'E:\\python\\python3.7\\lib', 'E:\\python\\python3.7', 'E:\\PyCharm\\workspace\\myImport\\venv', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages\\setuptools-40.8.0-py3.7.egg', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages\\pip-19.0.3-py3.7.egg', 'E:\\PyCharm\\PyCharm 2019.3.3\\plugins\\python\\helpers\\pycharm_matplotlib_backend']

1.pythonpath 环境变量的设置

可以看见已建好

2.·.pth 文件环境变量的设置

E:\python\python3.7\Lib\site-packages目录下添加.pth 文件。并在文件中增加内容。

练习4：模块本地的发布安装操作

1.模块本地发布

1. 为模块文件创建如下结构的文件夹（一般，文件夹的名字和模块的名字一样）
   
2. 在文件夹中创建一个名为『setup.py』的文件，内容如下：

from distutils.core import setup
setup(
name='mypackage', # 对外我们模块的名字
version='1.1.1', # 版本号
description='这是第一个描述，用于测试本地包的发布', #描述
author='Clichong', # 作者
author_email='1234567890@qq.com',
py_modules=['mypackage.module01','mypackage.module02'] # 要发布的模块,还有一个不发布
)

3. 构建一个发布文件。通过终端，cd 到模块文件夹 c 下面，再键入命令：
   
   命令为：

python setup.py sdist

执行完毕后，目录结构变为：

2.模块本地安装

1. 将发布安装到你的本地计算机上。仍在 cmd 命令行模式下操作，进 setup.py 所在目录，键入命令

python setup.py install

2. 安装成功后，我们进入 python 目录/Lib/site-packages 目录（第三方模块都安装的这里,python 解释器执行时也会搜索这个路径）

使用测试：


成功！

练习5：上传模块到 PyPI

参考链接：官方文档

1. 注册 PyPI 网站：http://pypi.python.org
2. 创建用户信息文件 .pypirc
   在用户的家目录里创建一个文件名为.pypirc, 内容为：

[distutils]
index-servers=pypi
[pypi]
repository = https://upload.pypi.org/legacy/
username = 账户名
password = 你自己的密码

【注】
Linux 的家目录： ~/.pypirc
Windows 的家目录是： c:/user/用户名
在 windows 下直接创建不包含文件名的文件会失败，因此创建时文件名为“.pypirc.”，
前后都有两个点即可。

3. 上传并远程发布
   进入 setup.py 文件所在目录，使用命令“python setup.py sdist upload”，即可以将模块代码上传并发布
4. 如果你的模块已经上传成功，那么当你登录 PyPI 网站后应该能在右侧导航栏看到管理入口。点击包名进去后你可以对你的模块进行管理，当然你也可以从这里删除这个模块。