Running the Budgeteer

Running the Budgeteer directly with Gradle

1. Clone the repository

git clone https://github.com/adessoAG/budgeteer

2. Execute the Gradle task to run the Budgeteer

./gradlew bootRun

3. Go to localhost:8080 in your browser

Run the tests

You can execute the tests simply by running the appropriate Gradle task

./gradlew test

Working with the Budgeteer in IntelliJ IDEA

1. Clone the repository

git clone https://github.com/adessoAG/budgeteer

2. You can simply import the Budgeteer as a Gradle project. Make sure to select Use default gradle wrapper instead of a local distribution. Also check the Delegate IDE build/run actions to gradle checkbox in File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> Runner.

3. Download the Lombok plugin for IntelliJ

File -> Settings -> Plugins -> Browse repositories -> Search for Lombok -> Install

4. Enable Annotation processing

File -> Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors -> Enable annotation processing

5. In the Gradle tab, select:

Budgeteer -> application -> bootRun

6. Go to localhost:8080 in your browser

Run the tests

You can run all tests by using the Gradle task at budgeteer-> verification -> test.

If you want to run the tests from the Project View or run individual tests, you have to tell IntelliJ to use the Gradle runner:

File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> Runner -> select the Gradle Test Runner

Working with the Budgeteer in Eclipse

1. Clone the repository

git clone https://github.com/adessoAG/budgeteer

2.Import the Budgeteer as a gradle project.

3.Get Lombok - https://projectlombok.org/download - It will automatically find your Eclipse installation and install itself.

4.Tell gradle to use JDK instead of JRE - Right click on the gradle install task and press Open Gradle Run Configuartions -> set Java Home to your JDK installation.

5.Run the application -> bootRun task.

6. Go to localhost:8080 in your browser

Run the tests

You can run the tests using the gradle test task.

Running the budgeteer with HSQLDB:

1. Open the build.gradle file in the budgeteer-web-interface module and find the bootRun block.

2. Comment out the line '-Dspring.datasource.url=jdbc:hsqldb:mem:budgeteer'

3. Uncomment the line '-Dspring.datasource.url=jdbc:hsqldb:hsql://localhost/budgeteer'.

4. Now, when running the budgeteer with bootRun it will use HSQLDB.

Configuration for HSQLDB:

After downloading and extracting the latest version of HSQLDB, you will find that it contains a bin folder. Open the file runServer.bat and replace the existing text with the following:

cd ..\data
@java -classpath ../lib/hsqldb.jar org.hsqldb.server.Server --database.0 file:test --dbname.0 budgeteer

Now you can run HSQL from this file and the budgeteer as described above.