Python wheel文件的详细介绍_F11 - 专业站长和开发者的学习网站

分享到

Python wheel文件的详细介绍

python 来源：互联网作者：佚名发布时间：2022-09-24 12:13:45 人浏览

摘要

1. wheel介绍 .whl文件(WHL file)也称为轮子(wheel)，这是用于python分发(distribution)的标准内置包格式(standard built-package format)。它包含安装所需的所有文件和元数据(metadata)。.whl文件使用zip进行

1. wheel介绍

.whl文件(WHL file)也称为轮子(wheel)，这是用于python分发(distribution)的标准内置包格式(standard built-package format)。它包含安装所需的所有文件和元数据(metadata)。.whl文件使用zip进行压缩。.whl文件还包含有关此wheel文件支持的Python版本和平台的信息。.whl文件格式是一种即装即用格式(ready-to-install format)，允许在不构建源代码分发(without building the source distribution)的情况下运行安装包。

.whl文件本质上是zip文件，这些.whl文件可以使用解压缩选项(unzip option)或标准解压缩软件应用程序(如WinZIP和WinRAR)解压缩。

.whl文件按照以下约定命名：

{dist}-{version}(-{build})?-{python.version}-{abi}-{platform}.whl

如果我们之前使用pip安装过Python包，那么我们的系统上很可能已经有轮子(wheel)被安装过。pip是安装wheel的包管理器。

我们可以通过pip安装已下载的.whl文件：pip install <filename>.whl ，安装包后，我们可以执行Python shell并尝试导入包：import whl_dist_name

wheel的直接好处是我们与其他人共享我们的包，他们不必担心构建它。他们只需pip install后即可使用该软件包。它也是一个更小的共享文件(与所有源代码相比)，安装速度更快，因为它不需要运行安装脚本。

2. wheel的类型

(1).universal wheel：包含py2.py3-none-any.whl。它在任何操作系统和平台上都支持Python 2和Python 3。

(2).pure-python wheel：包含py3-none-any.whl或py2-none-any.whl。它支持Python 3或Python 2，但不能同时支持两者。它在其它方面与universal wheel相同，但它会被标记为py2或py3而不是py2.py3标签。

(3).platform wheel：支持特定的Python版本和平台。

3. 创建wheel

(1).将所有模块(python脚本)、包(包含模块的文件夹/目录)保存在父目录中。随意命名根目录，通常与项目相关。

(2).最好创建一个空的名为__init__.py文件，并将此__init__.py文件放在所有包目录和子包目录下。无需将其保存在根目录中。

(3).创建一个名为setup.py的文件并将其放在根目录中。此脚本的内容至少应包括：distribution name, version number, and list of package names

(4).转到你可以运行python和pip命令的命令提示符。在命令提示符下更改目录并导航到放置setup.py的项目的根目录，执行以下命令：扩展名为.whl的文件将在根目录下自动创建的子目录中创建，名为dist。

wheel中并不包含setup.py，wheel不必运行setup.py脚本。

注：需提取安装wheel setuptools: pip install wheel setuptools，在conda中默认是安装的

python setup.py bdist_wheel --universal # universal wheel
python setup.py bdist_wheel # pure-Python wheel

这里通过conda在虚拟环境base下创建一个wheel，取名为testwheel目录组织结构如下所示：

setup.py内容如下：

import setuptools

setuptools.setup(

name="testwheel",

version="1.0.0",

author="fengbingchun",

author_email="fengbingchun@163.com",

description="test wheel",

packages=setuptools.find_packages(),

url="https://github.com/fengbingchun",

license="MIT",

python_requires=">=3.8"

)

testwheel目录下的__init__.py是个空文件，math目录下的__init__.py内容如下：

1 2	from .math_add import * from .math_sub import *

math_add.py内容如下：

def add3(a, b, c):

print("call add operation: three parameters ...")

return (a+b+c)

def add2(a, b):

print("call add operation: two parameters ...")

return (a+b)

math_sub.py内容如下：

def sub3(a, b, c):

print("call sub operation: three parameters ...")

return (a-b-c)

def sub2(a, b):

