百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程字典 > 正文

Python包版本表示趣谈(python的版本号)

toyiye 2024-07-06 23:29 21 浏览 0 评论

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

相关推荐

为何越来越多的编程语言使用JSON(为什么编程)

JSON是JavascriptObjectNotation的缩写,意思是Javascript对象表示法,是一种易于人类阅读和对编程友好的文本数据传递方法,是JavaScript语言规范定义的一个子...

何时在数据库中使用 JSON(数据库用json格式存储)

在本文中,您将了解何时应考虑将JSON数据类型添加到表中以及何时应避免使用它们。每天?分享?最新?软件?开发?,Devops,敏捷?,测试?以及?项目?管理?最新?,最热门?的?文章?,每天?花?...

MySQL 从零开始:05 数据类型(mysql数据类型有哪些,并举例)

前面的讲解中已经接触到了表的创建,表的创建是对字段的声明,比如:上述语句声明了字段的名称、类型、所占空间、默认值和是否可以为空等信息。其中的int、varchar、char和decimal都...

JSON对象花样进阶(json格式对象)

一、引言在现代Web开发中,JSON(JavaScriptObjectNotation)已经成为数据交换的标准格式。无论是从前端向后端发送数据,还是从后端接收数据,JSON都是不可或缺的一部分。...

深入理解 JSON 和 Form-data(json和formdata提交区别)

在讨论现代网络开发与API设计的语境下,理解客户端和服务器间如何有效且可靠地交换数据变得尤为关键。这里,特别值得关注的是两种主流数据格式:...

JSON 语法(json 语法 priority)

JSON语法是JavaScript语法的子集。JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔花括号保存对象方括号保存数组JS...

JSON语法详解(json的语法规则)

JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔大括号保存对象中括号保存数组注意:json的key是字符串,且必须是双引号,不能是单引号...

MySQL JSON数据类型操作(mysql的json)

概述mysql自5.7.8版本开始,就支持了json结构的数据存储和查询,这表明了mysql也在不断的学习和增加nosql数据库的有点。但mysql毕竟是关系型数据库,在处理json这种非结构化的数据...

JSON的数据模式(json数据格式示例)

像XML模式一样,JSON数据格式也有Schema,这是一个基于JSON格式的规范。JSON模式也以JSON格式编写。它用于验证JSON数据。JSON模式示例以下代码显示了基本的JSON模式。{"...

前端学习——JSON格式详解(后端json格式)

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScriptProgrammingLa...

什么是 JSON:详解 JSON 及其优势(什么叫json)

现在程序员还有谁不知道JSON吗?无论对于前端还是后端,JSON都是一种常见的数据格式。那么JSON到底是什么呢?JSON的定义...

PostgreSQL JSON 类型:处理结构化数据

PostgreSQL提供JSON类型,以存储结构化数据。JSON是一种开放的数据格式,可用于存储各种类型的值。什么是JSON类型?JSON类型表示JSON(JavaScriptO...

JavaScript:JSON、三种包装类(javascript 包)

JOSN:我们希望可以将一个对象在不同的语言中进行传递,以达到通信的目的,最佳方式就是将一个对象转换为字符串的形式JSON(JavaScriptObjectNotation)-JS的对象表示法...

Python数据分析 只要1分钟 教你玩转JSON 全程干货

Json简介:Json,全名JavaScriptObjectNotation,JSON(JavaScriptObjectNotation(记号、标记))是一种轻量级的数据交换格式。它基于J...

比较一下JSON与XML两种数据格式?(json和xml哪个好)

JSON(JavaScriptObjectNotation)和XML(eXtensibleMarkupLanguage)是在日常开发中比较常用的两种数据格式,它们主要的作用就是用来进行数据的传...

取消回复欢迎 发表评论:

请填写验证码