Currencies Converter App

Currencies converter app created with Python and Flask (restful api). Two environments available - dev (with test data) and prod (with real currencies rates).

To run application in production environment you will have to create account on Exchange Rates API.

Demo app

Demo app is deployed on Heroku. You can play with it.

https://py-currencies.herokuapp.com/

Docker

Build app image.

$ docker build . -t py-currencies/demo

List all docker images.

$ docker images     
REPOSITORY           TAG       IMAGE ID       CREATED          SIZE
py-currencies/demo   latest    b032f74cff9a   5 minutes ago    946MB
<none>               <none>    b1c5a22e9d74   15 minutes ago   917MB

Run docker container form created image.

$ docker run -d -p 80:3333 b032f74cff9a

List all docker containers running.

$ docker ps   
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                  NAMES
9a541fbf708e   b032f74cff9a   "python3 /app/main.py"   2 minutes ago   Up 2 minutes   0.0.0.0:80->3333/tcp   priceless_lamport

Shutdown running app container.

$ docker stop 9a541fbf708e

Usage

To check if the server is running on localhost port 80 (GET request).

$ curl http://localhost/
{
    "server": "running",
    "app": "currency converter"
}

Get list of all currencies and rates (GET request).

/rates

Parameters:

• none

$ curl http://localhost/rates
{
    "success": "true",
    "timestamp": 1645964069,
    "base": "EUR",
    "date": "2022-02-27",
    "rates": {
        ...
        "BTC": 2.8869014e-05,
        "EUR": 1,
        "GBP": 0.841179,
        ...
    }
}

Convert money from one currency to the other (GET request).

/convert/<from_money>/<from_currency>/<to_currency>

Parameters:

• from_money (float)
• from_currency (string)
• to_currency (string)

$ curl http://localhost/convert/1234/USD/GBP
{
    "success": "true",
    "result": {
        "USD": 1234,
        "GBP": 920.8276027865726
    }
}

Reset and update the rates (POST request).

/rates/reset

Parameters:

• none

$ curl -X POST http://localhost:3333/rates/reset
{
    "success": "true",
    "timestamp": 1645965366,
    "base": "EUR",
    "date": "2022-02-27",
    "rates": {
        ...
    }
}

Add new currency and new rates to the rates list (POST request) .

/rates

Parameters:

• new_currency (string)
• new_rate (float)

$ curl -X POST -F 'new_currency=icp' -F 'new_rate=1.22222' http://localhost:3333/rates
{
    "success": "true",
    "result": {
        "ICP": 1.22222,
        "rates": {
            ...
            "ICP": 1.22222
        }
    }
}

Update currency with a new rate (PUT request).

/rates

Parameters:

• currency (string)
• new_rate (float)

$ curl -X PUT -F 'currency=icp' -F 'new_rate=1.29222' http://localhost/rates
{
    "success": "true",
    "result": {
        "ICP": 1.29222,
        "rates": {
            ...
            "ICP": 1.29222
        }
    }
}

Delete currency from the list (DELETE request).

/rates

Parameters:

• currency (string)

$ curl -X DELETE -F 'currency=icp' http://localhost/rates

Good luck.