Auto Course Checker/Registrar

A CLI script to check/register courses from KFUPM Course Offering and Banner 9.

Prerequisites

You don't need to install any prerequisites, because install.sh script (for MacOS & Linux & WSL) and install.ps1 (for Windows) will install all the required dependencies for you (go to Installation), but you can install the dependencies manually if you want.

Minimal Manual Prerequisites

Python3.7+ Note: Make sure you install the correct version. You can check the version of Python you have installed by running python --version or python3 --version in the command prompt or terminal.
Browser: Chrome or Firefox. Currently, the script only supports Chrome and Firefox. If you want to use other browsers, you could open an issue on GitHub.
Browser Drivers Note: You have to create drivers folder and move the drivers to it then move the whole folder to the project. e.g., drivers/chromedriver.exe and drivers/geckodriver.exe.

Installation

Project Installation

Command-Line Interface (CLI)

Method	Command
cmd	`curl.exe -SLfso auto-registrar.zip https://github.com/Yokozuna59/auto-registrar/archive/refs/heads/master.zip && compact /u auto-registrar.zip /Q && del auto-registrar.zip`
curl	`curl -SLfso auto-registrar.zip https://github.com/Yokozuna59/auto-registrar/archive/refs/heads/master.zip && unzip auto-registrar.zip && rm auto-registrar.zip`
git	`git clone https://github.com/Yokozuna59/auto-registrar.git`
powershell	`Invoke-WebRequest -URI "https://github.com/Yokozuna59/auto-registrar/archive/refs/heads/master.zip" -OutFile "auto-registrar.zip" && Expand-Archive -Path "auto-registrar.zip" -DestinationPath (Get-Location).Path -Force && Remove-Item -Path "auto-registrar.zip" -Force`
wget	`wget -O auto-registrar.zip https://github.com/Yokozuna59/auto-registrar/archive/refs/heads/master.zip --quiet && unzip auto-registrar.zip && rm auto-registrar.zip`

Graphical User Interface (GUI)

Requirements Installation

Change directory to the auto-registrar folder:

cd auto-registrar

Platform	Command
Linux	`chmod +x install.sh && ./install.sh`
MacOS	`chmod +x install.sh && ./install.sh`
WSL	`chmod +x install.sh && sed -i 's/\r$//' install.sh && ./install.sh`
PowerShell	`Set-ExecutionPolicy -ExecutionPolicy Bypass && .\install.ps1`

Run the Script

Open Command Prompt or Terminal in project directory

It would be better to use Virtual Environment.

Platform	Command
Linux	`python3 -m venv .venv && source .venv/bin/activate`
MacOS	`python3 -m venv .venv && source .venv/bin/activate`
WSL	`python3 -m venv .venv && source .venv/bin/activate`
PowerShell	`python -m venv .venv && .venv/Scripts/activate.ps1`

Install requirements

pip install -r requirements.txt
# or pip3 install -r requirements.txt

Run the script:

python -m auto_registrar
# or python3 -m auto_registrar

To deactivate the virtual environment:
```
deactivate
```