/bilkent-scraper-kt

Kotlin port of my bilkent-scraper (from TypeScript).

Primary LanguageKotlinGNU General Public License v3.0GPL-3.0

bilkent-scraper-kt

Makeshift JVM-based API for Bilkent University services, achieved through lots of scraping.

Somewhat feature complete, somewhat work in progress.

This project was initially implemented with TypeScript, in another repository. Both ecosystems have their own merits, and I'm not sure which project will stay alive going forward (possibly both?).

Disclaimer

This is not an official project backed by the Bilkent University. It harmlessly scrapes the endpoints made available by them to any user. Do not misuse this package.

I do not (cannot) guarantee that the package will work as intended. Changes to the endpoints made by the university may break functionality at any time.

Features

  • Bilkent SRS
    • Request/parse the following: Academic Calendar, Attendance, Authentication, CGPA Calculator, Curriculum, Exam Schedule, Grades, Information Card, Letter Grade Statistics, Restricted Mode support, Weekly Schedule, Semester Course Details, Transcript
    • An authenticated SRS session object for ease of use
    • Factory methods with manual or automated verification to build sessions

Basic Usage

WIP

Bilkent SRS

Manual Verification

Automated Verification

Relevant Projects

  • SRS Mobile App (WIP)