JUReg

A web scraper for the registration website of the University of Jordan.

This library accesses the registration website and looks for courses you want to register in and tells you if any of them is open saving you a lot of time and effort.

Installation

Place the jureg folder in under (..\Python\Lib\site-packages). This will install the library system-wide.
Alternatively, you can just place it in the same directory as your python script.

Dependencies:

• PIL - pip install Pillow

• pytesseract - pip install pytesseract
  After installing the library, you need to download tesseract.
  If you are on windows you have to install it in C:\Program Files\Tesseract-OCR\ .

• selenium - pip install selenium
  You also need to download the WebDriver for your choice of browser and put it in PATH or just place it in the same directory as your code.
  Firefox(recommended): geckodriver
  Chrome: ChromeDriver

Usage

Constructor
Parameters:

• username: The username of the account you want to access the website with.
• password: The password of the account you want to access the website with.
• filepath: Alternatively sign-in credentials can be provided in a file as demonstrated in the example.
• target: Callback function after checking courses is finished. Expects a dictionary of open courses found with the course ID as the key and a list of open sections of that course as the value.
• ocr: This gives the option to provide an alternative OCR function. The built-in function is 70% accurate but better results could be achieved. Expects a PIL Image and returns a str of the captcha word.
• headless: This gives the option to make the webdriver headless. If set to True the constructor won't launch the webdriver GUI and everything will be ran in the background.
• refresh: How often you want the watched courses to be checked in minutes. If set to -1 it will only perform a single check.
• driver: The browser you want to use. 'ff' for Firefox, 'ch' for Chrome. Note that you need to download the WebDriver for your browser as explained in the installation section.

add_sections()
Parameters:

• courseID: The ID of the course the sections belong to.
• sections: List of sections you want JUReg to watch for you.

example:
Let's say you want to it to keep checking these sections:

you do the following:

JU.add_sections('0907528', [1, 2])

run()
Calling this starts a new thread and keeps calling check_watching() every refresh minutes and calls target after it's done checking.

check_watching()
Calling this will only check watched courses once and return the results in a dictionary.