From f1b2de1a972999572b9b20d8f1d90545d1c32886 Mon Sep 17 00:00:00 2001
From: Jia Chao <jiac13@chinaunicom.cn>
Date: Thu, 4 Jul 2024 16:35:50 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20util=20=E6=A8=A1=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

添加功能函数：
  uuid  生成一个新的 UUID。

Signed-off-by: Jia Chao <jiac13@chinaunicom.cn>
---
 Cargo.toml  |  1 +
 src/lib.rs  |  3 +++
 src/util.rs | 20 ++++++++++++++++++++
 3 files changed, 24 insertions(+)
 create mode 100644 src/util.rs

diff --git a/Cargo.toml b/Cargo.toml
index 29eaecf..795bc88 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -18,3 +18,4 @@ reqwest = { version = "0.12", features = ["stream"] }
 tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
 tracing = { version = "0.1" }
 tracing-subscriber = { version = "0.3", features = ["env-filter", "local-time"] }
+uuid = { version = "1", features = ["v4"] }
diff --git a/src/lib.rs b/src/lib.rs
index 49aa67a..9b34a5e 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,6 +1,9 @@
 use tokio::runtime::Runtime;
 use tracing_subscriber::{fmt, EnvFilter};
 
+/// 放置了一些基础的函数集合
+pub mod util;
+
 /// 包含了一些常用的文件操作函数
 pub mod file;
 
diff --git a/src/util.rs b/src/util.rs
new file mode 100644
index 0000000..f4c6c3d
--- /dev/null
+++ b/src/util.rs
@@ -0,0 +1,20 @@
+use uuid::Uuid;
+
+/// 生成一个新的 UUID。
+///
+/// 该函数使用 `Uuid` 库生成一个新的版本 4 UUID，并将其转换为字符串格式返回。
+///
+/// # 返回值
+/// 返回一个包含生成的 UUID 的字符串。
+///
+/// # 示例
+/// ```rust
+/// let new_uuid = uuid();
+/// println!("Generated UUID: {}", new_uuid);
+/// ```
+pub fn uuid() -> String {
+    // 生成一个新的版本 4 UUID
+    let uuid = Uuid::new_v4();
+    // 将 UUID 转换为字符串并返回
+    uuid.to_string()
+}