百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

Python包版本表示趣谈(python所有版本)

itomcoil 2025-03-19 13:37 10 浏览

Python包版本表面上看起来很简单,但是同一般业界通用的定义良好的版本方案却不一样,有点诡异。比如正常的版本表示都为SemVer 1.2.3或CalVer 2023.6.1,有时候还有带预发布版本后缀的,比如1.2.3pre1。但是Python包版本控制可能会有些不一样,本文虫虫就给大家介绍一些python包的版本管理。

概述

由于 Python 版本的复杂性,本文应作为不将Python版本作为简单字符串处理的原因列表。而是使用官方packaging.version.Version类。该类可以解析、比较和推理Python版本

PEP440的Python包版本的当前最新的标准。基于PEP440的规定,目前绝大多数的Python包(大概97%软件包)都使用这种方式。

Python包版本由最6种类型的“版本部分”组成。其中一个是必需的“Release”部分和3个常见的可选部分,分别称为“Pre-releases”、“Post-releases”和“Dev”。 其余2个可选且不太常见的部分是“Epoch”和“Local”版本部分。下面的图表显示了版本部分的所有类型、它们的排序方式以及分隔符是什么:

v前缀

任何版本号都可以以v前缀可选的开头。该字符在规范化过程中会被剥离,并且不携带有关版本的任何进一步数据。

__version__ = "v1.0" # 规范化为 '1.0'

Epoch版本

Epoch版本即日期纪元为包提供了一种更改其版本控制方案的方法,而无需承担过去版本控制的负担影响哪个版本将被视为“最新”的方案。 例如,如果项目使用大量第一个发行版本段可能会很笨重,然后使用更大的数字来“摆脱”之前的版本控制方案。

根据PEP440:

特别是,支持版本纪元允许之前使用基于日期的版本控制的项目通过指定新版本纪元切换到语义版本控制。

Local版本

local 本地版本是由字母数字和句点组成的任意标识符,位于“release”之后。本地版本没有任何预定义的语义,但通常用于区分上游版本来自下游集成商可能改变的重建。

本地版本“段”可以通过以下方式分隔 ., -,或者_但所有这些字符都会规范化为.:

__version__ = "1.0.0+ubuntu-1" # 规范化为'1.0.0+ubuntu.1'

注意:本地版本也无法上传到PyPI,该服务将拒绝它们:


PEP 中明确指出了这种行为:

由于Python包索引仅用于索引和托管上游项目,因此它不得允许使用本地版本标识符。

版本长度

PEP 440没有定义版本号的最大长度,所以可以是任意长度。例如,有的包使用了pi的前217位作为其版本号。

大小写

版本号都会被规范化为小写:

__version__ = "V1.0.0-RC0" # 规范化为'1.0.0rc0'

Pre-post-dev发布

Pre、post和dev版本部分并不是唯一的,可以将所有三个版本合并为一个,比如:

__version__ = "1.0.0-pre0-post0-dev0"

分隔符

Pre、post和dev版本部分都有一个可选的分隔符(-, _,或者.),这些部分可以组合在一起,而无需任何字符将它们分开,可以拥有包含所有三个的版本:

__version__ = "0previewpostdev" # 规范化为0rc0.post0.dev0

和“rc“相似的”cr”也是一个有效的版本标识符,但是两者意思完全,因为c表示预发布,但是r表示发布后:

比如

__version__ = "1.0.0rc1"

__version__ = "1.0.0cr1" # 规范化为 '1.0.0.rc0.post1'

分隔符规范化

alpha、beta、候选版本后缀在没有分隔符的情况下进行规范化,但post和开发版本后缀则使用分隔符进行规范化:

__version__ = "1.0.0-alpha0" # --> 1.0.0a0
__version__ = "1.0.0-beta" # --> 1.0.0b0
__version__ = "1.0.0-rc0" # --> 1.0.0rc0
__version__ = "1.0.0post0" # --> 1.0.0.post0
__version__ = "1.0.0dev0" # --> 1.0.0.dev0

隐式post

有连字符分隔符“-”并且任何release版本后面的数字相当于post:

__version__ = "0-0" # 规范化为'0.post0'

隐式零

版本1.0和1.0.0表示不同的版本号。 Release部分会自动将缺少的版本段添加零,以便两者比较相同的值。

所以可以在版本后添加大量零, pip可以很好地自动处理它:

数值归一化

所有整数均通过int()内置意味着它们将规范化,去掉前缀零无,成无错误的整数:

__version__ = "01.001.0000" # 规范化'1.1.0'

PEP440之前版本的不明确解析

PEP 440 于2014年才生效,在此之前已经发布了很多Python包了,对版本的PEP440规则的追溯应用可能会导致源发行版出现一些不明确的解析情况。

Wheel编译版本

