Courseography

About

Here at the University of Toronto, we have hundreds of courses to choose from, and it can be hard to navigate prerequisite chains, program requirements, and term-by-term offerings all at once. That's where Courseography comes in: by presenting course and scheduling information in a set of graphical interactive tools, we make it easier to choose the right courses for your academic career. Whether it's making sure you'll satisfy all the prerequities for that 4th year course you really want to take, or fitting together fragments of your schedule for next term, we hope Courseography makes your life easier!

Powered by Haskell, Courseography was started in late 2013 by David Liu. However, it wasn't until he recruited Ian Stewart-Binks to the project that things really got rolling. Though the past two years have really seen our tools take off within the CS student body, there's still a long way for us to go. Our current projects include moving the front-end of the application over to React, unifying the graph viewing and drawing tools, and improved exporting and report generation.

Getting Involved

See CONTRIBUTING.md.

Installation

Download Courseography

  1. Run $ git clone https://github.com/Courseography/courseography.git to create a local copy of the Courseography.

Software Dependencies

First install the following:

  1. Haskell
  2. Node.js
  3. Yarn, by opening a terminal and running: npm install -g yarn
  4. ImageMagick
  5. GraphViz
  6. LaTeX

Then, open a terminal window and cd into your courseography repository folder. The remaining steps should all be run in this terminal window.

Other Files

Run these two steps manually.

  1. Copy app/DevelopmentConfig.hs to app/Config.hs with $ cp app/DevelopmentConfig.hs app/Config.hs
  2. Create the db folder with $ mkdir db

Installing

Run the following commands (the parts after # are just comments):

$ yarn install  # Install all Javascript dependencies
$ stack setup   # Install the required GHC compiler
$ stack build   # Compile Courseography and all Haskell dependencies (this will take a while)

Parsing and Generation

  1. Create the database file $ stack run database-setup
  2. Parse prerequisite graphs $ stack run database-graphs
  3. Parse course information from Arts and Science Calendar $ stack run database-calendar
  4. Parse course information from Arts and Science Timetable $ stack run database-timetable

Running

  1. Run $ yarn watch to build the web static assets (Javascript and CSS files)
  2. In a new terminal window Run $ stack run to start the server
  3. Navigate to http://localhost:8000/graph in your browser

When running in production you should run $ yarn build instead of $ yarn watch to build the web assets. This will take longer but results in smaller asset files.

Running front-end tests

To run all tests, run $ yarn run test. However, if you need to run a specific file or folder of tests, run $ yarn run test -- <path>.

Developers

If you are contributing to Courseography, you should install our pre-commit hooks:

  1. Install Python 3.
  2. In the project repository, install the pre-commit Python package: $ pip install pre-commit.
  3. Run pre-commit install to install the hooks.

  4. Finally, run pre-commit run to test out the hooks. You should see the following:

    $ pre-commit run
Trim Trailing Whitespace.............................(no files to check)Skipped
Fix End of Files.....................................(no files to check)Skipped
Check Yaml...........................................(no files to check)Skipped
prettier.............................................(no files to check)Skipped
stylelint............................................(no files to check)Skipped
Check Haskell files with stylish-haskell.............(no files to check)Skipped

Contributors

This project would not exist without the contributions of many students in the Department of Computer Science. In alphabetical order, our contributors are:

Alex Baluta, Mehdi Benallegue, Alexander Biggs, Kelly Bell, Ching Chang, Christina Chen, Eugene Cheung, Kael Deverell, Spencer Elliott, Lana El Sanyoura, Ryan Fan, Ailsa Fang, Christian Garcia, Ross Gatih, Nazanin Ghazitabatabai, Sidharth Gupta, Parker Hutcheson, Philip Kukulak, Jaeyong Lee, Ryan Lee, Tamara Lipowski, Lydia Liu, Nathan Liu, Siqi Liu, Jahnavi Matholia, Hermish Mehta, Mia Meng, Christine Murad, Justin Park, Harsh Patel, Sam Shaftoe, Ian Stewart-Binks, Maryam Taj, Betty Wang, Fullchee Zhang, Minfan Zhang, Alex Shih, Cassandra Stefura, Zi Kai Xu

Privacy Policy and Licensing

Click here to learn about our Privacy Policy.

Click here to learn about our licensing.