Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/saifkhan192/currency-exchange-tracking-app
A simple currency exchange tracking application using AWS Serverless environment and services. The app fetches exchange rates every day and stores in DynamoDB and exposes REST api to provide current exchange rate information to the customers and comparison of rates as compared to last day
https://github.com/saifkhan192/currency-exchange-tracking-app
apigateway aws aws-sam-cli cloudformation dynamodb eventbridge lambda python3 serverless
Last synced: 8 days ago
JSON representation
A simple currency exchange tracking application using AWS Serverless environment and services. The app fetches exchange rates every day and stores in DynamoDB and exposes REST api to provide current exchange rate information to the customers and comparison of rates as compared to last day
- Host: GitHub
- URL: https://github.com/saifkhan192/currency-exchange-tracking-app
- Owner: saifkhan192
- Created: 2023-02-10T14:52:17.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-11T18:19:03.000Z (almost 2 years ago)
- Last Synced: 2023-09-17T11:25:00.632Z (over 1 year ago)
- Topics: apigateway, aws, aws-sam-cli, cloudformation, dynamodb, eventbridge, lambda, python3, serverless
- Language: Python
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Currency Exchange Tracking Application
[](https://www.linkedin.com/in/saifullah-khan-02318086/)
A simple currency exchange tracking application using AWS Serverless environment and services.
Application relies on European Central Bank Data
(https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html)
1. Exchange rates are fetched every day and stored in a dynamodb table
2. The application exposes a public REST API endpoint that provides current exchange rate information for all tracked currencies and their change compared to the previous day for all the tracked currencies.
3. So the customer can see current exchange rates
4. Customer can monitor exchange rate changes as compared to the previous day
4. To Do: Add single page web appliction to display the curency rates and a graph that shows the currency trends
## Language and Services being used
- Python 3.9
- AWS ApiGateway
- AWS Lambda
- AWS DynamoDB
- AWS Events (Event Rules)
- AWS Cloudformation
- AWS SAM (Serverless Application Model)
- AWS CloudWatch
- AWS SAM CLI (v1.59.0)
## Project structure
```sh
├── Makefile
├── README.md
├── daily.xml
├── functions
│ ├── __init__.py
│ ├── db.py
│ ├── handlers.py
│ ├── helper.py
│ ├── requirements.txt
│ └── samconfig.toml
├── pyproject.toml
├── samconfig.toml
├── template.yaml
└── tests
├── __init__.py
├── integration
│ ├── __init__.py
│ └── test_api_gateway.py
├── requirements.txt
└── unit
├── __init__.py
└── test_handlers.py
```
## Setup
First Install SAM CLI on your system then you can deply the app on AWS cloud or run locally via `sam local start-api`
```bash
# creates venv and installs the `/functions/requirements.txt`
make setup_local
# Paste your AWS access keys on the shell
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_DEFAULT_REGION=us-east-1
```
## Deploy application
```bash
# Paste your AWS access keys on the shell
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_DEFAULT_REGION=us-east-1
# Create new S3 bucket manually and update s3_bucket key in samconfig.toml file
# Run below command to build project usinng SAM and deploy
make build_and_deploy_dev
```
## Run Unit Tests
```bash
make run_unit_tests
```
## Run Integration Tests
```bash
make run_integration_tests
```
Note: Application should be deployed to AWS before running the tests