postgresdb3 1.1.0__tar.gz → 2.0.0__tar.gz

postgresdb3-2.0.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: postgresdb3
+Version: 2.0.0
+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.*

postgresdb3-2.0.0/README.md

@@ -0,0 +1,201 @@
+# 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.*

{postgresdb3-1.1.0 → postgresdb3-2.0.0}/postgresdb3/cli.py

@@ -19,6 +19,7 @@ def execute_from_command_line(db, argv=None):
                     
     make_parser = subparsers.add_parser("makemigrations", help="Modellardagi o'zgarishlar asosida yangi migratsiya fayllarini yaratadi")
     make_parser.add_argument("name", nargs="?", default="auto", help="Migratsiya nomi (masalan: initial_setup)")
+    make_parser.add_argument("--no-input", action="store_true", help="O'chirishlar (DROP) bo'lsa ogohlantirmasdan bajarish")
     
              
     subparsers.add_parser("migrate", help="Mavjud migratsiyalarni ma'lumotlar bazasiga qo'llaydi")
@@ -29,19 +30,22 @@ def execute_from_command_line(db, argv=None):
     if args.command == "makemigrations":
         engine = MigrationEngine()
         print(f"'{args.name}' nomli migratsiya yaratilmoqda...")
-        engine.makemigrations(args.name)
+        engine.makemigrations(args.name, interactive=not args.no_input)
         
     elif args.command == "migrate":
         engine = MigrationEngine()
         if isinstance(db, PostgresDB):
             engine.migrate(db)
         elif isinstance(db, AsyncPostgresDB):
-                                                                                   
-            loop = asyncio.get_event_loop()
-            if loop.is_running():
+            try:
+                loop = asyncio.get_running_loop()
+            except RuntimeError:
+                loop = None
+
+            if loop and loop.is_running():
                 asyncio.ensure_future(engine.async_migrate(db))
             else:
-                loop.run_until_complete(engine.async_migrate(db))
+                asyncio.run(engine.async_migrate(db))
         else:
             print("Xato: Noma'lum DB obyekti (PostgresDB yoki AsyncPostgresDB kerak).")
             
@@ -50,11 +54,15 @@ def execute_from_command_line(db, argv=None):
         if isinstance(db, PostgresDB):
             engine.undo_migration(db)
         elif isinstance(db, AsyncPostgresDB):
-            loop = asyncio.get_event_loop()
-            if loop.is_running():
+            try:
+                loop = asyncio.get_running_loop()
+            except RuntimeError:
+                loop = None
+
+            if loop and loop.is_running():
                 asyncio.ensure_future(engine.async_undo_migration(db))
             else:
-                loop.run_until_complete(engine.async_undo_migration(db))
+                asyncio.run(engine.async_undo_migration(db))
         else:
             print("Xato: Noma'lum DB obyekti (PostgresDB yoki AsyncPostgresDB kerak).")
             

{postgresdb3-1.1.0 → postgresdb3-2.0.0}/postgresdb3/core/async_db.py

@@ -27,9 +27,16 @@ class AsyncPostgresDB:
         self._async_conn = contextvars.ContextVar(f"async_conn_{id(self)}", default=None)
 
     async def _manager(self, sql: str, *params, fetchone=False, fetchall=False, commit=False, many=False) -> Any:
-        if "%s" in sql:
-            parts = sql.split("%s")
-            sql = "".join([part + f"${i+1}" for i, part in enumerate(parts[:-1])]) + parts[-1]
+        if params and "%s" in sql:
+            import re
+            counter = 1
+            def repl(match):
+                nonlocal counter
+                res = f"${counter}"
+                counter += 1
+                return res
+            sql = re.sub(r'(?<!%)%s', repl, sql)
+            sql = sql.replace("%%", "%")
             
         if self.echo:
             print(f"\033[94m[SQL]: {sql} \n[PARAMS]: {params}\033[0m")
@@ -103,6 +110,9 @@ class AsyncPostgresDB:
         if not isinstance(columns, str) or not columns.strip():
             raise ValueError("columns noto'g'ri bo'lishi mumkin emas")
 
+        if ";" in columns or "--" in columns:
+            raise ValueError("SQL injection xavfi mavjud: yaroqsiz ustun nomi")
+
         return columns
 
     def _build_where(self, where: Any, start_index: int = 1) -> tuple[str, list]:
@@ -128,6 +138,12 @@ class AsyncPostgresDB:
                 "lte": "<=",
                 "like": "LIKE",
                 "ilike": "ILIKE",
+                "contains": "LIKE",
+                "icontains": "ILIKE",
+                "startswith": "LIKE",
+                "istartswith": "ILIKE",
+                "endswith": "LIKE",
+                "iendswith": "ILIKE",
             }
 
             for key, value in where.items():
@@ -139,6 +155,12 @@ class AsyncPostgresDB:
                 self._validate_identifier(field, "where field")
 
                 if op in operator_map:
+                    if op in ("contains", "icontains"):
+                        value = f"%{value}%"
+                    elif op in ("startswith", "istartswith"):
+                        value = f"{value}%"
+                    elif op in ("endswith", "iendswith"):
+                        value = f"%{value}"
                     clauses.append(f"{field} {operator_map[op]} ${index}")
                     params.append(value)
                     index += 1
@@ -298,18 +320,9 @@ class AsyncPostgresDB:
         if not values_list:
             raise ValueError("values_list bo'sh bo'lishi mumkin emas")
 
-        placeholders_list = []
-        flat_values = []
-        counter = 1
-
-        for values in values_list:
-            placeholders = ", ".join(f"${i}" for i in range(counter, counter + len(values)))
-            placeholders_list.append(f"({placeholders})")
-            flat_values.extend(values)
-            counter += len(values)
-
-        sql = f"INSERT INTO {table} ({columns}) VALUES {', '.join(placeholders_list)}"
-        await self._manager(sql, *flat_values, commit=True)
+        placeholders = ", ".join(f"${i+1}" for i in range(len(values_list[0])))
+        sql = f"INSERT INTO {table} ({columns}) VALUES ({placeholders})"
+        await self._manager(sql, values_list, commit=True, many=True)
 
     async def update(self, table: str, set_column: str, set_value: Any, where_column: str, where_value: Any) -> None:
         sql = f"UPDATE {table} SET {set_column} = $1 WHERE {where_column} = $2"
@@ -463,6 +476,11 @@ class AsyncPostgresDB:
         
     @asynccontextmanager
     async def transaction(self):
+        existing_conn = self._async_conn.get()
+        if existing_conn:
+            yield existing_conn
+            return
+            
         if not self.pool:
             if self._pool_lock is None:
                 self._pool_lock = asyncio.Lock()
@@ -477,7 +495,7 @@ class AsyncPostgresDB:
                         min_size=self.min_size,
                         max_size=self.max_size
                     )
-        
+
         conn = await self.pool.acquire()
         token = self._async_conn.set(conn)
         try:
@@ -486,3 +504,15 @@ class AsyncPostgresDB:
         finally:
             self._async_conn.reset(token)
             await self.pool.release(conn)
+    def atomic(self):
+        """
+        Asinxron funksiyalarni tranzaksiya (transaction) ichida ishlatish uchun dekorator.
+        """
+        def decorator(func):
+            import functools
+            @functools.wraps(func)
+            async def wrapper(*args, **kwargs):
+                async with self.transaction():
+                    return await func(*args, **kwargs)
+            return wrapper
+        return decorator