canance/terminal_advisor

Automate mundane tasks in Webadvisor for faculty advisors.

terminal_advisor

Summary

This script aims to automate mundane tasks in Webadvisor for faculty advisors. The following tasks are currently supported:

• Remove an advisement hold - Removes the advisement hold from an advisee's account
• Run a program evaluation - Runs a program evaluation for the active program listed in Webadvisor. The program evaluation is converted to pdf and stored in your current working directory.
• Advisee search - Search for an advisee using part of his/her name

Dependencies

• Python 3
  • bs4
  • configparser
  • keyring
  • pdfkit
  • PyQt5
  • selenium
• wkhtmltopdf
• Selenium WebDriver
  • PhantomJS
  • Chrome

Installation

1. Install wkhtmltopdf for your Operating System
2. Install a web driver for your Operating System:
   • PhantomJS
   • Chrome
3. Install Python 3
4. Install pip
5. Verify wkhtmltopdf, your selenium web driver, and python3 are in your environment's PATH variable.
6. Run python setup.py install

Usage

usage: terminal_advisor [-h] [--user USER] [--base-url BASE_URL]
                        [--config CONFIG] [--driver [{PhantomJS,Chrome}]] [-s]
                        [-r] [-e] [--gui] [--no-login]
                        [advisee]

Automate mundane tasks in Webadvisor

positional arguments:
  advisee               An advisee's name or a substring of the advisee's
                        name.

optional arguments:
  -h, --help            show this help message and exit
  --user USER           User name to log in to webadvisor
  --base-url BASE_URL   Base URL for webadvisor. Example: https://wa.xyz.edu/
  --config CONFIG       Path to a configuration file
  --driver [{PhantomJS,Chrome}]
                        Webdriver to use with Selenium
  -s, --save-config     Save configuration file
  -r, --remove-hold     Remove the advisement hold
  -e, --program-eval    Run a program evaluation
  --gui                 Run in GUI mode.
  --no-login            This option is only used with --gui. It tells the GUI
                        not to login on startup.

Future Development

• Add search for 'eAdvising'
• Pull advisee's schedule for a specific term
• Pull class roster
• Pull midterm grades
• Input midterm and final grades

Video Summary

http://www.youtube.com/watch?v=2aCkRnLgyVk