Skip to content

Latest commit

 

History

History
49 lines (29 loc) · 1.67 KB

README.md

File metadata and controls

49 lines (29 loc) · 1.67 KB
Raw

Project name

Currency Converter

Description

Currency Converter is a command-line tool written in Rust, designed to enable users to convert amounts between various currencies based on real-time exchange rates fetched from an API.

Technical Specifications

  • Programming Language: Rust
  • External Libraries: reqwest for HTTP requests, serde for JSON parsing.

Features

  • Fetch real-time exchange rates from a free currency conversion API.
  • Function to list all available currencies.
  • Calculate and display the converted amount in the target currency, including the exchange rate used for the conversion.
  • An interactive interface guiding users through the currency conversion process.
  • Caching system providing better application performance.

How to Build and Run

  1. Prerequisites:
  • Rust programming environment (Cargo and Rust compiler).
  • An API key for the currency conversion API (obtain one from the API provider's website(https://exchangeratesapi.io/)).
  1. Building the Application:
  • Clone the repository to your local machine.
  • Navigate to the project directory and run cargo build --release to compile the project.
  1. Running the Application:
  • Run the application using cargo run

Authors

Obtaining an API Key

  • Visit the currency conversion API's website and sign up for an API key(https://exchangeratesapi.io/).
  • Set the API key in your environment variables or directly in the application as instructed by the API provider.

CI/CD Configuration

This project includes a .gitlab-ci.yml file for Continuous Integration and Continuous Deployment using GitLab CI/CD. It covers Docker image building.