SSU u-saint parser with Kotlin-Multiplatform and Ktor.

Hyomin Koo

Last update: Mar 23, 2022

Overview

kusaint

Soongsil University(SSU) u-Saint Parser with Kotlin Multiplatform.

Prerequisites

JVM !!IMPORTANT!!

To run kusaint as a library in JVM environment. You have to install DigiCert root CAs from u-Saint or other ssu sites.

This library won't disable ssl checks just because root CAs in ssu aren't included default keystore of JVM.

Download all three certificates, and install to keystore using keytool.

keytool -import -alias <alias> -cacerts -file <cert>

Write alias whatever you want, but add all three cert's path in cert.

After execution, you will prompt to type password of keystore.

Default password of keystore is changeit, so if you weren't changed the password, type it.

JS

In JavaScript, kusaint automatically installs required certificates.

Installation

JVM

Add GitHub Packages repository with url https://maven.pkg.github.com/EATSTEAK and add the xyz.eatsteak.kusaint-jvm dependency.

Maven

<dependencies>
    <dependency>
        <groupId>xyz.eatsteak</groupId>
        <artifactId>kusaint-jvm</artifactId>
        <version>1.0.1</version>
    </dependency>
    <!-- Other dependencies... -->
</dependencies>

Gradle (Groovy)

dependencies {
    implementation 'xyz.eatsteak:kusaint-jvm:1.0.1'
    // Other dependencies...
}

Gradle (Kotlin DSL)

dependencies {
    implementation("xyz.eatsteak:kusaint-jvm:1.0.1")
}

JS

JavaScript Installation isn't ready for npm yet.

If you use gradle or maven for javascript dependencies, you can add dependency xyz.eatsteak.kusaint-js.

Usage

For more info, please refer to Docs.

Examples

Kotlin

val kusaint = Kusaint()

kusaint.timeTable.major.find(2021, "2 학기", "IT대학", "글로벌미디어학부") // Find all lectures with given major.
kusaint.timeTable.requiredElectives.find(2021, "2 학기", "컴퓨팅적사고") // Find all required elective lectures with given lecture name.

Api Rest Card Game made in Kotlin with Ktor

ApiRest-CardGame "Card Game API" is a project made in Kotlin with Ktor. The API allows you to manage a simple card game deck (shuffle, take a card, pu

0 Dec 4, 2021

Kotlin Ktor REST Service

Servicio web para crear una API REST usando Kotlin y Kator así como otras tecnologías propuestas por JetBrains.

3 Jan 9, 2023

A small backend for the Thinkrchive app written in Kotlin with Ktor

A small backend for the Thinkrchive app written in Kotlin with Ktor. It uses Postgresql with a few requests and JWT authentication for admins.

6 Dec 12, 2022

Ktor is an asynchronous framework for creating microservices, web applications and more.

ktor-sample Ktor is an asynchronous framework for creating microservices, web applications and more. Written in Kotlin from the ground up. Application

5 Jan 22, 2022

Microservices with Ktor and Nomad

Microserviços com Ktor e Nomad Esse projeto é um teste prático de microserviços usando o framework Ktor, o banco de dados Postgres, o orquestrador de

3 Sep 16, 2022

🪟 Pluggable Ktor plugin to implement Sentry for error handling and request contexts

🪟 Ktor Plugin for Sentry Pluggable Ktor plugin to implement Sentry for error handling and request contexts. What is this library? This basically impl

3 Dec 6, 2022

Various Ktor extensions and plugins.

Ktor Plugins Collection of useful Ktor plugins. All plugins are hosted on Maven central and have same version that should be similar to the latest ver

25 Nov 24, 2022

🍓CookHelper - food social network. The Api and Websocket are based on Ktor framework. Dependency injection with Koin library.

CookHelper [ 🚧 Work in Progress 🚧 ] CookHelper is a cross-platform application that will allow you to cook a delicious dish from an existing recipe

11 Nov 9, 2022

It is a repository containing backend structure for Ktor.

Backend Architecture with Ktor + KMongo This project contains, Authentication using Jwt Database Layer (KMongo - Orm for MongoDB) Routing Advanced Rou

56 Dec 28, 2022

Comments

Add Getter for ComboBoxes in public api.
Api shows options for arguments when a given argument is not valid.

However, the User should have to find what argument is provided without exceptions.

enhancement
opened by EATSTEAK 0
Better way to find controls.
Refactor hard-coded controls id.

Since control id is not fixed value(it depends on state; a combination of actions), we have to find another way to find controls.

bug enhancement
opened by EATSTEAK 0
Add more documentation for advanced usage.
Add docs for internal apis.(like xyz.eatsteak.kusaint.model, xyz.eatsteak.kusaint.state, xyz.eatsteak.kusaint.action, xyz.eatsteak.eventqueue packages.)

documentation enhancement
opened by EATSTEAK 0
Better support for java interop.
Currently, kusaint uses kotlinx-coroutines-core for asynchronous operation.

This causes a lot of problems in pure java, so we have to provide "Future" methods like CompletableFuture.

enhancement
opened by EATSTEAK 0