mjki4hj3 / get-scheduled

Python app that takes in course list with duration and outputs a pomodoro based schedule directly into Google Calendar

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Get Scheduled


How to setup

  1. Clone or fork into your local repository

  2. Install pipenv if you don't already have it

pip install pipenv
  1. Add your course list in the data folder. Note: you must use the exact column headers and name the file src-data.xlsx

  2. Create virtual python environment and install dependencies

pipenv shell && pipenv install 
  1. Setup Google OAuth Credentials and add the credentials.json file into the project root. Make sure to set the uri to http://localhost:5000/

  2. To run the application from the root directory

cd calendar && python quickstart.py
  1. When you first run the application approval needs to be given to the app

Project Aims

  • Have fun
  • Solve a real-world problem using Python
  • Gain practical experience in using collaborative tools such as GitHub and Trello

Project Objectives:

  • Create a schedule that serves as a guide for when to study and when to take breaks
  • The app takes in a course list (excel or csv) with duration of each topic (in this case a video course), as shown in Table 1, and outputs a study schedule based on parameters inputted by the user (e.g. study duration/day, break duration etc).

  • Outputted study schedule then gets automatically put into your Google Calendar via an API call

Current Outputs

  • Excel schedule outputed based on a pomodoro split of 45 minutes of study and 15 minutes break

  • Calendar events that were inserted based on above study schedule

Future Works

  • Current ongoing and future developments of this project can be seen detailed in the milestones tab

Resources

Setup

Pipenv Guide - Virtual Environment & Package Management

Google Calendar - Python Installation

Google Calendar API - OAuth Credentials Setup

Project Development

Pandas Documentation

Pandas Tutorials

Pandas Cheat Sheet

Information

What is the pomodoro study technique?

About

Python app that takes in course list with duration and outputs a pomodoro based schedule directly into Google Calendar

License:MIT License


Languages

Language:Jupyter Notebook 68.7%Language:Python 31.3%