Wheel编译版本号是一个与版本号非常相似的功能,并且仅适用于Wheel发行版。 当两个包具有相同的名称、版本、平台、Python 和ABI标签时,这个版本号将用来区分比较两个版本。

从PEP 427开始,内部版本号位于Wheel文件名中的名称和版本之后:

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

所以可以拥有两个具有相同名称、版本和标签但仍不相同的发行版到Wheel版本号。除了锁定文件中的版本之外,固定哈希值也很重要的又一个原因。

综上,dist名称为0可以对应有一个名为 0-0-0-0-py3-any-none.whl的文件

0-0-0-0-py3-any-none.whl
^ ^ ^ ^
| | | |
| | | +- build number
| | +- post-release
| +- version
+- name

相关推荐

第十章:优化设计与自动化工作流(优化设计是)

以下重点讲解优化设计、自动化脚本编写以及与其他工具(如Python、优化算法库)的集成,提升CFD仿真的工程应用效率。目标:掌握参数化扫描、优化算法集成和批量任务管理,实现从单次模拟到自动化设计探索的...

安装python语言,运行你的第一行代码

#01安装Python访问Python官方(https://www.python.org/),下载并安装最新版本的Python。确保安装过程中勾选“Addpython.exetoPAT...

Python安装(python安装的库在哪个文件夹)

Windows系统1.安装python1.1下载Python安装包打开官方网站:https://www.python.org/downloads/点击"DownloadPython3.1...

比pip快100倍的Python包安装工具(python2.7.5安装pip)

简介uv是一款开源的Python包安装工具,GitHubstar高达56k,以性能极快著称,具有以下特性(官方英文原文):Asingletooltoreplacepip,pip-tool...

【跟着豆包AI学Python】Python环境的安装,编写第一个程序

最近几年,人工智能越来越走进人们的日常生活,国内各大公司都推出了自己的AI助手,例如:阿里旗下的通义千问、百度旗下的文心一言、腾讯的腾讯元宝、深度求索的deepseek等,元宝就是字节跳动公司推出的A...

Python3+ 变量命名全攻略:PEP8 规范 + 官方禁忌...

Python3+变量命名规则与约定详解一、官方命名规则(必须遵守)1.合法字符集变量名只能包含:大小写字母(a-z,A-Z)数字(0-9)下划线(_)2.禁止数字开头合法:user_age,...

Python程序打包为EXE的全面指南:从入门到精通

引言在Python开发中,将程序打包成可执行文件(EXE)是分发应用程序的重要环节。通过打包,我们可以创建独立的可执行文件,让没有安装Python环境的用户也能运行我们的程序。本篇文章将详细介绍如何使...

别再纸上谈兵了!手把手教你安装GraalVM,让你的代码瞬间起飞!

各位老铁们,是不是每次看到我吹嘘GraalVM的各种神迹,心里都痒痒的?想让自己的Java程序秒启动?想让Python脚本跑得比平时快好几倍?想体验一把多语言无缝协作的快感?但一想到要下载、配置、敲命...

纠结坏了!从 Python 3.8 升级到 3.14 真有必要吗?

点赞、收藏、加关注,下次找我不迷路"我电脑里装的Python3.8,现在都出3.14了,要不要赶紧升级啊?会不会像手机系统更新一样,越升级越卡?"相信很多刚入门的朋友都有类...

win10下python3.13.3最新版本解释器的下载与安装

一、python3.13.3下载官方下载地址:https://www.python.org/1.浏览器访问https://www.python.org/这个地址,进入python的网站,点击【Dowl...

Python简介与开发环境搭建详细教程

1.1Python简介与开发环境搭建详细教程一、Python语言简介1.Python的核心特点2.Python的应用领域表1.1Python主要应用领域领域典型应用常用库Web开发网站后端D...

python开发小游戏案例(python游戏开发入门经典教程)

#头条创作挑战赛#假设你正在开发一个小型游戏,需要实现角色移动、障碍物生成、碰撞检测等功能。你可以使用Python和Pygame库来开发这个游戏。输入以下命令来安装Pygame:pipinstall...

Python编程:从入门到实践 第十一、二 章 武装飞船

假设我们有一个名为AnonymousSurvey的类,用于收集匿名调查的答案。该类包含以下方法:classAnonymousSurvey:def__init__(self,questi...

「Python系列」python几个重要模块的安装(二)

一、python的pygame的安装:安装地址:https://www.cnblogs.com/charliedaifu/p/9938542.htmlpyagme包下载地址:https://down...

python如何绘制消消乐小游戏(python字母消消乐)

要开发一款消消乐的小游戏界面,我们可以使用Python的pygame库。首先需要安装pygame库,然后创建一个窗口,加载游戏素材,处理游戏逻辑,以及绘制游戏界面。以下是一个简单的消消乐游戏界面实现:...