Final Project

Description

My Calendar helps you keep track of your events on a calendar! You can add, delete, and edit events on your calendar by clicking on the event on the calendar. Optionally, you can also drag the events around on the calendar to update the time of the event.

Links to Container Images

Web App Database

Team Members

Lucia Song
Chelsea Hodgson
Yeshni Savadatti
Alan Zhao

How to Run the Application

1. Make sure to install, run, and login to Docker Destop on your local machine. You can do so with this link.
   

2. Make sure to have docker-compose installed.
   

3. Clone the repository by using the command:
   git clone [email protected]:software-students-fall2024/5-final-sg.git
   

4. Navigate into the project root folder.

5. To run the app, use the command:
   docker-compose up --build
   

Or run in detatched mode:
docker-compose up -d

6. To view the app, go to http://localhost:3000/.
   

7. To shut down the containers, run the command:
   docker-compose down
   

How to Run Tests the Web Application

1. Navigate into root directory of the app.

2. Set up a virtual environment, by using the commands: pip3 install pipenv OR pip install pipenv
   

3. Activate the virtual environment:
   pipenv shell
   

4. To run tests, use the command: pytest

How to Contribute to the Project

We welcome contributions! Here’s how you can help:

1. Fork the Repository: Start by forking the repository and cloning your fork to your local machine.
2. Create and Set up Virtual Environment: Set up a virtual environment with pipenv, using:
   pip install pipenv OR pip3 install pipenv
   and then:
   pipenv shell
   
3. Install Dependencies: Make sure you have the necessary dependencies installed if pipenv was not used:
   pip install -r requirements.txt OR pip3 install -r requirements.txt
   
4. Create a New Branch: Create a branch for your feature or bug fix.
5. Make Changes and Write Tests: Make your changes, ensuring that you add or update tests as needed in the tests directory. To run tests, use the command:
   pytest
   
6. Commit and Push Your Changes: After finishing your work on local machine, commit and push your changes to git.
7. Create a Pull Request: Go to the original repository and create a pull request for your changes.

Please ensure your codes come with meaningful commit messages and follow the PEP 8 standard, which can be found in detail here.