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 = '[email protected]',
	    url          = 'http://www.devlve.top',
	    description  = 'printlist模块，提供了一个名为printlist()的函数,这个函数的作用是显示列表，其中有可能包含（也可能不包含）嵌套列表。',
	    )

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

运行结果：

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

运行结果：

安装前后文件夹中文件对比：

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

python的所有代码都与一个命名空间关联，主python程序中的代码都与命名空间__main__关联。
python会自动创建与模块同名的命名空间，所以需要使用以下方式调用函数：

		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/*