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.
See CONTRIBUTING.md.
- Run
$ git clone https://github.com/Courseography/courseography.git
to create a local copy of the Courseography.
First install the following:
- Haskell
- Node.js v18.20.2 (not v20+)
- Yarn, by opening a terminal and running:
npm install -g yarn
- ImageMagick
- GraphViz
- LaTeX
Then, open a terminal window and cd
into your courseography
repository folder.
The remaining steps should all be run in this terminal window.
Run these two steps manually.
- Copy app/DevelopmentConfig.hs to app/Config.hs with
$ cp app/DevelopmentConfig.hs app/Config.hs
- Create the db folder with
$ mkdir db
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)
- Create the database file
$ stack run database-setup
- Parse prerequisite graphs
$ stack run database-graphs
- Parse course information from Arts and Science Calendar
$ stack run database-calendar
- Parse course information from Arts and Science Timetable
$ stack run database-timetable
- Run
$ yarn watch
to build the web static assets (Javascript and CSS files) - In a new terminal window Run
$ stack run
to start the server - Navigate to
https://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.
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>
.
If you are contributing to Courseography, you should run the following to install and test our pre-commit hooks:
yarn prepare
stack install hlint
npx lint-staged
(this will run the pre-commit hooks; make sure that it runs without errors)
This project would not exist without the contributions of many students in the Department of Computer Science. In alphabetical order, our contributors are:
Ismail Ahmed, Alex Baluta, Mehdi Benallegue, Alexander Biggs, Kelly Bell, Ching Chang, Christina Chen, Eugene Cheung, Mimis Chlympatsos, 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
Click here to learn about our Privacy Policy.
Click here to learn about our licensing.