search

lambdaloop / cal-schedule

A better UC Berkeley schedule planner. Basically a ninjacourses clone, but with the latest data.
http://lambdaloop.github.io/cal-schedule
MIT License
4 stars 3 forks source link

readme

Cal Planner

Remember when https://ninjacourses.com/ used to have Berkeley data and you could plan your schedule on it? Maybe not, but I do, and it was great.

Sadly, they dropped support, and we are left with CalCentral's schedule planner. It's usable, but still I preferred the more streamlined ninja courses. So this my ninjacourses clone to help plan courses for Fall 2016.

You can find it hosted here: http://lambdaloop.github.io/cal-schedule

Technicals

Scraping Schedules

For scraping the schedule pdfs, I use the excellent Tabula. Thanks to Raj Kesavan, we now have a simple script to update the schedule!

Download Tabula and update the TABULA_PATH inside the retrieve-data file to point to the downloaded jar. Then, you can simply run:

bash retrieve-data

This will fetch the latest schedule data from http://schedule.berkeley.edu/ , and update the berkeleytime.com schedule ids for enrollment data.

Frontend Overview

I tried to use some new tech with this, so this is built with:

Moving to Redux and ES6 definitely made the architecture and code cleaner.

Development

To develop, you need to get the latest npm packages, and then recompile the app with webpack:

npm install
wepback

For development, I recommend using webpack-dev-server, which auto-refreshes the webpage whenever you save. This is what I ran when developing:

webpack-dev-server --progress --colors --output-public-path=build

Once you've compiled the sources, you open the app by opening index.html in the browser of your choice.

Deployment

Github wants something in the gh-pages branch for deployment. I refactored the whole process into the deploy.sh script. So I just run bash deploy.sh to deploy the latest code online.

Contributing

I welcome pull requests! If you make one, I only ask you to try to use the latest ES6 syntax, and to avoid semicolons.

Thanks

Thanks to Ronald Kwan who built a schedule searcher from the same PDFs some time ago: http://rkwan.gitlab.io/cal-schedule/ This inspired me to build my own website as well (with the same name because it was good).

Thanks to Raj Kesavan for contributing a script to update the schedule easily.

Thanks to Jordon Wing for adding the "select all/none" feature.