Python打包模块wheel的使用方法与将python包发布到PyPI的方法详解
wheel文件
Wheel和Egg都是python的打包格式，目的是支持不需要编译或制作的安装过程，实际上也是一种压缩文件，将.whl的后缀改为.zip即可可看到压缩包里面的内容。按照官网说法，wheels是发行版Python的新标准并且要取代.egg。
Egg格式是由setuptools在2004年引入，而Wheel格式是由PEP427在2012年定义。Wheel现在被认为是Python的二进制包的标准格式。
以下是Wheel和Egg的主要的不同点：
Wheel有一个官方的PEP427来定义，而Egg没有PEP定义。
Wheel是一种分发格式，即打包格式。而Egg既是一种分发格式，也是一种运行时安装的格式，并且是可以被import的。
Wheel文件不会包含.pyc文件
Wheel使用和PEP376兼容的.dist-info目录，而Egg使用.egg-info目录。
Wheel有着更丰富的命名规则。
Wheel是有版本的，每个Wheel文件都包含wheel规格的版本和打包它的实现。
Wheel在内部被sysconfigpathtype管理，因此转向其他格式也更容易。
distutils和setuptools工具
用来Python环境中构建和安装额外的模块，模块可以基于Python，也可以C/C++写的扩展模块，可以是python包，包中包含了C和Python编写的模块。
setuptools是PythonEnterpriseApplicationKit(PEAK)的一个副项目,它是一组Python的distutilsde工具的增强版(适用于Python2.3.5以上的版本,64位平台则适用于Python2.4以上的版本),可以让程序员更方便的创建和发布Python包,特别是那些对其它包具有依赖性的状况。
setuptools重点在于setup.py文件编写：
setup.py参数介绍：
name:打包起来的包的文件名
version:版本号,添加为打包文件的后缀名
author:作者
author_email:作者的邮箱
py_modules:打包的.py文件
packages:打包的python文件夹
include_package_data:项目里会有一些非py文件,比如html和js等,这时候就要靠include_package_data和package_data来指定了。package_data:一般写成{‘your_package_name':[“files”]},include_package_data还没完,还需要修改MANIFEST.in文件.MANIFEST.in文件的语法为:includexxx/xxx/xxx/.ini/(所有以.ini结尾的文件,也可以直接指定文件名)
license:支持的开源协议
description:对项目简短的一个形容
ext_modules:是一个包含Extension实例的列表,Extension的定义也有一些参数。
ext_package:定义extension的相对路径
requires:定义依赖哪些模块
provides:定义可以为哪些模块提供依赖
data_files:指定其他的一些文件(如配置文件),规定了哪些文件被安装到哪些目录中。如果目录名是相对路径,则是相对于sys.prefix或sys.exec_prefix的路径。如果没有提供模板,会被添加到MANIFEST文件中。
将python文件(.py)封装成可安装使用的模块
参考：https://docs.python.org/3.6/distutils/introduction.html#distutils-simple-example
printtest.py
deftest():
print('printtest')
将以上.py文件做成python模块，需要在相同目录下创建setup.py文件，setup.py中输入配置信息:
fromsetuptoolsimportsetup setup(name='printtest', version='1.0', py_modules=['printtest'], )
打开终端，定位到该文件夹下，输入：
pythonsetup.pysdist
此时在目录中生成dist文件夹，文件夹中有testpg-1.0.tar.gz文件，用户安装的话只需要testpg-1.0.tar.gz文件即可。
将此文件解压得到testpg-1.0文件夹，会发现该文件夹有我们刚刚书写的3个py文件，还有一个PKG-INFO，打开该文件，会显示该模块的具体信息：由于我们没有设置，所以为UNKOWN
Metadata-Version:1.0
Name:printtest
Version:1.0
Summary:UNKNOWN
Home-page:UNKNOWN
Author:UNKNOWN
Author-email:UNKNOWN
License:UNKNOWN
Description:UNKNOWN
Platform:UNKNOWN
终端定位到此文件夹下，输入以下命令，模块将会被安装到解释器对应的Lib/site-packages目录下：
pythonsetup.pyinstall
安装后，会发现Lib/site-packages目录下存在printtest.py文件和printtest-1.0-py3.6.egg-info
应用：
importprinttest printtest.test()
输出：
printtest
封装Python包
导入单个Python文件时成为Python模块，而包含多个Python文件的文件夹成为一个Python包。本节主要讲述怎样封装一个Python包。
1.创建一个文件夹，将需要封装的pagtest文件夹（里面为.py文件，需要包括一个__init__.py文件，内容可以为空）放到该文件夹中，然后创建setup.py文件对包进行配置：
fromsetuptoolsimportsetup
setup(name='pagtest',
version='1.0.0',
description='AprinttestforPyPI',
author='winycg',
author_email='win@163.com',
url='https://www.python.org/',
license='MIT',
keywords='gann',
project_urls={
'Documentation':'https://packaging.python.org/tutorials/distributing-packages/',
'Funding':'https://donate.pypi.org',
'Source':'https://github.com/pypa/sampleproject/',
'Tracker':'https://github.com/pypa/sampleproject/issues',
},
packages=['pagtest'],
install_requires=['numpy>=1.14','tensorflow>=1.7'],
python_requires='>=3'
)
2.创建README.txt文件用于对文件的安装以及使用信息做描述
3.目前文件夹的目录的架构为：
pagtest/
__init__.py
print1.py
print2.py
setup.py
README.txt
输入以下命令进行打包，制作sourcedistribution（源代码发布包），此命令将会把所有内容在dist/目录打包为pagtest-1.0.0.tar.gz
pythonsetup.pysdist
4.上传到PyPI上。上传时，可以建立一个账户验证文件~/.pypirc（Windows不可以，因为文件命名中含有非法字符），也可以在上传时输入账户和密码。
[distutils]
index-servers=pypi
[pypi]
repository=https://upload.pypi.org/legacy/
username=
password=
5.将命令行定位到此文件夹下，输入命令对dist目录下的pagtest-1.0.0.tar.gzt包进行上传，twine为Python包需要安装：
twineuploaddist/*
制作python包为wheel文件
wheel是一个已经编译好的包，在安装时不需要编译过程，安装whl文件时要比发布的源文件安装要快。
在如上第2步后，输入如下命令即可在生成.whl
pythonsetup.pybdist_wheel
.whl文件在dist目录下，上传到PyPI：
twineuploaddist/*
更新Python包
修改setup.py中的版本号，然后直接上传即可
更多关于Python打包模块wheel的使用方法请查看下面的相关链接
声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。