Ma'lumot tuzilmalari: lug'atdan dataclass gacha

qator = {"ism": "Aziz", "guruh": "A", "baho": 85}

print("1. Xato kalit — xato faqat ishga tushganda chiqadi:")
try:
    print(qator["bahosi"])
except KeyError as e:
    print("   KeyError:", e)

print("2. Hech kim tuzilishni kafolatlamaydi:")
buzuq = {"ism": "Bobur"}
print("   guruh bormi?", "guruh" in buzuq)

print("3. Har joyda kalit nomini qo'lda yozasiz:")
print("   qator['guruh'] — imlo xatosi qilsangiz, dastur jim ishlaydi va noto'g'ri natija beradi")

"""Ma'lumot tuzilmalari."""
from dataclasses import dataclass, field
from enum import Enum


class Daraja(str, Enum):
    """Baho darajasi. `str` dan meros oladi — JSON ga to'g'ridan-to'g'ri yoziladi."""
    ALO = "a'lo"
    YAXSHI = "yaxshi"
    QONIQARLI = "qoniqarli"
    QONIQARSIZ = "qoniqarsiz"

    @classmethod
    def bahodan(cls, baho):
        if baho >= 90:
            return cls.ALO
        if baho >= 75:
            return cls.YAXSHI
        if baho >= 60:
            return cls.QONIQARLI
        return cls.QONIQARSIZ


@dataclass(frozen=True, slots=True)
class Talaba:
    """Bitta tekshirilgan qator. O'zgarmas (frozen) — tasodifan buzib bo'lmaydi."""
    ism: str
    guruh: str
    baho: int
    sana: str

    @property
    def daraja(self):
        return Daraja.bahodan(self.baho)


@dataclass
class Natija:
    """Tekshiruv natijasi: to'g'ri qatorlar va xatolar."""
    talabalar: list = field(default_factory=list)
    xatolar: list = field(default_factory=list)

    @property
    def jami(self):
        return len(self.talabalar) + len(self.xatolar)

.venv/bin/python3 -c "
from hisobot.modellar import Talaba, Daraja, Natija
t = Talaba(ism='Aziz', guruh='A', baho=85, sana='2026-09-01')
print(t)
print('daraja:', t.daraja, '| qiymati:', t.daraja.value)
print('teng solishtirish ishlaydi:', t == Talaba('Aziz', 'A', 85, '2026-09-01'))
"

.venv/bin/python3 -c "
from hisobot.modellar import Talaba
t = Talaba('Aziz', 'A', 85, '2026-09-01')
t.baho = 100
"

.venv/bin/python3 -c "
from dataclasses import replace
from hisobot.modellar import Talaba
eski = Talaba('Aziz', 'A', 85, '2026-09-01')
yangi = replace(eski, baho=92)
print('eski :', eski.baho, eski.daraja.value)
print('yangi:', yangi.baho, yangi.daraja.value)
print('eski o\'zgarmadi:', eski.baho == 85)
"

from dataclasses import dataclass

@dataclass
class SlotsSiz:
    ism: str
    baho: int

@dataclass(slots=True)
class SlotsBilan:
    ism: str
    baho: int

a = SlotsSiz("Aziz", 85)
a.bahosi = 90                          # imlo xatosi: baho emas, bahosi
print("slots YO'Q   -> imlo xatosi jim o'tdi:", a.bahosi, "| haqiqiy baho:", a.baho)

b = SlotsBilan("Aziz", 85)
try:
    b.bahosi = 90
except AttributeError as e:
    print("slots BILAN  -> AttributeError:", e)

from dataclasses import dataclass
import sys

@dataclass(frozen=True, slots=True)
class Ikkalasi:
    x: int

print("Python", sys.version.split()[0])
try:
    Ikkalasi(1).xato_nom = 5
except Exception as e:
    print(f"  {type(e).__name__}: {e}")

import sys, time
from dataclasses import dataclass

@dataclass
class Oddiy:
    ism: str
    guruh: str
    baho: int
    sana: str

@dataclass(slots=True)
class Slotli:
    ism: str
    guruh: str
    baho: int
    sana: str

def hajmi(obj):
    """Obyekt + uning __dict__ i (bo'lsa)."""
    h = sys.getsizeof(obj)
    if hasattr(obj, "__dict__"):
        h += sys.getsizeof(obj.__dict__)
    return h

lugat = {"ism": "Aziz", "guruh": "A", "baho": 85, "sana": "2026-09-01"}
o = Oddiy("Aziz", "A", 85, "2026-09-01")
s = Slotli("Aziz", "A", 85, "2026-09-01")

import pandas as pd
show(pd.DataFrame([
    {"tur": "dict", "bayt": hajmi(lugat)},
    {"tur": "dataclass", "bayt": hajmi(o)},
    {"tur": "dataclass(slots=True)", "bayt": hajmi(s)},
]))

def olch(f, n=200_000):
    f()
    t0 = time.perf_counter()
    for _ in range(n):
        f()
    return (time.perf_counter() - t0) / n * 1e6

show(pd.DataFrame([
    {"amal": "yaratish", "dict, mks": round(olch(lambda: dict(ism="A", guruh="B", baho=1, sana="C")), 3),
     "dataclass, mks": round(olch(lambda: Oddiy("A", "B", 1, "C")), 3),
     "slots, mks": round(olch(lambda: Slotli("A", "B", 1, "C")), 3)},
    {"amal": "maydon o'qish", "dict, mks": round(olch(lambda: lugat["baho"]), 3),
     "dataclass, mks": round(olch(lambda: o.baho), 3),
     "slots, mks": round(olch(lambda: s.baho), 3)},
]))

