https://github.com/rajtilak-2020/currency-converter

A simple and interactive command-line tool that helps you convert currencies using real-time exchange rates provided by the Fixer.io API
https://github.com/rajtilak-2020/currency-converter

api cli currency currency-converter currency-exchange-rates python

Last synced: 3 months ago
JSON representation

A simple and interactive command-line tool that helps you convert currencies using real-time exchange rates provided by the Fixer.io API

• Host: GitHub
• URL: https://github.com/rajtilak-2020/currency-converter
• Owner: rajtilak-2020
• License: mit
• Created: 2025-01-01T06:34:18.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-01-22T04:37:13.000Z (4 months ago)
• Last Synced: 2025-01-22T05:25:08.826Z (4 months ago)
• Topics: api, cli, currency, currency-converter, currency-exchange-rates, python
• Language: Python
• Homepage:
• Size: 6.84 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Python Currency Converter 🌍

A **simple** and **interactive** command-line tool that helps you convert currencies using **real-time exchange rates** provided by the **Fixer.io API**.

## ✨ Features ✨

- 💱 **Convert** between multiple currencies.

- 🏷️ **View available currencies**.

- 📜 **Display previous transactions** from the conversion history.

- 🗂️ Store all conversion history in a text file (`conversion storage.txt`).

- 📡 **Real-time exchange rate** data fetched from the **Fixer.io API**.

## 📦 Requirements 📦

- **Python 3.x** (Ensure you have Python 3.x installed on your system)

- Install the required Python package `requests` to make HTTP requests:

## How to Use 🚀

1. **Clone or download the project** to your local machine.

2. **Run the script** `currency_converter.py` in your terminal:

3. **The program will prompt you to specify the following:**

> The amount of currency to convert.

> 

> The currency to convert from (e.g., USD, EUR, INR).

> 

> The currency to convert to (e.g., USD, EUR, INR).

> 

> You can use the following commands during the program execution:

>

>SHOW to display the list of available currencies.

> 

>DISPLAY to show previous conversion transactions stored in the conversion storage.txt.

> 

>Q to quit the program.

>

>After each conversion, the program will store the transaction in a file called conversion storage.txt, logging the details of the currency conversion (e.g., 100 USD amounts to 85.3 EUR today)

>

### Enhancements:

1. **Emoji Usage**: Added to enhance the readability and make the document more engaging.

2. **Headers**: To make the sections clear and stand out.

3. **Formatted Examples**: The example commands are now clearly separated for better understanding.

4. **Color and Structure**: The use of bullet points, bold text, and formatted code blocks makes the document visually appealing.

## 📝 License 📝

This project is open-source and available under the MIT License.