Skip to main content

Package and scripts for interacting with Waterloo Works

Project description

Waterloo Works

A set of utilities used for interacting with Waterloo Works.

This project contains a set of utilities for interacting with Waterloo Works for employers.

Getting started

pip3 install waterlooworks

# Required for Apache Tika
brew cask install java8

# Required for pdftotext
brew install poppler #

This package depends on tika-python which requires Java 7+.

This package relies on the great pdf-redactor library created by Joshua Tauberer. The the core of the pdf-redactor library is embedded in waterlooworks since it is not available on pypi.


$ waterlooworks --help
Usage: waterlooworks [OPTIONS] COMMAND [ARGS]...

  A set of utilities for analyzing and processing WaterlooWorks intern

  --help  Show this message and exit.

  anonymize  Anonymize WaterlooWorks intern packages
  score      Analyze WaterlooWorks intern packages

Download the full resume package for interns from Waterloo Works

When logged into Waterloo Works, copy and past the contents of ww.js into the console. This script will trigger a dowload of the intern resume packages into your browser's Downloads folder. The script only downloads the packages visible on the current page, and not on additional paginated application pages.

pbcopy < ww.js

# 1. Log onto Waterloo Works, and navigate the the page containing applications
#    for your posting.
# 2. Paste into the console
# 3. Resumes for that page will be downloaded.

Print a table of scored / ranked waterlooworks packages

This script will output the metadata for resumes, in descending order based on the mean of term averages.

$ waterlooworks score data
1337 packages found
| Foo | 4A | 11111111 | 4A Software Engineering |  {'OUTSTANDING': 2, 'EXCELLENT': 2} | [80.0, 80.0, 80.0, 80.0, 80.0] |

Anonymize Packages

This is a simple attempt to try and remove references to names, gender and other information irrelevant to a package.

 $ waterlooworks anonymize ~/wwdata/ ~/anon1
1337 packages found


These utilities are best effort and do not guarantee the data is accurate. If the format for packages changes, this library will break.

These scripts should not be the sole way of evaluating candidates, they should augment typical hiring workflows.


If you have any ideas, just open an issue and tell me what you think.

If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.


MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

waterlooworks-0.0.1.tar.gz (16.4 kB view hashes)

Uploaded source

Built Distribution

waterlooworks-0.0.1-py3-none-any.whl (15.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page