Metadata-Version: 2.4
Name: pyworduz
Version: 0.0.1
Summary: Ushbu kutubxona orqali Word dasturi bilan ishlash mumkin!
Home-page: https://github.com/ozodbekcommunity
Author: G'ulomjonov Javohir
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-docx
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# рџ“ќ 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:

```bash
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. 

```python
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:

```python
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.
