Code Monkey home page Code Monkey logo

tp's Introduction

TermiNUS

Java CI codecov

This is a project template for a greenfield Java project. It's named after the Java mascot Duke. Given below are instructions on how to use it.

Setting up

Prerequisite

Before setting up the project, please do ensure you have the following items installed.

Java Development Kit ver 11 (JDK 11) is the environment / programming language in which TermiNUS is written with and IntelliJ IDEA will be the integrated development environment ( IDE) platform for us to write the programming codes on.

Go to link and retrieve the TermiNUS project file. You can do so by forking the project and cloning a copy into your computer.

To learn more about github fork-clone feature please follow the guide on link.

Setting up in Intellij

  1. Open the application IntelliJ IDEA.

  2. Inside IntelliJ IDEA navigate to open project button

    1. On the top left of the app, Fileโ†’Open...
  3. Locate and select the folder containing the files for Terminus that you have downloaded earlier on.

  4. Change the Project SDK that IntelliJ IDEA will be using.

    1. On the top left of the app, Fileโ†’Project Structure...
    2. Under Project SDK: section, find and select JDK version 11. Eg: Amazon Corretto version 11.0.12.
    3. Under Project language level:, select SDK default.
  5. Verifying the setup

    1. After performing the steps above, locate the file src/main/java/terminus/Terminus.java, right-click and select Run 'Terminus.main()'.
    2. If everything is correctly set up, you should see the following terminal.
    Welcome to TermiNUS!
    
    Type any of the following to get started:
    > exit
    > help
    > note
    > schedule
    
    [] >>>
    
    

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.

tp's People

Contributors

3m0w33d avatar kelvneo avatar louislouis19 avatar woolicious98 avatar j-lum avatar damithc avatar okkhoy avatar jiachen247 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.