postgresdb3 2.0.2__tar.gz → 2.0.3__tar.gz

{postgresdb3-2.0.2 → postgresdb3-2.0.3}/PKG-INFO

@@ -1,223 +1,254 @@
-Metadata-Version: 2.4
-Name: postgresdb3
-Version: 2.0.2
-Summary: High-Performance Sync and Async PostgreSQL ORM for Python
-Author: Abdulbosit Alijonov
-Project-URL: Source Code, https://github.com/AlijonovUz/PostgresDB
-Classifier: Programming Language :: Python :: 3.9
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: psycopg2>=2.9
-Requires-Dist: asyncpg>=0.31.0
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# PostgresDB3 - High-Performance Python ORM
-
-**PostgresDB3** — bu PostgreSQL uchun mo'ljallangan zamonaviy, tezkor va ham **sinxron**, ham **asinxron** ishlash imkoniyatiga ega bo'lgan ORM (Object-Relational Mapping) kutubxonasi. 
-
-U Django ORM kabi qulay va oson tushuniladi, lekin o'zida asinxronlik (`asyncpg`) va ko'plab yuqori texnologik xususiyatlarni mujassamlashtirgan. Kichik botlardan tortib, o'ta katta masshtabdagi (Highload) loyihalargacha bemalol ishlata olasiz!
-
----
-
-## 📦 O'rnatish
-
-Kutubxonani o'rnatish uchun terminalda quyidagi buyruqni kiriting:
-
-```bash
-pip install postgresdb3
-```
-
----
-
-## 🚀 Yangi (v2.0) Imkoniyatlari
-
-Ushbu "Enterprise" versiyada loyihaga quyidagi gigant imkoniyatlar qo'shildi:
-- **`values()` va `values_list()`** - Xotirani tejash uchun to'g'ridan to'g'ri `dict` yoki `list` qaytarish.
-- **`get_or_create()` va `update_or_create()`** - Kodlarni sezilarli darajada qisqartirish.
-- **`__` orqali Auto-Join** - Munosabatlarni avtomatik bog'lash (Masalan: `filter(user__profile__age__gt=18)`).
-- **Mavhum Modellar (Abstract Models)** - Qayta-qayta kod yozmaslik uchun `class Meta: abstract = True`.
-- **`annotate()` va `aggregate()`** - Murakkab matematik va guruhlash amallari.
-- **`update()` va `delete()` (Ommaviy)** - Obyektlarni bazada bitta qatorda ommaviy tahrirlash yoki o'chirish.
-
----
-
-## ⚡ Tezkor Boshlash
-
-PostgresDB3 bir vaqtning o'zida ikkita dunyoni qo'llab-quvvatlaydi. Xohlasangiz **Sinxron**, xohlasangiz **Asinxron** loyihalarda bir xil sintaksis bilan ishlay olasiz.
-
-### 1. Ulanishni sozlash
-
-```python
-from postgresdb3 import PostgresDB, AsyncPostgresDB
-
-# Sinxron ulanish (psycopg2 asosida)
-db_sync = PostgresDB("my_db", "user", "password", host="localhost", port=5432, echo=True)
-
-# Asinxron ulanish (asyncpg asosida)
-db_async = AsyncPostgresDB("my_db", "user", "password", host="localhost", port=5432, echo=True)
-```
-*(Eslatma: `echo=True` yoqilsa, barcha bajarilayotgan SQL so'rovlar terminalda ko'rinib turadi, bu debug uchun juda foydali).*
-
-### 2. Modellarni Yaratish (Abstract Model namunasida)
-
-```python
-from postgresdb3.orm.models import Model, AsyncModel
-from postgresdb3 import String, Integer, Float, Timestamp
-
-Model.db = db_sync
-
-class TimestampedModel(Model):
-    class Meta:
-        abstract = True # Jadval yaratilmaydi
-        
-    created_at = Timestamp(auto_now_add=True)
-
-class User(TimestampedModel):
-    name = String(length=50)
-    age = Integer(default=18)
-    score = Float(default=0.0)
-    
-    class Meta:
-        unique_together = (("name", "age"),) # Ism va yosh bir xil takrorlanmasligi kerak
-        index_together = (("score",),)       # Qidiruvni tezlashtirish uchun index
-```
-
-### 3. CRUD Operatsiyalari
-
-**Yangi funksiyalar yordamida:**
-```python
-# Yaratish yoki o'qish (Bazada bo'lmasa yaratadi)
-user, created = User.get_or_create(name="Ali", defaults={'age': 25, 'score': 10.0})
-
-# Ommaviy yangilash (Xotirani to'ldirmasdan)
-User.query().filter(age__lt=18).update(score=0.0)
-
-# Ommaviy o'chirish
-User.query().filter(score=0.0).delete()
-```
-
-**Tezkor O'qish (Values & Values List):**
-Agar modellar bilan ishlash shart bo'lmasa va faqat JSON yuborish kerak bo'lsa:
-```python
-users_dict = User.query().values('id', 'name').all()
-# [{'id': 1, 'name': 'Ali'}, {'id': 2, 'name': 'Vali'}]
-
-names_list = User.query().values_list('name', flat=True).all()
-# ['Ali', 'Vali']
-```
-
----
-
-## 🔄 Migratsiya Tizimi (CLI)
-
-Siz o'z loyihangiz papkasida bitta `manage.py` yaratib olib, jadvallarni SQL o'qib-o'tirmasdan terminal orqali avtomatik yangilab borishingiz mumkin.
-
-**`manage.py`:**
-```python
-import sys
-from postgresdb3 import execute_from_command_line
-from myapp.models import db_sync  # Sizning bazaga ulangan db obyektingiz
-
-# Modellar dvigatelga ko'rinishi uchun barchasini import qilish SHART!
-from myapp.models import User, Post 
-
-if __name__ == "__main__":
-    execute_from_command_line(db_sync, sys.argv)
-```
-
-**Terminalda:**
-```bash
-# Modellar asosida migratsiya faylini tayyorlash
-python manage.py makemigrations initial_setup
-
-# Bazaga jadvallarni qo'shish
-python manage.py migrate
-
-# Oxirgi migratsiyani bekor qilish va qaytarish (Rollback)
-python manage.py undo
-```
-
----
-
-## 🔍 Murakkab Qidiruv va Aloqalar (Relations)
-
-**Auto-Join (Bog'langan jadvallar bo'ylab o'tish):**
-Qo'lda JOIN yozish o'rniga, qo'shaloq chiziqcha `__` ishlating:
-```python
-posts = Post.query().filter(author__name__startswith='A').all()
-```
-
-**Q va F ifodalar (Murakkab shartlar):**
-```python
-from postgresdb3 import Q, F
-
-# OR (|) sharti
-User.query().filter(Q(age__gt=20) | Q(name="Ali")).all()
-
-# Yoshiga nisbatan score'i katta bo'lganlarni izlash
-User.query().filter(score__gt=F("age")).all()
-```
-
-**N+1 xatoligini chetlab o'tish (select_related & prefetch_related):**
-```python
-# ForeignKey uchun (1 ta SQL so'rov)
-posts = Post.query().select_related("author").all()
-
-# ManyToMany uchun (Optimallashtirilgan yig'ish)
-posts = Post.query().prefetch_related("tags").all()
-```
-
----
-
-## 📊 Katta Ma'lumotlar bilan Ishlash (Bulk & Pagination)
-
-**Sahifalash (Pagination):**
-Foydalanuvchiga ma'lumotlarni qismlab taqdim etish:
-```python
-result = User.query().paginate(page=1, per_page=20)
-print(result['total'])        # Jami elementlar soni
-print(result['has_next'])     # Keyingi sahifa bormi?
-print(result['data'])         # Modellar ro'yxati (20 ta)
-```
-
-**Ommaviy Yozish (Bulk Create):**
-10,000 ta obyekti birma-bir emas, bitta so'rov orqali kiritish:
-```python
-users = [User(name=f"U-{i}", age=20) for i in range(10000)]
-User.bulk_create(users)
-```
-
----
-
-## 📈 Agregatsiya va Annotatsiya (GroupBy)
-
-Baza orqali kalkulyatsiyalarni amalga oshirish:
-
-```python
-from postgresdb3 import Sum, Avg, Count
-
-# Jami obshiy statiska:
-result = User.query().aggregate(
-    total_score=Sum("score"),
-    avg_age=Avg("age")
-)
-# {'total_score': 1500, 'avg_age': 25}
-
-# Guruhlab hisoblash (Masalan: Har bir userning postlari soni):
-users_with_count = User.query().annotate(post_count=Count("posts")).all()
-for u in users_with_count:
-    print(u.name, u.post_count)
-```
-
----
-
-*Ushbu ORM kutubxonasi Python olamidagi ilg'or texnologiyalar yordamida tezlik va barqarorlikni birinchi o'ringa qo'yuvchi mutaxassislar uchun maxsus qurilgan.*
+Metadata-Version: 2.4
+Name: postgresdb3
+Version: 2.0.3
+Summary: High-Performance Sync and Async PostgreSQL ORM for Python
+Author: Abdulbosit Alijonov
+Project-URL: Source Code, https://github.com/AlijonovUz/PostgresDB
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: psycopg2-binary>=2.9
+Requires-Dist: asyncpg>=0.31.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PostgresDB3 - High-Performance Python ORM
+
+**PostgresDB3** — bu PostgreSQL uchun mo'ljallangan zamonaviy, tezkor va ham **sinxron**, ham **asinxron** ishlash imkoniyatiga ega bo'lgan ORM (Object-Relational Mapping) kutubxonasi. 
+
+U Django ORM kabi qulay va oson tushuniladi, lekin o'zida asinxronlik (`asyncpg`) va ko'plab yuqori texnologik xususiyatlarni mujassamlashtirgan. Kichik botlardan tortib, o'ta katta masshtabdagi (Highload) loyihalargacha bemalol ishlata olasiz!
+
+---
+
+## 📦 O'rnatish
+
+Kutubxonani o'rnatish uchun terminalda quyidagi buyruqni kiriting:
+
+```bash
+pip install postgresdb3
+```
+
+### ⚠️ Linux/macOS tizimlarida o'rnatish va muammolar yechimi
+
+`postgresdb3` ishlashi uchun sinxron ulanishlarda `psycopg2` kutubxonasidan foydalanadi. O'rnatish vaqtida tizimingiz holatidan kelib chiqib, quyidagi ikki variantdan biri avtomatik tanlanadi:
+
+1. **`psycopg2` (Kompilyatsiya qilinadigan variant)**: Agar tizimingizda PostgreSQL ning ishlab chiquvchi kutubxonalari (`pg_config` va `pg_config.h` fayllari, masalan `libpq-dev`) mavjud bo'lsa, kutubxona manbadan (source) kompilyatsiya qilinadi. Bu ishlab chiqarish (production) muhitlari uchun tavsiya etiladi.
+2. **`psycopg2-binary` (Tayyor variant)**: Agar tizimingizda kompilyatsiya qilish uchun kerakli PostgreSQL kutubxonalari topilmasa, o'rnatish jarayoni muvaffaqiyatli yakunlanishi uchun avtomatik ravishda tayyor pre-compiled `psycopg2-binary` o'rnatiladi. Bu lokal dasturlash va test muhitlari uchun juda mos keladi.
+
+#### Tizim kutubxonalarini o'rnatish (Tavsiya etiladi)
+Ishlab chiqarish (production) muhitida toza `psycopg2` (manbadan yig'iladigan) ishlatish tavsiya etiladi. Buning uchun `postgresdb3` ni o'rnatishdan oldin quyidagi tizim paketlarini o'rnatib olishingiz kerak bo'ladi:
+
+* **Debian/Ubuntu:**
+  ```bash
+  sudo apt update
+  sudo apt install python3-dev libpq-dev build-essential
+  ```
+* **RedHat/CentOS/Fedora/Rocky Linux:**
+  ```bash
+  sudo dnf install python3-devel postgresql-devel gcc
+  ```
+* **macOS (Homebrew):**
+  ```bash
+  brew install libpq
+  ```
+
+#### Majburiy kompilyatsiya rejimini yoqish
+Agar siz pre-compiled binary versiyadan mutlaqo foydalanmasdan, toza manbali `psycopg2` ni majburiy ravishda yig'moqchi bo'lsangiz, terminalda quyidagi muhit o'zgaruvchisini (env variable) ko'rsatgan holda o'rnatishni amalga oshiring:
+
+```bash
+POSTGRESDB_SOURCE_PSYCOPG2=1 pip install postgresdb3
+```
+
+---
+
+## 🚀 Yangi (v2.0) Imkoniyatlari
+
+Ushbu "Enterprise" versiyada loyihaga quyidagi gigant imkoniyatlar qo'shildi:
+- **`values()` va `values_list()`** - Xotirani tejash uchun to'g'ridan to'g'ri `dict` yoki `list` qaytarish.
+- **`get_or_create()` va `update_or_create()`** - Kodlarni sezilarli darajada qisqartirish.
+- **`__` orqali Auto-Join** - Munosabatlarni avtomatik bog'lash (Masalan: `filter(user__profile__age__gt=18)`).
+- **Mavhum Modellar (Abstract Models)** - Qayta-qayta kod yozmaslik uchun `class Meta: abstract = True`.
+- **`annotate()` va `aggregate()`** - Murakkab matematik va guruhlash amallari.
+- **`update()` va `delete()` (Ommaviy)** - Obyektlarni bazada bitta qatorda ommaviy tahrirlash yoki o'chirish.
+
+---
+
+## ⚡ Tezkor Boshlash
+
+PostgresDB3 bir vaqtning o'zida ikkita dunyoni qo'llab-quvvatlaydi. Xohlasangiz **Sinxron**, xohlasangiz **Asinxron** loyihalarda bir xil sintaksis bilan ishlay olasiz.
+
+### 1. Ulanishni sozlash
+
+```python
+from postgresdb3 import PostgresDB, AsyncPostgresDB
+
+# Sinxron ulanish (psycopg2 asosida)
+db_sync = PostgresDB("my_db", "user", "password", host="localhost", port=5432, echo=True)
+
+# Asinxron ulanish (asyncpg asosida)
+db_async = AsyncPostgresDB("my_db", "user", "password", host="localhost", port=5432, echo=True)
+```
+*(Eslatma: `echo=True` yoqilsa, barcha bajarilayotgan SQL so'rovlar terminalda ko'rinib turadi, bu debug uchun juda foydali).*
+
+### 2. Modellarni Yaratish (Abstract Model namunasida)
+
+```python
+from postgresdb3.orm.models import Model, AsyncModel
+from postgresdb3 import String, Integer, Float, Timestamp
+
+Model.db = db_sync
+
+class TimestampedModel(Model):
+    class Meta:
+        abstract = True # Jadval yaratilmaydi
+        
+    created_at = Timestamp(auto_now_add=True)
+
+class User(TimestampedModel):
+    name = String(length=50)
+    age = Integer(default=18)
+    score = Float(default=0.0)
+    
+    class Meta:
+        unique_together = (("name", "age"),) # Ism va yosh bir xil takrorlanmasligi kerak
+        index_together = (("score",),)       # Qidiruvni tezlashtirish uchun index
+```
+
+### 3. CRUD Operatsiyalari
+
+**Yangi funksiyalar yordamida:**
+```python
+# Yaratish yoki o'qish (Bazada bo'lmasa yaratadi)
+user, created = User.get_or_create(name="Ali", defaults={'age': 25, 'score': 10.0})
+
+# Ommaviy yangilash (Xotirani to'ldirmasdan)
+User.query().filter(age__lt=18).update(score=0.0)
+
+# Ommaviy o'chirish
+User.query().filter(score=0.0).delete()
+```
+
+**Tezkor O'qish (Values & Values List):**
+Agar modellar bilan ishlash shart bo'lmasa va faqat JSON yuborish kerak bo'lsa:
+```python
+users_dict = User.query().values('id', 'name').all()
+# [{'id': 1, 'name': 'Ali'}, {'id': 2, 'name': 'Vali'}]
+
+names_list = User.query().values_list('name', flat=True).all()
+# ['Ali', 'Vali']
+```
+
+---
+
+## 🔄 Migratsiya Tizimi (CLI)
+
+Siz o'z loyihangiz papkasida bitta `manage.py` yaratib olib, jadvallarni SQL o'qib-o'tirmasdan terminal orqali avtomatik yangilab borishingiz mumkin.
+
+**`manage.py`:**
+```python
+import sys
+from postgresdb3 import execute_from_command_line
+from myapp.models import db_sync  # Sizning bazaga ulangan db obyektingiz
+
+# Modellar dvigatelga ko'rinishi uchun barchasini import qilish SHART!
+from myapp.models import User, Post 
+
+if __name__ == "__main__":
+    execute_from_command_line(db_sync, sys.argv)
+```
+
+**Terminalda:**
+```bash
+# Modellar asosida migratsiya faylini tayyorlash
+python manage.py makemigrations initial_setup
+
+# Bazaga jadvallarni qo'shish
+python manage.py migrate
+
+# Oxirgi migratsiyani bekor qilish va qaytarish (Rollback)
+python manage.py undo
+```
+
+---
+
+## 🔍 Murakkab Qidiruv va Aloqalar (Relations)
+
+**Auto-Join (Bog'langan jadvallar bo'ylab o'tish):**
+Qo'lda JOIN yozish o'rniga, qo'shaloq chiziqcha `__` ishlating:
+```python
+posts = Post.query().filter(author__name__startswith='A').all()
+```
+
+**Q va F ifodalar (Murakkab shartlar):**
+```python
+from postgresdb3 import Q, F
+
+# OR (|) sharti
+User.query().filter(Q(age__gt=20) | Q(name="Ali")).all()
+
+# Yoshiga nisbatan score'i katta bo'lganlarni izlash
+User.query().filter(score__gt=F("age")).all()
+```
+
+**N+1 xatoligini chetlab o'tish (select_related & prefetch_related):**
+```python
+# ForeignKey uchun (1 ta SQL so'rov)
+posts = Post.query().select_related("author").all()
+
+# ManyToMany uchun (Optimallashtirilgan yig'ish)
+posts = Post.query().prefetch_related("tags").all()
+```
+
+---
+
+## 📊 Katta Ma'lumotlar bilan Ishlash (Bulk & Pagination)
+
+**Sahifalash (Pagination):**
+Foydalanuvchiga ma'lumotlarni qismlab taqdim etish:
+```python
+result = User.query().paginate(page=1, per_page=20)
+print(result['total'])        # Jami elementlar soni
+print(result['has_next'])     # Keyingi sahifa bormi?
+print(result['data'])         # Modellar ro'yxati (20 ta)
+```
+
+**Ommaviy Yozish (Bulk Create):**
+10,000 ta obyekti birma-bir emas, bitta so'rov orqali kiritish:
+```python
+users = [User(name=f"U-{i}", age=20) for i in range(10000)]
+User.bulk_create(users)
+```
+
+---
+
+## 📈 Agregatsiya va Annotatsiya (GroupBy)
+
+Baza orqali kalkulyatsiyalarni amalga oshirish:
+
+```python
+from postgresdb3 import Sum, Avg, Count
+
+# Jami obshiy statiska:
+result = User.query().aggregate(
+    total_score=Sum("score"),
+    avg_age=Avg("age")
+)
+# {'total_score': 1500, 'avg_age': 25}
+
+# Guruhlab hisoblash (Masalan: Har bir userning postlari soni):
+users_with_count = User.query().annotate(post_count=Count("posts")).all()
+for u in users_with_count:
+    print(u.name, u.post_count)
+```
+
+---
+
+*Ushbu ORM kutubxonasi Python olamidagi ilg'or texnologiyalar yordamida tezlik va barqarorlikni birinchi o'ringa qo'yuvchi mutaxassislar uchun maxsus qurilgan.*

{postgresdb3-2.0.2 → postgresdb3-2.0.3}/README.md

@@ -14,6 +14,37 @@ Kutubxonani o'rnatish uchun terminalda quyidagi buyruqni kiriting:
 pip install postgresdb3
 ```
 
+### ⚠️ Linux/macOS tizimlarida o'rnatish va muammolar yechimi
+
+`postgresdb3` ishlashi uchun sinxron ulanishlarda `psycopg2` kutubxonasidan foydalanadi. O'rnatish vaqtida tizimingiz holatidan kelib chiqib, quyidagi ikki variantdan biri avtomatik tanlanadi:
+
+1. **`psycopg2` (Kompilyatsiya qilinadigan variant)**: Agar tizimingizda PostgreSQL ning ishlab chiquvchi kutubxonalari (`pg_config` va `pg_config.h` fayllari, masalan `libpq-dev`) mavjud bo'lsa, kutubxona manbadan (source) kompilyatsiya qilinadi. Bu ishlab chiqarish (production) muhitlari uchun tavsiya etiladi.
+2. **`psycopg2-binary` (Tayyor variant)**: Agar tizimingizda kompilyatsiya qilish uchun kerakli PostgreSQL kutubxonalari topilmasa, o'rnatish jarayoni muvaffaqiyatli yakunlanishi uchun avtomatik ravishda tayyor pre-compiled `psycopg2-binary` o'rnatiladi. Bu lokal dasturlash va test muhitlari uchun juda mos keladi.
+
+#### Tizim kutubxonalarini o'rnatish (Tavsiya etiladi)
+Ishlab chiqarish (production) muhitida toza `psycopg2` (manbadan yig'iladigan) ishlatish tavsiya etiladi. Buning uchun `postgresdb3` ni o'rnatishdan oldin quyidagi tizim paketlarini o'rnatib olishingiz kerak bo'ladi:
+
+* **Debian/Ubuntu:**
+  ```bash
+  sudo apt update
+  sudo apt install python3-dev libpq-dev build-essential
+  ```
+* **RedHat/CentOS/Fedora/Rocky Linux:**
+  ```bash
+  sudo dnf install python3-devel postgresql-devel gcc
+  ```
+* **macOS (Homebrew):**
+  ```bash
+  brew install libpq
+  ```
+
+#### Majburiy kompilyatsiya rejimini yoqish
+Agar siz pre-compiled binary versiyadan mutlaqo foydalanmasdan, toza manbali `psycopg2` ni majburiy ravishda yig'moqchi bo'lsangiz, terminalda quyidagi muhit o'zgaruvchisini (env variable) ko'rsatgan holda o'rnatishni amalga oshiring:
+
+```bash
+POSTGRESDB_SOURCE_PSYCOPG2=1 pip install postgresdb3
+```
+
 ---
 
 ## 🚀 Yangi (v2.0) Imkoniyatlari

postgresdb3-2.0.3/postgresdb3/core/__init__.py

@@ -0,0 +1,2 @@
+from .sync_db import PostgresDB
+from .async_db import AsyncPostgresDB