puniyu_version 0.8.2

puniyu 轻量版本号类型，提供三段式语义版本表示与 semver 互转
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! # puniyu_version
//!
//! 轻量语义版本类型，主要用于在项目内部共享 `major.minor.patch` 版本信息。
//!
//! ## 特性
//!
//! - 提供 `Version::new` 构造函数
//! - 支持 `Display`，格式为 `major.minor.patch`
//! - 支持 `FromStr` 解析语义化版本字符串
//! - 支持与 `semver::Version` 双向转换
//! - 支持 `serde` 序列化与反序列化
//!
//! ## 设计说明
//!
//! `Version` 仅保留语义化版本的核心三段（`major` / `minor` / `patch`）。
//! 当从 `semver::Version` 转换或解析包含预发布/构建元数据的字符串时，
//! 这些扩展信息会被忽略。
//!
//! 例如：`1.2.3-beta.1+build.7` 会被转换为 `Version::new(1, 2, 3)`。
//!
//! ## 示例
//!
//! ```rust
//! use std::str::FromStr;
//! use puniyu_version::Version;
//!
//! let version = Version::new(1, 2, 3);
//! assert_eq!(version.to_string(), "1.2.3");
//!
//! let parsed = Version::from_str("1.2.3-beta.1+build.7").unwrap();
//! assert_eq!(parsed, Version::new(1, 2, 3));
//! ```

use derive_more::Display;
use serde::{Deserialize, Serialize};
use std::str::FromStr;

/// 三段式版本号（`major.minor.patch`）。
///
/// 这是 `semver` 的简化表示，仅保存核心版本信息，不保存预发布和构建元数据。
#[derive(
	Debug, Clone, Copy, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize, Display,
)]
#[display("{major}.{minor}.{patch}")]
pub struct Version {
	/// 主版本号
	pub major: u64,
	/// 次版本号
	pub minor: u64,
	/// 补丁版本号
	pub patch: u64,
}

impl Version {
	/// 创建一个新的版本号。
	pub const fn new(major: u64, minor: u64, patch: u64) -> Self {
		Self { major, minor, patch }
	}

	pub fn parse(s: &str) -> Result<Self, semver::Error> {
		Ok(Self::from(semver::Version::parse(s)?))
	}
}

impl From<semver::Version> for Version {
	fn from(v: semver::Version) -> Self {
		Self { major: v.major, minor: v.minor, patch: v.patch }
	}
}

impl From<Version> for semver::Version {
	fn from(v: Version) -> Self {
		semver::Version::new(v.major, v.minor, v.patch)
	}
}

impl FromStr for Version {
	type Err = semver::Error;

	fn from_str(s: &str) -> Result<Self, Self::Err> {
		semver::Version::from_str(s).map(Into::into)
	}
}

/// 从当前 crate 的 `Cargo.toml` 自动构造 [`Version`]。
///
/// 无需依赖 `const_str`，在 const 上下文中即可使用。
///
/// # 示例
///
/// ```rust
/// use puniyu_version::{Version, pkg_version};
///
/// const VERSION: Version = pkg_version!();
/// ```
#[macro_export]
macro_rules! pkg_version {
	() => {{
		const fn parse(s: &str) -> u64 {
			let b = s.as_bytes();
			let mut r: u64 = 0;
			let mut i = 0;
			while i < b.len() {
				r = r * 10 + (b[i] - b'0') as u64;
				i += 1;
			}
			r
		}
		$crate::Version::new(
			parse(env!("CARGO_PKG_VERSION_MAJOR")),
			parse(env!("CARGO_PKG_VERSION_MINOR")),
			parse(env!("CARGO_PKG_VERSION_PATCH")),
		)
	}};
}