version

package
v0.3.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 12, 2026 License: MIT Imports: 3 Imported by: 0

README

Version (版本)

提供简单的语义化版本管理工具。

API

Version
  • 结构体: Major, Minor, Patch
NewVersion
  • 签名: func NewVersion(verStr string) (*Version, error)
  • 描述: 解析版本字符串(支持带 'v' 前缀)。
Methods
  • Increment: func (v *Version) Increment()
    • 描述: 版本自增(逢 100 进位)。
  • Compare: func (v *Version) Compare(other *Version) int
    • 描述: 版本比较(1: 大于, 0: 等于, -1: 小于)。
  • String: func (v *Version) String() string
    • 描述: 格式化为 "vX.Y.Z" 形式。

示例

import (
    "fmt"
    "github.com/fireflycore/go-utils/version"
)

func main() {
    v, _ := version.NewVersion("v1.0.99")
    v.Increment()
    fmt.Println(v.String()) // v1.1.0
    
    v2, _ := version.NewVersion("v2.0.0")
    fmt.Println(v.Compare(v2)) // -1
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Version

type Version struct {
	Major int // 主版本号:不兼容的 API 修改
	Minor int // 次版本号:向下兼容的功能性新增
	Patch int // 修订号:向下兼容的问题修正
}

Version 表示一个语义化版本号 遵循 SemVer 规范:Major.Minor.Patch

func NewVersion

func NewVersion(verStr string) (*Version, error)

NewVersion 解析版本字符串并返回 Version 结构体 verStr: 版本字符串(如 "v1.0.1" 或 "1.0.1") 返回: Version 指针,如果格式错误则返回 error

func (*Version) Compare

func (v *Version) Compare(other *Version) int

Compare 比较两个版本号的大小 other: 待比较的另一个版本 返回:

  • 1: 当前版本 > other
  • 0: 当前版本 == other
  • -1: 当前版本 < other

func (*Version) Increment

func (v *Version) Increment()

Increment 对版本进行累加,修订号满 100 则次版本号加 1,次版本号满 100 则主版本号加 1。

func (*Version) String

func (v *Version) String() string

String 格式化输出版本号 格式: "v{Major}.{Minor}.{Patch}"

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL