python的模块与发布

1、模块
模块就是一个包含Python代码的文本文件。对模块的主要需求就是要求文件名以.py结尾，这是python扩展名。要把你的函数转换为一个模块，需要把代码保存到一个适当命名的文件中.

2、发布
为了共享新创建的这个模块，需要准备一个发布。发布工具允许将模块转换为可共享的包，在Python中，所谓“发布”(distribution)是指一个文件集合，这些文件联合在一起允许你构建、打包和发布你的模块。
一旦发布存在，就可以把模块安装到你的Python本地副本上，还可以把模块上传到PyPI与全世界共享。按照下面两页给出的流程，为你的模块创建一个发布。

Step1：创建文件夹，将XXX.py模块文件复制到这个文件夹中

Step2：在文件夹中创建setup.py文件，增加如下代码

    from distutils.core import setup        #从python发布工具导入setup函数
    
    setup(
        name         = 'printlist',                    # 包名
        version      = '3.0.0',                        # 版本号
        py_modules   = ['printlist'],                  # 模块名（即.py的文件名）
        author       = 'sonia',
        author_email = 'sonia_du@163.com',
        url          = 'http://www.devlve.top',
        description  = 'printlist模块，提供了一个名为printlist()的函数,这个函数的作用是显示列表，其中有可能包含（也可能不包含）嵌套列表。',
        )

Step3：在文件夹中运行cmd，键入python setup.py sdist，构建一个发布文件
运行结果：

image.png

Step4：python setup.py install，将发布安装到本地副本中
运行结果：

image.png

Step5：测试调用模块，使用模块中包含的函数

        import 模块名
        模块名.函数名()

Step6：上传发布
方法一：
1、使用python setup.py register注册并验证包，最简单但官网不推荐，因为使用的是HTTP未加密，有可能会被攻击人嗅探到你的密码。
2、使用python setup.py sdist upload上传包。
方法二:
1、通过PyPI网站提交表单完成注册验证。安装 pip install twine 然后在通过命令 twine register dist/mypkg.whl 完成注册。
2、使用 twine： twine upload dist/*