yokatlas-py

Genel Bakış

yokatlas-py, YÖKATLAS API için pydantic doğrulamalı, modern ve tip-güvenli bir Python wrapper'ıdır. Türk üniversite ve program verilerine programatik erişim sağlar.

Özellikler

• Tip Güvenliği: Pydantic doğrulamalı tam tip ipuçları
• Modern Python: Python 3.9+ gerektiren güncel sözdizimi
• Hızlı HTTP: Senkron ve asenkron işlemler için httpx
• Akıllı Arama: Üniversiteler ve programlar için fuzzy matching
• Kapsamlı Veri: 235 lisans ve 176 önlisans kurumu
• IDE Desteği: Gelişmiş otomatik tamamlama ve hata algılama

Kurulum

# pip ile
pip install yokatlas-py

# uv ile (önerilen)
uv add yokatlas-py

Kullanım Örnekleri

Akıllı Lisans Program Arama

from yokatlas_py import search_lisans_programs

results = search_lisans_programs({
    "uni_adi": "boğaziçi",
    "program_adi": "bilgisayar",
    "sehir": "istanbul"
})

Tip-Güvenli Arama

from yokatlas_py.models import SearchParams

params = SearchParams(
    puan_turu="say",
    length=10,
    sehir="İstanbul"
)

Geleneksel API Kullanımı

from yokatlas_py import YOKATLASLisansTercihSihirbazi

search = YOKATLASLisansTercihSihirbazi({
    'puan_turu': 'say',
    'sehir': 'ANKARA',
    'length': 5
})
results = search.search()

Arama Parametreleri

• uni_adi: Üniversite adı (fuzzy matching destekli)
• program_adi: Program adı
• sehir: Şehir
• puan_turu: Puan türü (say, söz, ea, dil)
• uni_turu: Devlet / Vakıf
• ucretli: Ücretli / Ücretsiz
• burslu: Burslu programlar
• ogretim_turu: Örgün / İkinci öğretim

Veri İçeriği

• Taban ve tavan puanları
• Kontenjan bilgileri
• Yerleşen profili istatistikleri
• Tercih sıralaması
• Başarı sıralaması değişimleri

Lisans

MIT License