BookBuddy project

BookBuddy is a CLI-based desktop app that is targeted towards users who prefer the CLI to efficiently keep track of the books that they have read or intend to read. BookBuddy targets casual readers who read for entertainment but not on a regular basis, avid readers who have a huge collection of books and profession/critical readers who read scholarly journals and papers for research and work.

BookBuddy provides a one-stop solution for building a personalised reading repository,is optimised for users who are quick at typing for efficient retrieval of book details and seeks to enable a customisable user experience to enhance the overall reading experience.

The program was created using Java. Version control was done using Sourcetree and Git.

Setting up in Intellij

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

1. Ensure Intellij JDK 11 is defined as an SDK, as described here -- this step is not needed if you have used JDK 11 in a previous Intellij project.
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/bookbuddy/BookBuddy.java file, right-click it, and choose Run BookBuddy.main(). If the setup is correct, you should see something like the below:

   > Task :compileJava
   > Task :processResources NO-SOURCE
   > Task :classes
   
   > Task :BookBuddy.main()
   ___________________________________
   Hello from
   BookBuddy!
   How can I help you today?
   _____________
   
   

   Read the user guide for the features available and use the programme!

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

• A skeleton JUnit test (src/test/java/seedu/duke/DukeTest.java) is provided with this project template.
• If you are new to JUnit, refer to the JUnit Tutorial at se-education.org/guides.

Checkstyle

• A sample CheckStyle rule configuration is provided in this project.
• If you are new to Checkstyle, refer to the Checkstyle Tutorial at se-education.org/guides.

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.