tp-o / edusoft

Support register for courses and crawl your data on the HCMIU Edusoft website.

⛔ [DEPRECATED], use https://github.com/TP-O/goer instead

EduSoft

EduSoft Package can help you get information from https://edusoftweb.hcmiu.edu.vn easily.

Installation

NPM

npm install edusoft

Yarn

yarn add edusoft

Usage

You need to provide credentials before using any feature that requires authentication.

const edu = require("edusoft");

edu.config({
    username: "<Student ID>",
    password: "<Passwod>",
});

News

Crawl all the news from https://edusoftweb.hcmiu.edu.vn/default.aspx?page=danhsachthongtin&type=0.

const news = await edu.getNews();

Schedule of current week

Not support for specific week yet.

const schedule = await edu.getSchedule();

Midterm schedule

const midtermSchedule = await edu.getMidtermSchedule();

Final schedule

const finalSchedule = await edu.getFinalSchedule();

Tuition

Information about your tuition.

const tuition = await edu.getTution();

Transcript

Getting transcript bases on year and semester. Parameters:

• Year: required
• Semester: default 1

const transcript = await edu.getTranscript(<Year>, <Semester>);

Register for courses

Registering for courses bases on a list of subject IDs (How to get ID).
ID of a subject looks like this: PT002IU01 |PT002IU|Physical Training 2|01|3|3|01/01/0001|0|0|0| |0|ITIT19CS31.

Warning: Do not sign in to your account while this function is working.

await edu.register([<Subject_ID_1>, <Subject_ID_2>], true);