Skip to content

GavZheng/wutong

Repository files navigation

Wutong - The Swiss Army Knife for Developers

Author: Gavin Zheng Language: Rust Version: 0.2.0 License: MIT Github Stars Contributor Covenant

English | 简体中文


Contents


Why We Need Wutong

In our daily project development, we frequently encounter situations where we need to encode or convert certain data. For instance, converting a string to Base64 encoding or representing a number in binary format. Often, to accomplish these tasks, we have to leave our development environment, search for specialized programs or websites, perform multiple interactive operations, copy the results, and then return to our development environment. This process is not only time-consuming but also disrupts our workflow by causing frequent context-switching, which can lead to a loss of focus and valuable inspiration.

Wutong was created to address this issue. It is a command-line tool that allows us to complete various mundane tasks that we may encounter in programming directly within the terminal, thereby significantly enhancing our coding efficiency.


How to Install Wutong

If you are a macOS user, you can use:

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.
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.2.0):

Function Description
base Encode input strings in base32 or base64
bc Convert input numbers to binary, octal, decimal, hexadecimal
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

How to Contribute to Wutong

Wutong is an open-source project, and we warmly welcome and highly anticipate developers from around the world to join and participate in its development.

You can contribute to Wutong in the following ways:

  1. Submit bug reports and feature suggestions: If you encounter any bugs or have any feature suggestions while using Wutong, please refer to the Wutong Security Guidelines.
  2. Contribute code: If you have the ability and are willing to contribute code to Wutong, please refer to the Wutong Contributor Guidelines.

Special Thanks

We sincerely thank the following individuals who have made outstanding contributions to Wutong (in alphabetical order):

  • Bob: Made numerous non-code contributions to the development of Wutong and was the first user.
  • Silent: Suggested the excellent name for Wutong.

Contributors

Contributors

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 to explore his technical contributions and open-source projects.


License

MIT © 2025 Gavin Zheng