reydb 1.1.60__py3-none-any.whl → 1.1.61__py3-none-any.whl

reydb/rparam.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import TypeVar, Generic, overload
+from typing import Literal, TypeVar, Generic, Final, overload
 
 from . import rdb
 from .rbase import DatabaseBase
@@ -17,10 +17,20 @@ from .rexec import Result
 
 
 __all__ = (
+    'DatabaseSchemaSuper',
     'DatabaseSchema',
+    'DatabaseSchemaAsync',
+    'DatabaseParametersSuper',
     'DatabaseParameters',
+    'DatabaseParametersAsync',
+    'DatabaseParametersVariables',
     'DatabaseParametersStatus',
-    'DatabaseParametersVariable'
+    'DatabaseParametersVariablesGlobal',
+    'DatabaseParametersStatusGlobal',
+    'DatabaseParametersVariablesAsync',
+    'DatabaseParametersStatusAsync',
+    'DatabaseParametersVariablesGlobalAsync',
+    'DatabaseParametersStatusGlobalAsync'
 )
 
 
@@ -185,16 +195,18 @@ class DatabaseSchemaAsync(DatabaseSchemaSuper['rdb.DatabaseAsync']):
         return schema_dict
 
 
-class DatabaseParameters(DatabaseBase):
+class DatabaseParametersSuper(DatabaseBase, Generic[DatabaseT]):
     """
-    Database parameters type.
+    Database parameters super type.
     """
 
+    mode: Literal['VARIABLES', 'STATUS']
+    glob: bool
+
 
     def __init__(
         self,
-        db: 'rdb.Database',
-        global_: bool
+        db: DatabaseT
     ) -> None:
         """
         Build instance attributes.
@@ -202,12 +214,16 @@ class DatabaseParameters(DatabaseBase):
         Parameters
         ----------
         db: Database instance.
-        global\\_ : Whether base global.
         """
 
         # Set parameter.
         self.db = db
-        self.global_ = global_
+
+
+class DatabaseParameters(DatabaseParametersSuper['rdb.Database']):
+    """
+    Database parameters type.
+    """
 
 
     def __getitem__(self, key: str) -> str | None:
@@ -246,12 +262,6 @@ class DatabaseParameters(DatabaseBase):
         self.update(params)
 
 
-class DatabaseParametersStatus(DatabaseParameters):
-    """
-    Database parameters status type.
-    """
-
-
     @overload
     def get(self) -> dict[str, str]: ...
 
@@ -274,14 +284,11 @@ class DatabaseParametersStatus(DatabaseParameters):
         """
 
         # Generate SQL.
-
-        ## Global.
-        if self.global_:
-            sql = 'SHOW GLOBAL STATUS'
-
-        ## Not global.
-        else:
-            sql = 'SHOW STATUS'
+        sql = 'SHOW ' + (
+            'GLOBAL '
+            if self.glob
+            else ''
+        ) + self.mode
 
         # Execute SQL.
 
@@ -312,25 +319,80 @@ class DatabaseParametersStatus(DatabaseParameters):
         params : Update parameter key value pairs.
         """
 
-        # Throw exception.
-        raise AssertionError('database status not update')
+        # Generate SQL.
+        sql_set_list = [
+            '%s = %s' % (
+                key,
+                (
+                    value
+                    if type(value) in (int, float)
+                    else "'%s'" % value
+                )
+            )
+            for key, value in params.items()
+        ]
+        sql_set = ',\n    '.join(sql_set_list)
+        sql = 'SHOW ' + (
+            'GLOBAL '
+            if self.glob
+            else ''
+        ) + sql_set
+
+        # Execute SQL.
+        self.db.execute(sql)
 
 
-class DatabaseParametersVariable(DatabaseParameters):
+class DatabaseParametersAsync(DatabaseParametersSuper['rdb.DatabaseAsync']):
     """
-    Database parameters variable type.
+    Asynchrouous database parameters type.
     """
 
 