def eski_usul(daraja):
    if daraja == "alo":                 # e'tibor bering: "a'lo" emas
        return "ajoyib"
    return "boshqa"

print("matn bilan:", eski_usul("a'lo"), "  <- jim noto'g'ri javob")

.venv/bin/python3 -c "
from hisobot.modellar import Daraja
print('to\'g\'ri:', Daraja('a\'lo'))
print('hamma qiymatlar:', [d.value for d in Daraja])
try:
    Daraja('alo')
except ValueError as e:
    print('XATO (yaxshi):', e)
"

.venv/bin/python3 -c "
import json
from hisobot.modellar import Daraja
print(json.dumps({'daraja': Daraja.ALO}))
print('matn sifatida solishtirish:', Daraja.ALO == 'a\'lo')
"

import pandas as pd
show(pd.DataFrame([
    {"tuzilma": "dict", "qachon": "Tuzilishi oldindan noma'lum; JSON dan endi o'qilgan xom ma'lumot"},
    {"tuzilma": "dataclass", "qachon": "Ichki modellar — maydonlar ma'lum va barqaror"},
    {"tuzilma": "dataclass(frozen)", "qachon": "Ma'lumot funksiyalar orasida yuradi; o'zgarmasligi kerak"},
    {"tuzilma": "NamedTuple", "qachon": "Kichik, indeks bilan ham murojaat qilinadi; to'liq o'zgarmas"},
    {"tuzilma": "Enum", "qachon": "Qiymatlar to'plami cheklangan: holat, daraja, tur"},
    {"tuzilma": "pydantic.BaseModel", "qachon": "Tashqi ma'lumotni tekshirish kerak (11-bob)"},
]))

"""CSV o'qish va qatorlarni tekshirib modelga aylantirish."""
import csv

from .modellar import Natija, Talaba
from .tekshiruv import bahoni_tekshir


def oqi(yol):
    """Faqat o'qiydi: lug'atlar ro'yxati."""
    with open(yol, encoding="utf-8") as f:
        return list(csv.DictReader(f))


def tozala(qatorlar):
    """Xom lug'atlarni Talaba obyektlariga aylantiradi."""
    natija = Natija()
    for i, q in enumerate(qatorlar, start=2):
        try:
            natija.talabalar.append(Talaba(
                ism=q.get("ism", "").strip(),
                guruh=q.get("guruh", "").strip(),
                baho=bahoni_tekshir(q.get("baho")),
                sana=q.get("sana", "").strip(),
            ))
        except ValueError as e:
            natija.xatolar.append((i, q.get("ism", "?"), str(e)))
    return natija

"""Statistika: kiritish/chiqarishsiz, faqat hisob."""
from collections import Counter


def guruh_ortachasi(talabalar):
    yigindi = {}
    for t in talabalar:
        jami, soni = yigindi.get(t.guruh, (0, 0))
        yigindi[t.guruh] = (jami + t.baho, soni + 1)
    return {g: round(jami / soni, 2) for g, (jami, soni) in sorted(yigindi.items())}


def daraja_taqsimoti(talabalar):
    return dict(Counter(t.daraja.value for t in talabalar).most_common())

"""python3 -m hisobot bilan ishga tushadi."""
import sys

from .hisob import daraja_taqsimoti, guruh_ortachasi
from .oqish import oqi, tozala


def main(argv=None):
    argv = sys.argv[1:] if argv is None else argv
    if not argv:
        print("ishlatish: python3 -m hisobot <fayl.csv>")
        return 2
    n = tozala(oqi(argv[0]))
    print(f"jami: {n.jami}, to'g'ri: {len(n.talabalar)}, xato: {len(n.xatolar)}")
    for g, o in guruh_ortachasi(n.talabalar).items():
        print(f"  {g}: {o}")
    print("darajalar:", daraja_taqsimoti(n.talabalar))
    for qator, ism, sabab in n.xatolar:
        print(f"  {qator}-qator ({ism}): {sabab}")
    return 0 if not n.xatolar else 1


if __name__ == "__main__":
    sys.exit(main())

"""CSV ma'lumotini tekshirib hisobot chiqaradigan asbob."""

from .hisob import daraja_taqsimoti, guruh_ortachasi
from .modellar import Daraja, Natija, Talaba
from .oqish import oqi, tozala
from .tekshiruv import bahoni_tekshir

__version__ = "0.4.0"
__all__ = ["daraja_taqsimoti", "guruh_ortachasi", "Daraja", "Natija", "Talaba",
           "oqi", "tozala", "bahoni_tekshir", "__version__"]

.venv/bin/python3 -c "
import hisobot
n = hisobot.tozala(hisobot.oqi('sinov_malumot.csv'))
print('jami qator:', n.jami, '| to\'g\'ri:', len(n.talabalar), '| xato:', len(n.xatolar))
print('guruh o\'rtachasi:', hisobot.guruh_ortachasi(n.talabalar))
print('darajalar:', hisobot.daraja_taqsimoti(n.talabalar))
print('birinchi talaba:', n.talabalar[0])
"
.venv/bin/python3 -m hisobot sinov_malumot.csv