reykit 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

reydb/rparameter.py

@@ -0,0 +1,243 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2022-12-05 14:10:02
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Database parameter methods.
+"""
+
+
+from typing import Union, Optional, overload
+
+from .rconnection import RDatabase, RDBConnection
+
+
+__all__ = (
+    'RDBParameter',
+    'RDBPStatus',
+    'RDBPVariable'
+)
+
+
+class RDBParameter(object):
+    """
+    Rey's `database parameters` type.
+    """
+
+
+    def __init__(
+        self,
+        rdatabase: Union[RDatabase, RDBConnection],
+        global_: bool
+    ) -> None:
+        """
+        Build `database parameters` attributes.
+
+        Parameters
+        ----------
+        rdatabase : RDatabase or RDBConnection instance.
+        global_ : Whether base global.
+        """
+
+        # Set parameter.
+        self.rdatabase = rdatabase
+        self.global_ = global_
+
+
+    def __getitem__(self, key: str) -> Optional[str]:
+        """
+        Get item of parameter dictionary.
+
+        Parameters
+        ----------
+        key : Parameter key.
+
+        Returns
+        -------
+        Parameter value.
+        """
+
+        # Get.
+        value = self.get(key)
+
+        return value
+
+
+    def __setitem__(self, key: str, value: Union[str, float]) -> None:
+        """
+        Set item of parameter dictionary.
+
+        Parameters
+        ----------
+        key : Parameter key.
+        value : Parameter value.
+        """
+
+        # Set.
+        params = {key: value}
+
+        # Update.
+        self.update(params)
+
+
+class RDBPStatus(RDBParameter):
+    """
+    Rey's `database parameter status` type.
+    """
+
+
+    @overload
+    def get(self, key: None = None) -> dict[str, str]: ...
+
+    @overload
+    def get(self, key: str = None) -> Optional[str]: ...
+
+    def get(self, key: Optional[str] = None) -> Union[dict[str, str], Optional[str]]:
+        """
+        Get parameter.
+
+        Parameters
+        ----------
+        key : Parameter key.
+            - `None`: Return dictionary of all parameters.
+            - `str`: Return value of parameter.
+
+        Returns
+        -------
+        Status of database.
+        """
+
+        # Generate SQL.
+
+        ## Global.
+        if self.global_:
+            sql = 'SHOW GLOBAL STATUS'
+
+        ## Not global.
+        else:
+            sql = 'SHOW STATUS'
+
+        # Execute SQL.
+
+        ## Dictionary.
+        if key is None:
+            status = result.fetch_dict(val_field=1)
+
+        ## Value.
+        else:
+            sql += ' LIKE :key'
+            result = self.rdatabase(sql, key=key)
+            row = result.first()
+            if row is None:
+                status = None
+            else:
+                status = row['Value']
+
+        return status
+
+
+    def update(self, params: dict[str, Union[str, float]]) -> None:
+        """
+        Update parameter.
+
+        Parameters
+        ----------
+        params : Update parameter key value pairs.
+        """
+
+        # Throw exception.
+        raise AssertionError('database status not update')
+
+
+class RDBPVariable(RDBParameter):
+    """
+    Rey's `database parameter variable` type.
+    """
+
+
+    @overload
+    def get(self, key: None = None) -> dict[str, str]: ...
+
+    @overload
+    def get(self, key: str = None) -> Optional[str]: ...
+
+    def get(self, key: Optional[str] = None) -> Union[dict[str, str], Optional[str]]:
+        """
+        Get parameter.
+
+        Parameters
+        ----------
+        key : Parameter key.
+            - `None`: Return dictionary of all parameters.
+            - `str`: Return value of parameter.
+
+        Returns
+        -------
+        Variables of database.
+        """
+
+        # Generate SQL.
+
+        ## Global.
+        if self.global_:
+            sql = 'SHOW GLOBAL VARIABLES'
+
+        ## Not global.
+        else:
+            sql = 'SHOW VARIABLES'
+
+        # Execute SQL.
+
+        ## Dictionary.
+        if key is None:
+            variables = result.fetch_dict(val_field=1)
+
+        ## Value.
+        else:
+            sql += ' LIKE :key'
+            result = self.rdatabase(sql, key=key)
+            row = result.first()
+            if row is None:
+                variables = None
+            else:
+                variables = row['Value']
+
+        return variables
+
+
+
+    def update(self, params: dict[str, Union[str, float]]) -> None:
+        """
+        Update parameter.
+
+        Parameters
+        ----------
+        params : Update parameter key value pairs.
+        """
+
+        # Generate SQL.
+        sql_set_list = [
+            '%s = %s' % (
+                key,
+                (
+                    value
+                    if value.__class__ in (int, float)
+                    else "'%s'" % value
+                )
+            )
+            for key, value in params.items()
+        ]
+        sql_set = ',\n    '.join(sql_set_list)
+
+        # Global.
+        if self.global_:
+            sql = f'SET GLOBAL {sql_set}'
+
+        ## Not global.
+        else:
+            sql = f'SET {sql_set}'
+
+        # Execute SQL.
+        self.rdatabase(sql)

reykit/__init__.py

@@ -38,4 +38,4 @@ rzip : File compress methods.
 from typing import Final
 
 
-__version__: Final[str] = '1.0.0'
+__version__: Final[str] = '1.0.1'

reykit/rrandom.py

@@ -47,25 +47,57 @@ class RConfigRandom(object, metaclass=RConfigMeta):
 
 class RRandomSeed(object):
     """