print("call sub operation: two parameters ...")

return (a-b)

执行如下命令生成wheel，此wheel仅限于在Python3上执行，将终端定位到setup.py目录下

执行完上述命令后会产生3个新的目录，build, dist, testwhell.egg-info，各个目录的内容如下所示，生成的whell在dist目录下，全名为testwheel-1.0.0-py3-none-any.whl，只需将此文件分发出去，其他人安装后即能使用。

4. 导入使用wheel

如果你想在项目中安装已经安装过的wheel文件，需要更新此wheel的版本号。如果版本号保持不变，pip将不会安装它。或者先卸载已安装的whell: pip uninstall testwheel

通过conda新建一个虚拟环境testwheel，用来测试上面生成的testwheel-1.0.0-py3-none-any.whl，将终端定位到其它的test目录下，并将生成的wheel文件拷贝到此目录下，安装，执行结果如下图所示：

会将此wheel安装到anaconda3/envs/testwheel/lib/python3.8/site-packages/目录下，如下图所示：

在tmp下添加一个test.py文件，用于测试wheel，内容如下：

from testwheel.math import math_add, math_sub

a, b, c = 10, 5, 2

print("add3:", math_add.add3(a, b, c))

print("add2:", math_add.add2(a, b))

print("sub3:", math_sub.sub3(a, b, c))

print("sub2:", math_sub.sub2(a, b))

print("test finish")

执行结果如下所示：可见正确的调用了wheel中的接口

如果需要反复的调整wheel的内容，需要反复的测试，又不想修改version number，一种方法是可先卸载已安装的wheel，然后再次安装新的wheel，如下图所示：也可使用--force-reinstall

GitHub传送门

您可能感兴趣的文章 :

原文链接 : https://blog.csdn.net/fengbingchun/article/details/126910333

Tag : python(762)

Python Django教程之实现新闻应用程序

Django是一个用Python编写的高级框架，它允许我们创建服务器端Web应用程序。在本文中，我们将了解如何使用Django创建新闻应用程序。我们将
书写Python代码的一种更优雅方式(推荐!)

一些比较熟悉pandas的读者朋友应该经常会使用query()、eval()、pipe()、assign()等pandas的常用方法，书写可读性很高的「链式」数据分析处理代码
Python灰度变换中伽马变换分析实现

1. 介绍伽马变换主要目的是对比度拉伸，将图像灰度较低的部分进行修正伽马变换针对的是对单个像素点的变换，也就是点对点的映射形
使用OpenCV实现迷宫解密的全过程

一、你能自己走出迷宫吗？如下图所示，可以看到是一张较为复杂的迷宫图，相信也有人尝试过自己一点一点的找出口，但我们肉眼来解谜
Python中的数据精度问题的介绍

一、python运算时精度问题 1.运行时精度问题在Python中（其他语言中也存在这个问题，这是计算机采用二进制导致的），有时候由于二进制和
Python随机值生成的常用方法

一、随机整数 1.包含上下限：[a, b] 1 2 3 4 import random #1、随机整数：包含上下限：[a, b] for i in range(10): print(random.randint(0,5),end= | ) 查看运行结
Python字典高级用法深入分析讲解

一、 collections 中 defaultdict 的使用 1.字典的键映射多个值将下面的列表转成字典 l = [(a,2),(b,3),(a,1),(b,4),(a,3),(a,1),(b,3)] 一个字典就是一个键对
Python浅析多态与鸭子类型使用实例

什么多态：同一事物有多种形态为何要有多态=》多态会带来什么样的特性，多态性多态性指的是可以在不考虑对象具体类型的情况下而直
Python字典高级用法深入分析介绍

一、 collections 中 defaultdict 的使用 1.字典的键映射多个值将下面的列表转成字典 l = [(a,2),(b,3),(a,1),(b,4),(a,3),(a,1),(b,3)] 一个字典就是一个键对
Python淘宝或京东等秒杀抢购脚本实现(秒杀脚本

我们的目标是秒杀淘宝或京东等的订单，这里面有几个关键点，首先需要登录淘宝或京东，其次你需要准备好订单，最后要在指定时间快速