Metadata-Version: 2.1
Name: currenapp
Version: 1.0.0
Summary: A CLI to convert different currencies.
Author: caio
Author-email: caio.2004vb@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: requests (>=2.28.1,<3.0.0)
Requires-Dist: typer[all] (>=0.6.1,<0.7.0)
Description-Content-Type: text/markdown

# Currency Converter CLI

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

[![GitHub issues](https://img.shields.io/github/issues/caio-bernardo/currencyconv-cli?style=for-the-badge)](https://github.com/caio-bernardo/currencyconv-cli/issues)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge)](https://github.com/psf/black)
[![GitHub license](https://img.shields.io/github/license/caio-bernardo/currencyconv-cli?color=red&style=for-the-badge)](https://github.com/caio-bernardo/currencyconv-cli/blob/master/LICENSE.md)
![](https://img.shields.io/badge/STATUS-IN%20PROGRESS-blueviolet?style=for-the-badge)

This is a small project using [Typer](https://github.com/tiangolo/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](https://www.exchangerate-api.com/), which responds with the calculated conversion.

# Table of Contents

[Know Issues](#know-issues) - [Instalation](#instalation) - [Making changes](#making-changes) - [Contributing](#contributing) - [License](#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
```zsh
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
``` zsh
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.

```bash
poetry install
```

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

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

```zsh
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](./LICENSE.md)