-    Rey's `random seed` type.
-    To be used in syntax `with`, set random seed.
+    Rey's `random seed` type, set random seed.
     If set, based on `random` package.
     If not set, based on `secrets` package.
+
+    Examples
+    --------
+    Use active switch.
+    >>> RRandomSeed(seed)
+    >>> randn()
+    >>> RRandomSeed()
+
+    Use `with` syntax.
+    >>> with RRandomSeed(seed):
+    >>>     randn()
     """
 
 
-    def __init__(self, seed: Union[int, float, str, bytes, bytearray]) -> None:
+    def __init__(self, seed: Optional[Union[int, float, str, bytes, bytearray]] = None) -> None:
         """
         Build `random` attributes.
+
+        Parameters
+        ----------
+        seed : Random seed.
+            - `None`: Clear seed.
+            - `Union[int, float, str, bytes, bytearray]` : Set seed.
         """
 
+        # Delete.
+        if seed is None:
+            self.__del__()
+
         # Build.
-        self.seed = seed
-        self.random = Random(seed)
+        else:
+            self.seed = seed
+            self.random = Random(seed)
 
-        # Record.
+            ## Record.
+            thread_id = threading_get_ident()
+            RConfigRandom._rrandom_dict[thread_id] = self
+
+
+    def __del__(self) -> None:
+        """
+        Delete instance.
+        """
+
+        # Delete.
         thread_id = threading_get_ident()
-        RConfigRandom._rrandom_dict[thread_id] = self
+        if thread_id in RConfigRandom._rrandom_dict:
+            del RConfigRandom._rrandom_dict[thread_id]
 
 
     def __enter__(self) -> Self:
@@ -97,8 +129,7 @@ class RRandomSeed(object):
         """
 
         # Delete.
-        thread_id = threading_get_ident()
-        del RConfigRandom._rrandom_dict[thread_id]
+        self.__del__()
 
 
 @overload

