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

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

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

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

相关推荐

selenium(WEB自动化工具)

定义解释Selenium是一个用于Web应用程序测试的工具。Selenium测试直接运行在浏览器中,就像真正的用户在操作一样。支持的浏览器包括IE(7,8,9,10,11),MozillaF...

开发利器丨如何使用ELK设计微服务中的日志收集方案?

【摘要】微服务各个组件的相关实践会涉及到工具,本文将会介绍微服务日常开发的一些利器,这些工具帮助我们构建更加健壮的微服务系统,并帮助排查解决微服务系统中的问题与性能瓶颈等。我们将重点介绍微服务架构中...

高并发系统设计:应对每秒数万QPS的架构策略

当面试官问及"如何应对每秒几万QPS(QueriesPerSecond)"时,大概率是想知道你对高并发系统设计的理解有多少。本文将深入探讨从基础设施到应用层面的解决方案。01、理解...

2025 年每个 JavaScript 开发者都应该了解的功能

大家好,很高兴又见面了,我是"高级前端进阶",由我带着大家一起关注前端前沿、深入前端底层技术,大家一起进步,也欢迎大家关注、点赞、收藏、转发。1.Iteratorhelpers开发者...

JavaScript Array 对象

Array对象Array对象用于在变量中存储多个值:varcars=["Saab","Volvo","BMW"];第一个数组元素的索引值为0,第二个索引值为1,以此类推。更多有...

Gemini 2.5编程全球霸榜,谷歌重回AI王座,神秘模型曝光,奥特曼迎战

刚刚,Gemini2.5Pro编程登顶,6美元性价比碾压Claude3.7Sonnet。不仅如此,谷歌还暗藏着更强的编程模型Dragontail,这次是要彻底翻盘了。谷歌,彻底打了一场漂亮的翻...

动力节点最新JavaScript教程(高级篇),深入学习JavaScript

JavaScript是一种运行在浏览器中的解释型编程语言,它的解释器被称为JavaScript引擎,是浏览器的一部分,JavaScript广泛用于浏览器客户端编程,通常JavaScript脚本是通过嵌...

一文看懂Kiro,其 Spec工作流秒杀Cursor,可移植至Claude Code

当Cursor的“即兴编程”开始拖累项目质量,AWS新晋IDEKiro以Spec工作流打出“先规范后编码”的系统工程思维:需求-设计-任务三件套一次生成,文档与代码同步落地,复杂项目不...

「晚安·好梦」努力只能及格,拼命才能优秀

欢迎光临,浏览之前点击上面的音乐放松一下心情吧!喜欢的话给小编一个关注呀!Effortscanonlypass,anddesperatelycanbeexcellent.努力只能及格...

JavaScript 中 some 与 every 方法的区别是什么?

大家好,很高兴又见面了,我是姜茶的编程笔记,我们一起学习前端相关领域技术,共同进步,也欢迎大家关注、点赞、收藏、转发,您的支持是我不断创作的动力在JavaScript中,Array.protot...

10个高效的Python爬虫框架,你用过几个?

小型爬虫需求,requests库+bs4库就能解决;大型爬虫数据,尤其涉及异步抓取、内容管理及后续扩展等功能时,就需要用到爬虫框架了。下面介绍了10个爬虫框架,大家可以学习使用!1.Scrapysc...

12个高效的Python爬虫框架,你用过几个?

实现爬虫技术的编程环境有很多种,Java、Python、C++等都可以用来爬虫。但很多人选择Python来写爬虫,为什么呢?因为Python确实很适合做爬虫,丰富的第三方库十分强大,简单几行代码便可实...

pip3 install pyspider报错问题解决

运行如下命令报错:>>>pip3installpyspider观察上面的报错问题,需要安装pycurl。是到这个网址:http://www.lfd.uci.edu/~gohlke...

PySpider框架的使用

PysiderPysider是一个国人用Python编写的、带有强大的WebUI的网络爬虫系统,它支持多种数据库、任务监控、项目管理、结果查看、URL去重等强大的功能。安装pip3inst...

「机器学习」神经网络的激活函数、并通过python实现激活函数

神经网络的激活函数、并通过python实现whatis激活函数感知机的网络结构如下:左图中,偏置b没有被画出来,如果要表示出b,可以像右图那样做。用数学式来表示感知机:上面这个数学式子可以被改写:...