postgresdb3 0.1.0__tar.gz → 0.2.0__tar.gz

{postgresdb3-0.1.0 → postgresdb3-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: postgresdb3
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python uchun oddiy PostgreSQL wrapper
 Home-page: https://github.com/AlijonovUz/PostgresDB
 Author: Abdulbosit Alijonov
@@ -10,6 +10,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 Requires-Dist: psycopg2>=2.9
+Requires-Dist: asyncpg>=0.31.0
 Dynamic: author
 Dynamic: classifier
 Dynamic: description

postgresdb3-0.2.0/postgresdb3/__init__.py

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

postgresdb3-0.2.0/postgresdb3/async_db.py

@@ -0,0 +1,228 @@
+import asyncpg
+from typing import Any, List, Optional
+
+
+class AsyncPostgresDB:
+    """
+    Async PostgreSQL helper class for CRUD operations and schema management.
+
+    Ushbu class `asyncpg` kutubxonasidan foydalanib,
+    PostgreSQL bilan asynchronous CRUD va schema operatsiyalarini bajaradi.
+    Aiogram kabi async frameworklar bilan to‘g‘ridan-to‘g‘ri ishlash uchun mos.
+    """
+
+    def __init__(self, database: str, user: str, password: str, host: str = "localhost", port: int = 5432):
+        """
+        PostgreSQL bazasiga ulanishni tayyorlaydi.
+
+        Args:
+            database (str): Bazaning nomi.
+            user (str): Foydalanuvchi nomi.
+            password (str): Parol.
+            host (str): Server manzili (default: "localhost").
+            port (int): Port (default: 5432).
+        """
+        self.database = database
+        self.user = user
+        self.password = password
+        self.host = host
+        self.port = port
+        self.pool: Optional[asyncpg.pool.Pool] = None
+
+    async def manager(self, sql: str, *params, fetchone=False, fetchall=False, commit=False):
+        """
+        Markaziy metod: barcha SQL so‘rovlarni bajaradi.
+
+        Args:
+            sql (str): Bajariladigan SQL so‘rov.
+            *params: SQL parametrlarini berish.
+            fetchone (bool): True bo‘lsa, faqat bitta qator qaytaradi.
+            fetchall (bool): True bo‘lsa, barcha natijalarni qaytaradi.
+            commit (bool): True bo‘lsa, tranzaksiya commit qilinadi.
+
+        Returns:
+            fetchone=True bo‘lsa: asyncpg.Record
+            fetchall=True bo‘lsa: list[asyncpg.Record]
+            commit=True bo‘lsa: None
+        """
+        if not self.pool:
+            self.pool = await asyncpg.create_pool(
+                database=self.database,
+                user=self.user,
+                password=self.password,
+                host=self.host,
+                port=self.port
+            )
+
+        async with self.pool.acquire() as conn:
+            if commit:
+                await conn.execute(sql, *params)
+                return
+            if fetchone:
+                return await conn.fetchrow(sql, *params)
+            if fetchall:
+                return await conn.fetch(sql, *params)
+
+    async def close_pool(self):
+        """
+        Connection poolni yopadi.
+        """
+        if self.pool:
+            await self.pool.close()
+            self.pool = None
+
+    async def create(self, table: str, columns: str):
+        """
+        Jadval yaratadi (agar mavjud bo‘lsa o‘tkazib yuboradi).
+
+        Args:
+            table (str): Jadval nomi.
+            columns (str): Ustunlar va turlari, misol: "id SERIAL PRIMARY KEY, name TEXT".
+        """
+        await self.manager(f"CREATE TABLE IF NOT EXISTS {table} ({columns})", commit=True)
+
+    async def drop(self, table: str):
+        """
+        Jadvalni o‘chiradi (agar mavjud bo‘lsa).
+
+        Args:
+            table (str): Jadval nomi.
+        """
+        await self.manager(f"DROP TABLE IF EXISTS {table} CASCADE", commit=True)
+
+    async def select(
+        self, table: str, columns: str = "*",
+        where: Optional[List[Any]] = None,
+        join: Optional[List[tuple]] = None,
+        group_by: Optional[str] = None,
+        order_by: Optional[str] = None,
+        limit: Optional[int] = None,
+        fetchone: bool = False
+    ):
+        """
+        Jadvaldan ma'lumotlarni tanlash.
+
+        Args:
+            table (str): Asosiy jadval nomi.
+            columns (str): Tanlanadigan ustunlar (default: "*").
+            where (Optional[List[Any]]): ("shart", [qiymatlar])
+            join (Optional[List[tuple]]): [("INNER JOIN", "orders", "users.id = orders.user_id")]
+            group_by (Optional[str]): GROUP BY ustuni.
+            order_by (Optional[str]): ORDER BY qoidasi.
+            limit (Optional[int]): LIMIT qiymati.
+            fetchone (bool): True bo‘lsa faqat bitta qator qaytaradi.
+
+        Returns:
+            asyncpg.Record yoki list[asyncpg.Record]
+        """
+        sql = f"SELECT {columns} FROM {table}"
+        params: List[Any] = []
+
+        if join:
+            for join_type, join_table, on_condition in join:
+                sql += f" {join_type} {join_table} ON {on_condition}"
+
+        if where:
+            condition, values = where
+            sql += f" WHERE {condition}"
+            params.extend(values)
+
+        if group_by:
+            sql += f" GROUP BY {group_by}"
+
+        if order_by:
+            sql += f" ORDER BY {order_by}"
+
+        if limit is not None:
+            sql += f" LIMIT $%d" % (len(params) + 1)
+            params.append(limit)
+
+        return await self.manager(sql, *params, fetchone=fetchone, fetchall=not fetchone)
+
+    async def insert(self, table: str, columns: str, values: List[Any]):
+        """
+        Jadvalga yangi qator qo‘shadi.
+
+        Args:
+            table (str): Jadval nomi.
+            columns (str): Ustunlar nomi, misol: "name, age".
+            values (List[Any]): Qiymatlar, misol: ["Ali", 25].
+        """
+        placeholders = ", ".join(f"${i+1}" for i in range(len(values)))
+        sql = f"INSERT INTO {table} ({columns}) VALUES ({placeholders})"
+        await self.manager(sql, *values, commit=True)
+
+    async def update(self, table: str, set_column: str, set_value: Any, where_column: str, where_value: Any):
+        """
+        Jadvaldagi qatorni yangilaydi.
+
+        Args:
+            table (str): Jadval nomi.
+            set_column (str): O‘zgartiriladigan ustun.
+            set_value (Any): Yangi qiymat.
+            where_column (str): Filtrlash ustuni.
+            where_value (Any): Filtrlash qiymati.
+        """
+        sql = f"UPDATE {table} SET {set_column} = $1 WHERE {where_column} = $2"
+        await self.manager(sql, set_value, where_value, commit=True)
+
+    async def delete(self, table: str, where_column: str, where_value: Any):
+        """
+        Jadvaldan qator o‘chiradi.
+
+        Args:
+            table (str): Jadval nomi.
+            where_column (str): Filtrlash ustuni.
+            where_value (Any): Filtrlash qiymati.
+        """
+        sql = f"DELETE FROM {table} WHERE {where_column} = $1"
+        await self.manager(sql, where_value, commit=True)
+
+    async def list_tables(self, schema: str = "public") -> List[str]:
+        """
+        Bazadagi barcha jadvallarni ro‘yxat sifatida qaytaradi.
+
+        Args:
+            schema (str): Schema nomi, default "public".
+
+        Returns:
+            List[str]: Jadval nomlari
+        """
+        sql = """
+            SELECT table_name
+            FROM information_schema.tables
+            WHERE table_schema = $1
+            ORDER BY table_name
+        """
+        result = await self.manager(sql, schema, fetchall=True)
+        return [r["table_name"] for r in result]
+
+    async def describe_table(self, table: str, schema: str = "public"):
+        """
+        Jadval ustunlari haqida ma'lumot beradi.
+
+        Args:
+            table (str): Jadval nomi.
+            schema (str): Schema nomi, default "public".
+
+        Returns:
+            list[asyncpg.Record]: Har bir ustun bo‘yicha ma’lumot
+        """
+        sql = """
+            SELECT column_name, data_type, is_nullable, column_default
+            FROM information_schema.columns
+            WHERE table_schema = $1 AND table_name = $2
+            ORDER BY ordinal_position
+        """
+        return await self.manager(sql, schema, table, fetchall=True)
+
+    async def alter(self, table: str, action: str):
+        """
+        Jadval strukturasi o‘zgartirish (ALTER TABLE).
+
+        Args:
+            table (str): Jadval nomi.
+            action (str): ALTER TABLE dan keyingi SQL qismi, misol: "ADD COLUMN age INT".
+        """
+        sql = f"ALTER TABLE {table} {action}"
+        await self.manager(sql, commit=True)

postgresdb3-0.1.0/postgresdb3/core.py → postgresdb3-0.2.0/postgresdb3/sync_db.py

@@ -147,3 +147,43 @@ class PostgresDB:
         """
         sql = f"DELETE FROM {table} WHERE {where_column} = %s"
         return self.manager(sql, (where_value,), commit=True)
+
+    def list_tables(self, schema="public"):
+        """
+        Bazadagi mavjud jadvallar ro'yxatini qaytaradi.
+
+        schema: str — schema nomi (standart: public)
+        """
+        sql = """
+              SELECT table_name
+              FROM information_schema.tables
+              WHERE table_schema = %s
+              ORDER BY table_name; \
+              """
+        return self.manager(sql, (schema,), fetchall=True)
+
+    def describe_table(self, table, schema="public"):
+        """
+        Jadval ustunlari haqida ma'lumot beradi.
+        """
+        sql = """
+              SELECT column_name,
+                     data_type,
+                     is_nullable,
+                     column_default
+              FROM information_schema.columns
+              WHERE table_schema = %s
+                AND table_name = %s
+              ORDER BY ordinal_position; \
+              """
+        return self.manager(sql, (schema, table), fetchall=True)
+
+    def alter(self, table, action):
+        """
+        Universal ALTER TABLE metodi.
+
+        table: str — jadval nomi
+        action: str — ALTER TABLE dan keyingi qism
+        """
+        sql = f"ALTER TABLE {table} {action}"
+        return self.manager(sql, commit=True)

{postgresdb3-0.1.0 → postgresdb3-0.2.0}/postgresdb3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: postgresdb3
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python uchun oddiy PostgreSQL wrapper
 Home-page: https://github.com/AlijonovUz/PostgresDB
 Author: Abdulbosit Alijonov
@@ -10,6 +10,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 Requires-Dist: psycopg2>=2.9
+Requires-Dist: asyncpg>=0.31.0
 Dynamic: author
 Dynamic: classifier
 Dynamic: description

{postgresdb3-0.1.0 → postgresdb3-0.2.0}/postgresdb3.egg-info/SOURCES.txt

@@ -2,7 +2,8 @@ README.md
 pyproject.toml
 setup.py
 postgresdb3/__init__.py
-postgresdb3/core.py
+postgresdb3/async_db.py
+postgresdb3/sync_db.py
 postgresdb3.egg-info/PKG-INFO
 postgresdb3.egg-info/SOURCES.txt
 postgresdb3.egg-info/dependency_links.txt

postgresdb3-0.2.0/postgresdb3.egg-info/requires.txt

@@ -0,0 +1,2 @@
+psycopg2>=2.9
+asyncpg>=0.31.0

{postgresdb3-0.1.0 → postgresdb3-0.2.0}/setup.py

@@ -5,10 +5,11 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name="postgresdb3",
-    version="0.1.0",
+    version="0.2.0",
     packages=find_packages(),
     install_requires=[
-        "psycopg2>=2.9"
+        "psycopg2>=2.9",
+        "asyncpg>=0.31.0"
     ],
     author="Abdulbosit Alijonov",
     description="Python uchun oddiy PostgreSQL wrapper",

postgresdb3-0.1.0/postgresdb3/__init__.py

@@ -1 +0,0 @@
-from .core import PostgresDB

postgresdb3-0.1.0/postgresdb3.egg-info/requires.txt

@@ -1 +0,0 @@
-psycopg2>=2.9