pyworduz 0.0.1

Ushbu kutubxona orqali Word dasturi bilan ishlash mumkin!

рџ“ќ pyworduz

Python orqali Word (.docx) hujjatlarini yaratish uchun mukammal va eng sodda kutubxona.

pyworduz — bu murakkab python-docx kodlarini yozishdan xalos etuvchi, zamonaviy va tushunarli API'ga ega o'zbekcha kutubxona. Uning yordamida hisobotlar, taqdimot matnlari, darsliklar yoki avtomatlashtirilgan hujjatlarni bir necha qator kod bilan, toza va professional ko'rinishda generatsiya qilishingiz mumkin.

---

рџљЂ O'rnatish

Kutubxonani PIP paketlar menejeri orqali oson o'rnatish mumkin:

pip install pyworduz

Talab: Tizimda Python 3.6+ o'rnatilgan bo'lishi kerak.

---

вљЎпёЏ Tezkor Boshlanish

Quyidagi qisqa va toza kod bloki orqali kutubxonaning qanday ishlashini tushunib olishingiz mumkin.

from pyworduz import WordHujjat

# 1. Hujjatni initsializatsiya qilish
doc = WordHujjat()

# 2. Asosiy sarlavha qo'shish (Zamonaviy shrift va markazlashtirilgan)
doc.sarlavha_qoshish(
    matn="Oylik Hisobot", 
    daraja=0, 
    tekislash="markaz", 
    shrift="Plus Jakarta Sans", 
    rang="#111827", 
    qalin=True
)

# 3. Chiroyli va o'qishli matn qo'shish
doc.matn_qoshish(
    matn="Ushbu hujjat pyworduz kutubxonasi yordamida toza (clean) va avtomatlashtirilgan tarzda yaratildi.",
    shrift="Plus Jakarta Sans", 
    olcham=12,
    rang="#4B5563"
)

# 4. Hujjatni kompyuterga saqlash
doc.saqlash("Hisobot.docx")

---

рџ›  Imkoniyatlar (API Reference)

Kutubxona keraksiz qiyinchiliklarsiz, faqat kerakli va eng muhim funksiyalarni taqdim etadi.

рџ“Њ Matn va Sarlavhalar

Metod	Tavsif	Asosiy parametrlar
sarlavha_qoshish()	Hujjatga Heading qo'shadi	matn, daraja, tekislash, shrift, rang
matn_qoshish()	Oddiy abzas qo'shadi	matn, tekislash, qalin, shrift, olcham
mundarija_qoshish()	Avtomatik Table of Contents (TOC)	-
yangi_sahifa()	Page Break (Yangi sahifaga o'tish)	-

рџ“Љ Ma'lumotlarni Vizualizatsiya Qilish

Metod	Tavsif	Asosiy parametrlar
jadval_qoshish()	2D Massiv orqali jadval yaratadi	malumotlar (list), sarlavha_qatori (bool)
diagramma_qoshish()	Chart (Grafik) chizadi	nomi, toifalar, seriyalar, tur (ustun/aylana)
rasm_qoshish()	Hujjatga rasm joylaydi	rasm_yoli, kenglik_sm, tekislash

рџ’ѕ Saqlash

Metod	Tavsif	Asosiy parametrlar
saqlash()	Tayyor faylni xotiraga yozadi	fayl_nomi (masalan, natija.docx)

---

рџЋЁ Mukammal Misol: Jadval va Diagramma

Agar sizga statistika va jadvallarni o'zida jamlagan professional hisobot kerak bo'lsa:

from pyworduz import WordHujjat

doc = WordHujjat()
doc.sarlavha_qoshish("Qabul Qilingan Talabalar Statistikasi", daraja=1, shrift="Fredoka")

# Dinamik Jadval yaratish
oquvchilar = [
    ["Guruh", "O'quvchilar soni", "O'zlashtirish (%)"],
    ["Frontend", 120, 85],
    ["Backend", 95, 88],
    ["Sun'iy Intellekt", 50, 92]
]
doc.jadval_qoshish(oquvchilar)

doc.yangi_sahifa()

# Diagramma qo'shish
toifalar = ["Frontend", "Backend", "Sun'iy Intellekt"]
seriyalar = {"Qabul qilinganlar": [120, 95, 50]}

doc.sarlavha_qoshish("Yo'nalishlar bo'yicha taqsimot", daraja=2)
doc.diagramma_qoshish("Talabalar", toifalar, seriyalar, tur="ustun")

doc.saqlash("Statistika_2026")

---

рџ“„ Litsenziya

Ushbu loyiha MIT License ostida tarqatiladi. Kutubxonadan shaxsiy, ta'lim va tijorat maqsadlarida bemalol foydalanishingiz mumkin.