Merge branch 'release/v0.2.0'

Author: GavZheng

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "wutong"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2021"
 authors = ["Gavin Zheng<gav.zheng@outlook.com"]
 description = "A Swiss Army Knife for Developers.🌳"
@@ -12,6 +12,9 @@ license = "MIT"
 readme = "README.md"
 
 [dependencies]
-clap = "4.5.26"
+clap = "4.5.34"
 colored = "3.0.0"
 md5 = "0.7.0"
+
+[dev-dependencies]
+tempfile = "3.19.1"

Cargo.toml

@@ -1,5 +1,12 @@
 <h1 style="text-align: center;">Wutong - The Swiss Army Knife for Developers</h1>
 
+[![Author: Gavin Zheng](https://img.shields.io/badge/Author-Gavin_Zheng-f2f28d)](https://github.com/GavZheng)
+![Language: Rust](https://img.shields.io/badge/Language-Rust-orange)
+![Version: 0.2.0](https://img.shields.io/badge/Version-0.2.0-blue)
+![License: MIT](https://img.shields.io/badge/License-MIT-green)
+![Github Stars](https://img.shields.io/github/stars/WutongDev/wutong?style=flat&color=red)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT_zh.md)
+
 [English](./README.md) | [简体中文](./docs/zh/README_zh.md)
 
 ---
@@ -24,18 +31,20 @@ In our daily project development, we frequently encounter situations where we ne
 ---
 
 ## How to Install Wutong
-If you are a MacOS user, you can use:
+If you are a macOS user, you can use:
 ```bash
+brew tap GavZheng/wutong
 brew install wutong
 ```
+PS: Only macOS 13 or later is supported.  
 If you are a Windows or Linux user, please wait for the subsequent version.  
-P.S.: Of course, you can compile Wutong yourself.
+*Of course, you can compile Wutong yourself.*
 
 ---
 
 ## How to Use Wutong
 You can obtain detailed information by typing `wutong --help` in the command line.  
-The general functions of Wutong are listed below (v0.1.0-beta):
+The general functions of Wutong are listed below (v0.2.0):
 
 | Function | Description                                                  |
 |----------|--------------------------------------------------------------|
@@ -44,6 +53,7 @@ The general functions of Wutong are listed below (v0.1.0-beta):
 | color    | Convert between RGB and Hex colors                           |
 | md5      | Hash input strings using MD5                                 |
 | charcode | Convert string encodings                                     |
+| flow     | Manage git repositories according to the Gitflow workflow    |
 
 ---
 
@@ -71,5 +81,21 @@ We sincerely thank the following individuals who have made outstanding contribut
 
 ---
 
+FAQ
+
+Q1: Why is it named "Wutong"?
+A: The name originates from developer Gavin's friend, Silent, whose favorite tree species is the Chinese parasol tree (梧桐). "Wutong" is the Pinyin transliteration of the tree's Chinese name.
+
+Q2: Why was Rust chosen as the development language?
+A: Rust was selected as the optimal technical choice after evaluating languages like Python, C++, and C, due to its cross-platform capabilities, memory safety features, and high-performance execution that align with the project's requirements.
+
+Q3: Why is only macOS currently supported?
+A: Current development prioritizes core feature refinement and rapid iteration. Windows and Linux versions are on the roadmap, with multi-platform adaptation scheduled to commence once core functionalities are stabilized.
+
+Q4: Where can I learn more about Gavin?
+A: Visit [Gavin's GitHub profile](https://github.com/GavZheng) to explore his technical contributions and open-source projects.
+
+---
+
 ## License
 [MIT](./LICENSE) © 2025 Gavin Zheng

README.md

@@ -1,15 +1,16 @@
 <h1 style="text-align: center;">梧桐 - 开发者的瑞士军刀</h1>
 
+[![Author: Gavin Zheng](https://img.shields.io/badge/Author-Gavin_Zheng-f2f28d)](https://github.com/GavZheng)
+![Language: Rust](https://img.shields.io/badge/Language-Rust-orange)
+![Version: 0.2.0](https://img.shields.io/badge/Version-0.2.0-blue)
+![License: MIT](https://img.shields.io/badge/License-MIT-green)
+![Github Stars](https://img.shields.io/github/stars/WutongDev/wutong?style=flat&color=red)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT_zh.md)
+
 [English](../../README.md) | [简体中文](README_zh.md)
 
 梧桐是一个由**Rust**编写的跨平台工具箱，用于帮助开发者快速完成各种任务。
 
-![LICENSE](https://img.shields.io/badge/License-MIT-blue)
-![Language](https://img.shields.io/badge/Language-Rust-orange)
-![Version](https://img.shields.io/badge/Version-v0.1.0%20alpha-green)
-![Github Stars](https://img.shields.io/github/stars/WutongDev/wutong?style=flat&color=red)
-[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT_zh.md)
-
 ---
 
 ## 目录
@@ -32,14 +33,19 @@
 ---
 
 ## 如何安装梧桐
-> [!NOTE]  
-> 梧桐在测试阶段不提供安装方式，如希望体验请自行编译。在正式版发布后，梧桐将会提供安装方式。
-
+如果您是 macOS 用户，则可以使用：
+```bash
+brew tap GavZheng/wutong
+brew install wutong
+```
+PS：仅支持 macOS 13 或更高版本。  
+如果您是 Windows 或 Linux 用户，请等待后续版本。   
+*当然，您可以自己编译梧桐。*
 ---
 
 ## 如何使用梧桐
 你可以通过在命令行键入`wutong --help`来获取详细信息。  
-梧桐的大致功能如下表（v0.1.0-alpha）
+梧桐的大致功能如下表（v0.2.0）
 
 | 功能       | 描述                         |
 |----------|----------------------------|
@@ -48,6 +54,7 @@
 | color    | RGB和Hex颜色的相互转换             |
 | md5      | 将输入的字符串进行md5哈希             |
 | charcode | 字符串编码转换                    |
+| flow     | 根据 Gitflow 工作流程管理 git 存储库  |
 
 ---
 
@@ -73,5 +80,20 @@
 
 ---
 
+## FAQ
+Q1: 为什么叫梧桐？  
+A：这个名字来自我（Gavin）的一个朋友（Silent），梧桐是她最喜欢的树。“Wutong”是梧桐的拼音。
+
+Q2: 为何选择Rust作为开发语言？  
+A: Rust凭借其卓越的跨平台能力、内存安全特性和高效执行性能，在综合评估Python/C++/C等候选语言后，被确认为满足项目需求的最佳技术选型。
+
+Q3: 当前为何仅支持macOS平台？
+A: 现阶段开发重心聚焦于核心功能完善与快速迭代。Windows/Linux版本已列入roadmap，将在主体功能稳定后启动多平台适配工作。
+
+Q4：更多关于Gavin？  
+A：你可以访问[Gavin的Github主页](https://github.com/GavZheng)。
+
+---
+
 ## 许可证
 [MIT](../../LICENSE) © 2025 Gavin Zheng

docs/zh/README_zh.md

@@ -17,7 +17,7 @@ pub fn base16_encode(input: &str) -> Result<String, FromUtf8Error> {
 pub fn base64_encode(input: &str) -> Result<String, FromUtf8Error> {
     const BASE64_CHARS: &[u8] = b"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
     let bytes = input.as_bytes();
-    let mut result = Vec::with_capacity(((bytes.len() + 2) / 3) * 4);
+    let mut result = Vec::with_capacity(bytes.len().div_ceil(3) * 4);
     let mut buffer = [0u8; 3];
     let mut buffer_index = 0;
 

src/base/text/encode.rs

@@ -0,0 +1,31 @@
+use crate::BranchType;
+use std::process;
+
+pub fn branch(branch_type: BranchType, branch_name: &str) -> Result<(), String> {
+    let git_path = crate::flow::git::which_git().map_err(|e| e.to_string())?;
+
+    let prefix = match branch_type {
+        BranchType::Feature => "feature",
+        BranchType::Release => "release",
+        BranchType::Hotfix => "hotfix",
+    };
+
+    let branch = format!("{}/{}", prefix, branch_name);
+
+    let output = process::Command::new(&git_path)
+        .arg("checkout")
+        .arg("-b")
+        .arg(&branch)
+        .output()
+        .map_err(|e| format!("Failed to execute Git command: {}", e))?;
+
+    if !output.status.success() {
+        let error_msg = String::from_utf8_lossy(&output.stderr);
+        return Err(format!(
+            "Failed to create branch '{}': {}",
+            branch, error_msg
+        ));
+    }
+
+    Ok(())
+}