Python script for logging into University Of Benin (UNIBEN) Ugbowo campus Wi-Fi. There are 2 modes for executing the script:

• Headless :- Log in without opening browser window.
• Visual :- Open browser window to log in.

Contributing?

Follow this guide for details concerning contributing to a project, it covers forking a project, cloning, e.t.c.

Environment Set Up

You will need the following software installed:

• Python (version 3.10 >=, <3.20)
• Google Chrome Browser & corresponding webdriver (https://developer.chrome.com/docs/chromedriver/get-started) — If you use another browser, then you'll need to install the corresponding webdriver for the browser's version and modify the browser class defined here
• Install pre-commit hooks:

pre-commit install

You'll need to pip install all project dependencies, **(however I would recommend you use a [virtual environment](https://docs.python.org/3/library/venv.html))**: 
```bash
pip install -r requirements.txt

Code contribution

Anyone can contribute code to this repository. Ideally, I recommend you follow this guide (mentioned earlier).

Documentation contribution

Anyone can contribute documentation to this repository. However, in the interest of having a paper trail to rely on and for future reference, it will be better to open an issue with the documentation label detailing what's missing/incorrect about the current docs — if any — and your proposal on how such issue(s) can be addressed. Once you have a pull request ready relating to or addressing one or more issues, link the relevant issue(s) in the pull request.