+    async def __getitem__(self, key: str) -> str | None:
+        """
+        Asynchrouous get item of parameter dictionary.
+
+        Parameters
+        ----------
+        key : Parameter key.
+
+        Returns
+        -------
+        Parameter value.
+        """
+
+        # Get.
+        value = await self.get(key)
+
+        return value
+
+
+    async def __setitem__(self, key: str, value: str | float) -> None:
+        """
+        Asynchrouous set item of parameter dictionary.
+
+        Parameters
+        ----------
+        key : Parameter key.
+        value : Parameter value.
+        """
+
+        # Set.
+        params = {key: value}
+
+        # Update.
+        await self.update(params)
+
+
     @overload
-    def get(self) -> dict[str, str]: ...
+    async def get(self) -> dict[str, str]: ...
 
     @overload
-    def get(self, key: str) -> str | None: ...
+    async def get(self, key: str) -> str | None: ...
 
-    def get(self, key: str | None = None) -> dict[str, str] | str | None:
+    async def get(self, key: str | None = None) -> dict[str, str] | str | None:
         """
-        Get parameter.
+        Asynchrouous get parameter.
 
         Parameters
         ----------
@@ -340,48 +402,49 @@ class DatabaseParametersVariable(DatabaseParameters):
 
         Returns
         -------
-        Variables of database.
+        Status of database.
         """
 
         # Generate SQL.
-
-        ## Global.
-        if self.global_:
-            sql = 'SHOW GLOBAL VARIABLES'
-
-        ## Not global.
-        else:
-            sql = 'SHOW VARIABLES'
+        sql = 'SHOW ' + (
+            'GLOBAL '
+            if self.glob
+            else ''
+        ) + self.mode
 
         # Execute SQL.
 
         ## Dictionary.
         if key is None:
-            result = self.db.execute(sql, key=key)
-            variables = result.to_dict(val_field=1)
+            result = await self.db.execute(sql, key=key)
+            status = result.to_dict(val_field=1)
 
         ## Value.
         else:
             sql += ' LIKE :key'
-            result = self.db.execute(sql, key=key)
+            result = await self.db.execute(sql, key=key)
             row = result.first()
             if row is None:
-                variables = None
+                status = None
             else:
-                variables = row['Value']
+                status = row['Value']
 
-        return variables
+        return status
 
 
-    def update(self, params: dict[str, str | float]) -> None:
+    async def update(self, params: dict[str, str | float]) -> None:
         """
-        Update parameter.
+        Asynchrouous update parameter.
 
         Parameters
         ----------
         params : Update parameter key value pairs.
         """
 
