Currency Converter

A Windows XP-esk currency exchange coded in 100% Java.
View Demo · Read Technical Report

NOTE: This repo is a clone of the original repo which was stored in the USYD Github Enterprise.

About The Project

Created for Project 1 in SOFT2412: Agile Software Development Practices, the Currency Converter project delivers a manually-administrated currency exchange program.

Created in Java 17 using java.swing for the GUI, the currency exchange allows users to:

• convert between various currencies
• view current exchange rates of popular currencies, and
• view historical exchange rate data

Admins of the application are responsible for setting which currencies are popular and adding and updating currencies and their exchange rates. All data is persistent and is stored in a local SQLite database.

(back to top)

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

This project is built in Java 17 using Gradle 7.4 for build automation, JUnit 5.8.1 for automated testing, and SQLite 3.36.0.3 for database storage. The following section goes in-detail on how to install each of these dependencies.

We recommend using the sdkman package manager to install Java 17 and Gradle 7.5.

• Java 17

  sdk list java
  sdk install java 17.0.2.8.1-amzn
  sdk default java 17.0.2.8.1-amzn

• Gradle 7.5

  sdk list gradle
  sdk install gradle 7.5
  sdk default gradle 7.5

Installation

1. Clone the repo to your local machine

   git clone https://github.sydney.edu.au/adha5655/currency-converter.git

2. Navigate to the /currency_convert/app directory

3. Run using gradle

   gradle run

4. To exit the application, either press Ctrl+Q OR open the in-app start menu and click Turn off computer.

(back to top)

Usage

How to test code

1. Navigate to the currency-converter/app directory
2. Run testing using gradle

gradle test

3. On successful testing, the terminal will display BUILD SUCCESSFUL

(back to top)

Contributing

Notes for the team on how to contribute/collaborate on the codebase: main/notes/README.md

We welcome any collaboration and contributions from the public to this open source project. If you have a suggestion that would make this better, please fork the repo and create a pull request. These steps are listed below:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

Created for SOFT2412: Agile Software Development Practices in Semester 2, 2022.

| name           | unikey   | sid       |
|----------------|----------|-----------|
| Antriksh Dhand | adha5655 | 510415022 |
| Nemo Gage      | ngag3129 | 500496851 |
| Udit Samant    | usam6049 | 500700976 |
| Sulav Malla    | smal8154 | 500495980 |

Project Link: https://github.sydney.edu.au/adha5655/currency-converter

Important Information on Linking Jenkins with discord, set up by a fellow team member : https://edstem.org/au/courses/9767/discussion/1014406

(back to top)