Python为我们提供了非常丰富的模块包,或者叫类库;我们可以通过Python的命令【pip】从官方的网站PYPI【 https://pypi.org / http://pypi.python.org 】上获取它们。

每个人都可以在PYPI上发布自己创建的模块包;
在下面的章节里,我会详细的演示如何将自己的Python项目打包,并且发布到PYPI上。

本文以前面自己编写的Python的配置文件++的脚本为例:
https://gitee.com/leviathan-litan/python_config_file_plus

本文中所涉及到的代码与文件,都上传到了GITEE:
https://gitee.com/leviathan-litan/how-to-upload-code-to-python-pypi


进入项目所在目录,并使用【pip】,安装模块包支持:
1. wheel
2. setuptools

具体如下:


编辑模块包目录:

可以看到,我的模块包目录是:【D:\python_pypa_data\python_configparser++】
在这个模块包目录中,包含了一个源码目录:【D:\python_pypa_data\python_configparser++\src】

下面,分别介绍其中包含的文件及其意义。

源码目录:
1. configparser_plus.py:为我的模块包的主体代码
2. __init__.py:构造函数 | 目的是为了告诉别人,你的模块包叫什么名字

文件:configparser_plus.py:

文件:__init__.py:

接下来是:【模块包目录】中的几个文件:
1. LICENSE | 授权方式的说明文件,声明你的源码可以用什么方式被分享,是否可以商用,等等信息
2. README.md | 模块包的说明文件,告诉用户或者其他的开发者,你所编写的这个模块包有什么用处、怎么使用、解决了什么问题,… 等等
3. setup.py | 让setuptools工具,知道有关模块包的一些信息,诸如:名称、版本、作者、模块包依赖关系,… 等等

文件:LICENSE

文件:README.md

文件:setup.py


升级:setuptools / wheel


生成分发包文件:

可以看到,创建了一个目录【dist】,其中,包含了PYPI所需要的分发包文件。


在PYPI上注册一个用户:
https://pypi.org/account/register/

这一部分不做过多的描述,直接注册就好。


安装模块包:twine


然后,通过【twine】执行上传:

可以看到,已经上传好了。

访问网站:
https://pypi.org/project/configparser-plus/

然后,在PYPI的用户页面也可以管理你上传的所有的模块包:


接下来,另建一个项目,然后用我刚刚上传的这个模块包解析一下包含操作系统命令的配置文件,以此来体验一下使用自己的模块包的方式。

安装自建模块包【configparser_plus】:

配置文件:config.cfg

Python代码:

执行结果:

可以看到,通过自定义的模块包解析配置文件的操作,成功完成。


Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

隐藏
变装