---

✨ Features

• 코루틴 기반 비동기 API
• 간단한 Client 호출 구조
• DTO → Domain 자동 변환
• Kotlin 친화적 DSL API 설계
• 시간표 누락 교시 자동 채우기
• 날짜 / 학년 / 반 / 급식 타입 등 다양한 조회 지원

---

📦 Installation

repositories {
    maven { url = uri("https://jitpack.io") }
}

val keisVersion = "2.0.6"
dependencies {
    implementation("com.github.mrjimin.Keis:ktor:$keisVersion") // ktor
    implementation("com.github.mrjimin.Keis:http4k:$keisVersion") // http4k
    implementation("com.github.mrjimin.Keis:spring-boot:$keisVersion") // spring-boot (WebFlux, RestClient)
}

---

🚀 Quick Start

suspend fun main() {
    val client = KeisClient("YOUR_API_KEY", engine) // keis("YOUR_API_KEY")
  
    // 학교 컨텍스트 생성
    val context = client.schoolContext("우석고") ?: return

    // Meal
    val lunch = context.meals {
        dateRange { 
            today()
        }
        type(MealType.LUNCH)
    }

    // Timetable
    val advancedTimetable = context.timetables { 
        grade(2)
        classNumber(5)
        fillMissing(true)
        today()
    }
    
    // Schedule
    val specificSchedule = context.schedules { 
        dateRange { 
            single(LocalDate.of(2026, 4, 2)) 
        }
    }
  
}

👉 자세한 사용법은 아래 API 또는 Example을 참고하세요.

---

📚 API

🏫 School

client.school("학교명")
client.schools("학교명")

🍽️ Meal

context.meal {
    type(MealType.BREAKFAST)
    today()
}

context.meal { 
    dateRange { 
        thisWeek()
    }
}

📚 Timetable

context.timetable {
    grade(2)
    classNumber(5)
    fillMissing()
}

📅 Schedule

context.schedule {
  today()
  dayNightCourse(DayNightCourse.DAY)
  schoolCourse(SchoolCourse.GENERAL)
}

---

📎 References

• NEIS Open API: https://open.neis.go.kr
• Other implementations:
  • https://github.com/nnnlog/neis
  • https://github.com/kimcore/neis.kt

---

🤝 Contributing

Keis는 누구나 기여할 수 있습니다! 🎉

1. 기여 방법

1. 이 레포지토리를 Fork 합니다.
2. 새로운 브랜치를 생성합니다.
3. 코드를 수정합니다.
4. Pull Request를 생성합니다.

2. 코드 스타일

• Kotlin 스타일 가이드를 따릅니다.
• 불필요한 null 사용을 지양합니다.
• Domain / DTO 분리를 유지합니다.

3. 기타

• 작은 수정도 환영합니다 🙌
• 문서 개선도 훌륭한 기여입니다!