+        # Check.
+        if self.mode == 'STATUS':
+            raise AssertionError('database status not update')
+
         # Generate SQL.
         sql_set_list = [
             '%s = %s' % (
@@ -395,14 +458,83 @@ class DatabaseParametersVariable(DatabaseParameters):
             for key, value in params.items()
         ]
         sql_set = ',\n    '.join(sql_set_list)
+        sql = 'SHOW ' + (
+            'GLOBAL '
+            if self.glob
+            else ''
+        ) + sql_set
 
-        ## Global.
-        if self.global_:
-            sql = f'SET GLOBAL {sql_set}'
+        # Execute SQL.
+        await self.db.execute(sql)
 
-        ## Not global.
-        else:
-            sql = f'SET {sql_set}'
 
-        # Execute SQL.
-        self.db.execute(sql)
+class DatabaseParametersVariables(DatabaseParameters):
+    """
+    Database variable parameters type.
+    """
+
+    mode: Final = 'VARIABLES'
+    glob: Final = False
+
+
+class DatabaseParametersStatus(DatabaseParameters):
+    """
+    Database status parameters type.
+    """
+
+    mode: Final = 'STATUS'
+    glob: Final = False
+
+
+class DatabaseParametersVariablesGlobal(DatabaseParameters):
+    """
+    Database global variable parameters type.
+    """
+
+    mode: Final = 'VARIABLES'
+    glob: Final = True
+
+
+class DatabaseParametersStatusGlobal(DatabaseParameters):
+    """
+    Database global status parameters type.
+    """
+
+    mode: Final = 'STATUS'
+    glob: Final = True
+
+
+class DatabaseParametersVariablesAsync(DatabaseParametersAsync):
+    """
+    Asynchrouous database variable parameters type.
+    """
+
+    mode: Final = 'VARIABLES'
+    glob: Final = False
+
+
+class DatabaseParametersStatusAsync(DatabaseParametersAsync):
+    """
+    Asynchrouous database status parameters type.
+    """
+
+    mode: Final = 'STATUS'
+    glob: Final = False
+
+
+class DatabaseParametersVariablesGlobalAsync(DatabaseParametersAsync):
+    """
+    Asynchrouous database global variable parameters type.
+    """
+
+    mode: Final = 'VARIABLES'
+    glob: Final = True
+
+
+class DatabaseParametersStatusGlobalAsync(DatabaseParametersAsync):
+    """
+    Asynchrouous database global status parameters type.
+    """
+
+    mode: Final = 'STATUS'
+    glob: Final = True

{reydb-1.1.60.dist-info → reydb-1.1.61.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reydb
-Version: 1.1.60
+Version: 1.1.61
 Summary: Database method set.
 Project-URL: homepage, https://github.com/reyxbo/reydb/
 Author-email: Rey <reyxbo@163.com>

reydb-1.1.61.dist-info/RECORD

@@ -0,0 +1,16 @@
+reydb/__init__.py,sha256=zuQ14sl7rZ6lQ1P566ALjiRi-PcIXj9Ff0U_yYNQHFE,581
+reydb/rall.py,sha256=8tWDeGRLKujqPHFy4898WCIgZEA4OxOfeQ8xG6Fw69c,387
+reydb/rbase.py,sha256=16fG_YWnvJFu0ElXvc3BS9PtSJFZ9M631Te0b2ewWDE,9457
+reydb/rbuild.py,sha256=-C8ORqJSa6tDBMm7Y-ZcN80sgWs5rX6I0aO0DioXNm4,46599
+reydb/rconfig.py,sha256=mA40xrC5O9Y3lHnuJYDRUqRsLk3s2BFxgXou2tnFAXM,21196
+reydb/rconn.py,sha256=guRaR8N6RuzZzujwaeq7HhKWTizF9SrUBqEAFjfjpoo,6909
+reydb/rdb.py,sha256=Dh0J26fIfRrX8EK25cH1MfFzPLmWC-VnvXjLgiS_wFM,13824
+reydb/rerror.py,sha256=309PJVQG7jsL2A2R5IW4zuS4IojBgoGx3qxwIotBh_k,9896
+reydb/rexec.py,sha256=sOiapQnnbMhnItgYhUZ4iz8xRolsUJz6inCH1-7hb54,52074
+reydb/rfile.py,sha256=usK1W39O3Fi7FoAljhDIFgqj15c1GrQv3ASYUt1IxdA,15087
+reydb/rorm.py,sha256=heJf_vVJgjlNNQHbkpS_Q2rk8CBmRdOOSO7RZBfHulE,40355
+reydb/rparam.py,sha256=hXpnT4YnTgZFjyuc6bf2TCc-p1HQ7ycJjamq7I1xook,12851
+reydb-1.1.61.dist-info/METADATA,sha256=U2Xa2A4pdO1OKHmYgzphmIWh0cma7fCBi31grlX8iwQ,1622
+reydb-1.1.61.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+reydb-1.1.61.dist-info/licenses/LICENSE,sha256=UYLPqp7BvPiH8yEZduJqmmyEl6hlM3lKrFIefiD4rvk,1059
+reydb-1.1.61.dist-info/RECORD,,