{reykit-1.0.0.dist-info → reykit-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reykit
-Version: 1.0.0
+Version: 1.0.1
 Summary: Rey's kit method set.
 Home-page: https://github.com/reyxbo/reykit/
 Author: Rey

reykit-1.0.1.dist-info/RECORD

@@ -0,0 +1,64 @@
+reydb/__init__.py,sha256=OoI005B_eXGcInBJEnV-r3IKXcASAXRtk4MW8EnsAhU,519
+reydb/rall.py,sha256=B1-E7TMMLOay28T-nm9rqWUvDQDPjwFNAhL-VzR_QAg,319
+reydb/rbuild.py,sha256=4vb0PtSKM-Y9Xhn0tSJSxsifmHdmtjHDv-gFGYjca5c,34832
+reydb/rconnection.py,sha256=bYwcynvmdpQkLKuDEaetRZxFthcV_sS1xj46HspjmZk,67168
+reydb/rexecute.py,sha256=afg4WqF-qvD5M2Lun-k7FZ6bGXuYKl8SKBey4ScZIrQ,9524
+reydb/rfile.py,sha256=CwBXgEORWF9QssIgdH9uQlZ4FG8aeowCejruab90dOs,11531
+reydb/rinformation.py,sha256=2kBr-X4yE3nlbf-RMsJkkUsdNjo0YCiEhe0wgcfVyzc,13240
+reydb/rparameter.py,sha256=aC-TUlwvUB2VUn7MlYJ_gNj5U600KJuYMKE6blOX1ek,5248
+reykit/__init__.py,sha256=Azqw5FaTSwK9tatoY01h3ELt0VVWqQL80d8rVEzAlSg,917
+reykit/rall.py,sha256=mOFwHXZ4-BOkJ5Ptbm6lQc2zwNf_VqcqM6AYYnYPfoo,672
+reykit/rcomm.py,sha256=_i0hrCB3moZhA3sm2ebg54i9dQ8QjI57ZV2cKm0vxA4,11523
+reykit/rdata.py,sha256=qmx9yKrfP2frOQjj-34ze8sa1l4sOQXtemkKyrVtKXs,8495
+reykit/remail.py,sha256=-uSU2yHyFbjs6X9M5Sjb4TMjw4cK8_Bnsmsaos3f0Rs,6860
+reykit/rexception.py,sha256=sI5EKD5gfsdwApovA4DFnlm_MxmPp7TChNLzGmGvZ9M,8150
+reykit/rimage.py,sha256=BmNNyhqezN9f40gaE5_rv6B7-v9mYkUwT8n2tfCDfdw,6331
+reykit/rlog.py,sha256=J-fnY5B3Y2oJOuyHvemy6ltkr8he4spS3iQOADIUg00,26525
+reykit/rmonkey.py,sha256=s8TdR-_tRRMiR11eCLHCkFAJuAZe7PVIhkR-74Xt8vw,7644
+reykit/rmultitask.py,sha256=L4_dlIKGV3DrWlID2MDc1Fl-o0kt23l7oYGp4-WJRYU,22057
+reykit/rnumber.py,sha256=MajaVOVa3_H1lm91cu9HLaLXd9ZsvZYFxXvcklC0LWs,3209
+reykit/ros.py,sha256=wv1DM2N8MXBwGqBhNUSiDLrvHRK7syibhFwEPGkpxYM,39336
+reykit/rrandom.py,sha256=4SICHR_ETKG2Syu50wPAZB8DCEmrQq3GQZl6nf4TZ9k,9161
+reykit/rregex.py,sha256=E9BConP7ADYyGVZ5jpxwUmtc_WXFb-I1Zjt6IZSHkIQ,6218
+reykit/rschedule.py,sha256=TiIFQ0siL20nlhikWfvRGhOdeRbyHQtN6uxFivA2WoI,5852
+reykit/rstdout.py,sha256=yjCTegPqm2FNIpNGVrmz16Jn2bNncYO1axuANVdTmVQ,9710
+reykit/rsystem.py,sha256=EbPOKtwtVyXqX4AqKMKPW1cEAixqHAOemaxrlEpT0ZY,29388
+reykit/rtable.py,sha256=ghsppMMOGkz3boV_CSxpkel5Lfj-ViBziZrpcCoY5YA,12229
+reykit/rtext.py,sha256=xilQxaMMdaVCBk6rxQb1aI8-j52QVUH5EtTZVMQsa8Q,11108
+reykit/rtime.py,sha256=2xOGGETwl1Sc3W80a2KiPbI4GsSfIyksTeXgqNOTYVw,17178
+reykit/rtype.py,sha256=PbfaHjNQTMiZynlz8HwP2K9SS-t91ThMOYBxQIBf9Ug,1975
+reykit/rwrap.py,sha256=4RdTxT2y7ViyeiWx2fJ54k9ZZT6Bmx5QStIiwEHB6rY,15320
+reykit/rzip.py,sha256=HTrxyb4e6f38eOPFIXsdbcEwr7FQSqnU2MVmVRBYTbg,3563
+reykit/rdll/__init__.py,sha256=vM9V7wSNno-WH9RrxgHTIgCkQm8LmBFoLFO8z7qovNo,306
+reykit/rdll/rdll_inject.py,sha256=bETl8tywtN1OiQudbA21u6GwBM_bqVX7jbiisNj_JBg,645
+reykit/rdll/rdll_inject_core.py,sha256=Trgh_pdJs_Lw-Y-0Kkn8kHr4BnilM9dBKnHnX25T_pM,5092
+reyweb/__init__.py,sha256=DKX_nTvcEY1UX7SCRdCgid-ak1XkLruvNzl50T5tl6o,287
+reyweb/rall.py,sha256=jHEW2PQkHddvxeaTUukPGb2p-3tXROPP4Cfdp4L_RWc,188
+reyweb/rbaidu/__init__.py,sha256=8HLCTEhMwGudKmGAHJ3Ix-pE4HY8ul6UEAisTPzoGO4,426
+reyweb/rbaidu/rbaidu_base.py,sha256=RjNaw713l2Fah2Xr9_SLXgAbWE0NAmucc-6rdSPG8tw,4134
+reyweb/rbaidu/rbaidu_chat.py,sha256=sYZ_w0arZ-SL5ZAYFGjdEoT7fmNwgm9vOQ76H4SOWkQ,8279
+reyweb/rbaidu/rbaidu_image.py,sha256=D4-VjaaZxvljhmv8qfaZ2N1qFY-Evkkw4S08m_l6jws,3997
+reyweb/rbaidu/rbaidu_voice.py,sha256=s6bf5K2fTlsBdINN-BGimAoCMGBdet-OSRiTLGbTkWY,5609
+reywechat/__init__.py,sha256=3dIerRyo2kL6MDzHaxcDb-FgPswFq6wpm8LKR8YYZgc,572
+reywechat/rall.py,sha256=2mjjPSzmiyR6AYOpuzP1Fnw75HXTYoRYSoRpCEcYQOc,385
+reywechat/rclient.py,sha256=jPoSezFgr4_N64XFcyXP4hqavCrb7UMoqVsQC6hPDAU,21934
+reywechat/rdatabase.py,sha256=McG-3GsOzO4jhPPI-_dwf7nIekAJa0M3e1mx2QzGfQo,37327
+reywechat/rexception.py,sha256=Q0r64erO4MbtIMHFkIfmTlWYY1A1XqS-brfHEw3Uh_E,1351
+reywechat/rexecute.py,sha256=mMyhjoSyG3_hU-j9BVvXdqEzmyXMb-pBqOuZ8MpREOA,4658
+reywechat/rlog.py,sha256=N55o-gmLbZ_6NRd8zznLR84Xrmc41h3RODPoqjGjWfQ,4667
+reywechat/rreceive.py,sha256=ATZ65656AJWZm43iuu0_xHa7d4KClmVkDSIav_D7Q1Q,31067
+reywechat/rschedule.py,sha256=XRCa1QVW0bq8Bhb4mYv-S_aq6-wvQFF3uZ0t2WFTFQI,3474
+reywechat/rsend.py,sha256=PIUY3ebAEY-xaTf2k50puWI-jlz5U9kTIjRvbrRpzUE,16221
+reywechat/rwechat.py,sha256=pRZPWu1nGfsQoYCC1A-79-xiflEFFzaqwh6Kshv3fdQ,5721
+reywechat/data/client_api.dll,sha256=H9uj-x9Ztg0jFZK0yY6NsnyH5_119dQRFfoVVMidxRs,592384
+reyworm/__init__.py,sha256=pUER-wZkP_r70mvgcTy2M2n55Zcybzf-iDWSIecOGZo,428
+reyworm/rall.py,sha256=gXixof3iLlJxmjS7Nmnk4lAXrHXX5mbYA9r4g7ZCYHU,291
+reyworm/rbrowser.py,sha256=QC1E29yNm0wyugKZlBhfkpIIieEus9SrS11Vt-ZMGCk,2612
+reyworm/rcalendar.py,sha256=pVifh3HqyaB6vujrS4z2G8QrFM5MYqpE3jq0HdAlLNw,3884
+reyworm/rnews.py,sha256=e63m0Lrmy2edvhKic94X3xRRgOySf3oniKu9N6Zyg60,3079
+reyworm/rsecurity.py,sha256=IiYTdCCs3VVKkT6Dh8adlZqRvdreJthdcf_R_1zcJqU,6912
+reyworm/rtranslate.py,sha256=vsg1EfAtPbff8Zqd5FvArq8Lg5AHOuOJR9aSQoEIVMo,1349
+reykit-1.0.1.dist-info/METADATA,sha256=lW4DMDUd0tQQfqKvoXmpLXrsRkPxKS77Nk_HpGArBCM,700
+reykit-1.0.1.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+reykit-1.0.1.dist-info/top_level.txt,sha256=2hvySInjpVEcpYg-XFCYVU5xB2TWW8RovoDtBDzAqyE,7
+reykit-1.0.1.dist-info/RECORD,,

reyweb/__init__.py

@@ -0,0 +1,19 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2023-02-19 18:59:26
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Rey's Web method set.
+
+Modules
+-------
+baidu : Baidu API methods.
+"""
+
+
+from typing import Final
+
+
+__version__: Final[str] = '1.0.0'

reyweb/rall.py

@@ -0,0 +1,12 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2024-01-11 22:47:52
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : All methods.
+"""
+
+
+from .rbaidu import *

reyweb/rbaidu/__init__.py

@@ -0,0 +1,21 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2024-01-11 21:55:48
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Baidu API methods.
+
+Modules
+-------
+rbaidu_base : Baidu API base methods.
+rbaidu_voice : Baidu API voice methods.
+rbaidu_Image : Baidu API image methods.
+"""
+
+
+from .rbaidu_base import *
+from .rbaidu_chat import *
+from .rbaidu_image import *
+from .rbaidu_voice import *

reyweb/rbaidu/rbaidu_base.py

@@ -0,0 +1,186 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2024-01-11 21:56:56
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Baidu API base methods.
+"""
+
+
+from typing import Any, TypedDict
+from datetime import datetime
+from requests import Response
+from uuid import uuid1
+from reykit.rcomm import request as reytool_request
+from reykit.rtime import now
+
+
+__all__ = (
+    'RAPIBaidu',
+)
+
+
+CallRecord = TypedDict('CallRecord', {'time': datetime, 'data': Any})
+
+
+class RAPIBaidu(object):
+    """
+    Rey's `Baidu API` type.
+    """
+
+
+    def __init__(
+        self,
+        key: str,
+        secret: str,
+        token_valid_seconds: float = 43200
+    ) -> None:
+        """
+        Build `Baidu API` attributes.
+
+        Parameters
+        ----------
+        key : API key.
+        secret : API secret.
+        token_valid_seconds : Authorization token vaild seconds.
+        """
+
+        # Set attribute.
+        self.key = key
+        self.secret = secret
+        self.token_valid_seconds = token_valid_seconds
+        self.cuid = uuid1()
+        self.call_records: list[CallRecord] = []
+        self.start_time = now()
+
+
+    def get_token(self) -> str:
+        """
+        Get token.
+
+        Returns
+        -------
+        Token.
+        """
+
+        # Get parameter.
+        url = 'https://aip.baidubce.com/oauth/2.0/token'
+        params = {
+            'grant_type': 'client_credentials',
+            'client_id': self.key,
+            'client_secret': self.secret
+        }
+
+        # Request.
+        response = self.request(
+            url,
+            params,
+            method='post'
+        )
+
+        # Extract.
+        response_json = response.json()
+        token = response_json['access_token']
+
+        return token
+
+
+    @property
+    def token(self) -> str:
+        """
+        Get authorization token.
+        """
+
+        # Get parameter.
+        if hasattr(self, 'token_time'):
+            token_time: datetime = getattr(self, 'token_time')
+        else:
+            token_time = None
+        if (
+            token_time is None
+            or (now() - token_time).seconds > self.token_valid_seconds
+        ):
+            self.token_time = now()
+            self._token = self.get_token()
+
+        return self._token
+
+
+    def request(
+        self,
+        *args: Any,
+        **kwargs: Any
+    ) -> Response:
+        """
+        Request.
+
+        Parameters
+        ----------
+        args : Position arguments of function.
+        kwargs : Keyword arguments of function.
+
+        Returns
+        -------
+        `Response` instance.
+        """
+
+        # Request.
+        response = reytool_request(*args, **kwargs)
+
+        # Check.
+        content_type = response.headers['Content-Type']
+        if content_type.startswith('application/json'):
+            response_json: dict = response.json()
+            if 'error_code' in response_json:
+                raise AssertionError('Baidu API request failed', response_json)
+
+        return response
+
+
+    def record_call(
+        self,
+        **data: Any
+    ) -> None:
+        """
+        Record call.
+
+        Parameters
+        ----------
+        data : Record data.
+        """
+
+        # Get parameter.
+        record = {
+            'time': now(),
+            'data': data
+        }
+
+        # Record.
+        self.call_records.append(record)
+
+
+    @property
+    def interval(self) -> float:
+        """
+        Return the interval seconds from last call.
+        When no record, then return the interval seconds from start.
+
+        Returns
+        -------
+        Interval seconds.
+        """
+
+        # Get parameter.
+        if self.call_records == []:
+            last_time = self.start_time
+        else:
+            last_time: datetime = self.call_records[-1]['time']
+
+        # Count.
+        now_time = now()
+        interval_time = now_time - last_time
+        interval_seconds = interval_time.total_seconds()
+
+        return interval_seconds