This is a basic API written in GO, which reads the latest exchange rates form Bank of Latvia's RSS feed, stores them to a MySQL database and then displays them through two endpoints.
Download the full repository and save it on your machine.
This program by default uses ports 8080 for the web app and 3306 for the database. If these ports are taken on your machine, change DB_PORT=3306 and WEB_PORT=8080 inside the .env file in the root of the repository.
Open a terminal of your choice and cd into the downloaded folder.
$ cd <path-to-folder>/tetTask-main
Run the command docker compose build and wait for the build process to end (This requires Docker being installed on your system)
$ docker compose build
Run the command docker compose up, this will create and start up the docker containers
$ docker compose up
Now that the containers are running, run the command docker exec -it currencies_api sh
$ docker exec -it currencies_api sh
This will now launch a new terminal window where you can access the program.
After starting and running the docker containers, and launching a command terminal as described in Setup. You can now give commands to the program. The program accepts two commands:
$ go run main.go -action loadCurrencies
This command will grab the latest currency exchange rates from Bank of Latvia's RSS feed and push them to the database. Only new, unique records are stored, so running this command immediately again will not store any new records.
$ go run main.go -action startEndpoints
This command will start the endpoints, so the user can access them.
There are two endpoints: /currencies and /currencies/{currency_name}
This endpoint will display the latest exchange rates for each currency. Results are displayed in JSON format.
This endpoint takes the GET parameter {currency_name} and then returns all of the recorded values of said currency, also in JSON format. For example /currencies/AUD will return all historical values for the Australian dollar.
For a list of available currencies, check here
NOTE: Before trying to access these endpoints, make sure to run go run main.go -action startEndpoints, so that the endpoints are ready. Also, if the endpoints return empty JSON, run go run main.go -action loadCurrencies, which will populate the database.
$ cd <path-to-folder>/tetTask
$ docker compose build
$ docker compose up
$ docker exec -it currencies_api sh
$ go run main.go -action loadCurrencies
Successfully added 93 new currencies!
$ go run main.go -action startEndpoints
[GIN-debug] Listening and serving HTTP on :8080
Now open localhost:8080/currencies in your browser to view all latest currencies or localhost:8080/currencies/AUD to view the Australian dollar exchange rates.
NOTE: If you changed the WEB_PORT value in the .env file, use that value in the URL for accesing the endpoints: localhost:{YOUR_PORT}/currencies