A CLI/GUI to shotgun classes from InforEstudante platform

Key Features • How To Use • Download • Credits • Special Thanks

Key Features

• Shotgun classes from InforEstudante before any of the other students
• Multi-threaded which means you can shotgun classes from different subjects at the same time
• Select multiple classes by order of preference
• Quickly and easily configurable through a JSON file
• Simple CLI that requires almost zero effort to use
  • Also available in the form of a Graphical User Interface (GUI) if you are not too into consoles and that kind of stuff

UPCOMMING: feature to keep application trying to subscribe to a class until successful

How To Use

CLI

To run this application you will only need to have Python 3.0.0 or higher installed on your computer.
Download rouba_turmas.py and config.json from the releases page and you are good to go, just run python rouba_turmas.py and the classes are all yours!

• Be sure to place the script and the JSON file in the same directory

Some libraries were used so you will need to install them using pip. To do so, grab requirements.txt and run one of the following commands on a terminal:

# install thorugh requirements.txt
$ pip install -r requirements.txt

# or just run this command
$ pip install bs4 lxml requests

Before launching the script you will need to edit the config.json file to fit your needs. Here is a example configuration:

{
    "time_to_run": "17:37:00", // specify a time for the script to run, leave "" to run immediately
    "domain": "inforestudante.ipc.pt",
    "student_number": "a2020143845",
    "classes": [
        {
            "name": "Arquiteturas Móveis",
            "practice": ["P2", "P3"],
            "theoric": ["T1"],
            "theoric_practice": []
        } //, add more subjects using the same format
    ]
}

• domain: the domain of your institution (only InforEstudante is supported)
• student_number: your student number/email
• classes: array of classes
  • name: name of the subject
  • practice: ID of practice class (ordered by preference)
  • theoric: ID of theoric class (ordered by preference)
  • theoric_practice: ID of theoric_practice class (ordered by preference)

After launching the script, it will show you what's happening behind the curtains as it goes and hopefully by the end you will have the classes you wanted the most :)

GUI

To clone and run this application, you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
$ git clone https://github.com/Asuryu/RoubaTurmasISEC

# Go into the repository
$ cd RoubaTurmasISEC
$ cd app

# Install dependencies
$ npm install

# Run the app
$ npm start

Note: If you do not want to follow the previous approach, you can always download a build of the application from the releases page.

Download

You can download the latest version of RoubaTurmasISEC for every platform that runs Python.

Note: For the GUI version, only Windows and Mac are supported

Credits

This software uses the following open source packages:

• Electron
• Node.js

Special Thanks

I extend my gratitude to those who helped this project become a reality:

IamM47Z

Yeshey