货币转换 CLI

一个简单的 CLI 工具，使用实时汇率进行货币转换。

特性

• 支持多种货币之间的转换。
• 支持正向和反向货币转换。
• 从 API 获取实时汇率。
• 在输出中显示货币符号。
• 列出所有可用的货币。
• 交互式菜单，易于使用。

先决条件

• Rust
• Cargo

安装

1. 克隆仓库

   git clone https://github.com/yourusername/currency_converter.git
   cd currency_converter
   

2. 在项目根目录中创建一个 .env 文件并添加您的 API 密钥

   echo "EXCHANGE_RATE_API_KEY=your_api_key_here" > .env
   

3. 构建项目

   cargo build --release
   

用法

转换货币

要从一个货币转换到另一个货币，运行以下命令

./target/release/currency_converter convert --amount <AMOUNT> --from <SOURCE_CURRENCY> --to <TARGET_CURRENCY>

例如，将 100 GBP 转换为 CNY

./target/release/currency_converter convert --amount 100 --from GBP --to CNY

反向转换货币

要反向转换金额到源货币，运行以下命令

./target/release/currency_converter reverse-convert --amount <AMOUNT> --from <SOURCE_CURRENCY> --to <TARGET_CURRENCY>

例如，找出需要多少 GBP 才能获得 100 CNY

./target/release/currency_converter reverse-convert --amount 100 --from GBP --to CNY

列出所有可用的货币

要列出所有可用的货币，运行

./target/release/currency_converter list-currencies

交互式菜单

您还可以以交互式菜单模式运行此工具

./target/release/currency_converter

在交互式菜单中，您将有以下选项

=============================
  Currency Converter Menu:
=============================
  1. Convert currency
  2. Reverse convert currency
  3. List available currencies
  Q. Quit
=============================
Enter your choice:

按照提示执行所需的操作。

示例输出

=============================
100.00 GBP is 922.05 ¥ (Rate as of 2024-06-22 12:00:00 UTC)
=============================

or

=============================
100.00 ¥ is 10.84 GBP (Rate as of 2024-06-22 12:00:00 UTC)
=============================

API 密钥

此工具使用 ExchangeRate-API 获取实时汇率。您需要注册一个 API 密钥并将其添加到项目根目录中的 .env 文件中。

许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。