Skip to content

qkbrandon/tp

 
 

Repository files navigation

FinanceIt

FinanceIt is a greenfield Java project. Given below are instructions on how to use it.

Setting up in Intellij

Prerequisites: JDK 11 (use the exact version), update Intellij to the most recent version.

  1. Configure Intellij for JDK 11, as described here.
  2. Import the project as a Gradle project, as described here.
  3. Verify the set up: After the importing is complete, locate the src/main/java/seedu.financeit/Financeit.java file, right-click it, and choose Run Financeit.main(). If the setup is correct, you should see something like the below:
    > Task :compileJava
    > Task :processResources NO-SOURCE
    > Task :classes
    
    > Task :run
    
    
       ||====================================================================||
       ||||$||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||$||||
       ||(100)==================|     Welcome to       |================(100)||
       ||||$||        ~         '------========--------'                ||$||||
       ||<< |        |$|              || ____ ||                         | >>||
       ||>>|  12    ||L||            || ///..) ||         L38036133B   12 |<<||
       ||<<|        || ||           || <||  >)  ||                        |>>||
       ||>>|         |$|            ||  $$ --)  ||        One Hundred     |<<||
    ||====================================================================||>||
    ||||$||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||$||||>||
    ||(100)==================|     FinanceIt!       |================(100)||>||
    ||||$||        ~         '------========--------'                ||$||||>||
    ||<< |        |$|              || ____ ||                         | >>||)||
    ||>>|  12    ||L||            || ///..) ||         L38036133B   12 |<<||/||
    ||<<|        || ||           || <||  >)  ||                        |>>||=||
    ||>>|         |$|            ||  $$ --)  ||        One Hundred     |<<||
    ||<<|      L38036133B        *||  |(_)  ||* series                 |>>||
    ||>>|  12                     *||(___)_||*   1989                  |<<||
    ||<<|      Treasurer     ______(  V2.0   )________     Secretary 12 |>>||
    ||||$|                 ~| A finanace tracking app |~               |$||||
    ||(100)===================  ONE HUNDRED DOLLARS =================(100)||
    ||||$||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||$//||
    ||====================================================================||
    
    Status: 
    =====================================================================================================
    = Welcome to Main Menu                                                                              =
    =====================================================================================================
    | No.            |  Feature                                           |  Commands                    |
    -----------------------------------------------------------------------------------------------------
    | [1]            |  Manual Income/Expense Tracker                     |  manual                      |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [2]            |  Recurring Income/Expense Tracker                  |  recur                       |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [3]            |  Account Summary                                   |  acc                         |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [4]            |  Goals Tracker                                     |  goal                        |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [5]            |  Financial Calculator                              |  financial                   |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [6]            |  Save Manager                                      |  saver                       |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [7]            |  Toggle Log On or Off                              |  logger                      |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    | [8]            |  Quit The Program                                  |  exit                        |
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    ____________________________________________________________
    >>> 
    
    

Build automation using Gradle

  • This project uses Gradle for build automation and dependency management. It includes a basic build script as well (i.e. the build.gradle file).
  • If you are new to Gradle, refer to the Gradle Tutorial at se-education.org/guides.

Testing

I/O redirection tests

  • To run I/O redirection tests (aka Text UI tests), navigate to the text-ui-test and run the runtest(.bat/.sh) script.

JUnit tests

Checkstyle

CI using GitHub Actions

The project uses GitHub actions for CI. When you push a commit to this repo or PR against it, GitHub actions will run automatically to build and verify the code as updated by the commit/PR.

Documentation

/docs folder contains a skeleton version of the project documentation.

Steps for publishing documentation to the public:

  1. If you are using this project template for an individual project, go your fork on GitHub.
    If you are using this project template for a team project, go to the team fork on GitHub.
  2. Click on the settings tab.
  3. Scroll down to the GitHub Pages section.
  4. Set the source as master branch /docs folder.
  5. Optionally, use the choose a theme button to choose a theme for your documentation. Kaiwen

About

https://bqxy.github.io/tp/

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.8%
  • Other 0.2%