currenapp 1.0.0

A CLI to convert different currencies.

Currency Converter CLI

A Command Line Interface made with Python that convertes different currencies from all the world.

This is a small project using Typer focusing in learning. The application takes an argument and two optional parameters, the base currency and the target currency, the default is 'BRL' (Brazilian Real) and 'USD' (US Dolar) in that order. After that, the program makes a request to ExchangeRate-API, which responds with the calculated conversion.

Table of Contents

Know Issues - Instalation - Making changes - Contributing - License

Know Issues

• ExchangeRate-API imposes a monthly quota of 1500 requests, limiting the usage of the application. Unfortanately, this can't be fixed.

Instalation

Pip Instalation

pip install currenapp

Go to [[https://www.exchangerate-api.com/]] and Get a Free Key, once you have your key set it on your machine

export EXCHANGERATE_KEY='YOUR KEY'

And it's done. You are free to use the application.

Making changes

If you want to make changes to this project you need to clone this repository and have poetry installed. After cloning, go to the project's directory and initialize the poetry, don't forget to install the dependencies.

poetry install

Create and set your api key in [[https://www.exchangerate-api.com/]] as in Instalation.

To run the project use poetry run python currenapp/main.py or start the poetry shell to skip these commands.

poetry shell
python currenapp/main.py

Contributing

Issues and Pull Request are welcomed. If you want to make suggestions, ask or discuss anything, open a issue.

License

MIT